AimsMobileOperator

Description

# AIMS Mobile Operator

Bienvenido al AIMS Mobile Operator. Este operador gestiona el despliegue y el ciclo de vida de la aplicación AIMS Mobile en clústeres de OpenShift. Automatiza la instalación, configuración y mantenimiento de todos los microservicios necesarios, incluyendo `adminApp`, `mainService` y `dbService`.

## Requisitos Previos

Antes de comenzar, asegúrate de tener:
1.  Acceso a un clúster de OpenShift 4.14 o superior.
2.  La herramienta de línea de comandos `oc` instalada y configurada.
3.  Permisos de administrador sobre un proyecto (namespace) en el clúster.
4.  Credenciales de acceso (usuario y contraseña/token) para el registro de imágenes privado `quay.io/microsafe_app_ban`.

---

## Proceso de Instalación

El despliegue se realiza en 4 pasos guiados:

### Paso 1: Crear un Proyecto (Namespace)
Se recomienda instalar la aplicación en su propio proyecto para mantener todo organizado.

```bash
# Reemplaza 'aims-mobile-app' con el nombre que prefieras para tu proyecto
oc new-project aims-mobile-app
```

### Paso 2: Preparar la Configuración y los Secretos de la Aplicación
Descarga los archivos de plantilla `configmaps-template.yaml` y `secrets-template.yaml` de este repositorio.

1.  **Rellena las Plantillas:** Abre cada archivo y reemplaza los valores de marcador de posición (ej. `PON_AQUI_TU_PASSWORD`) con los valores reales de tu entorno. Asegúrate de que el campo `metadata.namespace` en cada recurso coincida con el nombre de tu proyecto (ej. `aims-mobile-app`).

2.  **Aplica las Plantillas:**
   ```bash
   # Aplica el archivo con las configuraciones no sensibles
   oc apply -f configmaps-template.yaml

   # Aplica el archivo con los secretos y datos sensibles
   oc apply -f secrets-template.yaml
   ```

### Paso 3: Instalar el Operador desde OperatorHub

1.  En la consola web de OpenShift, navega a **OperatorHub** desde la perspectiva de **Administrator**.
2.  En el campo de búsqueda, escribe `AIMS Mobile Operator` y selecciónalo.
3.  Haz clic en el botón **Install**.
4.  En la página de instalación:
   * Elige el modo de instalación **"A specific namespace on the cluster"**.
   * Selecciona tu proyecto (`aims-mobile-app`) de la lista desplegable.
   * Acepta las opciones por defecto y haz clic en **Install**.
5.  Espera a que el estado del operador muestre **"Succeeded"**.

### Paso 4: Crear una Instancia de AIMS Mobile
Ahora que el operador está instalado y esperando, dale la orden de desplegar la aplicación.

1.  Navega a **Installed Operators** y haz clic en **AIMS Mobile Operator**.
2.  Ve a la pestaña **"AimsMobile"** y haz clic en **"Create AimsMobile"**.
3.  Cambia a la vista **YAML**.
4.  Pega la siguiente configuración. Este es el Recurso Personalizado (CR) que le dice al operador qué hacer.

   ```yaml
   apiVersion: cache.microsafe.com.mx/v1alpha1
   kind: AimsMobile
   metadata:
     # Dale un nombre a tu instalación
     name: aims-mobile-produccion
     # Asegúrate que el namespace sea el correcto
     namespace: aims-mobile-app
   spec:
     # --- Configuración General ---
     # Aquí puedes ajustar valores simples como el número de réplicas
     adminApp:
       replicas: 1
     mainService:
       replicas: 2
     dbService:
       replicas: 1