Compartilhar via

Início Rápido: Criar uma máquina virtual do Azure Operator Nexus usando a CLI do Azure

  • Artigo
  • Implantar uma máquina virtual do Nexus do Azure usando a CLI do Azure

Este guia de início rápido foi criado para ajudar você a começar a usar as máquinas virtuais Nexus para hospedar VNFs (funções de rede virtual). Ao seguir as etapas descritas neste guia, você poderá criar de forma rápida e fácil uma máquina virtual Nexus personalizada que atenda às suas necessidades e requisitos específicos. Seja você um iniciante ou um especialista em redes Nexus, este guia está aqui para ajudar. Você aprenderá tudo o que precisa saber para criar e personalizar máquinas virtuais Nexus para hospedar funções de rede virtual.

Antes de começar

Caso você não tenha uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.

  • Instale a última versão das extensões da CLI do Azure necessárias.

  • Este artigo requer a versão 2.49.0 ou posterior da CLI do Azure. Se você está usando o Azure Cloud Shell, a versão mais recente já está instalada.

  • Se tiver várias assinaturas do Azure, selecione a ID da assinatura adequada para cobrança dos recursos usando o comando az account.

  • Antes de prosseguir com a criação da máquina virtual, verifique se a imagem do contêiner a ser usada foi criada de acordo com as instruções.

  • Crie um grupo de recursos usando o comando az group create. Um grupo de recursos do Azure é um grupo lógico no qual os recursos do Azure são implantados e gerenciados. Ao criar um grupo de recursos, você é solicitado a especificar um local. Essa é a localização na qual os metadados do grupo de recursos são armazenados e na qual os recursos são executados no Azure, caso você não especifique outra região durante a criação de recursos. O exemplo a seguir cria um grupo de recursos chamado myResourceGroup no local eastus.

    az group create --name myResourceGroup --location eastus

    O exemplo de saída a seguir é semelhante à criação bem-sucedida do grupo de recursos:

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

  • Para implantar um arquivo Bicep ou um modelo do ARM, você precisa de acesso de gravação nos recursos que está implantando e acesso a todas as operações no tipo de recurso Microsoft.Resources/implantações. Por exemplo, para implantar um cluster, você precisa das permissões Microsoft.NetworkCloud/virtualMachines/write e Microsoft.Resources/deployments/*. Para ver uma lista de funções e permissões, consulte Funções interna do Azure.

  • Você precisa da ID do recurso custom location do cluster do Nexus do Operador do Azure.

  • Você precisa criar várias redes de acordo com os requisitos específicos de sua carga de trabalho, e é essencial ter os endereços IP apropriados disponíveis para suas cargas de trabalho. Para garantir uma implementação tranquila, recomenda-se consultar as equipes de suporte relevantes para obter assistência.

  • Conclua os pré-requisitos para a implantação de uma máquina virtual Nexus.

Criar uma máquina virtual Nexus

O exemplo a seguir cria uma máquina virtual chamada myNexusVirtualMachine no grupo de recursos myResourceGroup no local eastus.

Antes de executar os comandos, você precisa definir diversas variáveis para definir a configuração da máquina virtual. Aqui estão as variáveis que precisam ser definidas, juntamente com alguns valores padrão que você pode usar para determinadas variáveis:

Variável Descrição
LOCALIZAÇÃO A região do Azure em que deseja criar a máquina virtual.
RESOURCE_GROUP O nome do grupo de recursos do Azure em que deseja criar a máquina virtual.
ASSINATURA A ID da sua assinatura do Azure.
CUSTOM_LOCATION Este argumento especifica um local personalizado da instância Nexus.
CSN_ARM_ID A ID do ARM da rede de serviços de nuvem à qual a máquina virtual será conectada.
L3_NETWORK_ID A ID do ARM da rede L3 à qual a máquina virtual será conectada.
NETWORK_INTERFACE_NAME O nome do adaptador de rede L3 a ser atribuído.
ADMIN_USERNAME O nome de usuário do administrador da máquina virtual.
SSH_PUBLIC_KEY A chave pública SSH usada para comunicação segura com a máquina virtual.
CPU_CORES O número de núcleos de CPU para a máquina virtual (número par, máximo de 46 vCPUs)
MEMORY_SIZE A quantidade de memória (em GiB, máximo de 224 GiB) para a máquina virtual.
VM_DISK_SIZE O tamanho (no GiB) do disco da máquina virtual.
VM_IMAGE A URL da imagem da máquina virtual.
ACR_URL A URL do Registro de Contêiner do Azure.
ACR_USERNAME O nome de usuário do Registro de Contêiner do Azure.
ACR_PASSWORD A senha do Registro de Contêiner do Azure.

Depois de definir essas variáveis, você pode executar o comando da CLI do Azure para criar a máquina virtual. Adicione o sinalizador --debug no final para fornecer uma saída mais detalhada para fins de solução de problemas.

Para definir essas variáveis, use os comandos set a seguir e substitua os valores de exemplo pelos valores de sua preferência. Você também pode usar os valores padrão para algumas das variáveis, conforme mostrado no exemplo a seguir:

# 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>"

Importante

É essencial que você substitua os espaços reservados para os parâmetros CUSTOM_LOCATION, CSN_ARM_ID, L3_NETWORK_ID e ACR pelos seus valores reais antes de executar esses comandos.

Depois de definir essas variáveis, você pode criar a máquina virtual executando o seguinte comando da CLI do 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"

Após alguns minutos, o comando será concluído e retornará informações sobre a máquina virtual. Você criou a máquina virtual. Agora você está pronto para usá-las.

Examinar os recursos implantados

Depois que a implantação for concluída, você poderá exibir os recursos usando a CLI ou o portal do Azure.

Para exibir os detalhes do cluster myNexusVirtualMachine no grupo de recursos myResourceGroup, execute o seguinte

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

Limpar os recursos

Quando não for mais necessário, exclua o grupo de recursos. O grupo de recursos e todos os recursos no grupo de recursos são excluídos.

Use o comando az group delete para remover o grupo de recursos, a máquina virtual e todos os recursos relacionados, exceto os recursos de rede do Operator Nexus.

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

Próximas etapas

Você criou com êxito uma máquina virtual Nexus. Agora você pode usar a máquina virtual para hospedar VNFs (funções de rede virtual).