View a markdown version of this page

(Opcional) Uso de variables de entorno para configurar AWS AppConfig Agente para Amazon ECS y Amazon EKS - AWS AppConfig

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

(Opcional) Uso de variables de entorno para configurar AWS AppConfig Agente para Amazon ECS y Amazon EKS

Puede configurar el AWS AppConfig agente cambiando las siguientes variables de entorno para su contenedor de agentes.

nota

La siguiente tabla incluye una columna de valores de muestra. En función de la resolución del monitor, es posible que tenga que desplazarse hasta la parte inferior de la tabla y, a continuación, hacia la derecha para ver la columna.

Variable de entorno Details Predeterminado Valores de muestra

ACCESS_TOKEN

Esta variable de entorno define un token que se debe proporcionar al solicitar datos de configuración al servidor HTTP del agente. El valor del token debe estar establecido en el encabezado de autorización de la solicitud HTTP con un tipo de autorización de Bearer. A continuación se muestra un ejemplo.

GET /applications/my_app/... Host: localhost:2772 Authorization: Bearer <token value>
Ninguno MyAccessToken

BACKUP_DIRECTORY

Esta variable de entorno permite al AWS AppConfig Agente guardar una copia de seguridad de cada configuración que recupera en el directorio especificado.

importante

Las configuraciones con copia de seguridad en el disco no están cifradas. Si su configuración contiene datos confidenciales, le AWS AppConfig recomienda que aplique el principio de privilegios mínimos con los permisos del sistema de archivos. Para obtener más información, consulte Seguridad en AWS AppConfig.

Ninguno //copias path/to de seguridad

EXPERIMENT_ASSIGNMENT_LOG_DESTINATION

Esta variable de entorno permite al AWS AppConfig agente registrar los registros de asignación de experimentos, que capturan cada caso en el que se asigna un tratamiento experimental a una entidad determinada en un momento dado. Valores posibles: file:<path>/ indica un directorio base en el que se escriben los registros de asignación en el disco; stderr indica que los registros de asignación se envían a stderr. Esta función requiere la versión AWS AppConfig 2.0.175233 del agente o una posterior.

Ninguno

file:/tmp/aws-appconfig/assignments/

stderr

HTTP_PORT

Esta variable de entorno especifica el puerto en el que se ejecuta el servidor HTTP del agente.

2772 2772

HTTP_HOST

La variable HTTP_HOST controla la forma en que el AWS AppConfig agente se une a las interfaces de red. El comportamiento de enlace difiere según el entorno de ejecución para garantizar una seguridad y accesibilidad óptimas.

HECKS, EKS

  • Enlace predeterminado: todas las interfaces de red (0.0.0.0)

EC2 y local

  • Enlace predeterminado: solo localhost

  • Dirección IPv4:127.0.0. 1:2772

  • Dirección IPv6: [::1] :2772

Opciones de configuración personalizadas. Puede anular el comportamiento predeterminado con estos valores:

  • all(se vincula a todas las interfaces)

  • localhost(se vincula explícitamente a las interfaces localhost)

  • Dirección IP específica (p. ej.192.168.1.1)

  • Nombre de host personalizado

LOG_LEVEL

Esta variable de entorno especifica el nivel de detalle que registra el agente. Cada nivel incluye el nivel actual y todos los niveles superiores. El valor distingue entre mayúsculas y minúsculas. Del más detallado al menos detallado, los niveles de registro son: trace, debug, info, warn, error, fatal y none. El registro de trace incluye información detallada sobre el agente, incluida la información sobre el tiempo.

info

rastro

debug

info

aviso

error

fatal

none

LOG_PATH

La ubicación del disco en la que se escriben los registros. Si no se especifica, los registros se escriben en stderr.

Ninguno

/path/to/.log logs/agent

MANIFEST

Esta variable de entorno configura el AWS AppConfig Agente para que aproveche las funciones adicionales por configuración, como la recuperación de múltiples cuentas y el almacenamiento de la configuración en el disco. Para obtener más información sobre el uso de estas características, consulte Uso de un manifiesto para habilitar características de recuperación adicionales.

Ninguno

Al usar AWS AppConfig la configuración como manifiesto:. MyApp:MyEnv:MyManifestConfig

