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

Rellenar un archivo de configuración a partir de una plantilla

Algunas herramientas solo leen su configuración desde un archivo, como appsettings.json, una configuración YAML o un .npmrc. Con devo secret inject, conserva en el repositorio una plantilla con referencias devo:// y genera el archivo real cuando lo necesita.

Escribir la plantilla

Ponga una referencia dondequiera que vaya un secreto. Envuélvala en {{ }} para que Devolutions CLI sepa exactamente dónde empieza y dónde termina:

{
  "Database": {
    "User": "{{ devo://ws/<workspace-id>/vault/<vault-id>/entry/<entry-id>/field/username }}",
    "Password": "{{ devo://ws/<workspace-id>/vault/<vault-id>/entry/<entry-id>/field/password }}"
  }
}

Una referencia sin {{ }} también funciona. Termina en el primer espacio, comilla, <, >, ), ] o }.

Dentro de una referencia, $NAME, ${NAME} y ${NAME:-default} se sustituyen por el valor de una variable de entorno antes de que se resuelva la referencia. Úselo para compartir una plantilla entre entornos, por ejemplo devo://ws/${WORKSPACE_ID}/vault/….

Generar el archivo

devo secret inject --in-file appsettings.template.json --out-file appsettings.json
OPCIÓN
QUÉ HACE

--in-file, -i

La plantilla que se va a leer. Sin ella, Devolutions CLI lee la plantilla de la entrada estándar.

--out-file, -f

El archivo que se va a escribir. Sin él, el resultado va a la salida estándar.

--force

Sustituye el archivo de salida si ya existe. Sin ella, el comando se detiene antes de leer ningún secreto.

También puede trabajar con tuberías, por ejemplo para pasar el resultado directamente a otro programa:

En qué puede confiar

  • Todo o nada. Si una referencia no se puede resolver, Devolutions CLI no escribe ningún archivo ni nada de la plantilla. Enumera los errores en la salida de error, imprime una línea de resumen como References: 1/2 resolved en la salida estándar y termina con el código 1.

  • Archivo privado. El archivo de salida se 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.

  • Ningún archivo a medias. Devolutions CLI escribe en un archivo temporal de la misma carpeta y luego lo coloca en su sitio.

  • Cada referencia se lee una vez. Una referencia usada varias veces en la plantilla se resuelve una sola vez.

Con --output json, el comando devuelve un resumen en lugar del contenido: cuántas referencias encontró y resolvió. Los valores no están en él.

Bueno saberlo

  • Con la salida estándar, los valores aparecen en el terminal o en lo que lee la canalización. Prefiera --out-file cuando no necesite una canalización.

  • Las referencias se resuelven a través del contexto actual. Añada --context <context-name> para usar otro espacio de trabajo. Las referencias canónicas se resuelven siempre contra el espacio de trabajo al que pertenecen.

  • Una referencia no se resuelve: consulte Una referencia de secreto no se resuelve.

Siguiente

Última actualización

¿Te fue útil?