Szybki start: utwórz maszynę wirtualną Azure Operator Nexus przy użyciu Azure CLI

• Wdróż maszynę wirtualną Azure Nexus używając Azure CLI

Ten przewodnik Szybki start ułatwia rozpoczęcie pracy z maszynami wirtualnymi Nexus w celu hostowania funkcji sieci wirtualnej (VNFs). Wykonując kroki opisane w tym przewodniku, możesz szybko i łatwo utworzyć niestandardową maszynę wirtualną Nexus spełniającą określone potrzeby i wymagania. Niezależnie od tego, czy jesteś początkującym, czy ekspertem w dziedzinie sieci Nexus, ten przewodnik jest tutaj, aby pomóc. Dowiesz się, co musisz wiedzieć, aby tworzyć i dostosowywać maszyny wirtualne Nexus do hostowania funkcji sieci wirtualnej.

Zanim rozpoczniesz

Jeśli nie masz jeszcze konta platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.

• Użyj środowiska Bash w Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Get started with Azure Cloud Shell.

  

• Jeśli wolisz uruchamiać polecenia referencyjne interfejsu wiersza polecenia lokalnie, zainstaluj Azure CLI. Jeśli korzystasz z systemu Windows lub macOS, rozważ uruchomienie Azure CLI w kontenerze Docker. Aby uzyskać więcej informacji, zobacz Jak uruchomić Azure CLI w kontenerze Docker.

  • Jeśli korzystasz z instalacji lokalnej, zaloguj się do Azure CLI za pomocą polecenia az login. Aby zakończyć proces uwierzytelniania, wykonaj kroki wyświetlane na Twoim terminalu. Aby uzyskać inne opcje logowania, zobacz Uwierzytelnianie na platformie Azure przy użyciu interfejsu wiersza polecenia platformy Azure.

  • Gdy zostaniesz o to poproszony/a, zainstaluj rozszerzenie Azure CLI przy pierwszym użyciu. Aby uzyskać więcej informacji na temat rozszerzeń, zobacz Używanie rozszerzeń i zarządzanie nimi za pomocą interfejsu wiersza polecenia platformy Azure.

  • Uruchom az version, aby sprawdzić zainstalowaną wersję i biblioteki zależne. Aby zaktualizować do najnowszej wersji, uruchom az upgrade.

• Zainstaluj najnowszą wersję niezbędnych rozszerzeń interfejsu wiersza polecenia platformy Azure.

• Jeśli masz wiele subskrypcji platformy Azure, wybierz odpowiedni identyfikator subskrypcji, w którym zasoby mają być rozliczane przy użyciu az account polecenia .

• Przed kontynuowaniem tworzenia maszyny wirtualnej upewnij się, że obraz kontenera do użycia jest tworzony zgodnie z instrukcjami.

• Utwórz grupę zasobów przy użyciu polecenia az group create. Grupa zasobów platformy Azure to grupa logiczna, w której zasoby platformy Azure są wdrażane i zarządzane. Podczas tworzenia grupy zasobów zostanie wyświetlony monit o określenie lokalizacji. Ta lokalizacja to lokalizacja magazynu metadanych grupy zasobów i lokalizacja, w której zasoby są uruchamiane na platformie Azure, jeśli nie określisz innego regionu podczas tworzenia zasobów. W poniższym przykładzie tworzona jest grupa zasobów o nazwie myResourceGroup w lokalizacji eastus.

  az group create --name myResourceGroup --location eastus
  

  Poniższy przykład danych wyjściowych przypomina pomyślne utworzenie grupy zasobów:

  {
    "id": "/subscriptions/<guid>/resourceGroups/myResourceGroup",
    "location": "eastus",
    "managedBy": null,
    "name": "myResourceGroup",
    "properties": {
      "provisioningState": "Succeeded"
    },
    "tags": null
  }
  

