Implementar una aplicación

Esta guía explica cómo implementar una aplicación Node.js, Python o Go de ejecución continua en un contenedor dedicado, cómo administrar PHP-FPM y cómo cambiar las versiones de PHP, instalar extensiones y editar php.ini.

#Entornos de ejecución

Cada contenedor incluye los siguientes entornos de ejecución, disponibles en el PATH predeterminado (node, npm, python3, go, java, ruby, php, etc.):

Para ver las versiones exactas, abra la pestaña Gestión de configuración del contenedor y consulte la tarjeta Entorno de ejecución.

#Implementar una aplicación

La pestaña Gestión de apps de la página del contenedor tiene cuatro tarjetas de entornos de ejecución: PHP-FPM, Node.js, Python y Golang. Si aún no se ha implementado ninguna aplicación, las tarjetas de Node.js, Python y Golang muestran el botón Desplegar app.

#Paso 1: Cargar el código

El código debe estar en /var/www/html dentro del contenedor o en un subdirectorio de esa ruta. En la pestaña Administrador de archivos, la raíz / corresponde a /var/www/html del contenedor. Puede cargar un archivo comprimido y extraerlo allí mismo o utilizar Descarga remota para obtenerlo desde una URL. Consulte Archivos y tareas programadas.

Si la aplicación necesita dependencias (por ejemplo, de npm install o pip install), prepare la aplicación localmente y cargue el directorio con las dependencias incluidas.

#Paso 2: Introducir la configuración de inicio

1. Abra la página del contenedor y cambie a la pestaña Gestión de apps.

2. En la tarjeta del entorno de ejecución que necesita, haga clic en Desplegar app.

3. Complete el cuadro de diálogo:

   Campo	Descripción
   Comando de inicio	El comando completo que inicia la aplicación, p. ej., node app.js, npm start, python app.py, gunicorn app:app -b 0.0.0.0:$PORT o ./app
   Directorio de trabajo	El directorio en el que se ejecuta el comando. El valor predeterminado es /var/www/html
   Puerto de escucha	El puerto en el que escucha la aplicación dentro del contenedor. El valor predeterminado es 3000; el rango es 1–65535

4. Haga clic en Desplegar e iniciar. Cuando vea "App desplegada e iniciada", el estado de la tarjeta cambia a En ejecución.

#Cómo se ejecuta el comando de inicio

• El comando se ejecuta mediante /bin/sh -c, por lo que puede pasar argumentos, expandir variables de entorno (como $PORT) y utilizar sintaxis básica de shell.
• La aplicación se ejecuta con el usuario www del contenedor. Asegúrese de que ese usuario pueda leer los archivos de código y escribir en los directorios donde escriba la aplicación.
• Un administrador de procesos dentro del contenedor supervisa la aplicación. La inicia cuando arranca el contenedor y la reinicia automáticamente si termina de forma inesperada.
• Para Go, compile localmente un binario para Linux, cárguelo y utilice un comando como ./app.

#Una aplicación por entorno de ejecución

Cada tarjeta de entorno de ejecución administra un proceso de aplicación. Por ejemplo, la tarjeta Node.js puede ejecutar una aplicación Node.js. Una vez implementada una aplicación, el botón Desplegar app de la tarjeta se sustituye por Iniciar, Detener, Reiniciar y Registros.

#Administrar una aplicación en ejecución

En la pestaña Gestión de apps:

• Iniciar / Detener / Reiniciar controlan el proceso de la aplicación.
• Registros muestra las últimas 200 líneas de stdout y stderr de la aplicación. Haga clic en Actualizar en el cuadro de diálogo para volver a cargarlas.
• Actualizar estado vuelve a cargar todas las tarjetas de entornos de ejecución. Cada tarjeta muestra la versión, el PID y el tiempo de actividad cuando están disponibles.

Si no se ha implementado ninguna aplicación para un entorno de ejecución, su tarjeta muestra Detenido con un botón Desplegar app. Si hace clic en Iniciar en ese momento, se le indica que primero debe implementar una aplicación.

#PHP-FPM

PHP-FPM se ejecuta de forma predeterminada en todos los contenedores, por lo que no necesita implementarlo. La tarjeta PHP-FPM permite detenerlo, iniciarlo o reiniciarlo y consultar sus registros.

#Cambiar la versión de PHP

1. Haga clic en Cambiar versión de PHP. El botón está en Acciones rápidas, en la pestaña Resumen, y en la tarjeta Configuración de PHP de la pestaña Gestión de configuración.
2. Elija PHP 8.1 o PHP 8.2 y haga clic en Confirmar cambio.

PHP-FPM se reinicia automáticamente después del cambio, que afecta a todo el código que utiliza el PHP predeterminado. Compruebe que su código funcione con la versión de destino antes de cambiarla.

#Extensiones y php.ini

Abra la pestaña Configuración de PHP:

• Extensiones de PHP: las extensiones cargadas aparecen como etiquetas verdes. Haga clic en una etiqueta para desactivar esa extensión, pero tenga cuidado con las extensiones esenciales. Para instalar una, escriba su nombre (p. ej., redis, imap, soap, gmp) y haga clic en Instalar. Las extensiones se instalan desde los paquetes oficiales de Alpine.
• php.ini: edite en el navegador el archivo php.ini completo de la versión activa de PHP. Al guardar, PHP-FPM se reinicia en caliente automáticamente.

#Supervisión y acciones del contenedor

• La pestaña Resumen muestra el uso de CPU, memoria y disco y el tráfico de red, además de los límites de CPU, memoria y disco del contenedor.
• Los botones de la parte superior permiten Iniciar, Detener y Reiniciar el contenedor. Mientras el contenedor esté detenido, ninguna de sus aplicaciones estará disponible.
• Puede Eliminar un contenedor desde la lista de contenedores dedicados. Al eliminar un contenedor, se borran permanentemente todos sus datos y no se pueden recuperar.

#Implementar mediante la API

Los endpoints que utiliza la consola también pueden invocarse directamente. Envíe su token de inicio de sesión en el encabezado Authorization: Bearer <token>. container_id es el id que devuelve la lista de contenedores.

# List containers
curl -H "Authorization: Bearer $TOKEN" \
  https://api.yeap.cloud/api/user/host/containers

# Deploy a Node.js app
curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  https://api.yeap.cloud/api/user/host/apps/create \
  -d '{"container_id": 123, "type": "nodejs", "config": "node app.js", "working_dir": "/var/www/html", "port": 3000}'

# App status and recent logs
curl -H "Authorization: Bearer $TOKEN" \
  "https://api.yeap.cloud/api/user/host/apps/status?container_id=123&type=nodejs"
curl -H "Authorization: Bearer $TOKEN" \
  "https://api.yeap.cloud/api/user/host/apps/logs?container_id=123&type=nodejs&lines=200"

type puede ser nodejs, python o golang. Para iniciar, detener o reiniciar, invoque POST /api/user/host/apps/start, /stop o /restart con el cuerpo {"container_id": 123, "type": "nodejs"}.