Alterando a versão da solução

Faça o upgrade ou o downgrade de uma implantação da solução para uma versão diferente do pacote no Automation Cloud.

Dica:

Antes de atualizar uma implantação de produção, a UiPath recomenda primeiro validar a atualização em uma implantação de teste dedicada. Para obter detalhes, consulte Validar atualizações de solução em um ambiente de teste.

The Change version action lets you upgrade a deployment to a newer package version or downgrade it to an older one. A downgrade is not a rollback: in the Deployments tab, it shows as Change version.

Fazer o downgrade de uma solução não exclui entidades, conjuntos de escolhas e webhooks.

Abra o fluxo de trabalho Alterar versão

1. No Orchestrator, selecione Soluções no nível do tenant.

2. Na guia Implantações , encontre a implantação que você deseja atualizar.

   Dica:

   Quando uma versão de pacote mais recente está disponível para uma implantação, a coluna Versão mostra um indicador de atualização ao lado do número da versão atual. Você também pode selecionar Atualizar diretamente da linha para iniciar o fluxo.

3. Selecione o menu de três pontos (⋮) no final da linha e, em seguida, escolha Alterar versão.

   O fluxo de trabalho Alterar versão é aberto no formulário Configuração .

Preencha o formulário de Configuração

O formulário de Configuração é preenchido previamente com os detalhes da implantação atual. Revise e atualize o seguinte:

Campo	Description
Versão	The target package version. Defaults to the latest published version (or the most recent version other than the one currently installed). The list does not include the installed version. Select a different version from the dropdown to upgrade or downgrade to a specific version.
Área de negócios	Opcional. Pré-preenchido com as áreas de negócios atuais da implantação. Edite a seleção para atualizá-las como parte desta alteração de versão. Encontrado em Opções, que é recolhida por padrão.
Responsável pelos negócios	Opcional. Pré-preenchido com o proprietário do negócio atual da implantação. Altere-o para reatribuir a responsabilidade como parte dessa alteração de versão. Encontrado em Opções.

The breadcrumb reads Tenant > Solutions > Deployments > Deploy. The What will happen panel shows the following steps: Setup, Configure, Deactivate solution (disabling triggers and stopping active processes), Deploy, and Activate.

Select Deploy to proceed, or select the dropdown arrow and choose Customize ("Deploy package, then fine-tune settings") to open the resource explorer and review component changes before running the operation.

Revisar alterações de componente

Quando você seleciona Personalizar, o explorador de recursos mostra um resumo do que será alterado:

• Componentes recém-adicionados, marcados com um ícone de mais verde (+) e um chip Adicionados . Esses componentes serão criados no ambiente de destino após a alteração da versão.

  Se a versão de destino adicionar um componente com o mesmo nome daquele que essa alteração de versão remove, o conflito de nome não bloqueará mais a operação: o nome ficará disponível assim que a remoção for confirmada. O conflito ainda bloqueará a alteração de versão se o recurso com esse nome não estiver sendo removido.

• Componentes removidos, marcados com um ícone de menos (–). Esses componentes serão removidos do ambiente de destino, a menos que sejam referenciados por outras soluções. Nesse caso, os componentes permanecem no ambiente, mas são removidos da solução.

  A remoção de uma fila ou bucket de armazenamento será bloqueada se algo fora dessa alteração de versão ainda depender dele: uma fila não pode ser removida enquanto um gatilho que persiste à alteração de versão ainda a utiliza, e um bucket não pode ser removido enquanto uma fila, catálogo de tarefas ou o processo que permanece à alteração de versão ainda o usa como destino de retenção. Remova o componente dependente na mesma alteração de versão para prosseguir.

  Se a remoção de uma fila ou bucket de armazenamento excluir sua última referência (ela não é compartilhada com nenhuma outra pasta), você deve confirmar a exclusão antes que a alteração da versão possa ser executada. Consulte Confirmar a exclusão de recursos substituídos abaixo.

