Instalação do Serviço de Aplicativo do Azure

Visão geral

O script de instalação do Azure permite que você instale o Orchestrator em um ou vários nós.

Importante:

1. Todas as etapas são obrigatórias nos procedimentos de instalação listados abaixo. O Orchestrator não funciona sem instalar o Identity Server.

2. Antes de iniciar a instalação do Orchestrator, certifique-se de que seus certificados sejam emitidos por uma autoridade de certificação de confiança da Azure, como DigiCert.

3. O Azure Stack não é compatível, pois podem ocorrer incompatibilidades de API. Use o Azure Cloud para sua implantação.

Instalação de Nó Único

Para instalar o Orchestrator em um Serviço de Aplicativo do Azure, execute as seguintes etapas:

Etapas do Orchestrator

1. No Portal do Azure, em Serviços de Aplicativo, crie um novo serviço do aplicativo com um nome personalizado, como UiPathOrchestrator. Ao criar o aplicativo da Web, certifique-se de selecionar a pilha .NET Core 3.1. Para obter mais informações, consulte a documentação oficial da Microsoft.
2. Abra o aplicativo da Web recém-criado no Portal do Azure e, na guia Configuração, selecione Configurações Gerais e faça as seguintes alterações de configuração:
   • Defina a Plataforma como 64 bits.
   • Defina Web Sockets como Ativados.
3. Defina a string de conexão do banco de dados em Configuração > Strings de Conexão do aplicativo Web, com o nome Default. Por exemplo, Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True.
   Importante:

   • O usuário SQL do Azure fornecido aqui deve ter acesso no nível do servidor, o acesso no nível do banco de dados não é suficiente para uma instalação bem-sucedida.
   • Certifique-se de definir o atributo TrustServerCertificate na string de conexão do banco de dados como True.
   • Para definir uma string de conexão de banco de dados para o módulo Test Automation, siga as etapas descritas para o parâmetro -testAutomationFeatureEnabled em Parâmetros Publish-Orchestrator.ps1.
4. Crie um aplicativo e uma entidade de serviço do Azure AD que possam acessar seu Serviço de Aplicativo e Grupo de Recursos do Orchestrator. Opcionalmente, peça que sua simpática equipe do DevOps forneça a você uma ID e Senha de Entidade de Serviço do Azure que possam acessar o Serviço do Aplicativo e Grupo de Recursos associado.

Etapas do Identity Server

1. No Portal do Azure, em Serviços de Aplicativo, crie um novo serviço do aplicativo com um nome personalizado, como UiPathIdentity. Ao criar o aplicativo da Web, certifique-se de selecionar a pilha .NET Core 3.1. Para obter mais informações, consulte a documentação oficial da Microsoft.
2. Defina a string de conexão do banco de dados em Configuração > Strings de Conexão do aplicativo Web, com o nome DefaultConnection. Por exemplo, Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True.
   Importante: certifique-se de definir o atributo TrustServerCertificate na string de conexão do banco de dados como True.
3. Navegue até a aba Configurações > Configuração > Configurações Gerais e selecione 64 bits para a Plataforma.
4. Crie um aplicativo e uma entidade de serviço do Azure AD que possam acessar seu Serviço de Aplicativo e Grupo de Recursos do Identity. Opcionalmente, peça que sua simpática equipe do DevOps forneça a você uma ID e Senha de Entidade de Serviço do Azure que possam acessar o Serviço do Aplicativo e Grupo de Recursos associado.

Etapas Gerais

1. Faça o download do arquivo UiPathOrchestrator.zip para sua máquina local. Isso contém todos os scripts necessários para instalar o Orchestrator, Identity Server e o Serviço Webhooks. A UiPath fornece o arquivo UiPathOrchestrator.zip mediante solicitação. Fale conosco para obter mais detalhes.
2. Extraia o conteúdo do arquivo zip para uma pasta na sua máquina.
   Observação: as etapas a seguir requerem a execução dos scripts do PowerShell.Para desabilitar qualquer solicitação que interrompa essas tarefas, execute o comando Get-ChildItem *.ps1 -Recurse | Unblock-File no diretório selecionado na Etapa 10.
3. Execute o script Publish-Orchestrator.ps1 no PowerShell, usando os parâmetros descritos aqui.
   Importante:

   • Antes de executar o script Publish-Orchestrator.ps1, certifique-se de desinstalar o módulo do AzureRM PowerShell. Recomendamos usar o módulo Az PowerShell como alternativa. Não há suporte para instalar os módulos AzureRM e Az ao mesmo tempo.
   • Se a versão desejada do Az não for detectada e o AzureRM estiver presente ao executar o script, você receberá a solicitação para confirmar a remoção do AzureRM, mesmo em instalações não assistidas.
   • A atualização para o Az v6.0.0 quando alguma versão anterior do módulo estiver em uso faz com que a seguinte mensagem apareça: WARNING: The version 'x.x.x' of module 'Az.<Name>' is currently in use. Retry the operation after closing the applications. Para resolver esse problema, execute Publish-Orchestrator.ps1 em uma nova sessão do PowerShell.
   • Se você estiver usando agentes hospedados da Microsoft, um problema Publish-Orchestrator.ps1 impede que você execute a versão correta do Az. Em vez de usar a versão 5.4.0 ou 6.0.0, você está preso à 4.7.0. Como solução alternativa, certifique-se de excluir a pasta C:\Modules\az_4.7.0.
4. Execute o script Publish-IdentityServer.ps1 no PowerShell, usando os parâmetros descritos aqui.
   Importante: certifique-se de concluir o processo executando as etapas descritas na página Publicar no Identity Server.
