Referencia de configuración¶
Esta página reúne el contrato de las aplicaciones y sus pipelines. Las entradas HCL, las credenciales cloud y las variables del backend HTTP se detallan en variables de infraestructura.
Variables CI de aplicación¶
| Variable | Origen o valor observado | Uso y alcance |
|---|---|---|
CD_DEPLOY_USER |
Variable externa | Usuario de la identidad que lee/escribe el repositorio de manifiestos |
CD_DEPLOY_TOKEN |
Secreto externo | Autenticación de Git con capacidad de push; su nombre no implica Deploy Token |
CD_PROJECT_PATH |
YAML de cada aplicación | URL HTTPS autenticada del repositorio de manifiestos correspondiente |
ENABLE_QUALITY |
true en ambas aplicaciones |
Activa Code Quality y su resumen cuando la referencia está protegida |
ENABLE_SECURITY |
true en ambas aplicaciones |
Activa secretos, contenedores y sus resúmenes; no modifica por sí sola las reglas SAST heredadas |
DEPLOY_TARGET |
gke en aplicaciones; eks en plantilla |
Selecciona un contexto de despliegue |
EKS_KUBE_CONTEXT |
<group>/terraform-modules:eks-agent |
Contexto AWS compartido por el agente |
GKE_KUBE_CONTEXT |
<group>/terraform-modules:gke-agent |
Contexto GCP compartido por el agente |
K8S_NAMESPACE |
app |
Namespace de aplicación |
CS_SEVERITY_THRESHOLD |
HIGH |
Severidad mínima del informe de contenedores |
SECRET_DETECTION_HISTORIC_SCAN |
true |
Solicita escaneo histórico de secretos |
Guardar credenciales fuera del YAML, con el alcance y protección de rama necesarios. Validar que las variables protegidas están disponibles en el contexto de ejecución previsto. Las configuraciones privadas de variables, roles y runners no pueden deducirse completamente del repositorio público.
Variables suministradas por GitLab¶
CI_REGISTRY, CI_REGISTRY_IMAGE, CI_REGISTRY_USER y CI_REGISTRY_PASSWORD conectan con el registro. CI_COMMIT_SHA, CI_COMMIT_REF_SLUG, CI_COMMIT_BRANCH y CI_COMMIT_REF_PROTECTED participan en el etiquetado y las reglas. GITLAB_USER_NAME y GITLAB_USER_EMAIL se usan como autor del commit de manifiestos; la identidad que autentica el push es la de las credenciales CD.
El agente proporciona KUBECONFIG a los proyectos autorizados. No se ha encontrado un fichero kubeconfig de producción versionado. Evitar sustituir estas variables predefinidas con valores estáticos al copiar el proyecto.
Configuración de runtime¶
| Variable | Valor por defecto / procedencia | Consumidor |
|---|---|---|
REST_PORT |
8080 | Servidor backend |
REST_DB_HOST |
Secret rest, generado desde infraestructura |
Dirección de RDS o Cloud SQL |
REST_DB_PORT |
Secret rest; 3306 por defecto de infraestructura |
Puerto MySQL |
REST_DB_DATABASE |
Secret rest; nombre configurado de BD |
Esquema de aplicación |
REST_DB_USER |
Secret rest |
Usuario de BD |
REST_DB_PASSWORD |
Secret rest |
Contraseña de BD |
REST_LOGGING_ROOT |
info |
Nivel de log backend |
REST_LOGGING_CANALS |
info |
Log de paquetes propios backend |
WEB_PORT |
8080 | Servidor frontend |
WEB_REST_URL |
Configuración: http://rest:8080; Deployment: vacío |
Base de los endpoints usados por el navegador |
WEB_LOGGING_ROOT |
INFO |
Log raíz frontend |
WEB_LOGGING_CANALS |
INFO |
Log de paquetes propios frontend |
WEB_LOGGING_SPRING |
INFO |
Log Spring frontend |
LANG, LC_ALL |
es_ES.UTF-8 en Deployment |
Locale solicitado por el contenedor frontend |
Los Secrets inyectados como variables de entorno se leen al arrancar el contenedor. Si cambia el Secret de base de datos, comprobar la política de reinicio y la coordinación con la contraseña real de la base de datos; no asumir que un proceso existente recarga los valores.
Matriz de destinos¶
| Capa | AWS | Google Cloud |
|---|---|---|
| Infraestructura | CLOUD_PROVIDER=aws |
CLOUD_PROVIDER=gcp |
| Aplicación | DEPLOY_TARGET=eks |
DEPLOY_TARGET=gke |
| Agente | eks-agent |
gke-agent |
| Base de datos | RDS privado | Cloud SQL con IP privada |
| Ingress versionado | AWS ALB | No hay variante GKE confirmada |
No se define una variable compartida que sincronice automáticamente las dos primeras filas. ENVIRONMENT pertenece al pipeline de infraestructura; no configura una promoción dev/pre/pro de la aplicación.
Configuración de este sitio¶
La herramienta de construcción obtiene la URL publicada de CI_PAGES_URL y permite una URL base explícita al construir localmente. Los detalles, comandos y opciones exactas se encuentran en publicación. El sitio no necesita ninguna de las credenciales cloud anteriores.