Configuración¶

Esta página le informa sobre cada sección de la página Configuración y sobre el archivo de configuración.

Para abrir la página, pulse ⚙ Configuración en la barra superior. La página tiene estas secciones, de arriba abajo:

Credenciales
Fuentes de conjuntos de datos
Versiones de los conjuntos de datos y datos locales (con Visualizaciones del mapa dentro)
Memoria

El selector de idioma no está en la página Configuración. Está en la barra superior. Consulte Idioma.

Credenciales¶

La sección Credenciales tiene una tarjeta para cada credencial:

Título de la tarjeta	Credencial	Campos de la tarjeta
AWS (conjuntos de datos S3)	Un par de claves de AWS. Todas las fuentes de conjuntos de datos S3 usan este único par de claves.	ID de clave de acceso, Clave secreta de acceso
planet	La clave del mapa base Planet	Nombre de usuario, Clave de API
google	La clave del mapa base Google Maps	Clave de API
cdse	El ID de instancia del mapa base Copernicus (CDSE)	ID de instancia

Cada tarjeta tiene una línea En uso desde: que le indica de dónde viene la credencial en uso. Los valores posibles son Entorno, Secreto de Docker, Administrador de credenciales, Almacén cifrado y Sin configurar.

Una tarjeta con un campo secreto (Clave secreta de acceso o Clave de API) también muestra Guardado o No guardado. El campo secreto siempre está vacío, también después de guardar. La aplicación nunca envía un secreto guardado de vuelta al navegador.

Los campos ID de clave de acceso, Nombre de usuario e ID de instancia no son secretos. Estos campos muestran el valor que contiene el almacén cifrado.

Dónde obtener cada valor¶

AWS (conjuntos de datos S3): Obtenga un ID de clave de acceso y una clave secreta de acceso para una cuenta de AWS que usted controla. La cuenta de AWS paga todas las lecturas de los conjuntos de datos. Consulte Fuentes de conjuntos de datos.
planet: Obtenga la clave de API y el nombre de usuario de su cuenta de Planet.
google: Obtenga una clave de API para las teselas de Google Maps desde su cuenta de Google.
cdse: Obtenga el ID de instancia desde su panel de Copernicus Data Space. El ID de instancia tiene de 8 a 64 caracteres: solo letras, dígitos y guiones.

Añadir o cambiar una clave de AWS¶

En la tarjeta AWS (conjuntos de datos S3), escriba el ID de la clave en ID de clave de acceso.
Escriba el secreto en Clave secreta de acceso.
Pulse Comprobar credenciales.
Asegúrese de que la línea del resultado empieza con "La clave" y dice "es válida".
Pulse Guardar.

NOTA: Comprobar credenciales es gratuito. Solo pregunta a AWS STS si el par de claves es válido. No lee ningún bucket.

NOTA: No puede pulsar Guardar hasta que el par de claves supera Comprobar credenciales. Si cambia un campo después de la comprobación, debe hacer la comprobación otra vez. La aplicación muestra "Primero compruebe las credenciales. Un par de claves que no superó la comprobación nunca se guarda."

Para comprobar la clave de AWS que está en uso ahora, deje Clave secreta de acceso vacía y no cambie ID de clave de acceso. Después, pulse Comprobar credenciales. Si escribe solo uno de los dos valores, la aplicación muestra "Introduzca tanto el ID de clave de acceso como la clave secreta de acceso, o ninguno."

Resultados de Comprobar credenciales¶

