Glosario¶
Terminología usada en los capítulos. Los nombres de jobs, variables y recursos se conservan en inglés para poder encontrarlos directamente en los repositorios.
| Término | Significado en este proyecto |
|---|---|
| Agent for Kubernetes | Agente instalado en el clúster que conecta GitLab y permite compartir contextos con proyectos autorizados. |
| Artifact | Archivo conservado por un job, como un JAR o un informe. No es sinónimo de imagen publicada. |
| Bootstrap | Preparación inicial de cuentas, permisos, credenciales y recursos que permiten ejecutar la automatización. |
| CI/CD | Integración y entrega/despliegue continuo mediante jobs y reglas. La infraestructura de este proyecto mantiene applies manuales. |
| Commit SHA | Identificador de una revisión Git; aquí también se utiliza como etiqueta de imagen y mensaje de commit de manifiestos. |
| Container Registry | Registro donde se publican y recuperan las imágenes de aplicación. |
| Desired state | Estado deseado de recursos expresado en manifiestos o configuración IaC. |
| Digest | Huella del contenido de una imagen; permite fijar un contenido concreto aunque una etiqueta pueda cambiar. |
| Drift | Diferencia entre lo declarado, el estado registrado y los recursos reales. |
| EKS / GKE | Servicios Kubernetes de AWS y Google Cloud, respectivamente. |
| Environment | Aquí debe distinguirse el parámetro ENVIRONMENT de IaC, el destino cloud y un objeto environment de GitLab. |
| HCL | Lenguaje utilizado para describir las configuraciones Terraform/OpenTofu. |
| HTTP backend | Backend que almacena el estado IaC a través de una API HTTP; aquí se usa GitLab. |
| IaC | Infraestructura como código: configuración versionada de recursos y sus dependencias. |
| Ingress | Objeto Kubernetes de enrutamiento HTTP/HTTPS que requiere un controlador compatible. |
| IRSA | Asociación de una ServiceAccount Kubernetes con un rol IAM en EKS; usada por controladores concretos en AWS. |
| Merge request | Propuesta de cambio revisable en GitLab. Su existencia no implica aprobación obligatoria en todos los pipelines. |
| OpenTofu | Ejecutor IaC utilizado en el pipeline revisado. El proyecto mantiene la estructura de configuraciones Terraform. |
| Plan / apply | Cálculo de cambios y aplicación de esos cambios. Un plan guardado puede quedar obsoleto. |
| Private Service Access | Conexión privada usada por Cloud SQL con la VPC mediante Service Networking. |
| RDS / Cloud SQL | Servicios de base de datos administrada usados para MySQL en AWS y GCP. |
| Resource group | Mecanismo GitLab para excluir ejecuciones concurrentes de jobs con la misma clave; distinto de un grupo cloud. |
| Root module | Directorio IaC inicializado y aplicado como una unidad con su propio estado. Aquí hay ocho. |
| Secret | Objeto Kubernetes para valores sensibles; su acceso y persistencia deben controlarse. |
| State | Registro que relaciona recursos declarados y recursos administrados. No es un backup de datos de aplicación. |
| Workload Identity | Mecanismo de identidad de workloads GKE; habilitar el pool no completa todos los bindings de una aplicación. |
Distinciones importantes¶
Dos proveedores no equivalen a una aplicación distribuida entre ellos. Cada despliegue utiliza su clúster y su base de datos; no se ha implementado sincronización de datos o failover entre nubes.
Tener manifiestos en Git no aporta por sí solo reconciliación continua. En este proyecto el job de aplicación impulsa la entrega mediante el agente. No hay controlador que repare automáticamente cualquier desviación respecto a Git.
Un pipeline correcto no equivale a un servicio verificado. El alcance depende de sus jobs y políticas: aquí faltan espera de rollout y pruebas funcionales posteriores.
Terraform y OpenTofu deben describirse con precisión. La memoria utiliza Terraform para el enfoque y los módulos; el ejecutor revisado es OpenTofu, también citado en la memoria.
Consulta arquitectura, estado y calidad para desarrollar estas distinciones.