For the complete documentation index, see llms.txt. This page is also available as Markdown.

Instalar Devolutions CLI en los agentes de compilación

Devolutions CLI no necesita un runtime ni un servicio: extraiga el archivo para la plataforma de su agente, añada su carpeta al PATH, y el agente está listo. Esta página trata lo que cambia en un agente de compilación: elegir el archivo correcto, impedir que los trabajos compartan la configuración y limpiar después de un trabajo.

Elija el paquete para su agente

PLATAFORMA
ARQUITECTURA
COMANDO

Windows

x64, Arm64

devo.exe

macOS

x64, Arm64

devo

Linux

x64, Arm64

devo

Cada plataforma y cada arquitectura tiene su propia compilación, disponible como archivo .zip o .tar.gz: use la que corresponda al agente. El archivo puede contener otros archivos junto a devo, como bibliotecas nativas, así que mantenga junta la carpeta extraída.

Instálelo

mkdir -p "$HOME/devo"
tar -xzf <archive>.tar.gz -C "$HOME/devo"
export PATH="$HOME/devo:$PATH"
devo --help

Use cualquier carpeta en la que el trabajo pueda escribir.

Expand-Archive <archive>.zip -DestinationPath "$env:TEMP\devo" -Force
$env:PATH = "$env:TEMP\devo;$env:PATH"
devo --help

Sustituya $env:TEMP por cualquier carpeta en la que el trabajo pueda escribir.

Mantener separada la configuración de cada trabajo

Devolutions CLI guarda sus contextos, las sesiones de inicio de sesión y el estado de su proceso en segundo plano en una carpeta de configuración del perfil del usuario. En un agente de compilación que ejecuta trabajos uno tras otro con la misma cuenta, cada trabajo compartiría esa carpeta: un trabajo podría usar un contexto creado por otro.

Establezca DEVO_CLI_CONFIG_HOME en una carpeta que pertenezca al trabajo, antes del primer comando devo:

Cada comando devo del trabajo usa entonces esa carpeta para sus contextos y su proceso en segundo plano, y los demás trabajos no la ven.

Controlar el proceso en segundo plano

El primer comando devo que necesita su espacio de trabajo inicia un proceso en segundo plano y lo deja en ejecución para los comandos siguientes. Es el mismo archivo devo, que se ejecuta con la cuenta de usuario del trabajo. No mantiene abierta la salida de su trabajo, así que el paso que lo inició puede terminar con normalidad.

De forma predeterminada, el proceso en segundo plano se detiene por sí solo tras 60 minutos sin solicitudes. En un agente de compilación, normalmente quiere que desaparezca antes.

CONFIGURACIÓN
QUÉ HACE

DEVO_DAEMON_IDLE_TIMEOUT

Cuánto tiempo espera el proceso en segundo plano sin solicitudes antes de detenerse, por ejemplo 30s, 5m, 1h o 00:05:00. El valor predeterminado es 60 minutos. 0s desactiva la parada por inactividad. Si Devolutions CLI no puede leer el valor, el comando que iniciaría el proceso en segundo plano falla con invalidParameterValue.

opción --daemon o DEVO_DAEMON_MODE

auto (predeterminado): inicia el proceso en segundo plano cuando hace falta. require: usa uno que ya está en ejecución, sin iniciar nunca uno. never: no lo contacta, así que los comandos que lo necesitan fallan.

Opción --no-daemon-autostart o DEVO_DAEMON_AUTOSTART

No inicie el proceso en segundo plano automáticamente. Defina la variable como 0, false o no para desactivar el inicio automático.

Con require, o con el inicio automático desactivado, inicie usted mismo el proceso al principio del trabajo:

Defina las variables de entorno que Devolutions CLI lee más tarde, como la variable que contiene su secreto de aplicación, antes del primer comando devo. El proceso en segundo plano lee su entorno al iniciarse. Consulte Iniciar sesión desde una canalización de CI.

Limpiar al final del trabajo

Ejecute estos comandos en un paso que siempre se ejecuta, incluso cuando el trabajo falla:

  • devo logout borra la autenticación almacenada del contexto.

  • devo daemon stop --wait detiene el proceso en segundo plano de esta carpeta de configuración y espera hasta que desaparezca. Si no hay ninguno en ejecución, no hace nada.

  • Elimine la carpeta de configuración al final: devo daemon stop la usa para encontrar el proceso en segundo plano.

En los agentes de compilación que se eliminan después de cada trabajo, como contenedores o máquinas virtuales temporales, la limpieza no es obligatoria, pero no cuesta nada.

Bueno saberlo

Siguiente

Última actualización

¿Te fue útil?