Migración 3scale 2.15 → 2.16¶
Esta página es la guía del Validated Pattern. La versión 1.0.0 del selector es la guía de Kustomize y GitOps, con Vault y External Secrets y sin Pattern CR.
Este repositorio está pensado para administradores de OpenShift y SREs de plataforma que operan 3scale in-cluster y deben pasar de 2.15 a 2.16. Procedimiento de producto y matriz soportada: Migrating Red Hat 3scale API Management 2.16.
Sirve para externalizar PostgreSQL (system) y Redis (system y backend) in-cluster antes de actualizar el operador 3scale a 2.16. Las bases siguen en OpenShift. El operador 3scale deja de gestionarlas al marcar externalComponents.
Un corte de laboratorio suele llevar unas pocas horas cuando el cluster y el almacenamiento RWX ya están listos. En producción el tiempo depende del tamaño de las bases y de la ventana de mantenimiento.
Paquete validado en laboratorio
Las versiones y los valores por defecto de almacenamiento reflejan una migración de lab — ver Versiones probadas. Reconfirmar Supported Configurations y adaptar placeholders (REPLACE_*) y StorageClasses al cluster antes de aplicar manifiestos.
Este repositorio usa el Validated Patterns Operator. No es una declaración de soporte de Red Hat. El entorno probado es AWS: OpenShift 4.19 para la migración 2.15 a 2.16, y OpenShift 4.21 de un nodo para una instalación directa de 2.16.
Qué es este laboratorio¶
Una réplica de PostgreSQL y de cada Redis. No hay alta disponibilidad. Un drain de nodo o un rollout de imagen es un corte. El RPO es el último dump. El RTO es el tiempo de restaurar ese dump. Un paso posterior puede pasar PostgreSQL a un operador con HA y Redis a un servicio gestionado. Este repositorio no implementa ese paso.
El dump de PostgreSQL del laboratorio fue de 719027 bytes. Ese tamaño no es una estimación de producción.
Qué incluye¶
| Área | Ubicación en el repo |
|---|---|
| Pattern CR y values de cada escenario | examples/pattern-cr/, values-*.yaml |
| Charts Helm (APIManager, bases, ExternalSecret) | charts/all/ |
| Runbooks operativos (para clonar) | docs/runbooks/ (ES), docs/runbooks/en/ (EN) |
Ruta rápida¶
- Motivación
- Requisitos previos
- Instalar con un Pattern CR
- Secuencia de migración
- Rotación de credenciales
- Operación día 2 (después del cutover)
Los comandos de este sitio asumen Linux (bash). Para Git Bash en Windows, usar docs/runbooks/01-bis-externalize-postgresql-windows.md y docs/runbooks/02-bis-externalize-redis-windows.md en el repositorio.