Action Center: Instalação do Azure PaaS

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

Importante: Todos os passos nos procedimentos de instalação listados abaixo são obrigatórios.

Antes de começar

Certifique-se de que você tenha as seguintes ferramentas instaladas na sua máquina:

• Snap-in de implantação da Web do PowerShell
• Módulo do PowerShell AzureAZ versão 7.0 ou superior.

Instalação de Nó Único

Criando o Serviço de Aplicativo do Azure para o Action Center

1. Navegue até seu Portal do Azure e pesquise pelos Serviços de Aplicativo.
2. Crie um novo serviço de aplicativo e dê a ele um nome adequado, por exemplo UiPathActionCenter.
   Observação: na lista suspensa Pilha de Runtime, selecione .NET Core 3.1.
3. Abra o aplicativo web criado anteriormente e navegue até Configuração > Configurações gerais a partir do menu esquerdo e defina o campo Plataforma como 64 bits.

Criando a entidade de serviço do Azure para o Action Center

1. No portal do Azure, pesquise por Registros de aplicativos e criar um novo, com um nome adequado.

   Importante: Você precisa atribuir a função Contributor ao registro do aplicativo. Veja aqui como fazer isso.

2. Na página de Visão geral, copie o ID do aplicativo (cliente) e salve-o para usar mais tarde. Esse é seu ID da entidade de serviço do Azure.

   
   

   

   
   

3. Na página Clientes e segredos do registro de aplicativo criado anteriormente, gere um novo segredo de cliente. Copie seu Valor e salve-o para usar mais tarde. Essa é sua senha da entidade de serviço do Azure.

   
   

   

   
   
   Observação: Opcionalmente, você pode solicitar que sua equipe de DevOps amigável forneça a você um ID e senha de entidade de serviço do Azure que possam acessar o serviço de aplicativo e seu grupo de recursos associado.

Instalando o Action Center no Azure

1. Faça o download do arquivo UiPathActionCenter.zip para sua máquina local. Ele contém todos os scripts de instalação necessários.
   Observação: A UiPath fornece o arquivo UiPathActionCenter.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.
3. Execute o script Publish-ActionCenter-Azure.ps1 no PowerShell, usando estes parâmetros de instalação.

   Confira este exemplo de script.

4. Aproveite o uso do Action Center no seu Portal do Azure.

Instalação de vários nós

A instalação de vários nós é semelhante à i nstalação de nó único, com um passo adicional entre os passos 6 e 7 do procedimento para um nó único.

Portanto, após o passo 6, você precisa executar as seguintes ações:

• Abra o serviço de aplicativo recém-criado.
• Acesse a guia Expandir (plano de Serviço de Aplicativo) no menu à esquerda.
• Selecione a opção Escalonar para uma contagem de instâncias específica.
• Forneça a Contagem de instâncias desejada.

Continue com o passo 7 do procedimento de nó único daqui para frente.

Importante:

Após migrar ou atualizar para o Orchestrator 2022.4PaaS, vá para a Configuração do Serviço de Aplicativo do Azure e certifique-se de que as seguintes chaves estejam presentes na lista e que o valor delas esteja configurado para true:

• IdentityServer.OAuth.Enabled
• IdentityServer.S2SIntegration.Enabled

Parâmetros do script de instalação do PowerShell

Observação:

Se você quiser usar um domínio personalizado para seu serviço de aplicativo do Action Center, defina o domínio personalizado primeiro e use este nome de domínio nos parâmetros do script.

Por exemplo, se seu domínio personalizado for https://actioncenter.xyz.com, use o mesmo valor para o parâmetro actionCenterUrl do script.