• Aby wdrożyć plik Bicep lub szablon usługi ARM, musisz posiadać uprawnienia do zapisu w zasobach, które wdrażasz, oraz dostęp do wszystkich operacji na typie zasobu Microsoft.Resources/deployments. Na przykład do wdrożenia klastra potrzebne są uprawnienia Microsoft.NetworkCloud/virtualMachines/write i Microsoft.Resources/deployments/*. Aby uzyskać listę ról i uprawnień, zobacz Role wbudowane platformy Azure.

• Potrzebny jest identyfikator zasobu klastra Nexus operatora platformy custom location Azure.

• Musisz utworzyć różne sieci zgodnie z określonymi wymaganiami dotyczącymi obciążenia i niezbędne jest posiadanie odpowiednich adresów IP dostępnych dla obciążeń. Aby zapewnić bezproblemową implementację, zaleca się skonsultowanie się z odpowiednimi zespołami pomocy technicznej w celu uzyskania pomocy.

• Spełnij wymagania wstępne dotyczące wdrażania maszyny wirtualnej Nexus.

Tworzenie maszyny wirtualnej Nexus

Poniższy przykład tworzy maszynę wirtualną o nazwie myNexusVirtualMachine w grupie zasobów myResourceGroup w lokalizacji eastus .

Przed uruchomieniem poleceń należy ustawić kilka zmiennych, aby zdefiniować konfigurację maszyny wirtualnej. Poniżej przedstawiono zmienne, które należy ustawić, wraz z niektórymi wartościami domyślnymi, których można użyć dla niektórych zmiennych:

Po zdefiniowaniu zmiennych możesz utworzyć maszynę wirtualną, uruchamiając polecenie interfejsu wiersza polecenia platformy Azure. Aby udostępnić bardziej szczegółowe dane wyjściowe na potrzeby rozwiązywania problemów, dodaj flagę --debug na końcu.

Użyj następującego zestawu poleceń i zastąp przykładowe wartości preferowanymi wartościami. Możesz również użyć wartości domyślnych dla niektórych zmiennych, jak pokazano w poniższym przykładzie:

# Azure parameters
RESOURCE_GROUP="myResourceGroup"
SUBSCRIPTION="<Azure subscription ID>"
CUSTOM_LOCATION="/subscriptions/<subscription_id>/resourceGroups/<managed_resource_group>/providers/microsoft.extendedlocation/customlocations/<custom-location-name>"
LOCATION="$(az group show --name $RESOURCE_GROUP --query location --subscription $SUBSCRIPTION -o tsv)"

# VM parameters
VM_NAME="myNexusVirtualMachine"

# VM credentials
ADMIN_USERNAME="azureuser"
SSH_PUBLIC_KEY="$(cat ~/.ssh/id_rsa.pub)"

# Network parameters
CSN_ARM_ID="/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.NetworkCloud/cloudServicesNetworks/<csn-name>"
L3_NETWORK_ID="/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.NetworkCloud/l3Networks/<l3Network-name>"
NETWORK_INTERFACE_NAME="mgmt0"

# VM Size parameters
CPU_CORES=4
MEMORY_SIZE=12
VM_DISK_SIZE="64"

# Virtual Machine Image parameters
VM_IMAGE="<VM image, example: myacr.azurecr.io/ubuntu:20.04>"
ACR_URL="<Azure Container Registry URL, example: myacr.azurecr.io>"
ACR_USERNAME="<Azure Container Registry username>"
ACR_PASSWORD="<Azure Container Registry password>"

Po zdefiniowaniu tych zmiennych możesz utworzyć maszynę wirtualną, wykonując następujące polecenie interfejsu wiersza polecenia platformy Azure.

az networkcloud virtualmachine create \
    --name "$VM_NAME" \
    --resource-group "$RESOURCE_GROUP" \
    --subscription "$SUBSCRIPTION" \
    --extended-location name="$CUSTOM_LOCATION" type="CustomLocation" \
    --location "$LOCATION" \
    --admin-username "$ADMIN_USERNAME" \
    --csn "attached-network-id=$CSN_ARM_ID" \
    --cpu-cores $CPU_CORES \
    --memory-size $MEMORY_SIZE \
    --network-attachments '[{"attachedNetworkId":"'$L3_NETWORK_ID'","ipAllocationMethod":"Dynamic","defaultGateway":"True","networkAttachmentName":"'$NETWORK_INTERFACE_NAME'"}]'\
    --storage-profile create-option="Ephemeral" delete-option="Delete" disk-size="$VM_DISK_SIZE" \
    --vm-image "$VM_IMAGE" \
    --ssh-key-values "$SSH_PUBLIC_KEY" \
    --vm-image-repository-credentials registry-url="$ACR_URL" username="$ACR_USERNAME" password="$ACR_PASSWORD"

Maszyny wirtualne z tożsamościami zarządzanymi

Utwórz maszynę wirtualną przy użyciu przypisanej przez system lub przypisanej przez użytkownika tożsamości zarządzanej. Aby dodać tożsamość zarządzaną do maszyny wirtualnej, wersja interfejsu API musi być 2025-07-01-preview lub nowsza.

Upewnij się, że networkcloud rozszerzenie jest zainstalowane z wersją, która obsługuje wymaganą wersję interfejsu API. Obsługiwane wersje można znaleźć w historii wersji rozszerzenia w witrynienetworkcloud GitHub.

Aby włączyć tożsamość zarządzaną przypisaną przez system dla maszyny wirtualnej, pamiętaj o dołączeniu --mi-system-assigned flagi (lub aliasu --system-assigned).

Utwórz maszynę wirtualną z tożsamością zarządzaną przypisaną przez system (SAMI) za pomocą Azure CLI.

az networkcloud virtualmachine create \
    --name "$VM_NAME" \
    --resource-group "$RESOURCE_GROUP" \
    --subscription "$SUBSCRIPTION" \
    --extended-location name="$CUSTOM_LOCATION" type="CustomLocation" \
    --location "$LOCATION" \
    --admin-username "$ADMIN_USERNAME" \
    --csn "attached-network-id=$CSN_ARM_ID" \
    --cpu-cores $CPU_CORES \
    --memory-size $MEMORY_SIZE \
    --network-attachments '[{"attachedNetworkId":"'$L3_NETWORK_ID'","ipAllocationMethod":"Dynamic","defaultGateway":"True","networkAttachmentName":"'$NETWORK_INTERFACE_NAME'"}]'\
    --storage-profile create-option="Ephemeral" delete-option="Delete" disk-size="$VM_DISK_SIZE" \
    --vm-image "$VM_IMAGE" \
    --ssh-key-values "$SSH_PUBLIC_KEY" \
    --vm-image-repository-credentials registry-url="$ACR_URL" username="$ACR_USERNAME" password="$ACR_PASSWORD" \
    --mi-system-assigned

Aby użyć tożsamości zarządzanej przypisanej przez użytkownika, można określić identyfikator tożsamości zarządzanej przypisanej przez użytkownika z flagą --mi-user-assigned (lub aliasem --user-assigned).

Pamiętaj, aby uwzględnić zmienną UAMI_ID z identyfikatorem zasobu tożsamości zarządzanej przypisanej przez użytkownika, której chcesz użyć.

export UAMI_ID=$(az identity show --name "$UAMI_NAME" --resource-group "$RESOURCE_GROUP" --query "id" -o tsv)

Utwórz maszynę wirtualną przy użyciu tożsamości zarządzanej przypisanej do użytkownika (UAMI) za pomocą interfejsu wiersza poleceń Azure CLI.

az networkcloud virtualmachine create \
    --name "$VM_NAME" \
    --resource-group "$RESOURCE_GROUP" \
    --subscription "$SUBSCRIPTION" \
    --extended-location name="$CUSTOM_LOCATION" type="CustomLocation" \
    --location "$LOCATION" \
    --admin-username "$ADMIN_USERNAME" \
    --csn "attached-network-id=$CSN_ARM_ID" \
    --cpu-cores $CPU_CORES \
    --memory-size $MEMORY_SIZE \
    --network-attachments '[{"attachedNetworkId":"'$L3_NETWORK_ID'","ipAllocationMethod":"Dynamic","defaultGateway":"True","networkAttachmentName":"'$NETWORK_INTERFACE_NAME'"}]'\
    --storage-profile create-option="Ephemeral" delete-option="Delete" disk-size="$VM_DISK_SIZE" \
    --vm-image "$VM_IMAGE" \
    --ssh-key-values "$SSH_PUBLIC_KEY" \
    --vm-image-repository-credentials registry-url="$ACR_URL" username="$ACR_USERNAME" password="$ACR_PASSWORD" \
    --mi-user-assigned "$UAMI_ID"

Po kilku minutach polecenie się wykonuje i podaje informacje o maszynie wirtualnej. Maszyna wirtualna jest teraz gotowa do użycia.

Przeglądanie wdrożonych zasobów

Po zakończeniu wdrażania możesz wyświetlić zasoby przy użyciu interfejsu wiersza polecenia lub witryny Azure Portal.

Aby wyświetlić szczegóły klastra myNexusVirtualMachine w myResourceGroup grupie zasobów, wykonaj następujące czynności

az networkcloud virtualmachine show --name myNexusVirtualMachine --resource-group myResourceGroup

Uprzątnij zasoby

Gdy grupa zasobów nie będzie już potrzebna, usuń grupę zasobów. Grupa zasobów i wszystkie zasoby w grupie zasobów zostaną usunięte.

az group delete --name myResourceGroup --yes --no-wait

Dalsze kroki

Maszyna wirtualna Nexus została pomyślnie utworzona! Teraz możesz użyć maszyny wirtualnej do hostowania funkcji sieci wirtualnej (VNFs).