Tutorial: reutilizar los recursos existentes de Orchestrator al implementar

Reutiliza una conexión, activo o cola de Orchestrator existente al implementar una solución desde un proceso CI/CD, en lugar de aprovisionar una nueva.

Al implementar una solución, cada recurso que declara (colas, activos, procesos, conexiones) se aprovisiona de nuevo en la carpeta de implementación. A menudo, ya tienes un recurso compartido en el entorno de destino, como una conexión a un sistema externo, y deseas que la implementación lo reutilice en lugar de crear uno nuevo.

En la interfaz de usuario de Orchestrator, puedes elegir Personalizar al implementar y vincular el recurso a mano. Ese paso manual no se traduce en un proceso unattended. El equivalente de CLI es obtener la configuración de implementación, vincular el recurso dentro de ese archivo y luego pasar el archivo a deploy run.

Nota:

config link vincula un recurso declarado a uno existente. Para hacer que cada recurso reutilice una contraparte existente, consulta Reutilizar cada recurso a continuación.

Requisitos previos

• Un paquete de soluciones publicado en el tenant. Consulta Empaquetar y publicar una solución.
• Una aplicación externa configurada para la autenticación de credenciales de cliente, con estos ámbitos: AutomationSolutions, Solutions.Deployments, Solutions.Packages, OR.Folders, RCS.FolderAuthorization. Consulta Autenticación: flujo 2. OR.Folders y RCS.FolderAuthorization son necesarios para que la CLI pueda resolver y vincular los recursos que se encuentran en las carpetas de Orchestrator.
• La aplicación externa asignada a la carpeta de Orchestrator que contiene el recurso existente.

Pasos

1. Autentica con la aplicación externa.

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

2. Descarga la configuración de implementación para el paquete.

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

3. Vincula el recurso de solución al recurso de Orchestrator existente. Utiliza el nombre del recurso tal y como aparece en el archivo de configuración y apunta --folder-path a la carpeta donde reside el recurso existente.

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

4. Implementa el paquete con la configuración 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
   

La implementación reutiliza el recurso vinculado y no crea uno nuevo en la carpeta de implementación.

Nota:

El config link, --folder-path es donde reside el recurso existente . El deploy run, --parent-folder-path es donde se crea la carpeta de implementación. Son marcadores independientes en subcomandos independientes.

Conexiones: aplazar la selección al tiempo de ejecución

Para los recursos de conexión, vincular una conexión existente no es la única opción. Si estableces el authenticationType de la conexión en ConfigurableByUsers en la configuración de implementación, puedes dejar la conexión sin vincular y aplazar su selección y autenticación al tiempo de ejecución: los usuarios eligen y autentican la conexión cuando se ejecuta la automatización. Esta también es una configuración válida para la activación.

authenticationType acepta dos valores: ConfigurableByUsers (aplazar al usuario en tiempo de ejecución) y AuthenticateAfterDeployment (la conexión debe autenticarse después de la implementación). Con AuthenticateAfterDeployment, si la conexión no se autentica en el momento en que se ejecuta la activación, la activación se informa como fallida.

Reutilizar cada recurso

Cuando desees que toda la implementación reutilice los recursos existentes en lugar de crear otros nuevos, establece la política de conflictos en todos los recursos en una llamada antes de la implementación.

1. Establece la política de conflictos en cada recurso en el archivo de configuración.

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

2. Pasa el mismo archivo deploy run --config-file, como se muestra en el paso 4.

Ver también

• uip solution deploy : la referencia para config get, config link, config set y deploy run.
• Gestionar activos y colas de Orchestrator : crea los recursos a los que vincularás más tarde.
• Implementar en Orchestrator desde CI : autenticación, almacenamiento en caché y fijación de versiones para el proceso en el que se ajusta.
• Autenticación : el flujo de aplicación externa utilizado aquí.