Resultado	Qué le indica	Qué hacer
"La clave ... es válida: ..."	AWS aceptó el par de claves. La línea muestra una parte de la clave, la identidad de AWS y los últimos 4 dígitos de la cuenta de AWS.	Pulse Guardar si escribió un par nuevo.
"AWS rechazó esta credencial ..."	El ID de la clave o el secreto son incorrectos, o la clave no está activa.	Escriba los dos valores otra vez y pulse Comprobar credenciales.
"No hay ninguna credencial de AWS introducida ni guardada."	No hay ningún par de claves escrito ni guardado.	Escriba el ID de la clave y el secreto.
"Existe una credencial guardada, pero no se pudo leer ..."	La aplicación no puede descifrar la clave guardada con la clave maestra activa.	Escriba el ID de la clave y el secreto otra vez y guarde.
"No se pudo contactar con AWS STS ..."	Un problema de red o del punto de conexión. El resultado no le indica nada sobre la credencial.	Haga la comprobación otra vez.
"AWS STS no respondió a tiempo."	La comprobación se detuvo después del límite de tiempo. El resultado no le indica nada sobre la credencial.	Haga la comprobación otra vez.
"AWS respondió ..."	AWS envió un código de error diferente. La línea muestra el código.	Examine el código.

Añadir o cambiar una clave de mapa base¶

En la tarjeta planet, google o cdse, escriba el valor. Para planet, escriba el Nombre de usuario y la Clave de API.
Pulse Probar conexión.
Asegúrese de que el resultado empieza con "Conexión correcta."
Pulse Guardar.

NOTA: Probar conexión envía los valores escritos al proveedor, pero no los guarda. No puede pulsar Guardar hasta que una prueba de los mismos valores es correcta. La aplicación muestra "Pruebe primero la conexión. Una conexión fallida nunca se guarda."

Para probar la clave que está en uso ahora, deje la tarjeta vacía. Después, pulse Probar conexión. El resultado es uno de estos:

La fuente que la aplicación probó. Un ejemplo es "Se probó la credencial en uso (Entorno); no se escribió nada en esta tarjeta."
Si la tarjeta no tiene ningún valor guardado: "Nada que probar: esta tarjeta está vacía y no hay nada guardado para ella."

Resultados de Probar conexión para un mapa base¶

Una prueba correcta empieza con "Conexión correcta." Una prueba fallida empieza con "Conexión fallida:". La causa viene después.

Resultado	Qué le indica
ok: "El proveedor aceptó esta credencial."	La clave es correcta.
unauthorized: "El proveedor rechazó esta credencial. ..."	El valor es incorrecto, o no tiene permiso ahora.
unreachable: "No se pudo acceder al proveedor ..."	Un problema de red o del punto de conexión. No le indica nada sobre la credencial.
timed out: "El proveedor no respondió dentro del tiempo permitido. ..."	El proveedor fue demasiado lento, o la aplicación no puede llegar a él. No le indica nada sobre la credencial.
misconfigured: "El proveedor está mal configurado en el servidor, ..."	La configuración del servidor para este proveedor tiene un problema. La aplicación no probó la credencial.
not configured: "No hay ninguna credencial disponible para probar."	No se encontró ninguna credencial.

Dónde guarda la aplicación las credenciales¶

La aplicación busca cada credencial en 4 lugares, en este orden. Usa el primero que encuentra:

Entorno: variables de entorno. Los nombres son AWS_ACCESS_KEY_ID y AWS_SECRET_ACCESS_KEY (y un AWS_SESSION_TOKEN opcional), PLANET_API_KEY (como user:key), GOOGLE_MAPS_API_KEY y CDSE_INSTANCE_ID.
Secreto de Docker: un archivo con el mismo nombre en la carpeta de secretos de Docker. La carpeta predeterminada es /run/secrets.
Administrador de credenciales: el Administrador de credenciales de Windows. Las claves de configuración security.credential_manager_names y security.credential_manager_pairs dan los nombres de destino.
Almacén cifrado: las credenciales que usted guarda en la página Configuración.

El almacén cifrado guarda un archivo para cada credencial (<name>.enc.json) en la carpeta que da security.secret_store_dir. El valor predeterminado es ./data/secrets.d, relativo a la carpeta del archivo de configuración. En la imagen de Docker, esta carpeta es /data/data/secrets.d.

