Implantação e ativação de soluções

Depois de carregar um pacote de solução para Soluções, você pode implantá-lo em uma pasta de destino e ativá-lo para torná-lo operacional.

Fluxo de trabalho da implantação

A implantação de uma solução é um processo de duas etapas:

1. Implantar: crie uma configuração de implantação e associe o pacote a uma pasta de destino.
2. Ativar: torne a implantação ao vivo e operacional.

Essa separação permite que você prepare as implantações com antecedência e ative-as durante as janelas de manutenção ou após a aprovação manual.

Implantação de uma solução

O comando deploy cria uma implantação de um pacote de solução em um ambiente específico.

Sintaxe de comando

uipcli solution deploy <package-name> [options]

Parâmetros:

Parâmetro	Description	Required
<package-name>	Nome do pacote carregado	Sim
-v ou --version	Versão do pacote a ser implantada	Sim
-d ou --deploymentName	Nome para esta implantação	Sim
-f ou --deploymentFolderName	Nome da pasta de destino no Orchestrator	Sim
-U	URL do Orchestrator	Sim
-T	Nome do tenant	Sim
-A	Nome da Organização	Sim
-I	ID do aplicativo externo	Sim
-S	Segredo do aplicativo externo	Sim
--applicationScope	Escopos exigidos	Sim
--deploymentParentFolder	A pasta do Orchestrator onde a pasta de implantação será criada. Se não for especificado, a pasta de implantação será criada na pasta do tenant. Quando especificado, a implantação estará na respectiva pasta. Quando definido como "[e-mail] 's workspace", a implantação ocorrerá no espaço de trabalho pessoal do usuário especificado.	Não
--configPath	Caminho local para o arquivo de configuração da solução; necessário em cenários com associações de substituição	Não
--traceLevel	Nível de Registros de Log	Não

Importante:

Se uma implantação com o mesmo nome já existir em qualquer nível dentro do tenant no Orchestrator, essa operação atualiza a implantação existente em vez de criar uma nova. Se a implantação existente estiver no estado de Falha, a atualização não prosseguirá; resolva ou desinstale a implantação com falha antes de tentar novamente.

Importante:

Soluções implantadas ao nível de tenant não atribuem automaticamente um usuário à pasta resultante. Para atribuir uma conta, certifique-se de que a configuração apropriada esteja definida no Orchestrator (Tenant > Pastas).

Autenticação

Consulte Autenticação e escopos para escopos necessários e Configuração de aplicativos externos.

Exemplo

uipcli solution deploy MySolution \  -v 1.2.3 \  -d MySolution-Prod-v1.2.3 \  -f Production \  -U https://cloud.uipath.com/ \  -T DefaultTenant \  -A myorg \  -I 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \  -S **** \  --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \  --traceLevel Information

Convenções de nomenclatura de implantação

Escolha nomes de implantação significativos que incluam:

• Nome da solução
• Identificador do ambiente
• Versão ou data

Exemplos:

MySolution-Dev-v1.2.3MySolution-Test-2025-01-15MySolution-Prod-Release-1.2.3InvoiceProcessing-Production-v2.0.0

Isso facilita o rastreamento e o gerenciamento de implantações entre ambientes.

O que acontece durante a implantação

Quando você executar o comando de implantação:

1. O pacote é validado em Soluções.
2. Uma configuração de implantação é criada.
3. A implantação está associada à pasta de destino.
4. As associações específicas de ambiente são inicializadas.
5. A implantação está preparada, mas ainda não está ativa.

A solução não começa a executar processos até que você a ative.

Ativando uma implantação

O comando deploy-activate torna uma implantação ativa e operacional.

Sintaxe de comando

uipcli solution deploy-activate <deployment-name> [options]

Parâmetros:

Parâmetro	Description	Required
<deployment-name>	Nome da implantação a ser ativada	Sim
-U	URL do Orchestrator	Sim
-T	Nome do tenant	Sim
-A	Nome da Organização	Sim
-I	ID do aplicativo externo	Sim
-S	Segredo do aplicativo externo	Sim
--applicationScope	Escopos exigidos	Sim
--traceLevel	Nível de Registros de Log	Não

Autenticação

Consulte Autenticação e escopos para escopos necessários e Configuração de aplicativos externos.

Exemplo

uipcli solution deploy-activate MySolution-Prod-v1.2.3 \  -U https://cloud.uipath.com/ \  -T DefaultTenant \  -A myorg \  -I 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \  -S **** \  --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \  --traceLevel Information

