Tutorial: reutilizar recursos existentes do Orchestrator ao implantar

Reutilize uma conexão, ativo ou fila existente do Orchestrator ao implantar uma solução a partir de um pipeline de CI/CD, em vez de provisionar um novo.

Quando você implanta uma Solução, cada recurso que ela declara — filas, ativos, processos, conexões — é provisionado novamente na pasta de implantação. Muitas vezes, você já tem um recurso compartilhado no ambiente de destino, como uma conexão com um sistema externo, e deseja que a implantação o reutilize em vez de criar um novo.

Na IU do Orchestrator, você faz isso escolhendo Personalizar ao implantar e vincular o recurso manualmente. Essa etapa manual não se traduz em um pipeline não assistido. O equivalente da CLI é buscar a configuração de implantação, vincular o recurso dentro desse arquivo e, em seguida, passar o arquivo para deploy run.

Observação:

config link vincula um recurso declarado a um existente. Para fazer com que cada recurso reutilize uma contraparte existente, consulte Reutilizar cada recurso abaixo.

Pré-requisitos

• Um pacote de solução publicado no tenant. Consulte Empacotar e publicar uma solução.
• Um Aplicativo Externo configurado para autenticação de credenciais de cliente, com estes escopos: AutomationSolutions, Solutions.Deployments, Solutions.Packages, OR.Folders, RCS.FolderAuthorization. Consulte Autenticação — Fluxo 2. OR.Folders e RCS.FolderAuthorization são necessários para que a CLI possa resolver e vincular recursos que residem nas pastas do Orchestrator.
• O Aplicativo Externo atribuído à pasta do Orchestrator que contém o recurso existente.

Etapas

1. Autentique com o aplicativo externo.

   uip login \
     --client-id env.UIPATH_CLIENT_ID \
     --client-secret env.UIPATH_CLIENT_SECRET \
     --tenant "$UIPATH_TENANT"
   

2. Baixe a configuração de implantação para o pacote.

   uip solution deploy config get "my-package" \
     --package-version 1.0.0 \
     -d ./deploy-config.json
   

3. Vincule o recurso da solução ao recurso do Orchestrator existente. Use o nome do recurso conforme ele aparece no arquivo de configuração e aponte --folder-path para a pasta em que o recurso existente está.

   uip solution deploy config link ./deploy-config.json "MyConnection" \
     --name "SharedCrmConnection" \
     --folder-path "Shared"
   

4. Implante o pacote com a configuração editada.

   uip solution deploy run \
     --name "my-deployment" \
     --package-name "my-package" \
     --package-version 1.0.0 \
     --folder-name "MySolution" \
     --parent-folder-path "Shared" \
     --config-file ./deploy-config.json
   

A implantação reutiliza o recurso vinculado e não cria um novo na pasta de implantação.

Observação:

Em config link, --folder-path é onde o recurso existente reside. Em deploy run, --parent-folder-path é onde a pasta de implantação é criada. Eles são sinalizadores separados em subcomandos separados.

Conexões: adiar seleção para o runtime

Para recursos de conexão, vincular uma conexão existente não é a única opção. Se você definir a authenticationType da conexão como ConfigurableByUsers na configuração da implantação, você pode deixar a conexão não associada e adiar sua seleção e autenticação para o tempo de execução — os usuários escolhem e autenticam a conexão quando a automação é executada. Essa também é uma configuração válida para ativação.

authenticationType aceita dois valores: ConfigurableByUsers (adiar ao usuário no runtime) e AuthenticateAfterDeployment (a conexão deve ser autenticada após a implantação). Com AuthenticateAfterDeployment, se a conexão não for autenticada até o momento em que a ativação será executada, a ativação será relatada como com falha.

Reutilizar todos os recursos

Quando você quiser que toda a implantação reutilize recursos existentes em vez de criar novos, defina a política de conflito em todos os recursos em uma chamada antes de implantar.

1. Defina a política de conflito em cada recurso no arquivo de configuração.

   uip solution deploy config set ./deploy-config.json --all conflictFixingAction UseExisting
   

2. Passe o mesmo arquivo para deploy run --config-file, conforme mostrado na etapa 4.

Veja também

• uip solution deploy — a referência para config get, config link, config set e deploy run.
• Gerenciar ativos e filas do Orchestrator — crie os recursos aos quais você vincula depois.
• Implantar no Orchestrator a partir do CI — autenticação, cache e anexação de versão para o pipeline no qual ele se encaixa.
• Autenticação — o fluxo do Aplicativo externo usado aqui.