Una clave maestra cifra el almacén. Para ver de dónde viene la clave maestra, abra Detalles en la sección Credenciales. Si la clave maestra es un archivo en el mismo árbol de carpetas que las credenciales guardadas, la aplicación muestra una advertencia. Entonces, cualquier persona que pueda leer esa carpeta puede descifrar las credenciales.

ADVERTENCIA: Si la clave maestra es un archivo junto a los datos, dé la clave mediante LUC_ANALYTICS_SECRET_KEY (una variable de entorno o un secreto de Docker). Una persona que puede leer el archivo de la clave puede leer sus credenciales guardadas.

Eliminar una credencial guardada¶

NOTA: Este procedimiento elimina la credencial solo del almacén cifrado. No elimina una variable de entorno, un secreto de Docker ni un valor del Administrador de credenciales de Windows. Debe eliminarlos en su origen.

En la sección Credenciales, abra Detalles.
Busque la fila de la credencial. La columna Almacén cifrado muestra Guardada, o Guardada, no en uso (una fuente anterior tiene prioridad).
Pulse Eliminar guardada.
Lea el mensaje y pulse OK.
Asegúrese de que la aplicación muestra "Credencial guardada eliminada."

PRECAUCIÓN: No puede deshacer una eliminación. Para usar la credencial otra vez, escríbala y guárdela otra vez.

Fuentes de conjuntos de datos¶

La sección Fuentes de conjuntos de datos indica a la aplicación dónde leer cada uno de los 6 conjuntos de datos: Área de píxel, Bosques naturales SBTN, Cobertura forestal mundial JRC 2020, Alertas de perturbación, Factores de pérdida de cobertura arbórea y Año de pérdida de cobertura arbórea.

Privacidad y coste de leer el bucket del WRI¶

La sección empieza con el aviso Privacidad y coste de leer el bucket del WRI. El aviso le indica estos hechos:

WRI es la fuente de los conjuntos de datos. El aviso tiene un enlace a la página WRI Data Explorer.
Cuando la aplicación lee un conjunto de datos del bucket S3 de WRI, WRI registra la solicitud en sus registros de almacenamiento. Los registros muestran las partes del conjunto de datos que la aplicación solicitó. Así, los registros pueden mostrar las áreas que usted analiza. La aplicación nunca envía las formas de sus ubicaciones.
El bucket de WRI usa el pago por solicitante. Cada solicitud y cada byte que la aplicación transfiere se cargan a su cuenta de AWS. Esto incluye cada descarga.

ADVERTENCIA: Todas las lecturas de datos del bucket de WRI son un cargo a su cuenta de AWS. La aplicación da un coste aproximado de $0.09 por cada GB hacia un equipo fuera de AWS, más una pequeña tarifa por cada lectura. Estos son precios de lista de AWS y pueden cambiar.

Para evitar estas lecturas, descargue una copia de cada conjunto de datos en este equipo. Después de la descarga, los análisis no leen nada de WRI.

Tarjetas de los conjuntos de datos¶

Cada conjunto de datos tiene una tarjeta. La tarjeta muestra una línea En uso:, una palabra de estado y un botón Cambiar. La línea En uso: le indica qué lee ahora el conjunto de datos, por ejemplo "En uso: WRI en línea, lo más reciente — facturado por análisis". La palabra de estado es Actualizado, Hay una versión más reciente, Sin comprobar o Descargando….

Pulse Ver versiones para ir a las versiones de ese conjunto de datos en Versiones de los conjuntos de datos y datos locales.

Cambiar la fuente de un conjunto de datos¶

Cuando pulsa Cambiar, se abre un cuadro de diálogo. El primer paso pregunta "¿De dónde debe venir conjunto de datos?". Puede seleccionar una de 3 opciones:

Opción	Qué hace
WRI en línea, siempre lo más reciente	Cada análisis lee el conjunto de datos del bucket de WRI. Cada análisis es un cargo a su cuenta de AWS.
Descargar una copia en este equipo	La aplicación descarga una copia. Usted paga una vez por la transferencia. Después, los análisis leen la copia sin coste.
Una carpeta que ya tengo (avanzado)	La aplicación lee una carpeta zarr que ya está en este equipo. Nunca escribe en esa carpeta.