Cuando se carga el manifiesto desde el disco: file:/path/to/manifest.json

MAX_CONNECTIONS

Esta variable de entorno configura el número máximo de conexiones que el agente utiliza para recuperar las configuraciones de AWS AppConfig.

3 3

POLL_INTERVAL

Esta variable de entorno controla la frecuencia con la que el agente AWS AppConfig busca datos de configuración actualizados. Puede especificar un número de segundos para el intervalo. También puede especificar un número con una unidad de tiempo: s para segundos, m para minutos y h para horas. Si no se especifica una unidad, el agente ejecuta de forma predeterminada los segundos. Por ejemplo, 60, 60s y 1m dan como resultado el mismo intervalo de sondeo.

45 segundos

45

45 s

5 m

1 h

PREFETCH_LIST

Esta variable de entorno especifica los datos de configuración que el agente solicita en AWS AppConfig cuanto se inicia. Si hay varios identificadores de configuración, se pueden presentar en una lista separada por comas.

Ninguno

MyApp:MyEnv:MyConfig

abcd123:efgh456:ijkl789

MyApp:MyEnv:Config1,MyApp:MyEnv:Config2

PRELOAD_BACKUPS

Si se establece entrue, el AWS AppConfig agente carga en la BACKUP_DIRECTORY memoria las copias de seguridad de la configuración que se encuentran en ella y comprueba inmediatamente si existe una versión más reciente del servicio. Si se configura en false, el agente de AWS AppConfig solo carga el contenido de una copia de seguridad de la configuración si no puede recuperar los datos de configuración del servicio, por ejemplo, si hay un problema con la red.

true

true

false

PROXY_HEADERS Esta variable de entorno especifica los encabezados que requiere el proxy al que se hace referencia en la variable de entorno PROXY_URL. El valor es una lista de encabezados separados por comas. Ninguno

encabezado: valor

h1: v1, h2: v2

PROXY_URL Esta variable de entorno especifica la URL del proxy que se utilizará para las conexiones desde el agente a Servicios de AWS, incluso AWS AppConfig. HTTPSy se admiten HTTP las URL. Ninguno

http://localhosty se admiten las URL. ----sep----:7474

https://my-proxy.example.com

REQUEST_TIMEOUT

Esta variable de entorno controla la cantidad de tiempo durante el que el agente espera una respuesta. AWS AppConfig Si el servicio no responde, se produce un error en la solicitud.

Si la solicitud se emplea para la recuperación inicial de datos, el agente devuelve un error a su solicitud.

Si el tiempo de espera se agota cuando se está comprobando en segundo plano si hay datos actualizados, el agente registra el error y lo vuelve a intentar tras un breve retraso.

Puede especificar el número de milisegundos del tiempo de espera. También puede especificar un número con una unidad de tiempo: ms para milisegundos y s para segundos. Si no se especifica una unidad, el valor predeterminado del agente es milisegundos. Por ejemplo, 5000, 5000ms y 5s dan como resultado el mismo valor de tiempo de espera de la solicitud.

3000 ms

3 000

3000 ms

5 s

ROLE_ARN Esta variable de entorno especifica el nombre de recurso de Amazon (ARN) de un rol de IAM. AWS AppConfig El agente asume este rol para recuperar los datos de configuración. Ninguno arn:aws:iam: :123456789012: role/MyRole
ROLE_EXTERNAL_ID Esta variable de entorno especifica el ID externo que se utilizará con el ARN del rol asumido. Ninguno MyExternalId
ROLE_SESSION_NAME Esta variable de entorno especifica el nombre de la sesión que se va a asociar a las credenciales del rol de IAM asumido. Ninguno AWSAppConfigAgentSession
SERVICE_REGION Esta variable de entorno especifica una alternativa que el agente utiliza para llamar al servicio. Región de AWS AWS AppConfig AWS AppConfig Si no se define, el agente intenta determinar la región actual. Si no puede, el agente no podrá iniciarse. Ninguno

us-east-1

eu-west-1

WAIT_ON_MANIFEST

Esta variable de entorno configura al AWS AppConfig Agente para que espere hasta que se procese el manifiesto antes de completar el inicio.

true

true

false