• Edited components, marked with an amber warning-triangle icon and a Modified chip. The details area shows two columns: Existing deployment values (For reference) and New deployment values.

  Components with changes only to configurable properties are not marked as edited. Edited components retain their existing configuration values for configurable properties by default. To switch to the package configuration, use the Source of configuration values dropdown. The options are Existing deployment (Recommended) and Defaults of this package version.

Optionally edit any configurable component properties, then select Continue to run the operation. For connection components, the authentication type property is presented as radio cards, each showing the option's title and description, instead of a dropdown.

Vincular, alterar ou desvincular um recurso

Quando o explorador de recursos está aberto, você pode vincular um componente a um recurso existente, alterar a qual recurso ele está vinculado ou desvinculá-lo, antes que a alteração da versão seja executada. Desvincular remove a conexão entre a solução e o componente externo; no momento da atualização, o recurso é criado novamente dentro da pasta da solução em vez de reutilizar o componente vinculado.

Isso também se aplica a um recurso que uma versão anterior instalou automaticamente: o controle de link não aparece mais bloqueado para eles, e você pode vinculá-los da mesma forma que qualquer outro recurso desvinculado. A vinculação de um recurso instalado é compatível com os seguintes tipos de recursos:

• Processo
• Ativo
• Armazenar bucket
• Fila
• Webhook
• Conexão
• Índice

Os componentes vinculados são marcados com um selo Vinculado no explorador de recursos. Selecionar um componente vinculado mostra um cartão com as informações do recurso vinculado, incluindo um chip do tenant se o recurso estiver no nível do tenant, em vez de em uma pasta.

Para vincular, alterar ou desvincular um recurso:

1. No explorador de recursos, selecione o componente.
2. Selecione um dos seguintes:
   • Vincule ao existente para vincular um componente desvinculado.
   • Altere para vincular um componente vinculado a um recurso diferente.
   • Desvincule para remover um link existente.

Observação:

Um recurso não pode ser vinculado à sua própria cópia instalada.

Para obter detalhes sobre o seletor Vincular ao existente , consulte Vincular, alterar ou desvincular um componente na Implantação de uma solução.

Resultado: após a desvinculação, o recurso será criado novamente dentro da pasta da solução no momento da atualização, a menos que você o vincule a um componente existente diferente antes de aplicar a alteração da versão. Depois que a alteração de versão for aplicada, o recurso não poderá mais ser vinculado.

Quando você vincula um recurso que uma versão anterior instalou automaticamente, a cópia instalada é desativada: ela é excluída permanentemente, juntamente com seus dados, assim que a alteração de versão é executada. Consulte Confirmar a exclusão de recursos substituídos abaixo.

Confirmar a exclusão de recursos substituídos

Vincular um recurso instalado a um existente ou remover uma fila ou bucket de armazenamento que não tem outra referência, exclui permanentemente o recurso substituído e seus dados. Antes que a alteração da versão possa ser executada, você deve confirmar essa perda.

Um alerta incorporado aparece acima dos botões de ação, listando os recursos afetados. Selecione Excluir e implantar para confirmar e continuar ou use Validar ou Salvar como rascunho para alterar a configuração. Se você alterar a configuração após a confirmação, o alerta reaparecerá para uma nova confirmação.

Se a alteração de versão for iniciada sem essa confirmação (por exemplo, por meio da API), a operação será rejeitada.

AVISO:

Os recursos excluídos não são recuperados por uma reversão posterior. Reverter recria o recurso do pacote da solução como um novo recurso instalado, sem seus dados anteriores.

Após a alteração da versão

Você pode monitorar o status da operação na guia Implantações . Para obter detalhes sobre todos os status, consulte Status de implantações.

Observação:

After a version change, the Activate step runs automatically and the deployment stays Active. If activation needs additional setup, the deployment status is Inactive (Needs setup to activate), and you must complete the setup and activate the deployment for the solution to become functional.

Result: The deployment is upgraded or downgraded to the selected version. The Deployments tab shows Change version · Successful in Last operation, and the Version column reflects the new version.