Servidores y aplicaciones

Servidores lista las máquinas en las que la empresa corre sus proyectos, y Aplicaciones de servidor lista las aplicaciones web instaladas en ellas, una por proyecto y ambiente. Desde la página de una aplicación puedes configurarla en Ploi, la herramienta que administra los servidores, y seguir la configuración paso a paso.

Los dos están en el grupo Infraestructura del menú lateral, y cada uno aparece solo si te han dado acceso a él. Los super administradores también tienen herramientas de Ploi en el área de administración, descritas en Sincroniza usuarios con Ploi y La herramienta env de Ploi.

Servidores

Un servidor tiene:

• Nombre e IP, los dos obligatorios.
• Enlace de base de datos, el enlace para administrar sus bases de datos.
• Proveedor, también obligatorio: Linode o Hetzner.
• Ploi Id, el identificador del servidor en Ploi. Una aplicación no se puede configurar en Ploi hasta que su servidor tenga uno.

La página de un servidor también lista sus Aplicaciones web.

Agrega una aplicación web

1. Abre Aplicaciones de servidor y haz clic en Crear Aplicación del servidor.
2. Elige el Servidor y el Proyecto.
3. Elige el Ambiente de desarrollo: Producción, Staging o Desarrollo.
4. Escribe el Dominio y, si la aplicación guarda archivos ahí, el Bucket de AWS S3.
5. Haz clic en Agregar Aplicación del servidor.

Un proyecto solo puede tener una aplicación por ambiente en cada servidor. Si ya tiene una, verás Este proyecto ya tiene una aplicación web para el entorno seleccionado en este servidor.

Las licencias se eligen después. Edita la aplicación para indicar:

• Licencia, la licencia de hosting del proyecto.
• Licencia de AWS, la licencia de almacenamiento de archivos del proyecto.

Cada una ofrece solo licencias de ese proyecto: Licencia las que tienen un servicio cuyo nombre incluye la palabra "hosting", y Licencia de AWS las que tienen un servicio cuyo nombre incluye la palabra "espacio". Consulta Clientes, servicios y licencias para ver cómo se llevan las licencias. Ploi Id e Id de la base de datos también se muestran al editar; se llenan cuando la aplicación se configura en Ploi.

Revisión semanal del almacenamiento

Cada domingo a medianoche, hora de la Ciudad de México, se mide el bucket de cada aplicación que tiene tanto Bucket de AWS S3 como Licencia de AWS. El espacio que puede usar es el número de GB del nombre de su Licencia de AWS, como 10 para una licencia llamada "Simple 10GB". Se publica un mensaje en el canal de operaciones de la empresa en Slack cuando:

• el bucket existe pero la Licencia de AWS está cancelada o su Fecha de Fin ya llegó, para que revises si hay que eliminar el bucket;
• el bucket usa más GB de los que permite su licencia.

Un bucket que no existe no envía ningún mensaje.

Qué pasa al guardar o eliminar una aplicación

Esto solo pasa cuando el servidor de la aplicación tiene Ploi Id:

• Una vez que la aplicación tiene Ploi Id e Id de la base de datos, cambiar su Servidor, Proyecto, Ambiente de desarrollo, Ploi Id o Id de la base de datos les da a las personas con acceso a la base de datos del proyecto su usuario en esa base de datos. También pasa cuando la configuración en Ploi llena esos dos campos.
• Eliminar una aplicación creada ese mismo día y ya configurada en Ploi también elimina su sitio y su base de datos en Ploi. Eliminar cualquier otra aplicación solo quita el acceso de las personas a su base de datos; su sitio y su base de datos se quedan en Ploi.

Configura una aplicación en Ploi

1. Abre la aplicación.
2. Haz clic en Ejecutar en Ploi.

La configuración empieza de inmediato, sin confirmación. Antes de empezar comprueba que todo lo que necesita está listo, y se detiene con un mensaje cuando falta algo:

• El servidor seleccionado debe tener un Ploi ID antes de ejecutar deploy
• El proyecto debe tener un repositorio de GitLab antes de ejecutar deploy
• El proyecto debe tener un canal de Slack antes de ejecutar deploy
• Para un proyecto de cualquier cliente que no sea el primer registro de cliente, el de la propia empresa (un proyecto de otro cliente marcado como Es interno también necesita estas licencias):
  • Debes definir la licencia de AWS cuando la aplicación tiene un bucket de S3, cuando la aplicación tiene Bucket de AWS S3 pero no tiene Licencia de AWS.
  • En Producción: Debes definir la licencia de AWS para aplicaciones de producción y Debes definir la licencia de hosting para aplicaciones de producción.
• La licencia seleccionada no es válida; debe decir Simple o Max, cuando el nombre de la licencia de hosting no incluye ninguna de esas palabras.
• La licencia de AWS seleccionada no es válida; debe incluir la capacidad en GB, cuando el nombre de la licencia de almacenamiento no indica su tamaño en GB.

Puedes volver a ejecutarla cuando quieras. Los pasos ya hechos se confirman en lugar de hacerse dos veces. Cada ejecución también deja una entrada Ploi deploy requested, con la persona que hizo clic, en el registro de actividad del área de administración.

Cuando la configuración conecta el repositorio de GitLab del proyecto, también le agrega un webhook, para que cada push a la rama del ambiente despliegue el sitio en Ploi: master para Producción, staging para Staging y develop para Desarrollo. Volver a ejecutar la configuración conserva ese único webhook en lugar de agregar otro. Cuando el webhook no se puede agregar, la configuración sigue sin él y el registro de actividad dice por qué; vuelve a ejecutar Ejecutar en Ploi para reintentarlo. Una aplicación configurada antes de que esto existiera recibe su webhook la próxima vez que ejecutes Ejecutar en Ploi en ella.

Sigue la configuración

El Monitor de deploy en Ploi en la página de la aplicación muestra cómo va la configuración, y se actualiza solo mientras corre:

• Estado: inactivo, pendiente, ejecutando, completado o fallido.
• Paso actual y cuándo se actualizó por última vez, en Actualizados.
• Pasos de despliegue, cada uno con su propio estado: Confirmar sitio y repositorio, Confirmar base de datos, Reintentar creación de base de datos, Sincronizar usuarios de la base de datos, Configurar .env, Configurar script de deploy, Finalizar script de deploy, Configurar worker de cola, Configurar scheduler, Aplicar configuraciones finales de Ploi y Configurar SSL. Un paso muestra pendiente, en cola, ejecutando, completado o fallido; Configurar SSL muestra omitido cuando no hizo falta.
• Registro de ejecución, cada mensaje de la ejecución con su hora.

Cuando la configuración falla, Diagnóstico de la falla indica qué salió mal y, cuando los conoce:

• Paso, dónde falló.
• Endpoint y Método, la petición a Ploi que falló.
• Valor intentado y Rama intentada, lo que se envió.
• Esperado y Actual, lo que Ploi debía responder y lo que respondió.
• Qué revisar antes de volver a ejecutarla.

El monitor conserva una ejecución durante 6 horas desde su última actualización mientras avanza, y durante 12 horas cuando ya terminó o falló. Después vuelve a mostrar inactivo, sin pasos ni registro.