La aplicación muestra Recomendado junto a la opción que corresponde a la frecuencia con la que cambia el conjunto de datos. La aplicación no cambia la fuente por sí misma.

Si ninguna clave de AWS superó la comprobación, el cuadro de diálogo añade el paso Añada su clave de AWS. Escriba el ID de clave de acceso y la Clave secreta de acceso y pulse Comprobar esta clave. No puede pulsar Siguiente hasta que la clave supera la comprobación.

Nada cambia hasta que pulsa el último botón del cuadro de diálogo. Para detenerse, pulse Cancelar, pulse × o pulse la tecla Esc.

Descargar una copia en este equipo¶

ADVERTENCIA: Una descarga es un cargo a su cuenta de AWS por la transferencia de datos. Asegúrese de que acepta el coste antes de pulsar Iniciar descarga.

En la tarjeta del conjunto de datos, pulse Cambiar.
Seleccione Descargar una copia en este equipo.
Pulse Siguiente.
Si el cuadro de diálogo pregunta "¿Qué versión de conjunto de datos?", seleccione La más reciente (hay que descargarla) o una copia que ya está en este equipo.
Pulse Siguiente.
Si el cuadro de diálogo pide una clave de AWS, escriba la clave y pulse Comprobar esta clave. Después, pulse Siguiente.
En Destino, escriba una carpeta o pulse Examinar… para seleccionar una carpeta. Consulte El explorador de carpetas.
Asegúrese de que el cuadro de diálogo no muestra "No hay espacio libre suficiente para este conjunto de datos."
Pulse Siguiente.
Seleccione la casilla Entiendo que esta descarga se factura a mi cuenta de AWS.
Pulse Iniciar descarga.

Si selecciona una copia que ya está en este equipo, el cuadro de diálogo pregunta "¿Usar la copia del fecha?". Pulse Usar esta copia. Esto no hace ninguna solicitud y no cuesta nada.

Hasta que la descarga está completa, los análisis siguen leyendo el conjunto de datos de WRI en línea. Cuando la descarga está completa, el conjunto de datos lee la copia local.

Mientras una descarga está en curso, la tarjeta muestra Pausar, Reanudar y Detener. Pausar conserva los archivos que llegaron. Detener le pregunta primero. Si pulsa Detener y descartar, la aplicación elimina la copia parcial, y la descarga siguiente empieza otra vez sin archivos. Pulse Seguir descargando para continuar.

El explorador de carpetas¶

Los campos Destino y Carpeta tienen un cuadro de texto y un botón Examinar…. Puede escribir una ruta de carpeta completa en el cuadro de texto.

Pulse Examinar…. El explorador muestra las Raíces de descarga aprobadas.
Seleccione una carpeta para abrirla.
Para subir un nivel, pulse Subir.
Cuando el explorador muestra la carpeta correcta, pulse Usar esta carpeta.
Para cerrar el explorador sin ningún cambio, pulse Cerrar el explorador.

El explorador muestra solo carpetas. Nunca muestra archivos ni carpetas fuera de una raíz aprobada.

Las descargas van solo a las carpetas de datasets.download_roots en el archivo de configuración. En la imagen de Docker, la raíz de descarga predeterminada es /data/datasets. Si no hay ninguna raíz de descarga configurada, el explorador muestra "No hay raíces de descarga configuradas en este servidor (datasets.download_roots), así que no se puede examinar ni descargar nada."

Para Una carpeta que ya tengo (avanzado), el explorador también muestra las carpetas de datasets.browse_roots con la etiqueta "solo lectura". También puede escribir una carpeta fuera de las raíces. Entonces, la aplicación lee la carpeta pero nunca escribe en ella.

