Compartilhar via

Conectar computadores híbridos ao Azure usando um script de implantação

Você pode habilitar servidores habilitados para Azure Arc para um ou mais computadores Windows ou Linux em seu ambiente executando um conjunto de etapas manualmente. Ou você pode usar um método automatizado executando um script de modelo que fornecemos. Esse script automatiza o download e a instalação de ambos os agentes.

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

Conexão automática para SQL Server

Quando você conecta um servidor Windows ou Linux ao Azure Arc que também tem o Microsoft SQL Server instalado, as instâncias do SQL Server também são conectadas automaticamente ao Azure Arc. O SQL Server habilitado pelo Azure Arc fornece um inventário detalhado e recursos de gerenciamento adicionais para suas instâncias e bancos de dados do SQL Server. Como parte do processo de conexão, uma extensão é implantada no servidor habilitado para Azure Arc e novas funções são aplicadas ao SQL Server e aos bancos de dados. Se você não quiser conectar automaticamente os seus SQL Servers ao Azure Arc, é possível recusar a adição de uma marca ao servidor Windows ou Linux com o nome ArcSQLServerExtensionDeployment e o valor Disabled ao conectá-lo ao Azure Arc.

Para obter mais informações, confira Gerenciar conexão automática para o SQL Server habilitado pelo Azure Arc.

Pré-requisitos

  • Esse método exige que você tenha permissões de administrador no computador para instalar e configurar o agente. No Linux, use a conta raiz e, no Windows, você deve ser membro do grupo Administradores Locais.

  • Antes de começar, examine os pré-requisitos do agente do Connected Machine e verifique se sua assinatura e recursos atendem aos requisitos. Para obter informações sobre as regiões com suporte e outras considerações relacionadas, confira Regiões com suporte do Azure.

Note

Siga as práticas de segurança recomendadas e evite usar uma conta do Azure com acesso de proprietário a servidores integrados. Em vez disso, use uma conta que tenha apenas a atribuição de função Azure Connected Machine Onboarding ou Azure Connected Machine Resource Administrator. Para saber mais, confira as práticas recomendadas de segurança de controle de acesso e gerenciamento de identidade do Azure.

Gerar o script de instalação no portal do Azure

Use o portal do Azure para criar um script que automatiza o download e a instalação do agente e estabelece a conexão com o Azure Arc. Para concluir esse processo, execute estas etapas:

  1. Na parte superior do portal do Azure, pesquise e selecione o Azure Arc.
  2. No menu de serviço, expanda Infraestrutura e selecione Computadores.
  3. Selecione Integrar/Criar e, em seguida, selecione Integrar computadores existentes.
  4. Na página Noções básicas , forneça o seguinte:
    1. Selecione a Assinatura e o Grupo de recursos dos computadores.
    2. Em Região, selecione a região do Azure para armazenar os metadados dos servidores.
    3. Em Sistema operacional, selecione o sistema operacional no qual o script está configurado para execução.
    4. Em método de conectividade:
      1. Selecione o ponto de extremidade público ou o ponto de extremidade privado. Se você selecionar o ponto de extremidade privado, poderá selecionar um escopo de link privado existente ou criar um novo.
      2. Se você quiser usar uma URL do servidor Proxy, insira o endereço IP do servidor proxy ou o nome e o número da porta que o computador usa no formato http://<proxyURL>:<proxyport>.
      3. Se você selecionou Public endpoint e deseja usar o Gateway do Azure Arc, selecione um recurso de Gateway existente ou crie um novo.
    5. Em Autenticação, selecione Autenticar computadores manualmente e selecione Avançar.
  5. Em Marcas, examine as marcas de localização física padrão sugeridas e insira um valor ou especifique uma ou mais marcas personalizadas para dar suporte aos seus padrões.
  6. Selecione Próximo.
  7. Em Baixar e executar o script, examine as informações de resumo. Se você precisar fazer alterações, selecione Anterior e faça as edições necessárias.
  8. Selecione Baixar e, em seguida, selecione Fechar.

Para o Windows, é solicitado que você salve OnboardingScript.ps1e para o Linux OnboardingScript.sh em seu computador.

Instalar o agente no Windows

Instale o agente do Connected Machine manualmente executando o pacote AzureConnectedMachineAgent.msi do Windows Installer. Você pode baixar a versão mais recente do Pacote do Windows Installer do agente do Windows no Centro de Download da Microsoft.

Note

  • Para instalar ou desinstalar o agente, você precisa ter permissões de Administrador.
  • Primeiro, você deve baixar e copiar o pacote do instalador para uma pasta no servidor de destino ou em uma pasta de rede compartilhada. Se você executar o pacote do instalador sem nenhuma opção, ele iniciará um assistente de instalação que você pode seguir para instalar o agente interativamente.

Se o computador precisar se comunicar por meio de um servidor proxy para o serviço, depois de instalar o agente, você precisará executar um comando descrito nas etapas a seguir. Ele define a variável de ambiente https_proxy do sistema do servidor proxy. Quando essa configuração é usada, o agente se comunica por meio do servidor proxy usando o protocolo HTTP.

