Automatizar a instalação do runtime de integração autoalojado com scripts locais do PowerShell

  • Artigo

Para automatizar a instalação de Integration Runtime autoalojados em máquinas locais (para além das VMs do Azure, onde podemos tirar partido do modelo de Resource Manager), pode utilizar scripts locais do PowerShell. Este artigo apresenta dois scripts que pode utilizar.

Pré-requisitos

  • Inicie o PowerShell no seu computador local. Para executar os scripts, tem de escolher Executar como Administrador.
  • Transfira o software de runtime de integração autoalojado. Copie o caminho onde se encontra o ficheiro transferido.
  • Também precisa de uma chave de autenticação para registar o runtime de integração autoalojado.
  • Para automatizar atualizações manuais, tem de ter um runtime de integração autoalojado pré-configurado.

Introdução aos scripts

Nota

Estes scripts são criados com o utilitário de linha de comandos documentado no runtime de integração autoalojado. Se for necessário, pode personalizar estes scripts em conformidade para satisfazer as suas necessidades de automatização. Os scripts têm de ser aplicados por nó, por isso, certifique-se de que os executa em todos os nós em caso de configuração de elevada disponibilidade (2 ou mais nós).

  • Para automatizar a configuração: instale e registe um novo nó de runtime de integração autoalojado com InstallGatewayOnLocalMachine.ps1 – o script pode ser utilizado para instalar o nó de runtime de integração autoalojado e registá-lo com uma chave de autenticação. O script aceita dois argumentos, especificando primeiro a localização do runtime de integração autoalojado num disco local e, em segundo lugar , especificando a chave de autenticação (para registar o nó de IR autoalojado).

  • Para automatizar atualizações manuais: atualize o nó de IR autoalojado com uma versão específica ou para a versão mais recente script-update-gateway.ps1 – isto também é suportado caso tenha desativado a atualização automática ou pretenda ter mais controlo sobre as atualizações. O script pode ser utilizado para atualizar o nó de runtime de integração autoalojado para a versão mais recente ou para uma versão superior especificada (a versão anterior não funciona). Aceita um argumento para especificar o número da versão (exemplo: -versão 3.13.6942.1). Quando nenhuma versão é especificada, atualiza sempre o IR autoalojado para a versão mais recente encontrada nas transferências.

    Nota

    Só podem ser especificadas as últimas 3 versões. Idealmente, isto é utilizado para atualizar um nó existente para a versão mais recente. PRESSUPÕE QUE TEM UM IR AUTOALOJADO REGISTADO.

Exemplos de utilização

Para automatizar a configuração

  1. Transfira o IR autoalojado.

  2. Especifique o caminho onde se encontra o SHIR MSI (ficheiro de instalação) transferido acima. Por exemplo, se o caminho for C:\Users\username\Downloads\IntegrationRuntime_4.7.7368.1.msi, pode utilizar o seguinte exemplo de linha de comandos do PowerShell para esta tarefa:

    PS C:\windows\system32> C:\Users\username\Desktop\InstallGatewayOnLocalMachine.ps1 -path "C:\Users\username\Downloads\IntegrationRuntime_4.7.7368.1.msi" -authKey "[key]"

    Nota

    Substitua [chave] pela chave de autenticação para registar o IR. Substitua "nome de utilizador" pelo seu nome de utilizador. Especifique a localização do ficheiro "InstallGatewayOnLocalMachine.ps1" ao executar o script. Neste exemplo, armazenámo-lo no Ambiente de Trabalho.

  3. Se existir um IR autoalojado pré-instalado no seu computador, o script desinstala-o automaticamente e, em seguida, configura um novo. Verá a seguinte janela apresentada: configurar o runtime de integração

  4. Quando a instalação e o registo de chaves estiverem concluídos, verá Com êxito a instalação do gateway e Com êxito para registar os resultados do gateway no PowerShell local. resultado da execução do script 1

Para automatizar atualizações manuais

Este script é utilizado para atualizar/instalar + registar o runtime de integração autoalojado mais recente. A execução do script executa os seguintes passos:

  1. Verificar a versão atual do IR autoalojado
  2. Obter a versão mais recente ou a versão especificada a partir do argumento
  3. Se existir uma versão mais recente do que a versão atual:
    • transferir msi de IR autoalojado
    • atualizá-lo

Pode seguir o exemplo da linha de comandos abaixo para utilizar este script:

  • Transfira e instale o gateway mais recente:

    PS C:\windows\system32> C:\Users\username\Desktop\script-update-gateway.ps1

  • Transferir e instalar o gateway da versão especificada:

    PS C:\windows\system32> C:\Users\username\Desktop\script-update-gateway.ps1 -version 3.13.6942.1

    Se a sua versão atual já for a mais recente, verá o seguinte resultado, sugerindo que não é necessária nenhuma atualização. [script 2 run result](media/self-hosted-integration-runtime-automation-scripts/script-2-run-result.png)