Implantação de uma solução

Implante um pacote da solução em um tenant do Orchestrator no Automation Cloud.

Implantar uma solução significa instalar um pacote de solução como uma nova implantação em uma pasta do Orchestrator. Para obter mais informações sobre implantações de soluções, consulte Entendendo o ciclo de vida de desenvolvimento da solução.

Você pode iniciar uma implantação de solução a partir do Studio Web ou do Orchestrator. Ambas as superfícies geram a mesma experiência de implantação subjacente: o Studio Web é a superfície originária, projetada para autores de soluções que desejam empacotar e implantar em um único fluxo; O Orchestrator é a superfície administrativa, projetada para administradores de tenant que gerenciam implantações em escala. Essa página documenta o fluxo do Orchestrator.

O fluxo de implantação do Orchestrator requer um pacote de solução que já foi publicado em um feed. Você pode publicar um pacote do Studio Web ou Studio Desktop antes de implantar aqui.

Essa etapa é executada normalmente por um administrador.

Abra o fluxo de trabalho de implantação

Você pode abrir o fluxo de trabalho de implantação a partir de qualquer um dos seguintes locais no Orchestrator:

• Guia Implantações: selecione Implantar no canto superior direito.
• Guia Pacotes: selecione a ação de linha Implantar para o pacote que você deseja implantar.
• Barra lateral do pacote: abra um pacote para expandir sua barra lateral e, em seguida, selecione Implantar no canto superior direito da barra lateral.
• Aba Versões da barra lateral do pacote: selecione a ação Implantar linha para a versão específica do pacote que você deseja implantar.

Todos os quatro caminhos abrem o mesmo fluxo de trabalho de implantação no formulário Configuração . A trilha de navegação na parte superior lê Tenant > Soluções > Implantações > Implantar.

Preencha o formulário de Configuração

O formulário de Configuração é onde você define o que implantar, onde chega e como é ativado. Preencha os campos a seguir e, em seguida, selecione Implantar. Os campos Pacote e Versão são sempre visíveis; os campos restantes são agrupados no controle Opções , que você pode expandir ou recolher. Quando recolhida, Opções mostra um resumo dos valores atuais (por exemplo, a pasta de destino, se os gatilhos são habilitados imediatamente e se um runtime está configurado).

Campo	Description
Pacote	Selecione o pacote da solução a implantar no menu suspenso. A lista mostra todos os pacotes publicados em seu feed do tenant. Após selecionar um pacote, sua descrição aparece abaixo do campo.
Versão	A versão do pacote a ser instalado. É exibido após selecionar um pacote. O padrão é a versão mais recente publicada. A data de publicação e as notas de versão para a versão selecionada aparecem abaixo do campo. Selecione uma versão diferente no menu suspenso, se necessário.
Opções	Expande ou recolhe as configurações de implantação a seguir. Quando recolhida, mostra um resumo dos valores selecionados.
Nome da implantação	Um nome exclusivo do tenant necessário para esta implantação. Preenchido automaticamente a partir do nome do pacote. Edite para usar outro nome. O nome é validado conforme você digita: se uma implantação com o mesmo nome já existir, o formulário mostra um erro e você não poderá continuar até que o nome seja exclusivo.
Location	A pasta onde a pasta da solução será criada. O padrão é Compartilhado. Selecione uma pasta diferente no menu suspenso para alterar o destino.
Nome da pasta da solução	O nome da subpasta criada dentro da pasta de destino. Preenchido automaticamente para corresponder ao nome da implantação até que você o edite. Edite-o para personalizá-lo para esta implantação.
Ativar imediatamente	Alternar (ativado por padrão). Quando habilitado, os gatilhos são habilitados imediatamente, se houver.
Configurar runtime	Alternar (ativado por padrão). Quando habilitado, provisiona um runtime sem servidor quando nenhuma máquina de execução padrão está configurada no nível do tenant.

Execute a implantação

Após preencher o formulário de configuração, escolha uma das seguintes opções na parte inferior do formulário:

• Implantar: valida a configuração e executa a implantação imediatamente. O fluxo de trabalho progride pelas seguintes etapas, exibidas no painel O que acontecerá à esquerda:

  Etapa	Description
  Configurar	Valida e configura a implantação.
  Implantar	Define pastas e provisiona recursos.
  Ativar	Habilita gatilhos e valida a implantação se Ativar imediatamente estiver ativado.

• Personalizar (selecione a seta suspensa no botão Implantar ): abre o explorador de recursos para que você possa revisar e configurar componentes individuais da solução antes que a implantação seja executada. No explorador de recursos, você pode:

  • Filtre as propriedades exibidas para um componente usando o controle Exibir (Todas as propriedades, Propriedades vazias, Propriedades obrigatórias ou Propriedades configuráveis).
  • Vincule um componente a um recurso existente, altere o recurso ao qual ele está vinculado ou desvincule-o — consulte Vincular, alterar ou desvincular um componente abaixo.
  • Reverta as alterações em um componente usando Redefinir.
  • Revise o contador de Problemas (erros, avisos e informações) e o painel de Logs .

  Ao finalizar, selecione uma das seguintes opções:

  • Continue para prosseguir com a implantação.
  • Valide para verificar a configuração sem implantar.
  • Salve como rascunho para salvar e retomar mais tarde.
  • Cancel to discard your changes. A confirmation dialog explains what will be lost and offers the option to save as a draft instead of discarding.

Salvar uma implantação como rascunho

Se você não estiver pronto para executar uma implantação, poderá salvar seu progresso e finalizá-lo mais tarde:

1. Selecione Personalizar no menu suspenso do botão Implantar para abrir o explorador de recursos.
2. Configure os componentes conforme necessário.
3. Selecione Salvar como rascunho.

O rascunho aparece na guia Implantações com um chip de status Rascunho . Para retomar a edição, selecione a linha de rascunho e, em seguida, selecione Continuar editando. Para descartá-lo, selecione Excluir rascunho.

Vincular, alterar ou desvincular um componente (opcional)

Vincular um componente a um recurso existente evita a duplicação de conexões, ativos e filas entre implantações. Ao personalizar uma implantação de rascunho, você pode vincular um componente a um recurso existente, alterar o recurso ao qual ele está vinculado ou desvinculá-lo.

Observação:

Quando a implantação está localizada fora do seu espaço de trabalho pessoal (por exemplo, em uma pasta compartilhada), a lista de candidatos exclui recursos armazenados no seu espaço de trabalho pessoal em qualquer profundidade de pasta, incluindo subpastas aninhadas. Isso evita configurações de implantação quebradas que seus colaboradores não podem executar ou manter porque não podem acessar seus recursos do Espaço de Trabalho Pessoal.

Se a implantação estiver dentro do seu Espaço de Trabalho Pessoal, todos os seus recursos acessíveis, incluindo seus recursos do Espaço de Trabalho Pessoal, estarão disponíveis para vinculação.

Quando você seleciona Personalizar, o explorador de recursos mostra todos os componentes no pacote da solução. Se um componente com o mesmo nome já existir no tenant, você poderá vincular a solução a ele em vez de criar uma nova. Essa opção está disponível para Ativos, Buckets de armazenamento, Webhooks e Filas. Para cada conflito, você pode:

• Mantenha o componente existente e não crie um adicional.
• Mantenha o componente existente e adicione novos campos da solução (os campos existentes não são alterados).
• Renomeie o recurso que está em conflito no respectivo serviço.
• Renomeie o recurso na implantação da solução, se possível.

Os recursos que residem no nível do tenant, em vez de em uma pasta, são marcados com um ícone dedicado na árvore do explorador de recursos, e seu cabeçalho de detalhes do recurso mostra um chip Tenant .

Vincular um componente a um recurso existente

1. No explorador de recursos, selecione o componente que deseja vincular.