Se você não estiver familiarizado com as opções de linha de comando para pacotes do Windows Installer, examine as opções de linha de comando padrão msiexec e as opções de linha de comando msiexec.

Por exemplo, execute o programa de instalação com o parâmetro /? para revisar a opção de ajuda e referência rápida.

msiexec.exe /i AzureConnectedMachineAgent.msi /?

  1. Para instalar o agente silenciosamente e criar um arquivo de log de instalação na C:\Support\Logs pasta, execute o comando a seguir.

    msiexec.exe /i AzureConnectedMachineAgent.msi /qn /l*v "C:\Support\Logs\Azcmagentsetup.log"

    Se o agente não for iniciado após a conclusão da instalação, verifique os logs para obter informações de erro detalhadas. O diretório de log é %ProgramData%\AzureConnectedMachineAgent\log.

  2. Se o computador precisar se comunicar por meio de um servidor proxy, defina a variável de ambiente do servidor proxy executando o comando a seguir. Substitua {proxy-url} pelo endereço do servidor proxy (por exemplo proxy.example.com) e {proxy-port} pelo número da porta (por exemplo, 8080).

    [Environment]::SetEnvironmentVariable("https_proxy", "http://{proxy-url}:{proxy-port}", "Machine")
$env:https_proxy = [System.Environment]::GetEnvironmentVariable("https_proxy","Machine")
# For the changes to take effect, the agent service needs to be restarted after the proxy environment variable is set.
Restart-Service -Name HIMDS

    Note

    O agente não dá suporte à configuração de autenticação de proxy.

    Para obter mais informações, confira Configuração de proxy específica do agente.

  3. Depois de instalar o agente, configure-o para se comunicar com o serviço do Azure Arc.

    Parâmetros

    • --resource-group (cadeia de caracteres, exemplo: myResourceGroup)
    • --tenant-id (cadeia de caracteres, exemplo: aaaabbbb-0000-cccc-1111-dddd2222eeee)
    • --subscription-id (cadeia de caracteres, exemplo: aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e)
    • --location (cadeia de caracteres, exemplo: eastus)
    • --cloud (cadeia de caracteres, exemplo: AzureCloud)
    • --proxy (cadeia de caracteres, exemplo: http://proxy.example.com:8080)
    & "$env:ProgramFiles\AzureConnectedMachineAgent\azcmagent.exe" connect `
  --resource-group "myResourceGroup" `
  --tenant-id "aaaabbbb-0000-cccc-1111-dddd2222eeee" `
  --location "eastus" `
  --subscription-id "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"

Instalar o agente no Linux

O agente do Computador Conectado para Linux é fornecido no formato de pacote preferencial para a distribuição (.RPM ou .DEB) hospedada no repositório de pacotes da Microsoft. O pacote de script do shell Install_linux_azcmagent.sh executa as seguintes ações:

  • Configura o computador host para baixar o pacote do agente em packages.microsoft.com.
  • Instala o pacote do provedor de recursos híbrido.

Opcionalmente, você pode configurar o agente com as suas informações de proxy, incluindo o parâmetro --proxy "{proxy-url}:{proxy-port}". Quando essa configuração é usada, o agente se comunica por meio do servidor proxy usando o protocolo HTTP.

O script também contém a lógica para identificar as distribuições com e sem suporte e verifica as permissões necessárias para executar a instalação.

  1. Para baixar e instalar o agente, execute os seguintes comandos:

    # Download the installation package.
wget https://aka.ms/azcmagent -O ~/Install_linux_azcmagent.sh

# Install the Azure Connected Machine agent.
bash ~/Install_linux_azcmagent.sh

    Se o computador precisar se comunicar por meio de um servidor proxy para se conectar à Internet, inclua o --proxy parâmetro, por exemplo:

    # Download the installation package.
wget https://aka.ms/azcmagent -O ~/Install_linux_azcmagent.sh

# Install the Azure Connected Machine agent.
bash ~/Install_linux_azcmagent.sh --proxy "proxy.contoso.com:8080"

  2. Depois de instalar o agente, configure-o para se comunicar com o serviço do Azure Arc:

    Parâmetros

    • --resource-group (cadeia de caracteres, exemplo: myResourceGroup)
    • --tenant-id (cadeia de caracteres, exemplo: aaaabbbb-0000-cccc-1111-dddd2222eeee)
    • --subscription-id (cadeia de caracteres, exemplo: aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e)
    • --location (cadeia de caracteres, exemplo: eastus)
    • --cloud (cadeia de caracteres, exemplo: AzureCloud)
    • --proxy (cadeia de caracteres, exemplo: http://proxy.example.com:8080)
    azcmagent connect \
  --resource-group "myResourceGroup" \
  --tenant-id "aaaabbbb-0000-cccc-1111-dddd2222eeee" \
  --location "eastus" \
  --subscription-id "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e" \
  --cloud "AzureCloud"

Verificar a conexão com o Azure Arc

Depois de instalar o agente e configurá-lo para se conectar aos servidores habilitados para Azure Arc, acesse o portal do Azure para verificar se o servidor se conectou com êxito.

Captura de tela mostrando uma conexão de computador bem-sucedida no portal do Azure.

Próximas etapas

  • Last updated on