En un servidor en WSL, la aplicación lee una ruta de Windows como D:\data como /mnt/d/data. Si esa unidad no está montada, la aplicación muestra "Esa unidad no está disponible en este servidor (no está montada)."

El encabezado de Fuentes de conjuntos de datos¶

Buscar actualizaciones $ lee el manifiesto de WRI y le indica cuántos conjuntos de datos tienen una versión más reciente. Esto es una solicitud al bucket de WRI. Así, es un pequeño cargo a su cuenta de AWS.
Actualizar todo a lo más reciente descarga la versión más reciente de cada conjunto de datos que lee una copia local. Antes de que empiece la descarga, debe seleccionar la casilla Entiendo que estas descargas se facturan a mi cuenta de AWS.
Guardar esta configuración conserva las opciones actuales de los conjuntos de datos. Volver a esta configuración restablece una configuración guardada.

Avanzado¶

El panel Avanzado en la parte inferior de la sección es para las opciones que el cuadro de diálogo no puede hacer. Para cada conjunto de datos, muestra Tipo de fuente, Ubicación, Pago por solicitante, Usar ruta del manifiesto $, Probar conexión y Guardar fuente.

PRECAUCIÓN: Use el panel Avanzado solo si conoce la ubicación S3 del conjunto de datos. Una ubicación incorrecta da resultados incorrectos o ningún resultado.

Pago por solicitante debe estar activado para el bucket de WRI. Si está desactivado, la aplicación no hace ninguna solicitud con cargo.

Probar conexión en el panel Avanzado abre el almacén del conjunto de datos. Esto es un cargo a su cuenta de AWS. Un resultado correcto empieza con "Conexión correcta." Un resultado fallido empieza con "Conexión fallida:". Las causas son estas:

Resultado	Qué le indica
"Conexión exitosa. ..."	El conjunto de datos se abrió y la aplicación puede leerlo.
Pago por solicitante está desactivado	La credencial es correcta, pero Pago por solicitante está desactivado. Active Pago por solicitante.
AWS rechazó la credencial	La clave fue revocada, es incorrecta o no tiene permiso.
Ninguna credencial de AWS	No hay ninguna clave de AWS disponible. Añada una clave, guárdela y pruebe otra vez.
La credencial guardada no se puede leer	La aplicación no puede descifrar la clave guardada. Escriba la clave otra vez y guarde.
No accesible	Un problema de red o del punto de conexión. No es un problema de la credencial.
No es un almacén Zarr	La ubicación es correcta, pero no tiene ningún almacén Zarr que se pueda leer.
Tiempo agotado	El conjunto de datos no respondió dentro del límite de tiempo.
Ubicación no encontrada	No hay nada en esa ubicación. Pulse Usar ruta del manifiesto $.
Región no coincidente	El bucket está en una región diferente. Cambie `datasets.upstream.region` en `config.yaml`.
AccessDenied	La clave es válida pero no puede leer este bucket. Pulse Comprobar credenciales.
Otro error de AWS	AWS envió un código de error diferente. La línea muestra el código.

Versiones de los conjuntos de datos y datos locales¶

Esta sección muestra cada versión fechada de cada conjunto de datos, dónde la guarda la aplicación y cuánto espacio en disco usa.

La aplicación guarda 3 tipos de copia:

Guardada automáticamente: la aplicación hace estas copias cuando usted ejecuta listas. Cuentan para el Límite de espacio.
Descarga completa: una copia que usted descargó en Fuentes de conjuntos de datos. La aplicación nunca la elimina.
Su propia copia: una copia en una carpeta que usted seleccionó. La aplicación nunca la elimina.

Para cambiar el límite de espacio, escriba un valor de 1 a 10000 en Límite de la caché automática (GB) y pulse Guardar límite. El valor predeterminado es 50 GB.

ADVERTENCIA: Si el límite nuevo es menor que el espacio en uso, la aplicación elimina inmediatamente las capas guardadas más antiguas. Si una ejecución posterior necesita una capa eliminada, la aplicación la descarga otra vez, y eso es un cargo a su cuenta de AWS.

