Implantação de uma solução

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:

• Deployments tab: Select Deploy in the upper-right corner.
• Packages tab: Select the Deploy row action for the package you want to deploy.
• Package sidebar: Open a package to expand its sidebar, then select Deploy in the upper-right corner of the sidebar.
• Versions tab of the Package sidebar: Select the Deploy row action for the specific package version you want to deploy.

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

The Setup form is where you define what to deploy, where it lands, and how it activates. Complete the following fields, then select Deploy. The Package and Version fields are always visible; the remaining fields are grouped under the Options control, which you can expand or collapse. When collapsed, Options shows a summary of the current values (for example, the destination folder, whether triggers are enabled right away, and whether a runtime is set up).

Campo	Description
Pacote	Select the solution package to deploy from the dropdown. The list shows all packages published to your tenant feed. After you select a package, its description appears beneath the field.
Versão	The package version to install. Appears after you select a package. Defaults to the latest published version. The publish date and release notes for the selected version appear beneath the field. Select a different version from the dropdown if needed.
Opções	Expands or collapses the deployment settings that follow. When collapsed, it shows a summary of the selected values.
Nome da implantação	A required, tenant-unique name for this deployment. Auto-filled from the package name. Edit to use a different name. The name is validated as you type: if a deployment with the same name already exists, the form shows an error and you cannot continue until the name is unique.
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	The name of the subfolder created inside the destination folder. Auto-filled to match the deployment name until you edit it. Edit to customize it for this deployment.
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:

• Deploy: validates the configuration and runs the deployment immediately. The workflow progresses through the following steps shown in the What will happen panel on the left:

  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.

• Customize (select the dropdown arrow on the Deploy button): opens the resource explorer so you can review and configure individual solution components before the deployment runs. In the resource explorer, you can:

  • Filter the properties shown for a component using the Display control (All properties, Empty properties, Required properties, or Configurable properties).
  • Link a component to an existing resource using Link to existing.
  • Revert your changes to a component using Reset.
  • Review the Issues counter (errors, warnings, and information) and the Logs panel.

  When you finish, select one of the following:

  • Continue to proceed with the deployment.
  • Validate to check the configuration without deploying.
  • Save as draft to save and resume later.
  • Delete draft to discard the deployment.

Save a deployment as a draft

If you are not ready to run a deployment, you can save your progress and finish it later:

1. Select Customize from the Deploy button dropdown to open the resource explorer.
2. Configure components as needed.
3. Select Save as draft.

The draft appears in the Deployments tab with a Draft status chip. To resume it, select the draft row, then select Continue editing. To discard it, select Delete draft.

Reutilize componentes existentes (opcional)

Observação:

When the deployment is located outside your Personal Workspace (for example, in a shared folder), the candidate list excludes resources stored in your Personal Workspace at any folder depth, including nested subfolders. This prevents broken deployment configurations that your collaborators cannot run or maintain because they cannot access your Personal Workspace resources.

If the deployment is inside your Personal Workspace, all your accessible resources, including your Personal Workspace resources, are available for linking.

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.

Para vincular um componente existente:

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

2. Selecione Vincular ao existente.

   

3. Na caixa de diálogo Vincular ao processo existente , selecione o componente ao qual deseja vincular.

4. Selecione Link.

Observação:

• When a resource is linked, it is not created as part of the deployment; the solution uses the linked resource directly. Linking a resource with a different name may lead to runtime errors unless the solution was developed to support this configuration.
• When you link a resource that exists in another folder, the solution stores the runtime dependency against the solution folder where the resource is copied, not the original source folder. Users with permissions on the solution folder can run the process without needing permissions on the original resource location.

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.
     Observação:

     When deploying a solution, a Default Serverless template may be automatically attached to the target folder if the Set up runtime toggle was enabled on the Setup form. This ensures the solution can run without manually configuring machine templates. If a serverless template is already inherited, no additional template is attached.

  3. Resolva os itens listados.

  4. Selecione Validar.

  5. Selecione Ativar.

Result: Once your solution is deployed and successfully activated, that solution is displayed on the Deployments tab with an Active status.