Compartilhar 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 a instalação da ponte de recursos do Arc com um produto de parceiro correspondente, confira:

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 do Arc. As credenciais fornecidas durante createconfig, como as credenciais do vCenter para vMware vSphere, são armazenadas em um arquivo de configuração e localmente dentro da ponte de recursos do Arc. Essas credenciais devem ser uma conta de usuário separada usada apenas pela ponte de recursos do 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 comando createconfig 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. Isso 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 do Arc.

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

Observação

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

az arcappliance validate

O comando validate verifica os arquivos de configuração para obter um esquema válido, validações de nuvem e núcleo (como conectividade do computador 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 distribuição de conteúdo.

az arcappliance prepare

Esse 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 de nuvem local para estarem disponíveis para a criação da VM do dispositivo.

Esse 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 comando deploy implanta uma instância local da ponte de recursos do Arc como uma VM do dispositivo, inicializada para ser um cluster de gerenciamento do Kubernetes. Esse comando obtém todos os pods e agentes necessários dentro do cluster do Kubernetes em um estado de execução. Depois que a VM do dispositivo estiver habilitada, o arquivo kubeconfig será gerado.

az arcappliance create

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

Depois que o comando create 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 do ARM e a VM local.

az arcappliance show

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

Enquanto a ponte de recursos do Arc estiver conectando o recurso do ARM à VM local, a ponte de recursos avançará pelos estágios abaixo:

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

Status transiçõ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 serviço.
  • Connecting: a VM do dispositivo está sincronizando recursos locais com o Azure.
  • Connected: A VM do dispositivo concluiu a sincronização dos 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 do 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.

Caso haja falha na implantação, você deve executar esse comando para limpar o ambiente antes de tentar implantar novamente.

Próximas etapas