Guia de início rápido: criar uma máquina virtual do Azure Operator Nexus usando a CLI do Azure

Artigo
11/09/2024

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

Este guia de início rápido foi projetado para ajudá-lo a começar a usar máquinas virtuais Nexus para hospedar funções de rede virtual (VNFs). Seguindo as etapas descritas neste guia, você pode criar rápida e facilmente uma máquina virtual Nexus personalizada que atenda às suas necessidades e requisitos específicos. Se você é um iniciante ou um especialista em redes Nexus, este guia está aqui para ajudar. Você aprende tudo o que precisa saber para criar e personalizar máquinas virtuais Nexus para hospedar funções de rede virtual.

Antes de começar

Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.

Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, consulte Guia de início rápido para Bash no Azure Cloud Shell.
Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.
- Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de entrada, consulte Entrar com a CLI do Azure.
- Quando solicitado, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.
- Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.

Instale a versão mais recente das extensões necessárias da CLI do Azure.
Este artigo requer a versão 2.49.0 ou posterior da CLI do Azure. Se estiver usando o Azure Cloud Shell, a versão mais recente já está instalada.
Se você tiver várias assinaturas do Azure, selecione a ID de assinatura apropriada na qual os recursos devem ser cobrados usando o az account comando.
Antes de prosseguir com a criação da máquina virtual, verifique se a imagem do contêiner a ser usada é criada de acordo com as instruções.
Crie um grupo de recursos usando o az group create comando. 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ê será solicitado a especificar um local. Esse local é o local de armazenamento dos metadados do grupo de recursos e onde os recursos são executados no Azure se você não especificar outra região durante a criação do recurso. O exemplo seguinte cria um grupo de recursos com o nome myResourceGroup na localização 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 implementar um ficheiro Bicep ou modelo do ARM, precisa de acesso de escrita nos recursos que está a implementar e acesso a todas as operações no tipo de recurso Microsoft.Resources/deployments. Por exemplo, para implantar um cluster, você precisa das permissões Microsoft.NetworkCloud/virtualMachines/write e Microsoft.Resources/deployments/*. Para obter uma lista de funções e permissões, veja Funções incorporadas do Azure.
Você precisa da custom location ID do recurso do cluster do Azure Operator Nexus.
Você precisa criar várias redes de acordo com seus requisitos específicos de carga de trabalho, e é essencial ter os endereços IP apropriados disponíveis para suas cargas de trabalho. Para garantir uma implementação sem problemas, é aconselhável consultar as equipas de apoio relevantes para obter assistência.

Conclua os pré-requisitos para implantar 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 várias variáveis para definir a configuração para sua máquina virtual. Aqui estão as variáveis que você precisa definir, juntamente com alguns valores padrão que você pode usar para determinadas variáveis:

Variável	Description
LOCALIZAÇÃO	A região do Azure onde você deseja criar sua máquina virtual.
RESOURCE_GROUP	O nome do grupo de recursos do Azure onde você deseja criar a máquina virtual.
SUBSCRIÇÃO	A ID da sua assinatura do Azure.
CUSTOM_LOCATION	Esse argumento especifica um local personalizado da instância do Nexus.
CSN_ARM_ID	O ARM ID da rede de serviços de nuvem à qual a máquina virtual será conectada.
L3_NETWORK_ID	O ARM ID da rede L3 à qual a máquina virtual será conectada.
NETWORK_INTERFACE_NAME	O nome da interface de rede L3 a ser atribuída.
ADMIN_USERNAME	O nome de usuário para o administrador da máquina virtual.
SSH_PUBLIC_KEY	A chave pública SSH que é 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áx. 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 (em 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 para o Registro de Contêiner do Azure.
ACR_PASSWORD	A senha para o 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 --debug sinalizador no final para fornecer uma saída mais detalhada para fins de solução de problemas.

Para definir essas variáveis, use os seguintes comandos set e substitua os valores de exemplo pelos seus valores preferidos. 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 parâmetros CUSTOM_LOCATION, CSN_ARM_ID, L3_NETWORK_ID e ACR por 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 conclui e retorna informações sobre a máquina virtual. Você criou a máquina virtual. Agora você está pronto para usá-los.

Rever os recursos implementados

Após a conclusão da implantação, você pode exibir os recursos usando a CLI ou o portal do Azure.

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

CLI do Azure

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

Clean up resources (Limpar recursos)

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

CLI do Azure

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óximos passos

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

Partilhar via