Saltar al contenido principal

🚀 Arranque y Validación de Máquina Virtual para API RIPS (Docker)

Esta guía técnica operativa describe el procedimiento paso a paso para encender, iniciar los contenedores de Docker y verificar la disponibilidad del servicio API RIPS (Resolución 1036 / 2275) en la máquina virtual Ubuntu, indispensable para la validación y transmisión ministerial de la Facturación Electrónica con RIPS en Medifolders.

1. 📋 Propósito y Beneficios​

  • ¿Para qué sirve?: Poner en funcionamiento los microservicios del validador ministerial de RIPS basados en contenedores Docker dentro de una máquina virtual local, permitiendo que el software Gema envíe los archivos JSON normativos directamente a la plataforma del Ministerio de Salud.
  • ¿Quiénes lo utilizan?: Administradores del sistema, personal de soporte técnico de sistemas y coordinadores de facturación y RIPS.
  • Resultado final: API RIPS en estado operativo (Up) con interfaz Swagger / TestApi respondiendo en la red institucional.

2. 🔑 Requisitos Previos​

  • Tener instalado Oracle VM VirtualBox en el servidor o equipo designado para el servicio de RIPS.
  • Máquina virtual UBUNTU2204MV1 previamente importada y configurada con adaptador de red en modo puente (Bridge) o red interna fija.
  • Credenciales de acceso a la máquina virtual:
    • Usuario: DOCKERADMIN
    • Contraseña: TestDocker.24

3. 🖥️ Paso a Paso en Pantalla​

Paso 1: Encendido de la Máquina Virtual en VirtualBox​

  1. En el servidor o equipo principal, abre la aplicación Oracle VM VirtualBox.
  2. En la lista lateral izquierda de máquinas virtuales, selecciona UBUNTU2204MV1.
  3. Haz clic en el botón verde [Iniciar]:

VirtualBox Máquina Ubuntu Figura 1: Selección y arranque de la máquina virtual UBUNTU2204MV1 en VirtualBox.

Paso 2: Inicio de Sesión en Ubuntu​

  1. Espera a que cargue el sistema operativo Ubuntu 22.04.
  2. En la pantalla de bienvenida, selecciona el usuario DOCKERADMIN:

Inicio de Sesión Ubuntu DockerAdmin Figura 2: Ingreso de credenciales de usuario DOCKERADMIN.

  1. Digita la contraseña: TestDocker.24 y pulsa [Enter].

Paso 3: Despliegue de Servicios Docker Compose​

  1. Una vez en el escritorio de Ubuntu, abre la Consola / Terminal de comandos.
  2. Digita exactamente los siguientes comandos en el orden establecido:
cd rips1036/fevripsdockerv2
docker-compose -f apilocal-dockercompose.Production.yml down
docker-compose -f apilocal-dockercompose.Production.yml up -d
docker-compose -f apilocal-dockercompose.Production.yml ps

Comandos Docker Compose en Terminal Figura 3: Ejecución de comandos de reinicio y despliegue del docker-compose de producción.

  1. Verificación de Contenedores: La salida del comando docker-compose ... ps debe mostrar todos los contenedores con estado Up:

Contenedores Docker en Estado Up Figura 4: Verificación de contenedores activos y puertos de escucha asignados.

Paso 4: Validación del Endpoint en el Navegador Web​

  1. Desde cualquier computador conectado a la red de la institución, abre el navegador web (Google Chrome o Microsoft Edge).
  2. Ingresa a la siguiente URL de prueba del servicio: 
    https://192.168.0.246:9443/api/TestApi/Index
    (Si el navegador muestra advertencia de certificado autofirmado por tratarse de una IP local, haz clic en Configuración avanzada > Continuar al sitio).
  3. Comprueba que en pantalla aparezca la respuesta con la versión activa de API-DOCKER:

Validación TestApi en Navegador Figura 5: Pantalla de confirmación con la versión del servicio API-DOCKER en funcionamiento.

[!TIP] Si la página web carga la versión de API-DOCKER correctamente, significa que el servicio ministerial está 100% operativo y listo para recibir las validaciones desde Medifolders.

4. 📝 Guía de Campos y Botones​

Comando / Parámetro¿Qué función cumple?
UBUNTU2204MV1Nombre de la máquina virtual que aloja el entorno Linux del API.
DOCKERADMINUsuario administrador predeterminado de la máquina virtual.
TestDocker.24Contraseña de autenticación del usuario.
cd rips1036/fevripsdockerv2Navega al directorio donde residen los manifiestos de Docker Compose.
docker-compose ... downDetiene y remueve contenedores previos para liberar puertos de red.
docker-compose ... up -dDescarga/inicia los contenedores del API en segundo plano (detached mode).
docker-compose ... psLista el estado de salud y ejecución de cada contenedor.
https://192.168.0.246:9443Dirección IP y puerto seguro HTTPS asignado a la máquina virtual en la red local.

5. 🗺️ Mapa Visual del Proceso​

6. ❓ Preguntas Frecuentes y Alertas en Pantalla​

  1. Verifica que la máquina virtual de VirtualBox continúe encendida y no haya entrado en suspensión o apagado.
  2. En la terminal de Ubuntu, escribe ip addr y confirma que la dirección IP sea efectivamente 192.168.0.246. Si cambió la IP, actualiza la dirección en los parámetros de Gema.
  3. Ejecuta de nuevo docker-compose -f apilocal-dockercompose.Production.yml ps para verificar si algún contenedor se detuvo.

¿Se debe encender esta máquina virtual todos los días?​

Sí, si la institución no cuenta con un servidor dedicado encendido 24/7, la máquina virtual debe iniciarse al comenzar la jornada laboral para que las facturas y atenciones con RIPS puedan validarse y transmitirse oportunamente.