Download de pacotes de solução e configurações

Você pode baixar pacotes de soluções e arquivos de configuração de implantação de Soluções no Orchestrator. Isso é útil para recuperação de desastres, promoção do ambiente e gerenciamento de configurações.

Download de um pacote

O comando download-package recupera um pacote de soluções de Soluções.

Sintaxe de comando

uipcli solution download-package <package-name> [options]

Parâmetros:

Parâmetro	Description	Required
<package-name>	Nome do pacote a ser baixado	Sim
-d ou --destinationPath	Caminho de destino local em que o pacote será salvo	Sim
-v ou --version	Número da versão (se omitido, a versão mais recente é baixada)	Não
-f ou --fileName	Nome do arquivo local (se omitido, o nome do arquivo será o nome do pacote + a versão)	Não
-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 opcionais (padrão aplicados)	Não
--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 download-package MySolution \
  -d C:\Downloads \
  -v 1.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

Isso baixa o pacote para:

C:\Downloads\MySolution.1.2.3.zip

Exemplo com nome de arquivo personalizado:

uipcli solution download-package MySolution \
  -d C:\Downloads \
  -f CustomPackageName.zip \
  -v 1.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

Casos de uso para baixar pacotes

Recuperação de desastre:

• Arquivar pacotes para backup
• Restaurar pacotes se o Orchestrator estiver indisponível

Promover o ambiente:

• Download do Ambiente de teste
• Carregar para o ambiente de produção

Auditoria:

• Recuperar versões específicas para revisões de conformidade
• Comparar os conteúdos do pacote entre as versões

Testes locais:

• Baixar um pacote implantado para validação
• Teste o descompactação e implante localmente

Download de configurações de implantação

O comando download-config recupera modelos de configuração específicos do ambiente para uma implantação de Solução.

Sintaxe de comando

uipcli solution download-config <package-name> [options]

Parâmetros:

Parâmetro	Description	Required
<package-name>	Nome do pacote	Sim
-d ou --destinationPath	Caminho de destino local em que os arquivos de configuração serão salvos	Sim
-v ou --version	Número da versão (se omitido, a configuração da versão mais recente é baixada)	Não
-f ou --fileName	Nome do arquivo local (se omitido, o nome do arquivo será o nome do pacote + a versão)	Não
--format	Formato de configuração: yaml ou json (padrão: yaml)	Não
-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 opcionais (padrão aplicados)	Não
--traceLevel	Nível de Registros de Log	Não

Observação:

Ao usar a autenticação de aplicativos externos sem especificar o parâmetro --applicationScope , a CLI aplica automaticamente esses escopos padrão do AutomationSolution:

Solutions.Packages Solutions.Deployments OR.Execution

Importante: todos os três escopos são necessários para todos os comandos de CLI relacionados à solução. Esses escopos são agrupados para fornecer uma cobertura abrangente para todos os comandos de solução disponíveis e devem ser configurados coletivamente em vez de individualmente por comando.

Autenticação

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

Exemplo

Baixe a configuração no formato YAML (padrão):

uipcli solution download-config MySolution \
  -d C:\Configs \
  -v 1.0.0 \
  -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

Baixe a configuração no formato JSON com nome de arquivo personalizado:

uipcli solution download-config MySolution \
  -d C:\Configs \
  -f CustomConfigFile \
  -v 1.0.0 \
  --format json \
  -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 são configurações de implantação?

As configurações de implantação definem configurações específicas do ambiente para uma solução:

• Strings de conexão
• Pontos de extremidade da API
• Referências de credenciais
• Variáveis de Ambiente
• Mapeamentos de pasta

Essas configurações são:

• Criado ao implantar uma solução
• Armazenado em Soluções
• Reutilizável em várias implantações
• Controlado por versão separadamente do pacote

Casos de uso para o download de configurações

Pipelines de vários ambientes:

# Download Dev config
uipcli solution download-config MySolution \
  -d C:\Configs\Dev \
  -f dev-config \
  -v 1.0.0 \
  -U https://cloud.uipath.com/ ...

# Download Prod config
uipcli solution download-config MySolution \
  -d C:\Configs\Prod \
  -f prod-config \
  -v 1.0.0 \
  -U https://cloud.uipath.com/ ...

Configuração como código:

• Arquivos de configuração de controle de versão
• Acompanhar alterações nas configurações do ambiente
• Revise as diferenças de configuração em solicitações de pull

Geração de modelo:

• Baixe uma configuração que esteja funcionando como ponto de partida
• Modificar para novos ambientes
• Reutilizar padrões de implantação

Auditoria e conformidade:

• Arquivar as configurações de cada implantação
• Comparar configurações entre ambientes
• Verificar se a configuração de produção corresponde aos modelos aprovados

Exemplo de integração do pipeline

Configurações de download e controle de versão

- name: Download Solution Configs
  run: |
    # Download config from Test environment
    uipcli solution download-config MySolution \
      -d ./configs/test \
      -f test-config \
      --format yaml \
      -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"

- name: Commit configs to repo
  run: |
    git add ./configs
    git commit -m "Update deployment configs from Test"
    git push

Solução de problemas

Erro: "Não autorizado" ou "403 Proibido"

• Verifique se o aplicativo externo tem o escopo Solutions.Packages.Read
• Verifique se o nome da organização (-A) está correto
• Confirmar se o ID e o segredo do aplicativo externo são válidos

Erro: "Pacote não encontrado"

• Verifique se o nome e a versão do pacote estão corretos (diferencia por maiúsculas e minúsculas)
• Certifique-se de que você está segmentando o tenant e a organização corretos
• Verifique se o pacote foi carregado com sucesso

Erro: "Configuração não encontrada"

• Verifique se o nome do pacote está correto
• Verifique se a versão existe (ou omita -v para usar a mais recente)
• Certifique-se de que o pacote tenha configurações de implantação disponíveis

Erro: "Diretório de saída não acessível"

• Verifique se o caminho de destino (-d) é válido e gravável
• Verifique as permissões de diretório no agente
• Certifique-se de que haja espaço em disco suficiente disponível

Próximas Etapas

Depois de baixar pacotes ou configurações, você pode:

1. Implante soluções nos ambientes de destino.
2. Arquivos de configuração de controle de versão para auditoria e conformidade.
3. Use configurações como modelos para novas implantações.