Ejecutar un comando con sus secretos
devo secret run es la forma más segura de dar un secreto a un programa. Devolutions CLI lee los valores de su bóveda, los coloca en el entorno de ese único programa, lo inicia y oculta los valores en todo lo que imprime. Su shell nunca contiene el valor, y no se escribe nada en el disco.
devo secret run --env-ref DB_PASSWORD=<reference> -- <your-command> <arguments>Todo lo que sigue a -- es el programa y sus argumentos. Para encontrar <reference>, consulte Encontrar la referencia de un secreto.
Elegir la forma correcta de pasar referencias
--env-ref NAME=<reference>
Establece la variable de entorno NAME en el valor. Repita la opción para cada secreto.
Inicia un comando a mano o desde un script.
Una variable que ya contiene una referencia
Cualquier variable de entorno de su shell cuyo valor sea una referencia devo:// se sustituye por el valor para el programa.
Su perfil de shell o su canalización de CI ya define variables como DB_PASSWORD=devo://….
--env-file <file>
Lee KEY=value líneas y resuelve las referencias que contienen.
Su proyecto ya tiene un archivo .env. Consulte Sacar las contraseñas de un archivo .env.
--stdin-reference <reference>
Escribe el valor, exactamente, en la entrada estándar del programa y luego la cierra.
El programa lee una contraseña de la entrada estándar, como docker login --password-stdin.
--manifest <file>
Lee el comando, sus argumentos y sus referencias desde un archivo JSON.
Quiere un archivo de inicio para revisar y reutilizar, por ejemplo para un agente de IA.
Pasar varios secretos
Repita --env-ref para cada variable. Los nombres usan letras, dígitos y guiones bajos, y no pueden empezar por un dígito.
devo secret run \
--env-ref DB_USER=<username-reference> \
--env-ref DB_PASSWORD=<password-reference> \
-- ./migrate.shdevo secret run `
--env-ref DB_USER=<username-reference> `
--env-ref DB_PASSWORD=<password-reference> `
-- pwsh -NoProfile -File ./migrate.ps1El programa recibe el resto de su entorno como de costumbre. Cada nombre de variable solo puede definirse una vez entre todas las fuentes: si el mismo nombre viene de --env-ref y de una variable de su shell que contiene una referencia, el comando se detiene con un conflicto en lugar de elegir por usted.
Usar las referencias que ya están en su entorno
Si una variable de su shell actual contiene una referencia devo://, devo secret run la resuelve para el programa sin ninguna opción:
La variable de su shell conserva la referencia. Solo el programa ve el valor. Esto no se aplica con --manifest, donde el manifiesto enumera cada referencia: con un manifiesto, esa variable llega al programa como el texto de la referencia en claro, no el valor.
Enviar un secreto a la entrada estándar
Devolutions CLI escribe el valor sin un salto de línea final y luego cierra la entrada estándar del programa.
Mantener las referencias fuera de la línea de comandos
Devolutions CLI rechaza un argumento del programa que es una referencia, como -- psql --password devo://…. Las referencias solo se resuelven mediante --env-ref, --stdin-reference, un archivo de entorno o un manifiesto. Una referencia dentro de un argumento más largo, como --password=devo://…, no se rechaza, pero tampoco se resuelve: el programa recibe el texto de la referencia.
Compruebe antes de ejecutar
Dos opciones le permiten probar un inicio sin arrancar el programa:
--dry-run
Construye el plan de inicio y muestra un resumen: el comando, el número de referencias, el tiempo límite y si el enmascaramiento está activado. Con --output json, el plan enumera cada variable con su referencia. No contacta con su espacio de trabajo y no busca el programa.
--check
También comprueba que el programa exista en la carpeta actual o en su PATH, y ejecuta una lectura sin valor de cada referencia. Eso confirma la sintaxis y, para una referencia con nombre o en un perfil local, la bóveda y la entrada. No demuestra que el campo se pueda leer: en Devolutions Cloud y Devolutions Server, una referencia canónica no se busca. Las referencias de un archivo de entorno se comprueban tal como están escritas, antes de que ${NAME} se sustituya.
Puede usar uno u otro, no ambos. Ambos aceptan --output json.
Limitar cuánto tiempo se ejecuta el programa
Cuando se agota el tiempo, Devolutions CLI detiene el programa y todo lo que inició, y termina con el código 124. Si cancela con Ctrl+C, detiene el programa y termina con 130. De lo contrario, devo secret run termina con el código de salida de su programa.
Conservar un registro del inicio
Añada --receipt-file <path> para escribir un recibo JSON cuando el programa termine: el plan de inicio, los nombres de las variables, el código de salida, la duración y si el programa agotó el tiempo o se canceló. El recibo no contiene ningún valor de secreto. El archivo no debe existir todavía. Devolutions CLI lo crea con permisos privados: en macOS y Linux, solo su cuenta de usuario puede leerlo; en Windows, su cuenta, la cuenta del sistema y los administradores.
Usar un manifiesto de inicio
Un manifiesto es un archivo JSON que describe todo el inicio. Con --manifest, no puede añadir --env-ref, --env-file, --stdin-reference, --timeout-seconds ni un comando después de --.
commandes obligatorio.schemaVersiones opcional; si lo define, debe ser1. Las demás propiedades son opcionales.Cada valor en
environmentdebe ser una sola referenciadevo://.workingDirectorydebe ser una ruta absoluta a una carpeta que exista.Un nombre de propiedad o de variable no puede aparecer dos veces.
Acerca del enmascaramiento
Devolutions CLI observa lo que el programa imprime en su salida estándar y en su salida de error, y sustituye cada valor resuelto por <concealed by Devolutions>. Si una herramienta debe imprimir un valor, por ejemplo para pasarlo a otro programa, añada --no-masking.
Bueno saberlo
Las referencias se resuelven a través del contexto actual. Añada
--context <context-name>para usar otro espacio de trabajo en un solo comando. Las referencias canónicas se resuelven siempre en el espacio de trabajo al que pertenecen.Un inicio no válido, como un
--env-refmal formado, termina con el código2antes de que se lea nada. Consulte Códigos de salida y errores.Una referencia que no se resuelve detiene el inicio antes de que el programa arranque. Consulte Una referencia de secreto no se resuelve.
Siguiente
Cada opción de
devo secret run: Comandos
Última actualización
¿Te fue útil?