Desplegar con Docker Compose

El servicio de Apps te permite desplegar una aplicación usando un archivo docker-compose.yml ubicado en el repositorio. Esto permite ejecutar cualquier tipo de aplicación, incluidas aquellas creadas con frameworks frontend y backend que no son directamente compatibles con el servicio.

Requisitos

• Coloca el archivo docker-compose.yml en la raíz del repositorio.

• No utilices los puertos 80 ni 443 como puertos del host en el manifiesto. Estos puertos están reservados para Nginx.

• El proxy se configura para el primer servicio listado en docker-compose.yml. Otros servicios, si tienen puertos del host definidos, solo serán accesibles a través de esos puertos específicos. Por ejemplo:

 

services:
  my-app:
    ports:
      - "9000:80"
  adminer:
    ports:
      - "8080:8080"

 

En este caso:

• • my-app estará disponible en el dominio principal.
  • adminer estará disponible en http://<dominio>:8080.

Los volúmenes definidos en docker-compose.yml no se conservarán entre despliegues.

Paso 1. Selecciona el Tipo de Aplicación

1. Ve a la sección Plataforma de Apps y haz clic en Crear.
2. Selecciona la pestaña Docker Compose.

Paso 2. Conecta un Repositorio

Selecciona el repositorio que contiene la aplicación. El archivo docker-compose.yml debe estar en la raíz del repositorio.

Puedes conectar un repositorio:

• Desde tu cuenta de GitHub, GitLab o Bitbucket. Haz clic en el nombre de la plataforma, inicia sesión y selecciona el repositorio deseado. Si ya has iniciado sesión, Hostman mostrará automáticamente los repositorios disponibles.

• Por URL, proporcionando un enlace a un repositorio creado en cualquier plataforma. Haz clic en "Conectar repositorio por URL" e introduce la URL Git. Si el repositorio es privado, también ingresa los datos de acceso.

Lee más sobre cómo conectar repositorios aquí.

Paso 3. Selecciona una Rama y Commit

Selecciona una rama para el despliegue.

Por defecto, está activada la opción "Build con el último commit ejecutado". En ese caso, la plataforma desplegará el commit más reciente y reconstruirá automáticamente la aplicación con cada nuevo commit. Si es necesario, puedes desactivar el despliegue automático.

Si deseas seleccionar un commit específico manualmente, desactiva esta opción.

Paso 4. Selecciona la Ubicación y Configuración del Servidor

Tu aplicación debe ejecutarse en un servidor cloud independiente. Elige la región y configuración del servidor.

Podrás actualizar el servidor más adelante, pero no será posible hacer downgrade.

Paso 5. Configura una Red Privada

Ahora puedes agregar la aplicación a una red privada y especificar la dirección IP que utilizará.

Ten en cuenta que no podrás cambiar la red privada después del despliegue.

Paso 6. Configura los Parámetros de Compilación

La plataforma leerá las instrucciones desde docker-compose.yml y construirá la aplicación según lo definido.

En este momento puedes establecer variables si es necesario. Si ya están especificadas en docker-compose.yml o en el Dockerfile, no es necesario duplicarlas. Las variables se usarán en la etapa de compilación del Dockerfile, pero actualmente no se pueden pasar al archivo docker-compose.yml.

Más adelante podrás cambiar cualquiera de estas configuraciones, seleccionar otra rama o commit y reiniciar el despliegue con los nuevos ajustes.

Paso 7. Introduce la Información de la Aplicación

Aquí puedes especificar un nombre y un comentario para tu aplicación, que se mostrará en el panel de Hostman. También puedes seleccionar un proyecto al cual asociarla.

Estas configuraciones también se pueden modificar más adelante.

Paso 8. Desplegar

Haz clic en Iniciar Deploy. Una vez iniciado el proceso, verás el log de despliegue en la pestaña Deploy.

El log de despliegue contiene toda la información necesaria para resolver posibles errores. Si algo sale mal —por ejemplo, por errores en el código— el log mostrará una notificación con la causa.

Cuando despliegas un proyecto por primera vez, la instalación del servidor puede tardar algunos minutos. Una vez finalizado, el estado de la aplicación se actualizará y también verás un mensaje en el log.

¡Todo listo!

Puedes encontrar la dirección IP de la app y el dominio técnico vinculado en la pestaña Dashboard. Para vincular tu propio dominio, sigue esta guía.

La aplicación se ejecuta en los puertos 80 y 443.

En el futuro, la plataforma App supervisará los cambios en el repositorio y, si el despliegue automático está activado, reconstruirá el proyecto automáticamente cuando haya nuevas actualizaciones.