Partilhar via

Visão geral do comando de implantação da ponte de recursos do Azure Arc

  • Artigo

A CLI do Azure é necessária para implantar a ponte de recursos do Azure Arc. Ao implantar a ponte de recursos do Arc com um produto de parceiro correspondente, os comandos da CLI do Azure podem ser combinados em um script de automação, juntamente com comandos adicionais específicos do provedor.

Para saber mais sobre como instalar a ponte de recursos Arc com um produto parceiro correspondente, consulte:

Este artigo fornece uma visão geral dos comandos da CLI do Azure que são usados para gerenciar a implantação da ponte de recursos do Arc, na ordem em que normalmente são usados para implantação.

az arcappliance createconfig

Este comando cria os arquivos de configuração usados pela ponte de recursos Arc. As credenciais fornecidas durante createconfigo , como as credenciais do vCenter para VMware vSphere, são armazenadas em um arquivo de configuração e localmente na ponte de recursos do Arc. Essas credenciais devem ser uma conta de usuário separada usada apenas pela ponte de recursos Arc, com permissão para exibir, criar, excluir e gerenciar recursos locais. Se as credenciais forem alteradas, as credenciais na ponte de recursos deverão ser atualizadas.

O createconfig comando apresenta dois modos: interativo e não interativo. O modo interativo fornece prompts úteis que explicam o parâmetro e o que passar. Para iniciar o modo interativo, passe apenas os três parâmetros necessários. O modo não interativo permite que você passe todos os parâmetros necessários para criar os arquivos de configuração sem ser solicitado, o que economiza tempo e é útil para scripts de automação.

Três arquivos de configuração são gerados: resource.yaml, appliance.yaml e infra.yaml. Esses arquivos devem ser mantidos e armazenados em um local seguro, pois são necessários para a manutenção da ponte de recursos Arc.

Este comando também chama o validate comando para verificar os arquivos de configuração.

Nota

O Azure Stack HCI usa comandos diferentes para criar os arquivos de configuração da ponte de recursos Arc.

az arcappliance validate

O validate comando verifica os arquivos de configuração em busca de um esquema válido, validações na nuvem e no núcleo (como conectividade da máquina de gerenciamento com URLs necessárias), configurações de rede e configurações de proxy. Ele também executa testes em privilégios de identidade e atribuições de função, configuração de rede, configuração de balanceador de carga e conectividade de rede de entrega de conteúdo.

az arcappliance prepare

Este comando baixa as imagens do sistema operacional da Microsoft que são usadas para implantar a VM do dispositivo local. Depois de baixadas, as imagens são carregadas na galeria de imagens da nuvem local para se preparar para a criação da VM do dispositivo.

Este comando geralmente leva de 10 a 30 minutos para ser concluído, dependendo da velocidade da rede. Permita que o comando seja concluído antes de continuar com a implantação.

az arcappliance deploy

O deploy comando implanta uma instância local do Arc resource bridge como uma VM de dispositivo, inicializada para ser um cluster de gerenciamento do Kubernetes. Esse comando coloca todos os pods e agentes necessários dentro do cluster Kubernetes em um estado de execução. Quando a VM do dispositivo estiver ativada, o arquivo kubeconfig será gerado.

az arcappliance create

Este comando cria a ponte de recursos Arc no Azure como um recurso ARM e, em seguida, estabelece a conexão entre o recurso ARM e a VM do dispositivo local.

Assim que o create comando iniciar a conexão, ele retornará no terminal, mesmo que a conexão entre o recurso ARM e a VM do dispositivo local ainda não esteja concluída. A ponte de recursos precisa de cerca de cinco minutos para estabelecer a conexão entre o recurso ARM e a VM local.

az arcappliance show

O show comando obtém o status da ponte de recursos Arc e informações de recursos ARM. Ele pode ser usado para verificar o progresso da conexão entre o recurso ARM e a VM do dispositivo local.

Enquanto a ponte de recursos Arc está conectando o recurso ARM à VM local, a ponte de recursos progride pelos seguintes estágios:

ProvisioningState pode ser Creating, Created, Failed, Deleting, ou Succeeded.

Statustransições entre WaitingForHeartbeat -Validating> ->Connecting ->Connected -.>Running

  • WaitingForHeartbeat: O Azure está aguardando para receber um sinal da VM do dispositivo.
  • Validating: A VM do dispositivo está verificando os serviços do Azure quanto à conectividade e à capacidade de manutenção.
  • Connecting: A VM do dispositivo está sincronizando recursos locais com o Azure.
  • Connected: A VM do dispositivo concluiu a sincronização de recursos locais com o Azure.
  • Running: A VM do dispositivo e o Azure concluíram a sincronização híbrida e a ponte de recursos do Arc agora está operacional.

A criação bem-sucedida da ponte de recursos Arc resulta em ProvisioningState = Succeeded e Status = Running.

az arcappliance delete

Este comando exclui a VM do dispositivo e os recursos do Azure. Ele não limpa a imagem do sistema operacional, que permanece na galeria de nuvem local.

Se uma implantação falhar, execute este comando para limpar o ambiente antes de tentar implantar novamente.

Próximos passos