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 8 (LTS). 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.
   • Definir Estado de FTP para Todos permitidos.
3. Defina a string de conexão com o banco de dados em Configuração > Configurações do aplicativo > 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.
   • Certifique-se de selecionar SQL Azure como o tipo de string de conexão com banco de dados.
   • Para definir uma string de conexão do banco de dados para o módulo de Testar Automação, siga as etapas descritas para o parâmetro -testAutomationFeatureEnabled em Parâmetros Publish-Orchestrator.ps1.
   • Para definir uma string de conexão de banco de dados para o módulo Servidor de atualização, siga as etapas descritas para o -updateServerFeatureEnabled parâmetro em Parâmetros Publish-Orchestrator.ps1.
4. O mecanismo de autenticação do Azure PowerShell suportado por nossos scripts pode ser um dos dois a seguir:

• Por meio de sua própria identidade de usuário - use o parâmetro noAzureAuthentication ao fazer login com o Azure PowerShell.
• Por meio de uma entidade de serviço - 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 8 (LTS). 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é Configurações > Configuração > guia Configurações Gerais e faça as seguintes alterações de configuração:
   • Defina a Plataforma como 64 bits.
   • Definir Estado de FTP para Todos permitidos.
4. O mecanismo de autenticação do Azure PowerShell suportado por nossos scripts pode ser um dos dois a seguir:

• Por meio de sua própria identidade de usuário - use o parâmetro noAzureAuthentication ao fazer login com o Azure PowerShell.
• Por meio de uma entidade de serviço - 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 do Webhooks

1. Em seu Portal do Azure, crie um novo aplicativo da Web com um nome personalizado, como por exemplo: UiPathWebhookService.
2. No campo Publicar, selecione Código.
3. Para Runtime Stack, selecione . NET Core 8 (LTS).
4. Abra seu novo aplicativo web e navegue até Configurações > Configuração > Configurações Gerais e faça as seguintes alterações de configuração:
   • Defina a Plataforma como 64 bits.
   • Definir Estado de FTP para Todos permitidos.
5. Selecione Salvar.
   Importante:

   Se você não criou anteriormente um aplicativo e entidade de serviço do Azure AD a partir da instalação do Orchestrator no Azure, crie-os agora. Você deve configurá-los para poder acessar seu UiPathWebhookService e Grupo de Recursos.

Etapas do catálogo de recursos

1. No Portal do Azure, em Serviços de Aplicativo, crie um novo serviço do aplicativo com um nome personalizado, como UiPathResourceCatalogService. Ao criar o aplicativo da Web, certifique-se de selecionar a pilha .NET 8 (LTS). Para obter mais informações, consulte a documentação oficial da Microsoft.
2. Navegue até Configurações > Configuração > guia Configurações Gerais e faça as seguintes alterações de configuração:
   • Defina a Plataforma como 64 bits.
   • Definir Estado de FTP para Todos permitidos.
3. 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.
4. O mecanismo de autenticação do Azure PowerShell suportado por nossos scripts pode ser um dos dois a seguir:

• Por meio de sua própria identidade de usuário - use o parâmetro noAzureAuthentication ao fazer login com o Azure PowerShell.
• Por meio de uma entidade de serviço - 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 Catálogo de recursos.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, Catálogo Recursos 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 UiPathOrchestrator.zip para uma pasta na sua máquina. Isso revela o arquivo UiPath.Orchestrator.Web.zip.
   Observação:

   • As seguintes etapas exigem a execução dos scripts do PowerShell. Para desabilitar quaisquer solicitações que interrompam essas tarefas, execute o comando Get-ChildItem *.ps1 -Recurse | Unblock-File no diretório selecionado na etapa anterior.
   • Descompacte o arquivo UiPathOrchestrator.zip para extrair o arquivo UiPath.Orchestrator.Web.zip.
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.
   • Atualizar para Az v6.0.0 quando qualquer versão anterior do módulo está 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 este problema, certifique-se de executar 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. Execute o script Publish-ResourceCatalog.ps1 no PowerShell, usando os parâmetros descritos aqui.