Para eliminar copias, selecciónelas en Versiones por conjunto de datos y pulse Eliminar seleccionadas. Lea la lista del cuadro de diálogo y pulse Eliminar.

Visualizaciones del mapa muestra el espacio en disco que usan los datos de mapa guardados. Escriba un valor en Límite (GB) y pulse Guardar límite. La aplicación conserva los mapas hasta que usted los borra. Para borrar los datos de mapa, use Borrar para las listas seleccionadas… o Borrado completo de todos los datos de mapa….

Memoria¶

La sección Memoria define cuánta memoria puede usar la aplicación. Tiene 4 partes:

1. Entorno: Límite de memoria del host / VM (GB). La aplicación encuentra este valor cuando funciona en un contenedor. Para definir un valor menor, pulse Anular. Para volver, pulse Usar el detectado.
2. Esta aplicación: Reservado para el sistema operativo (GB) y Memoria asignada a la aplicación (GB). La reserva predeterminada es el mayor de 3 GB y el 10% del límite del host. La aplicación también muestra un mínimo recomendado. Hasta que la aplicación mide un valor, el mínimo es 2.0 GB.
3. Cómo se reparte la asignación: una tabla de las partes. No puede cambiar las partes en esta página. Se definen en config.yaml (analysis.memory_shares) y se aplican después de un reinicio.
4. Detalle de renderizado: Máx. de celdas en nativo. Es el número máximo de celdas que puede devolver una vista a resolución nativa.

Para cambiar los valores de memoria:

Escriba los valores nuevos.
Asegúrese de que la sección no muestra ningún error.
Pulse Aplicar.

Los valores se aplican inmediatamente. No tiene que reiniciar la aplicación.

PRECAUCIÓN: Si Memoria asignada a la aplicación (GB) es menor que el mínimo recomendado, un análisis puede fallar. La aplicación muestra una advertencia, pero le permite aplicar el valor.

Idioma¶

El selector de idioma está en la barra superior, a la derecha de ⚙ Configuración. Tiene estos idiomas: English (en), Español (es), Français (fr), Bahasa Indonesia (id) y Português (pt).

Pulse el selector de idioma.
Seleccione un idioma.

La aplicación cambia el idioma inmediatamente. El navegador conserva su selección para la próxima visita.

NOTA: Esta guía también está disponible en los otros idiomas de la aplicación: English, Français, Bahasa Indonesia y Português. Use la guía en el idioma que usted selecciona, para que las etiquetas de la guía sean las mismas que las etiquetas de su pantalla.

El archivo de configuración¶

El archivo de configuración contiene los ajustes que la página Configuración no puede cambiar. En la imagen de Docker, el archivo es /data/config.yaml. La variable de entorno LUC_ANALYTICS_CONFIG puede dar una ruta diferente.

Cuando el contenedor se inicia por primera vez, crea /data/config.yaml a partir de config.example.yaml. Activa las cargas y define la raíz de descarga como /data/datasets. El archivo también activa el proveedor Copernicus. Consulte El mapa base Sentinel-2. El contenedor nunca cambia un archivo de configuración que ya existe.

config.example.yaml contiene cada clave con su valor predeterminado. En la imagen de Docker, /data/config.yaml es una copia completa de ese archivo, y la aplicación lee solo /data/config.yaml. Si elimina una clave de él, la aplicación usa el valor predeterminado del código del programa. Este valor puede ser diferente del valor de config.example.yaml. Por ejemplo, el valor predeterminado del programa para maps.cdse_enabled es false.

NOTA: Si inicia la aplicación sin Docker, con un archivo que tiene el nombre config.yaml, la aplicación lee primero config.example.yaml. Después, los valores de config.yaml reemplazan los valores de config.example.yaml. Le recomendamos que este config.yaml contenga solo las claves que usted cambia.

Estas claves tienen relación con la página Configuración:

Clave	Qué controla
`datasets.download_roots`	Las carpetas a las que pueden ir las descargas. Una lista vacía detiene todas las descargas.
`datasets.browse_roots`	Más carpetas que muestra el explorador de carpetas. La aplicación solo lee estas carpetas.
`datasets.upstream.region`, `datasets.upstream.regions`	La región de AWS de las fuentes S3. El bucket de WRI está en `us-east-1`.
`datasets.upstream.cadence`	Con qué frecuencia cambia cada conjunto de datos. Esto define la opción Recomendado.
`datasets.cost_model`	Los precios que usa la aplicación para calcular el coste de las lecturas S3.
`datasets.zarr_store.max_gb`	El límite de la caché automática (en vivo; predeterminado 50).
`viz.grid_store_max_gb`	El límite de las visualizaciones del mapa (en vivo; predeterminado 2.0).
`analysis.memory_budget_gb`	La memoria asignada a la aplicación (en vivo; predeterminado 1.5).
`analysis.memory_shares`	Las partes de la asignación de memoria.
`analysis.zoom_adaptive.max_cells_ceiling`	Máx. de celdas en nativo (en vivo; predeterminado 200000).
`security.*`	La clave maestra, la carpeta del almacén de secretos, la carpeta de secretos de Docker y los nombres del Administrador de credenciales.
`maps.*`	Los proveedores de mapas base, por ejemplo `maps.cdse_enabled`.
`ingest.upload_enabled`	Cargas activadas o desactivadas.

Una clave con las palabras en vivo en la tabla también puede cambiar en la página Configuración. La página guarda el valor en el archivo de superposición de ejecución (runtime.overlay_path, predeterminado ./data/runtime-overlay.yaml). En la imagen de Docker, este archivo es /data/data/runtime-overlay.yaml. Un valor de la superposición de ejecución tiene prioridad sobre la misma clave de config.yaml. Todas las otras claves se aplican solo después de un reinicio.

Cambiar el archivo de configuración en Docker¶

El archivo /data/config.yaml está en el volumen de Docker, no en su equipo. Para cambiarlo, cópielo fuera del contenedor, cambie la copia y cópiela otra vez dentro. Estos pasos usan el nombre de contenedor luc-analytics de Instalar e iniciar.

ADVERTENCIA: No escriba credenciales en config.yaml. La aplicación no lee credenciales del archivo de configuración. Use la sección Credenciales, variables de entorno, secretos de Docker o el Administrador de credenciales de Windows.

PRECAUCIÓN: No cambie a mano el archivo de superposición de ejecución. Si contiene una clave que no está permitida, la aplicación ignora el archivo completo.

Abra una terminal en una carpeta de su equipo.
Copie el archivo fuera del contenedor:

docker cp luc-analytics:/data/config.yaml config.yaml

Haga una segunda copia de config.yaml con el nombre config.yaml.bak. Consérvela para restablecerla si el cambio falla.
Abra config.yaml en un editor de texto.
Busque la clave en config.example.yaml y copie su nombre exactamente. Para leer config.example.yaml, escriba docker exec luc-analytics cat /app/config.example.yaml.
Cambie el valor. Conserve la sangría de la estructura YAML.
Guarde el archivo.
Copie el archivo otra vez dentro del contenedor:

docker cp config.yaml luc-analytics:/data/config.yaml

Reinicie el contenedor:

docker restart luc-analytics

Escriba docker logs luc-analytics y lea el registro. Si el nombre de una clave es incorrecto, el registro muestra una advertencia con el nombre completo de la clave.

NOTA: docker cp hace que el usuario root sea el propietario del archivo copiado. La aplicación funciona como el usuario 10001 y solo lee /data/config.yaml. Así, no tiene que cambiar el propietario del archivo.

PRECAUCIÓN: Una clave desconocida bajo security detiene la carga de la configuración. Si la aplicación no se inicia después de un cambio, copie config.yaml.bak otra vez dentro del contenedor con docker cp y reinicie el contenedor.