O que acontece durante a ativação

Quando você ativa uma implantação:

1. A implantação se torna a versão ativa na pasta de destino.
2. Os gatilhos são ativados.
3. Qualquer implantação ativa anteriormente na mesma pasta será desativada.

Integração do pipeline de CI/CD

Conclua o fluxo de trabalho da implantação

steps:  # 1. Pack the Solution  - name: Pack Solution    run: |      uipcli solution pack ./MySolution \        --output ./packages \        --version "1.0.${{ github.run_number }}"  # 2. Upload to Solutions Management  - name: Upload Package    run: |      uipcli solution upload-package ./packages/MySolution.1.0.${{ github.run_number }}.zip \        -U ${{ secrets.ORCHESTRATOR_URL }} \        -T ${{ secrets.ORCHESTRATOR_TENANT }} \        -A ${{ secrets.ORG_NAME }} \        -I ${{ secrets.EXTERNAL_APP_ID }} \        -S ${{ secrets.EXTERNAL_APP_SECRET }} \        --applicationScope "AutomationSolutions Solutions.Packages Solutions.Packages.Write"  # 3. Deploy to target environment  - name: Deploy Solution    run: |      uipcli solution deploy MySolution \        -v "1.0.${{ github.run_number }}" \        -d "MySolution-Prod-v1.0.${{ github.run_number }}" \        -f Production \        -U ${{ secrets.ORCHESTRATOR_URL }} \        -T ${{ secrets.ORCHESTRATOR_TENANT }} \        -A ${{ secrets.ORG_NAME }} \        -I ${{ secrets.EXTERNAL_APP_ID }} \        -S ${{ secrets.EXTERNAL_APP_SECRET }} \        --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write"  # 4. Activate the deployment  - name: Activate Deployment    run: |      uipcli solution deploy-activate "MySolution-Prod-v1.0.${{ github.run_number }}" \        -U ${{ secrets.ORCHESTRATOR_URL }} \        -T ${{ secrets.ORCHESTRATOR_TENANT }} \        -A ${{ secrets.ORG_NAME }} \        -I ${{ secrets.EXTERNAL_APP_ID }} \        -S ${{ secrets.EXTERNAL_APP_SECRET }} \        --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write"

Implantações fechadas com aprovação manual

Você pode separar e ativar as etapas para implementar fluxos de trabalho de aprovação:

# Stage 1: Deploy (automated)- stage: DeployToProduction  jobs:  - job: Deploy    steps:    - script: |        uipcli solution deploy MySolution -v $(version) -d MySolution-Prod-$(version) -f Production ...      displayName: 'Prepare Production Deployment'# Stage 2: Activate (requires approval)- stage: ActivateProduction  dependsOn: DeployToProduction  # Manual approval gate configured in Azure DevOps  jobs:  - deployment: Activate    environment: 'Production'    steps:    - script: |        uipcli solution deploy-activate MySolution-Prod-$(version) ...      displayName: 'Activate Production Deployment'

Promoção de vários ambientes

Implante a mesma versão em vários ambientes sequencialmente:

# Deploy to Devuipcli solution deploy MySolution -v 1.2.3 -d MySolution-Dev-1.2.3 -f Dev ...uipcli solution deploy-activate MySolution-Dev-1.2.3 ...# Deploy to Testuipcli solution deploy MySolution -v 1.2.3 -d MySolution-Test-1.2.3 -f Test ...uipcli solution deploy-activate MySolution-Test-1.2.3 ...# Deploy to Production (after approval)uipcli solution deploy MySolution -v 1.2.3 -d MySolution-Prod-1.2.3 -f Production ...uipcli solution deploy-activate MySolution-Prod-1.2.3 ...

Estratégia de reversão

Para reverter para uma versão anterior:

1. Implante a versão anterior com um novo nome de implantação.
2. Ative a implantação da versão anterior.
3. Opcionalmente, desinstale a implantação mais recente.

# Roll back to v1.2.2uipcli solution deploy MySolution -v 1.2.2 -d MySolution-Prod-Rollback-1.2.2 -f Production ...uipcli solution deploy-activate MySolution-Prod-Rollback-1.2.2 ...

Próximas Etapas

Após implantar e ativar as Soluções, você poderá:

1. Monitore a execução no Orchestrator.
2. Desinstale as implantações quando não forem mais necessárias.
3. Implante novas versões seguindo o mesmo fluxo de trabalho.