7. Execute o script MigrateTo-ResourceCatalog.ps1 no PowerShell, usando os parâmetros descritos aqui.
8. Execute o script Publish-Webhooks.ps1 no PowerShell, usando os parâmetros descritos aqui.
9. Execute o script MigrateTo-Webhooks.ps1 no PowerShell, usando os parâmetros descritos aqui.
10. 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 .

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 8 (LTS). 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 com o banco de dados em Configuração > Configurações do aplicativo > Strings de conexão do aplicativo Web, com o nome "Padrão".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.
   • Certifique-se de selecionar SQL Azure como o tipo de string de conexão com banco de dados.
   • A configuração do Nlog não é preservada.
4. O mecanismo de autenticação do Azure PowerShell suportado por nossos scripts pode ser um dos dois a seguir:
   • Por meio de sua própria identidade de usuário - use o parâmetro noAzureAuthentication ao fazer login com o Azure PowerShell.
   • Por meio de uma entidade de serviço - 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 8 (LTS). 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. O mecanismo de autenticação do Azure PowerShell suportado por nossos scripts pode ser um dos dois a seguir:

• Por meio de sua própria identidade de usuário - use o parâmetro noAzureAuthentication ao fazer login com o Azure PowerShell.
• Por meio de uma entidade de serviço - 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 do Webhooks

1. Em seu Portal do Azure, crie um novo aplicativo da Web com um nome personalizado, como por exemplo: UiPathWebhookService.
2. No campo Publicar, selecione Código.
3. Para Runtime Stack, selecione . NET 8 (LTS).
4. Abra seu novo aplicativo da Web e navegue até Configurações > Definição.
5. Na guia Configurações Gerais, selecione 64 bits para a Plataforma.
6. Selecione Salvar.
   Importante:

   Se você não criou anteriormente um aplicativo e entidade de serviço do Azure AD a partir da instalação do Orchestrator no Azure, crie-os agora. Você deve configurá-los para poder acessar seu UiPathWebhookService e Grupo de Recursos.

Etapas do catálogo de recursos

1. No Portal do Azure, em Serviços de Aplicativo, crie um novo serviço do aplicativo com um nome personalizado, como UiPathResourceCatalogService. Ao criar o aplicativo da Web, certifique-se de selecionar a pilha .NET 8 (LTS). Para obter mais informações, consulte a documentação oficial da Microsoft.
2. Navegue até a aba Configurações > Configuração > Configurações Gerais e selecione 64 bits para a Plataforma.
3. 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.
4. O mecanismo de autenticação do Azure PowerShell suportado por nossos scripts pode ser um dos dois a seguir:

• Por meio de sua própria identidade de usuário - use o parâmetro noAzureAuthentication ao fazer login com o Azure PowerShell.
• Por meio de uma entidade de serviço - 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 Catálogo de recursos.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, Catálogo Recursos 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 seguintes etapas exigem a execução dos scripts do PowerShell. Para desabilitar quaisquer solicitações que interrompam essas tarefas, execute o comando Get-ChildItem *.ps1 -Recurse | Unblock-File no diretório selecionado na etapa anterior.

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.
   • Atualizar para Az v6.0.0 quando qualquer versão anterior do módulo está 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 este problema, certifique-se de executar 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. Execute o script Publish-ResourceCatalog.ps1 no PowerShell, usando os parâmetros descritos aqui.
7. Execute o script MigrateTo-ResourceCatalog.ps1 no PowerShell, usando os parâmetros descritos aqui.
8. Execute o script Publish-Webhooks.ps1 no PowerShell, usando os parâmetros descritos aqui.
9. Execute o script MigrateTo-Webhooks.ps1 no PowerShell, usando os parâmetros descritos aqui.
10. Inicie os serviços de aplicativo do Orchestrator e do Identity. Aproveite o uso do Orchestrator no seu Portal Azure.