Cargar y eliminar paquetes de soluciones

Después de empaquetar una solución, puedes cargar el paquete en Soluciones en Orchestrator. También puedes eliminar paquetes cuando ya no sean necesarios.

Consejo:

For Orchestrator instances signed by a private Certificate Authority (such as UiPath Automation Suite), both upload-package and delete-package also accept --ca-cert and --pinnedpubkey parameters. See Trusting custom certificates for scenarios and examples.

Cargar un paquete

El comando upload-package envía un archivo .zip de solución a Soluciones.

Sintaxis del comando

uipcli solution upload-package <package-path> [options]

Parámetros:

Parámetro	Descripción	Obligatorio
<package-path>	Ruta al archivo del paquete .zip	Sí
-U	URL de Orchestrator	Sí
-T	Nombre del tenant	Sí
-A	Nombre de la organización	Sí
-I	ID de aplicación externa	Sí
-S	Secreto de aplicación externa	Sí
--applicationScope	Ámbitos opcionales (aplicados por defecto)	No
--traceLevel	Nivel de registro	No
--ca-cert	Trusted root CA file(s) (PEM, DER, or PKCS#7) for the Orchestrator/Identity TLS certificate. Repeat or comma-separate. See Trusting custom certificates.	No
--pinnedpubkey	Pin the leaf public key (sha256//<base64>). See Trusting custom certificates.	No

Autenticación

Consulta Autenticación y ámbitos para conocer los ámbitos necesarios y Configuración de la aplicación externa.

Ejemplo

uipcli solution upload-package C:\Output\MySolution.1.2.3.zip \
  -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

Uso de secretos de CI/CD

Nunca codifiques las credenciales en los scripts. Utiliza la gestión de secretos de tu plataforma:

Azure DevOps:

- script: |
    uipcli solution upload-package $(Build.ArtifactStagingDirectory)\MySolution.$(Build.BuildId).zip \
      -U $(orchestratorUrl) \
      -T $(orchestratorTenant) \
      -A $(organizationName) \
      -I $(externalAppId) \
      -S $(externalAppSecret) \
      --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \
      --traceLevel Information
  displayName: 'Upload Solution Package'

Acciones de GitHub:

- name: Upload Solution Package
  run: |
    uipcli solution upload-package ${{ runner.temp }}/packages/MySolution.${{ 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.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \
      --traceLevel Information

Qué sucede después de la carga

Una vez cargado, el paquete:

• Aparece en Soluciones en Orchestrator.
• Se puede implementar en cualquier carpeta de destino.
• Está versionado y rastreado.
• Puede ser descargado por otros procesos o usuarios.

Deleting a package

El comando delete-package elimina un paquete de soluciones de Soluciones.

Sintaxis del comando

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

Parámetros:

Parámetro	Descripción	Obligatorio
<package-name>	Nombre del paquete (sin la extensión .zip )	Sí
-v o --version	Número de versión para eliminar	Sí
-U	URL de Orchestrator	Sí
-T	Nombre del tenant	Sí
-A	Nombre de la organización	Sí
-I	ID de aplicación externa	Sí
-S	Secreto de aplicación externa	Sí
--applicationScope	Ámbitos opcionales (aplicados por defecto)	No
--traceLevel	Nivel de registro	No
--ca-cert	Trusted root CA file(s) (PEM, DER, or PKCS#7) for the Orchestrator/Identity TLS certificate. Repeat or comma-separate. See Trusting custom certificates.	No
--pinnedpubkey	Pin the leaf public key (sha256//<base64>). See Trusting custom certificates.	No

Nota:

Al utilizar la autenticación de aplicaciones externas sin especificar el parámetro --applicationScope , la CLI aplica automáticamente estos ámbitos predeterminados de AutomationSolution:

Solutions.Packages Solutions.Deployments OR.Execution

Autenticación

Consulta Autenticación y ámbitos para conocer los ámbitos necesarios y Configuración de la aplicación externa.

Ejemplo

uipcli solution delete-package MySolution \
  -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

Cuándo eliminar paquetes

Escenarios comunes para eliminar paquetes:

• Procesos de limpieza : elimina las versiones antiguas después de una implementación correcta.
• Compilaciones fallidas : elimina los paquetes no válidos que no deben implementarse.
• Políticas de retención : aplica las reglas del ciclo de vida del paquete (por ejemplo, mantener solo las últimas 10 versiones).
• Gestión de almacenamiento : libera espacio en Soluciones.

Ejemplo de proceso: limpieza de versiones antiguas

# Delete old version after deploying new one
uipcli solution delete-package MySolution \
  -v 1.2.2 \
  -U https://cloud.uipath.com/ \
  -T DefaultTenant \
  -A myorg \
  -I $(externalAppId) \
  -S $(externalAppSecret) \
  --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write"

Nomenclatura del paquete

El nombre del paquete utilizado en las operaciones de carga y eliminación se deriva del nombre de la solución, no del nombre del archivo.

Ejemplo:

• El comando Empaquetar crea: MySolution.1.2.3.zip
• Nombre del paquete para eliminar: MySolution
• Versión: 1.2.3

Próximos pasos

Después de cargar un paquete, puedes:

1. Descarga las configuraciones de implementación.
2. Implementar la solución en un entorno de destino.