5. Execute o script MigrateTo-IdentityServer.ps1 no PowerShell, usando os parâmetros descritos aqui.
6. Instale o Serviço do Webhooks.
7. Inicie os serviços de aplicativo do Orchestrator e do Identity. Aproveite o uso do Orchestrator no seu Portal Azure.

Instalação de vários nós

Observação: instalações de vários nós exigem a configuração do High Availability Add-on.

Para instalar o Orchestrator em vários nós em um Serviço de Aplicativo do Azure, execute as seguintes etapas:

Etapas do Orchestrator

1. No Portal do Azure, em Serviços de Aplicativo, crie um novo serviço do aplicativo com um nome personalizado, como UiPathOrchestrator. Ao criar o aplicativo da Web, certifique-se de selecionar a pilha .NET Core 3.1. Para obter mais informações, consulte a documentação oficial da Microsoft.
2. Abra o aplicativo da Web recém-criado no Portal do Azure e, na guia Configuração, selecione Configurações Gerais e faça as seguintes alterações de configuração:
   • Defina a Plataforma como 64 bits.
   • Defina Web Sockets como Ativados.
3. Defina a string de conexão do banco de dados em Configuração > Strings de Conexão do aplicativo Web, com o nome "Default". Por exemplo, Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True.
   Importante:

   • O usuário SQL do Azure fornecido aqui deve ter acesso no nível do servidor, o acesso no nível do banco de dados não é suficiente para uma instalação bem-sucedida.
   • Certifique-se de definir o atributo TrustServerCertificate na string de conexão do banco de dados como True.
4. Crie um aplicativo e uma entidade de serviço do Azure AD que possam acessar seu Serviço de Aplicativo e Grupo de Recursos do Orchestrator. Opcionalmente, peça que sua simpática equipe do DevOps forneça a você uma ID e Senha de Entidade de Serviço do Azure que possam acessar o Serviço do Aplicativo e Grupo de Recursos associado.
5. Na guia Expandir (plano de Serviço do Aplicativo) selecione a opção Expandir para uma quantidade de instâncias específica e forneça a quantidade de instâncias desejada.

Etapas do Identity Server

1. No Portal do Azure, em Serviços de Aplicativo, crie um novo serviço do aplicativo com um nome personalizado, como UiPathIdentity. Ao criar o aplicativo da Web, certifique-se de selecionar a pilha .NET Core 3.1. Para obter mais informações, consulte a documentação oficial da Microsoft.
2. Defina a string de conexão do banco de dados em Configuração > Strings de Conexão do aplicativo Web, com o nome DefaultConnection. Por exemplo, Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True.
   Importante: certifique-se de definir o atributo TrustServerCertificate na string de conexão do banco de dados como True.
3. Navegue até a aba Configurações > Configuração > Configurações Gerais e selecione 64 bits para a Plataforma.
4. Crie um aplicativo e uma entidade de serviço do Azure AD que possam acessar seu Serviço de Aplicativo e Grupo de Recursos do Identity. Opcionalmente, peça que sua simpática equipe do DevOps forneça a você uma ID e Senha de Entidade de Serviço do Azure que possam acessar o Serviço do Aplicativo e Grupo de Recursos associado.

Etapas Gerais

1. Faça o download do arquivo UiPathOrchestrator.zip para sua máquina local. Isso contém todos os scripts necessários para instalar o Orchestrator, Identity Server e o Serviço Webhooks. A UiPath fornece o arquivo UiPathOrchestrator.zip mediante solicitação. Fale conosco para obter mais detalhes.
2. Extraia o conteúdo do arquivo zip para uma pasta na sua máquina.
   Observação: as etapas a seguir requerem a execução dos scripts do PowerShell.Para desabilitar qualquer solicitação que interrompa essas tarefas, execute o comando Get-ChildItem *.ps1 -Recurse | Unblock-File no diretório selecionado na Etapa 11.
3. Execute o script Publish-Orchestrator.ps1 no PowerShell, usando os parâmetros descritos aqui.
   Importante:

   • Antes de executar o script Publish-Orchestrator.ps1, certifique-se de desinstalar o módulo do AzureRM PowerShell. Recomendamos usar o módulo Az PowerShell como alternativa. Não há suporte para instalar os módulos AzureRM e Az ao mesmo tempo.
   • Se a versão desejada do Az não for detectada e o AzureRM estiver presente ao executar o script, você receberá a solicitação para confirmar a remoção do AzureRM, mesmo em instalações não assistidas.
   • A atualização para o Az v6.0.0 quando alguma versão anterior do módulo estiver em uso faz com que a seguinte mensagem apareça: WARNING: The version 'x.x.x' of module 'Az.<Name>' is currently in use. Retry the operation after closing the applications. Para resolver esse problema, execute Publish-Orchestrator.ps1 em uma nova sessão do PowerShell.
   • Se você estiver usando agentes hospedados da Microsoft, um problema Publish-Orchestrator.ps1 impede que você execute a versão correta do Az. Em vez de usar a versão 5.4.0 ou 6.0.0, você está preso à 4.7.0. Como solução alternativa, certifique-se de excluir a pasta C:\Modules\az_4.7.0.
4. Execute o script Publish-IdentityServer.ps1 no PowerShell, usando os parâmetros descritos aqui.
   Importante: certifique-se de concluir o processo executando as etapas descritas na página Publicar no Identity Server.
5. Execute o script MigrateTo-IdentityServer.ps1 no PowerShell, usando os parâmetros descritos aqui.
6. Instale o Serviço do Webhooks.
7. Inicie os serviços de aplicativo do Orchestrator e do Identity. Aproveite o uso do Orchestrator no seu Portal Azure.