Parâmetro	Description
orchestratorUrl	Obrigatório. O URL da instância do Orchestrator.
identityServerUrl	Obrigatório. A URL da instância do Identity Server.
actionCenterUrl	Obrigatório. A URL da instância do ActionCenter.
identityInstallationAccessToken	Obrigatório. O token de acesso a partir do Portal de Gerenciamento de Identidades. Consulte Configurações de autenticação do host para obter detalhes.
azureSubscriptionId	Obrigatório. O ID de assinatura do Azure para o Serviço de Aplicativo que hospeda o Action Center. Observação: Encontre-o na página de Visão geral do serviço de aplicativo, no seu Portal do Azure.
azureAccountTenantId	Obrigatório. O ID de tenant do Azure. Observação: Encontre-o na página Visão geral do registro do aplicativo, no seu Portal do Azure.
azureAccountApplicationId	Obrigatório. A ID principal do serviço do Azure. Observação: É aquela que você copiou e salvou no passo 5 do procedimento de Instalação de Nó Único .
azureAccountPassword	Obrigatório. A senha da entidade de serviço do Azure. Observação: É aquela que você copiou e salvou no passo 6 do procedimento de Instalação de Nó Único .
package	Obrigatório. Indique o caminho completo ou o caminho relativo do arquivamento UiPath.ActionCenter.Web.zip. Observação: Encontre-o no arquivamento UiPath.Actioncenter.zip.
resourceGroupName	Obrigatório. O nome do grupo de recursos do Azure que contém o serviço de aplicativo do Action Center.
appServiceName	Obrigatório. O nome do serviço de aplicativo do Azure no Action Center.
stopApplicationBeforePublish	Opcional. Se presente, ele interrompe a aplicação antes da implantação e reinicia após a conclusão da implantação.
unattended	Opcional. Se presente, a implantação continua sem qualquer confirmação do usuário.

Exemplo de script do PowerShell

.\Publish-ActionCenter-Azure.ps1 `
    -orchestratorUrl "https://<OrchestratorServiceURL>" `
    -identityServerUrl "https://<IdentityServerURL>/identity" `
    -actionCenterUrl "https://<ActionCenterServiceURL>" `
    -identityInstallationAccessToken "abcdefgh ... MAxJeysh6IQFSabcd" `
    -azureSubscriptionId "d12f123e-12ac-1da1-1234-ed1234d5cf4b" `
    -azureAccountTenantId "d1234d2a-b123-1d12-1234-902c51f12345" `
    -azureAccountApplicationId "12345678-67e1-123d-1234-1c6cd123b123" `
    -azureAccountPassword "O.T5pX4bX89I3~Wi.clbM_u0-R5Aa-sRl~" `
    -package "E:\)\)Work\)\)UiPathActionCenter\)\)UiPath.ActionCenter.Web.zip" `
    -stopApplicationBeforePublish `
    -resourceGroupName "<ResourceGroupName" `
    -appServiceName "<ActionCenterServiceName>" `
    -unattended

Solicitações de Buckets de Armazenamento

Recursos do Action Center que usam os buckets de armazenamento no Orchestrator, como a renderização de imagens e PDF em ações de Formulário, Classificação de Documentos e ações de Validação de Documentos exigem a configuração do Orchestrator a seguir:

Para aceitar solicitações do Action Center para o Orchestrator:

• Abra o aplicativo web do Orchestrator no seu Portal do Azure.
• Navegue até Configuração e selecione Configurações do Aplicativo.

• Adicione uma Nova configuração de aplicativo e insira o seguinte:

  • Nome - AcceptedRootUrls
  • Valor - https://localhost:6234,https://<ActionCenterServiceURL>
    Importante: Certifique-se de que o valor inserido no campo Valor não possua espaços vazios nele.
    Observação: Substitua <ActionCenterServiceURL> pela URL correspondente do seu Serviço do Action Center.

    

Para permitir OPTIONS no arquivo web.config do aplicativo web do Orchestrator:

• Abra o aplicativo web do Orchestrator no seu Portal do Azure.
• Navegue até o Editor do Serviço de Aplicativo (Visualização).
• Edite o arquivo web.config:
  • Navegue até a seção <requestFiltering> <verbs>.
  • Anexe <add verb="OPTIONS" allowed="true" /> no final da seção.
    Observação: Atualizando o Orchestrator redefine o arquivo web.config, fazendo com que você precise permitir o verbo OPTIONS novamente.

    Para provedores de armazenamento de terceiros, consulte mais detalhes sobre a Configuração de CORS/CSP.

Atualização

Para atualizar o Azure PaaS Action Center, você precisa instalar uma versão nova, superior, que substitua a atual.

Desinstalando

Para remover o Action Center do seu Portal do Azure, exclua os seguintes recursos do Azure:

• Serviço de aplicativo do Action Center
• Registro de aplicativo do Action Center