2. Selecione Vincular ao existente.

   No Link para o seletor existente , cada linha de recurso candidato mostra o ícone do tipo de recurso (ou a imagem do conector, para conexões), um rótulo do tipo amigável e o local da pasta do recurso. Os locais em seu Espaço de trabalho pessoal são rotulados Meu Espaço de trabalho.

3. Selecione o recurso ao qual você deseja vincular.

4. Selecione Link.

Observação:

• Quando um recurso é vinculado, ele não é criado como parte da implantação; a solução usa o recurso vinculado diretamente. Vincular um recurso com outro nome pode gerar erros de runtime, a menos que a solução tenha sido desenvolvida para aceitar essa configuração.
• Quando você vincula um recurso que existe em outra pasta, a solução armazena a dependência do runtime na pasta da solução na qual o recurso é copiado, não na pasta de origem original. Os usuários com permissões na pasta da solução podem executar o processo sem precisar de permissões no local do recurso original.

Entender um componente vinculado

Quando um componente é vinculado, o explorador de recursos mostra um cartão com as informações do recurso vinculado em vez de um conjunto de campos somente leitura.

Alterar ou desvincular um componente

Os componentes vinculados são marcados com um selo Vinculado no explorador de recursos.

1. No explorador de recursos, selecione o componente vinculado.
2. Selecione um dos seguintes:
   • Altere para vincular o componente a um recurso diferente, usando o mesmo seletor descrito acima.
   • Desvincule para remover o link.

Resultado: a desvinculação remove a conexão entre a solução e o recurso externo. O recurso será criado novamente dentro da pasta da solução em vez de reutilizar o vinculado.

Monitorar o status da implantação

Após o início da implantação, você pode monitorar o progresso a partir da visualização do fluxo de trabalho ou da guia Implantações em Soluções. Os seguintes status são possíveis:

Status	Description
Em progresso	A operação de implantação está em execução.
Bem-sucedido	A implantação foi concluída e todos os componentes foram instalados.
Com falha	A implantação falhou e uma reversão automática foi executada.
Falha em reverter	A implantação falhou e alguns componentes exigem limpeza manual.

Para obter detalhes sobre todos os status, consulte Status de implantações.

Ativar a implantação

Observação:

Se a solução contiver apps e eles não estiverem ativados usando o link fornecido, a ativação da implantação falhará. Consulte a documentação do Orchestrator e do Apps para obter instruções detalhadas.

Após uma implantação bem-sucedida, o Orchestrator avalia a prontidão de ativação. A implantação é exibida na guia Implantações com um dos seguintes status:

• Inativo (pronto para ativar): nenhuma configuração adicional é necessária. Selecione o ícone Mais ações e, em seguida, selecione Ativar implantação.

• Inativo (precisa de configuração para ativar): os pré-requisitos adicionais devem ser concluídos antes da ativação:

  1. Selecione o ícone Mais ações e escolha Configurar ativação.

  2. Revise os resultados da validação de ativação e conclua os itens necessários:

     • Adicione contas e atribua funções.
     • Adicione máquinas às pastas de soluções.
     • Defina mapeamentos de conta-máquina, se necessário.
     • Defina valores de ativos por robô, se aplicável.
     • Ative os aplicativos usados na solução.
     • Preencha as associações para componentes do tipo de processo, se aplicável.

     Os componentes vinculados não podem ser revinculados ou desvinculados durante a ativação. Se um componente estiver vinculado, a visualização de configuração mostra um aviso em vez de campos editáveis.

     Observação:

     Ao implantar uma solução, um modelo Serverless padrão pode ser anexado automaticamente à pasta de destino se a alternância Configurar runtime tiver sido habilitada no formulário Configuração. Isso garante que a solução possa ser executada sem configurar manualmente os modelos de máquina. Se um modelo sem servidor já estiver herdado, nenhum modelo adicional será anexado.

  3. Resolva os itens listados.

  4. Selecione Validar.

  5. Selecione Ativar.

Resultado: depois que sua solução for implantada e ativada com sucesso, essa solução será exibida na guia Implantações com um status Ativo.