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	The Orchestrator folder where the deployment folder will be created. If not specified, the deployment folder will be created in tenant folder. When specified, deployment will be under respective folder. When set to "[e-mail]'s workspace", the deployment will be under personal workspace for specified user.	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:

If a deployment with the same name already exists at any level within the tenant in Orchestrator, this operation upgrades the existing deployment instead of creating a new one. If the existing deployment is in Failed state, the upgrade does not proceed; resolve or uninstall the failed deployment before retrying.

Importante:

Solutions deployed at the tenant level do not automatically assign a user to the resulting folder. To assign an account, ensure the appropriate configuration is set in Orchestrator (Tenant > Folders).

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.