Al final de esta guía tendrás todo para aprovechar la potencia de Kamal en tus proyectos. Comencemos.<\/p>
\n\n\n\n\n\n\n\n
¿Qué es Kamal?<\/h4>\n
Kamal es una herramienta que facilita la implantación eficaz de aplicaciones web. Integra servicios y operaciones esenciales en un flujo de trabajo cohesionado, haciendo que la implementación de aplicaciones web con Kamal sea más ágil y menos propensa a errores. <\/p>\n <\/div>\n\n\n\n<\/p>
Diseñado para gestionar y automatizar, Kamal reduce la complejidad a menudo asociada a la gestión manual de servidores y servicios. Permite a los desarrolladores centrarse en crear y actualizar sus aplicaciones web sin la sobrecarga de la logística.<\/p>
Kamal admite implantaciones que van desde un servidor local a una única máquina virtual. Ofrece implementaciones sin tiempo de inactividad, reinicios continuos, puenteo de activos, compilaciones remotas y gestión integral de servicios accesorios.<\/p>
Con Kamal puedes implementar aplicaciones web, configurar servidores, gestionar bases de datos y equilibrar el tráfico sin esfuerzo. Esta herramienta es compatible con varios entornos, lo que la hace versátil para implementar aplicaciones web en distintas plataformas.<\/p>
¿Por qué utilizar Kamal para el despliegue de aplicaciones web?<\/h3>![\"Portada](\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/32\/2024\/06\/image.png\/public\")
<\/figure>Elegir Kamal ofrece varias ventajas a desarrolladores y empresas:<\/p>
\n- Simplicidad<\/strong>. El enfoque directo de Kamal para la implantación elimina la curva de aprendizaje, a menudo pronunciada, asociada a otras herramientas de implantación. Simplifica el proceso, permitiendo la implementación de aplicaciones con solo unos pocos comandos de Linux<\/a>.<\/li>\n\n\n\n
- Automatización<\/strong>. Agiliza tus flujos de trabajo. Desde las actualizaciones hasta el escalado, Kamal automatiza estas tareas, garantizando que se realicen de forma rápida y coherente. Esto significa menos tiempo en procesos manuales y más en desarrollo.<\/li>\n\n\n\n
- Fiabilidad<\/strong>. Con Kamal puedes esperar versiones estables. Su proceso estructurado minimiza los errores que pueden producirse con la implementación manual, garantizando que tu aplicación web funcione sin problemas y de forma fiable.<\/li>\n\n\n\n
- Idoneidad<\/strong>. Kamal es excepcionalmente compatible con los entornos VPS Linux. Su alineación con los servidores Linux significa que puedes aprovechar todo el potencial y la flexibilidad de implementar aplicaciones en hosting VPS Linux.<\/li>\n<\/ul>
Cómo implementar aplicaciones web con Kamal<\/h2>
En esta sección aprenderás a utilizar Kamal para agilizar el proceso de implementación de tu aplicación web.<\/p>
1. Prepárate para la implementación<\/h3>
Al utilizar una máquina local o un servidor virtual, preparar los requisitos previos garantiza una implementación fluida de la aplicación web con Kamal. En este ejemplo utilizaremos el hosting VPS<\/a> de Hostinger para configurar tu entorno.<\/p>El VPS de Hostinger ofrece un servidor fiable que prepara el escenario para tus necesidades. Proporciona medidas de seguridad de primera categoría, fácil escalabilidad para crecer junto con tu aplicación y Kodee<\/strong>, un asistente con IA, para simplificar tus procesos de desarrollo e implementación.<\/p>![\"\"](\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/32\/2023\/02\/ES-VPS-hosting_in-text-banner.png\/public\")
<\/a><\/figure>Tras preparar tu VPS, accede a tu servidor con PuTTY<\/a> o cualquier otro cliente SSH. Luego, actualiza tus paquetes Linux con los siguientes comandos SSH:<\/p>sudo apt-get update && sudo apt-get upgrade<\/pre>Luego, configura el entorno de software necesario para tu aplicación web, que puede incluir la instalación de un servidor web como Apache o NGINX y la configuración de una base de datos como MySQL o PostgreSQL. También es fundamental asegurar tu servidor con firewall y claves SSH para un acceso seguro.<\/p>
Si estás desarrollando una aplicación Rails, asegúrate de tener instalado el framework Ruby on Rails<\/a>. Si no, puedes instalar Docker<\/a> y gestionar contenedores para tu aplicación.<\/p>2. Instala e implementa con Kamal<\/h3>
Una vez que tu entorno esté listo, procede a la instalación de Kamal. Para quienes dispongan de un entorno Ruby, instala Kamal globalmente en tu VPS Linux con el siguiente comando:<\/p>
gem install kamal<\/pre>Esto hace que Kamal sea accesible desde cualquier directorio de tu servidor.<\/p>
Si prefieres la contenedorización en las implantaciones de Kamal, extrae la imagen Docker y establece un alias en tu archivo de configuración del shell. Esto te permitirá utilizar comandos Kamal sin instalar las dependencias en tu servidor.<\/p>
Luego, navega hasta el directorio config <\/strong>y abre el archivo deploy.yml<\/strong>. Aquí puedes especificar detalles como las etapas de implementación, las direcciones IP públicas y la URL del repositorio para el control de versiones con Kamal.<\/p>Tu archivo deploy.yml <\/strong>también incluirá detalles del registro. Si utilizas Docker Hub, no necesitarás especificar un servidor porque es el predeterminado.<\/p>He aquí un ejemplo básico de lo que podría incluir el contenido de deploy.yml<\/strong>:<\/p># El nombre de tu aplicación web. Se utiliza para configurar de forma única los contenedores.\nservice: hey\n# El host de tu imagen o el nombre de la imagen del contenedor\nimage: 37s\/hey\nservidores:\n - 192.168.0.1\n - 192.168.0.2\nregistry:\n # El servidor de registro de contenedores, si no utilizas Docker Hub\n server: ghcr.io \/ ...\n username: registry-user-name\n password:\n secure: KAMAL_REGISTRY_PASSWORD\nenv:\n secret:\n secure: RAILS_MASTER_KEY\n#Configura un chequeo personalizado\nhealthcheck:\n path: \/healthz\n port: 4000\n max_attempts: 7\n interval: 20s<\/pre><\/p>
Recuerda mantener tus credenciales seguras sustituyendo KAMAL_REGISTRY_PASSWORD <\/strong>por tu token de acceso al registro de Docker.<\/p>Con tu archivo de configuración listo, es hora de iniciar el proceso de implementación. Primero ejecuta:<\/p>
kamal setup<\/pre>Esto prepara tus servidores creando directorios, estableciendo permisos y realizando otras tareas necesarias.<\/p>
Para las implantaciones posteriores, utiliza:<\/p>
kamal deploy<\/pre>Este comando ejecuta las tareas descritas en tu archivo deploy.yml<\/strong>, como actualizaciones de código, migraciones y reinicios de servicios.<\/p>3. Gestiona los archivos de entorno<\/h3>
Para implementar eficazmente tu aplicación web utilizando Kamal, es vital gestionar meticulosamente tus archivos de entorno. Estos archivos contienen variables de entorno fundamentales para configurar tu aplicación en distintos entornos de desarrollo, pruebas y producción.<\/p>
Por razones de seguridad, los archivos ENV <\/strong>de tu aplicación nunca deben incluirse en el control de versiones. En su lugar, aprovecha las sólidas funciones de gestión de entornos de Kamal para transferir estos archivos a tu servidor de forma segura.<\/p>Empieza por asegurar tu archivo de entorno en una ubicación de almacenamiento segura. Considera la posibilidad de utilizar el VPS de Hostinger para gestionar de forma fiable las variables de entorno de tu aplicación, garantizando que se apliquen de forma segura y se mantengan de coherentemente durante toda la implementación.<\/p>
Luego, utiliza el comando kamal env push <\/strong>para transferir el archivo a tu servidor de forma segura.<\/p>Siempre que añadas nuevas variables de entorno o modifiques las existentes en tu archivo ENV<\/strong>, recuerda enviar estas actualizaciones a tus servidores remotos mediante kamal env push<\/strong>. Antes de ejecutar el comando kamal deploy<\/strong>, completa este paso para asegurarte de que tu proceso de implementación incorpore las variables actualizadas al contenedor de tu aplicación.<\/p>Estos procedimientos son fundamentales para hacer funcionar adecuadamente los contenedores Docker<\/a> y servicios, ya que dependen de los ajustes de configuración correctos proporcionados por las variables de entorno.<\/p>4. Ejecuta los comandos en servidores<\/h3>
Para simplificar la gestión de tu aplicación web, Kamal proporciona una función fácil de usar que te permite ejecutar comandos en toda tu infraestructura de servidores de forma eficaz.<\/p>
Por ejemplo, para ejecutar un comando en todos tus servidores para comprobar la versión de Ruby, utilizarías:<\/p>
kamal app exec 'ruby -v'<\/pre>La salida confirmará la versión de Ruby en cada host de la aplicación, por ejemplo:<\/p>
App Host: 192.168.0.1\nruby 3.1.3p185 (2022-11-24 revision 1a6b16756e) [x86_64-linux]\nApp Host: 192.168.0.2\nruby 3.1.3p185 (2022-11-24 revision 1a6b16756e) [x86_64-linux]<\/pre>Para apuntar solo al servidor primario, el comando sería:<\/p>
kamal app exec --primary 'cat .ruby-version'<\/pre>Si necesitas ejecutar un comando relacionado con Rails en todos los servidores, como comprobar la configuración del entorno Rails, introducirás lo siguiente:<\/p>
kamal app exec 'bin\/rails about'<\/pre>El resultado debería ser el siguiente:<\/p>
App Host: 192.168.0.1\nAbout your application's environment\nRails version: 7.1.0.alpha\nRuby version: ruby 3.1.3p185 (2022-11-24 revision 1a6b16756e) [x86_64-linux]\nRubyGems version: 3.3.26\nRack version: 2.2.5\nMiddleware: ActionDispatch::HostAuthorization, Rack::Sendfile, ActionDispatch::Static, ActionDispatch::Executor, Rack::Runtime, Rack::MethodOverride, ActionDispatch::RequestId, ActionDispatch::RemoteIp, Rails::Rack::Logger, ActionDispatch::ShowExceptions, Action Dispatch::DebugExceptions, Action Dispatch::Callbacks, Action Dispatch::Cookies, Action Dispatch::Session::CookieStore, Action Dispatch::Flash, Action Dispatch::ContentSecurityPolicy::Middleware, Action Dispatch::PermissionsPolicy::Middleware, Rack::Head, Rack::ConditionalGet, Rack::ETag, Rack::TempfileReaper\nApplication root: \/rails\nEnvironment: production\nDatabase adapter: sqlite3\nDatabase schema version: 20221231233303<\/pre>Para tareas más interactivas, como iniciar una consola Rails o una sesión bash, Kamal simplifica el proceso. Solo tienes que ejecutar los siguientes comandos para iniciar una sesión bash en un nuevo contenedor de imagen de aplicación o en el contenedor Docker que se esté ejecutando en ese momento:<\/p>
# New container bash session\nkamal app exec -i bash\n# Reuse the current container for bash session\nkamal app exec -i --reuse bash\n# New container Rails console\nkamal app exec -i 'bin\/rails console'<\/pre>5. Comprueba el estado del servidor con los detalles de Kamal<\/h3>
Conocer el estado de tus servidores es crucial para mantener su salud y garantizar que tus aplicaciones funcionen sin problemas. Kamal proporciona una forma eficaz de controlarlo mediante el comando details<\/strong>.<\/p>Ejecutar kamal details <\/strong>te ofrece una snapshot de tus contenedores, su estado y su rendimiento. Esto es lo que verás normalmente:<\/p>Para contenedores Traefik:<\/p>
Traefik Host: 192.168.0.1\nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS\n6195b2a28c81 traefik \"\/entrypoint.sh…\" 30 minutes ago Up 19 minutes 0.0.0.0:80->80\/tcp...<\/pre>Para tus contenedores de aplicaciones:<\/p>
App Host: 192.168.0.1\nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS\nbadb1aa51db3 registry.domain.tld\/... \"\/rails\/bin\/…\" 13 minutes ago Up 13 minutes 3000\/tcp<\/pre>Este resultado te permite verificar rápidamente que los contenedores están en funcionamiento y que los puertos están correctamente asignados, lo que indica un estado saludable del servidor.<\/p>
Para una inspección más centrada, puedes limitar los detalles a contenedores específicos de la aplicación o de Traefik<\/strong> utilizando kamal app details <\/strong>o kamal traefik details<\/strong>, respectivamente.<\/p>Estos comandos específicos proporcionan acceso directo a los registros y a los datos específicos de los contenedores, agilizando el proceso de gestión de las configuraciones del entorno y simplificando la gestión de errores en las implementaciones de Kamal.<\/p>
6. Implementaciones Rollback<\/h3>
Cuando una implementación no sale según lo previsto, Kamal proporciona un sencillo proceso de reversión. Consiste en reactivar un contenedor Docker previamente estable. Para gestionar una reversión rápida y eficaz, sigue estos pasos:<\/p>
En primer lugar, identifica los contenedores antiguos disponibles utilizando el comando kamal app containers<\/strong>. Esto listará tanto los contenedores activos como los inactivos. Busca el último contenedor activo por su etiqueta de imagen o ID antes de la implementación fallida.<\/p>Por ejemplo, puedes ver un resultado que muestre:<\/p>
App Host: 192.168.0.1\nCONTAINER ID IMAGE COMMAND STATUS\n1d3c91ed1f51 [previous_image] \"\/rails\/bin\/docker-e…\" Up 19 minutes\n539f26b28369 [failed_image] \"\/rails\/bin\/docker-e…\" Exited (1) 27 minutes ago<\/pre>Para hacer un rollback, ejecuta kamal<\/strong> rollback [previous_image_tag]<\/strong>. Kamal detendrá el contenedor problemático actual y reiniciará el último contenedor estable. Con el contenedor anterior ya en el host, el rollback se produce rápidamente sin tener que volver a tirar del registro.<\/p>Ten en cuenta que los contenedores antiguos se purgan automáticamente a los tres días de una nueva implantación de kamal<\/strong>, por lo que es aconsejable confirmar el éxito de tu implantación dentro de este plazo para conservar la opción de una rápida reversión.<\/p>También es esencial que te asegures de que tienes las copias de seguridad y recuperación adecuadas con Kamal para protegerte de problemas imprevistos. El alojamiento VPS de Hostinger incluye copias de seguridad automatizadas, mejorando sin problemas tus capacidades de reversión.<\/p>
7. Limpia los servidores con Kamal Remove<\/h3>
Gestionar el espacio y el rendimiento del servidor implica eliminar las aplicaciones que no se utilizan. Con Kamal, limpiar tu servidor es muy sencillo. Para eliminar una aplicación entera, ejecuta el comando kamal remove<\/strong>.<\/p>Luego, Kamal eliminará todos los componentes asociados a la aplicación en el servidor, lo que incluye detener y eliminar los contenedores Docker, borrar cualquier imagen Docker y borrar cualquier sesión de registro asociada.<\/p>
Este comando es útil para garantizar que tu servidor se mantenga despejado y funcione de forma óptima. Sin embargo, es esencial utilizar esta función con precaución. Antes de ejecutar kamal remove<\/strong>, asegúrate de que tienes copias de seguridad de los datos que deseas conservar.<\/p>8. Reinicia Traefik<\/h3>
Cuando gestionas un equilibrador de carga y un proxy inverso, especialmente en un servidor NGINX, puede haber ocasiones en las que necesites reiniciar Traefik, el servicio que enruta tu tráfico HTTP. Esta necesidad suele surgir tras actualizaciones de los argumentos o etiquetas de Traefik, que requieren un reinicio para que los cambios surtan efecto.<\/p>
Para reiniciar Traefik utilizando Kamal, utiliza el siguiente comando:<\/p>
kamal traefik reboot<\/pre>Esto reiniciará el servicio Traefik, implementando tus nuevas configuraciones. Sin embargo, en un entorno de producción, donde la estabilidad y el tiempo de actividad son críticos, opta por la función de reinicio continuo:<\/p>
kamal traefik reboot --rolling<\/pre>Un rolling reboot reinicia metódicamente los contenedores Traefik de forma secuencial, asegurando que no haya tiempo de inactividad y manteniendo la funcionalidad de equilibrio de carga continua. Este enfoque más seguro garantiza que tus aplicaciones web sigan siendo accesibles a los usuarios mientras se realizan las actualizaciones en segundo plano.<\/p>
Buenas prácticas para implementar aplicaciones web con Kamal<\/h2>
Después de aprender a implementar tu aplicación web en un servidor, vamos a explorar algunas de las mejores prácticas con Kamal para una gestión fluida y eficiente de la aplicación web.<\/p>
Automatiza tu flujo de trabajo de implementación<\/h3>
Adoptar la automatización Kamal para las implantaciones transforma las tareas manuales repetitivas en una operación de un solo clic. Los comandos y scripts de Kamal te permiten automatizar la configuración inicial, las actualizaciones y el mantenimiento continuo de tus aplicaciones web, haciendo que el proceso de implementación sea más rápido y fiable al reducir los errores humanos.<\/p>
Integrar las herramientas de automatización en las canalizaciones CI\/CD mejora aun más la eficacia. Estas canalizaciones promueven la mejora continua y las actualizaciones sin fisuras, permitiendo un flujo ininterrumpido desde el desarrollo hasta la implementación.<\/p>
El hosting VPS de Hostinger es ideal para estas prácticas, ya que ofrece un Asistente con IA llamado Kodee<\/strong> que agiliza la automatización de scripts para gestionar y escalar tus aplicaciones web sin esfuerzo. <\/p>Puedes hacerle consultas a Kodee para obtener instrucciones sobre cómo automatizar tu flujo de trabajo.<\/p>
Por ejemplo, inicia una consulta con un prompt como «¿Cómo automatizo las copias de seguridad del servidor de base de datos utilizando Kamal?»<\/p>
<\/figure>Elegir Kamal ofrece varias ventajas a desarrolladores y empresas:<\/p>
- \n
- Simplicidad<\/strong>. El enfoque directo de Kamal para la implantación elimina la curva de aprendizaje, a menudo pronunciada, asociada a otras herramientas de implantación. Simplifica el proceso, permitiendo la implementación de aplicaciones con solo unos pocos comandos de Linux<\/a>.<\/li>\n\n\n\n
- Automatización<\/strong>. Agiliza tus flujos de trabajo. Desde las actualizaciones hasta el escalado, Kamal automatiza estas tareas, garantizando que se realicen de forma rápida y coherente. Esto significa menos tiempo en procesos manuales y más en desarrollo.<\/li>\n\n\n\n
- Fiabilidad<\/strong>. Con Kamal puedes esperar versiones estables. Su proceso estructurado minimiza los errores que pueden producirse con la implementación manual, garantizando que tu aplicación web funcione sin problemas y de forma fiable.<\/li>\n\n\n\n
- Idoneidad<\/strong>. Kamal es excepcionalmente compatible con los entornos VPS Linux. Su alineación con los servidores Linux significa que puedes aprovechar todo el potencial y la flexibilidad de implementar aplicaciones en hosting VPS Linux.<\/li>\n<\/ul>
Cómo implementar aplicaciones web con Kamal<\/h2>
En esta sección aprenderás a utilizar Kamal para agilizar el proceso de implementación de tu aplicación web.<\/p>
1. Prepárate para la implementación<\/h3>
Al utilizar una máquina local o un servidor virtual, preparar los requisitos previos garantiza una implementación fluida de la aplicación web con Kamal. En este ejemplo utilizaremos el hosting VPS<\/a> de Hostinger para configurar tu entorno.<\/p>
El VPS de Hostinger ofrece un servidor fiable que prepara el escenario para tus necesidades. Proporciona medidas de seguridad de primera categoría, fácil escalabilidad para crecer junto con tu aplicación y Kodee<\/strong>, un asistente con IA, para simplificar tus procesos de desarrollo e implementación.<\/p>
<\/a><\/figure>Tras preparar tu VPS, accede a tu servidor con PuTTY<\/a> o cualquier otro cliente SSH. Luego, actualiza tus paquetes Linux con los siguientes comandos SSH:<\/p>
sudo apt-get update && sudo apt-get upgrade<\/pre>
Luego, configura el entorno de software necesario para tu aplicación web, que puede incluir la instalación de un servidor web como Apache o NGINX y la configuración de una base de datos como MySQL o PostgreSQL. También es fundamental asegurar tu servidor con firewall y claves SSH para un acceso seguro.<\/p>
Si estás desarrollando una aplicación Rails, asegúrate de tener instalado el framework Ruby on Rails<\/a>. Si no, puedes instalar Docker<\/a> y gestionar contenedores para tu aplicación.<\/p>
2. Instala e implementa con Kamal<\/h3>
Una vez que tu entorno esté listo, procede a la instalación de Kamal. Para quienes dispongan de un entorno Ruby, instala Kamal globalmente en tu VPS Linux con el siguiente comando:<\/p>
gem install kamal<\/pre>
Esto hace que Kamal sea accesible desde cualquier directorio de tu servidor.<\/p>
Si prefieres la contenedorización en las implantaciones de Kamal, extrae la imagen Docker y establece un alias en tu archivo de configuración del shell. Esto te permitirá utilizar comandos Kamal sin instalar las dependencias en tu servidor.<\/p>
Luego, navega hasta el directorio config <\/strong>y abre el archivo deploy.yml<\/strong>. Aquí puedes especificar detalles como las etapas de implementación, las direcciones IP públicas y la URL del repositorio para el control de versiones con Kamal.<\/p>
Tu archivo deploy.yml <\/strong>también incluirá detalles del registro. Si utilizas Docker Hub, no necesitarás especificar un servidor porque es el predeterminado.<\/p>
He aquí un ejemplo básico de lo que podría incluir el contenido de deploy.yml<\/strong>:<\/p>
# El nombre de tu aplicación web. Se utiliza para configurar de forma única los contenedores.\nservice: hey\n# El host de tu imagen o el nombre de la imagen del contenedor\nimage: 37s\/hey\nservidores:\n - 192.168.0.1\n - 192.168.0.2\nregistry:\n # El servidor de registro de contenedores, si no utilizas Docker Hub\n server: ghcr.io \/ ...\n username: registry-user-name\n password:\n secure: KAMAL_REGISTRY_PASSWORD\nenv:\n secret:\n secure: RAILS_MASTER_KEY\n#Configura un chequeo personalizado\nhealthcheck:\n path: \/healthz\n port: 4000\n max_attempts: 7\n interval: 20s<\/pre>
<\/p>
Recuerda mantener tus credenciales seguras sustituyendo KAMAL_REGISTRY_PASSWORD <\/strong>por tu token de acceso al registro de Docker.<\/p>
Con tu archivo de configuración listo, es hora de iniciar el proceso de implementación. Primero ejecuta:<\/p>
kamal setup<\/pre>
Esto prepara tus servidores creando directorios, estableciendo permisos y realizando otras tareas necesarias.<\/p>
Para las implantaciones posteriores, utiliza:<\/p>
kamal deploy<\/pre>
Este comando ejecuta las tareas descritas en tu archivo deploy.yml<\/strong>, como actualizaciones de código, migraciones y reinicios de servicios.<\/p>
3. Gestiona los archivos de entorno<\/h3>
Para implementar eficazmente tu aplicación web utilizando Kamal, es vital gestionar meticulosamente tus archivos de entorno. Estos archivos contienen variables de entorno fundamentales para configurar tu aplicación en distintos entornos de desarrollo, pruebas y producción.<\/p>
Por razones de seguridad, los archivos ENV <\/strong>de tu aplicación nunca deben incluirse en el control de versiones. En su lugar, aprovecha las sólidas funciones de gestión de entornos de Kamal para transferir estos archivos a tu servidor de forma segura.<\/p>
Empieza por asegurar tu archivo de entorno en una ubicación de almacenamiento segura. Considera la posibilidad de utilizar el VPS de Hostinger para gestionar de forma fiable las variables de entorno de tu aplicación, garantizando que se apliquen de forma segura y se mantengan de coherentemente durante toda la implementación.<\/p>
Luego, utiliza el comando kamal env push <\/strong>para transferir el archivo a tu servidor de forma segura.<\/p>
Siempre que añadas nuevas variables de entorno o modifiques las existentes en tu archivo ENV<\/strong>, recuerda enviar estas actualizaciones a tus servidores remotos mediante kamal env push<\/strong>. Antes de ejecutar el comando kamal deploy<\/strong>, completa este paso para asegurarte de que tu proceso de implementación incorpore las variables actualizadas al contenedor de tu aplicación.<\/p>
Estos procedimientos son fundamentales para hacer funcionar adecuadamente los contenedores Docker<\/a> y servicios, ya que dependen de los ajustes de configuración correctos proporcionados por las variables de entorno.<\/p>
4. Ejecuta los comandos en servidores<\/h3>
Para simplificar la gestión de tu aplicación web, Kamal proporciona una función fácil de usar que te permite ejecutar comandos en toda tu infraestructura de servidores de forma eficaz.<\/p>
Por ejemplo, para ejecutar un comando en todos tus servidores para comprobar la versión de Ruby, utilizarías:<\/p>
kamal app exec 'ruby -v'<\/pre>
La salida confirmará la versión de Ruby en cada host de la aplicación, por ejemplo:<\/p>
App Host: 192.168.0.1\nruby 3.1.3p185 (2022-11-24 revision 1a6b16756e) [x86_64-linux]\nApp Host: 192.168.0.2\nruby 3.1.3p185 (2022-11-24 revision 1a6b16756e) [x86_64-linux]<\/pre>
Para apuntar solo al servidor primario, el comando sería:<\/p>
kamal app exec --primary 'cat .ruby-version'<\/pre>
Si necesitas ejecutar un comando relacionado con Rails en todos los servidores, como comprobar la configuración del entorno Rails, introducirás lo siguiente:<\/p>
kamal app exec 'bin\/rails about'<\/pre>
El resultado debería ser el siguiente:<\/p>
App Host: 192.168.0.1\nAbout your application's environment\nRails version: 7.1.0.alpha\nRuby version: ruby 3.1.3p185 (2022-11-24 revision 1a6b16756e) [x86_64-linux]\nRubyGems version: 3.3.26\nRack version: 2.2.5\nMiddleware: ActionDispatch::HostAuthorization, Rack::Sendfile, ActionDispatch::Static, ActionDispatch::Executor, Rack::Runtime, Rack::MethodOverride, ActionDispatch::RequestId, ActionDispatch::RemoteIp, Rails::Rack::Logger, ActionDispatch::ShowExceptions, Action Dispatch::DebugExceptions, Action Dispatch::Callbacks, Action Dispatch::Cookies, Action Dispatch::Session::CookieStore, Action Dispatch::Flash, Action Dispatch::ContentSecurityPolicy::Middleware, Action Dispatch::PermissionsPolicy::Middleware, Rack::Head, Rack::ConditionalGet, Rack::ETag, Rack::TempfileReaper\nApplication root: \/rails\nEnvironment: production\nDatabase adapter: sqlite3\nDatabase schema version: 20221231233303<\/pre>
Para tareas más interactivas, como iniciar una consola Rails o una sesión bash, Kamal simplifica el proceso. Solo tienes que ejecutar los siguientes comandos para iniciar una sesión bash en un nuevo contenedor de imagen de aplicación o en el contenedor Docker que se esté ejecutando en ese momento:<\/p>
# New container bash session\nkamal app exec -i bash\n# Reuse the current container for bash session\nkamal app exec -i --reuse bash\n# New container Rails console\nkamal app exec -i 'bin\/rails console'<\/pre>
5. Comprueba el estado del servidor con los detalles de Kamal<\/h3>
Conocer el estado de tus servidores es crucial para mantener su salud y garantizar que tus aplicaciones funcionen sin problemas. Kamal proporciona una forma eficaz de controlarlo mediante el comando details<\/strong>.<\/p>
Ejecutar kamal details <\/strong>te ofrece una snapshot de tus contenedores, su estado y su rendimiento. Esto es lo que verás normalmente:<\/p>
Para contenedores Traefik:<\/p>
Traefik Host: 192.168.0.1\nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS\n6195b2a28c81 traefik \"\/entrypoint.sh…\" 30 minutes ago Up 19 minutes 0.0.0.0:80->80\/tcp...<\/pre>
Para tus contenedores de aplicaciones:<\/p>
App Host: 192.168.0.1\nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS\nbadb1aa51db3 registry.domain.tld\/... \"\/rails\/bin\/…\" 13 minutes ago Up 13 minutes 3000\/tcp<\/pre>
Este resultado te permite verificar rápidamente que los contenedores están en funcionamiento y que los puertos están correctamente asignados, lo que indica un estado saludable del servidor.<\/p>
Para una inspección más centrada, puedes limitar los detalles a contenedores específicos de la aplicación o de Traefik<\/strong> utilizando kamal app details <\/strong>o kamal traefik details<\/strong>, respectivamente.<\/p>
Estos comandos específicos proporcionan acceso directo a los registros y a los datos específicos de los contenedores, agilizando el proceso de gestión de las configuraciones del entorno y simplificando la gestión de errores en las implementaciones de Kamal.<\/p>
6. Implementaciones Rollback<\/h3>
Cuando una implementación no sale según lo previsto, Kamal proporciona un sencillo proceso de reversión. Consiste en reactivar un contenedor Docker previamente estable. Para gestionar una reversión rápida y eficaz, sigue estos pasos:<\/p>
En primer lugar, identifica los contenedores antiguos disponibles utilizando el comando kamal app containers<\/strong>. Esto listará tanto los contenedores activos como los inactivos. Busca el último contenedor activo por su etiqueta de imagen o ID antes de la implementación fallida.<\/p>
Por ejemplo, puedes ver un resultado que muestre:<\/p>
App Host: 192.168.0.1\nCONTAINER ID IMAGE COMMAND STATUS\n1d3c91ed1f51 [previous_image] \"\/rails\/bin\/docker-e…\" Up 19 minutes\n539f26b28369 [failed_image] \"\/rails\/bin\/docker-e…\" Exited (1) 27 minutes ago<\/pre>
Para hacer un rollback, ejecuta kamal<\/strong> rollback [previous_image_tag]<\/strong>. Kamal detendrá el contenedor problemático actual y reiniciará el último contenedor estable. Con el contenedor anterior ya en el host, el rollback se produce rápidamente sin tener que volver a tirar del registro.<\/p>
Ten en cuenta que los contenedores antiguos se purgan automáticamente a los tres días de una nueva implantación de kamal<\/strong>, por lo que es aconsejable confirmar el éxito de tu implantación dentro de este plazo para conservar la opción de una rápida reversión.<\/p>
También es esencial que te asegures de que tienes las copias de seguridad y recuperación adecuadas con Kamal para protegerte de problemas imprevistos. El alojamiento VPS de Hostinger incluye copias de seguridad automatizadas, mejorando sin problemas tus capacidades de reversión.<\/p>
7. Limpia los servidores con Kamal Remove<\/h3>
Gestionar el espacio y el rendimiento del servidor implica eliminar las aplicaciones que no se utilizan. Con Kamal, limpiar tu servidor es muy sencillo. Para eliminar una aplicación entera, ejecuta el comando kamal remove<\/strong>.<\/p>
Luego, Kamal eliminará todos los componentes asociados a la aplicación en el servidor, lo que incluye detener y eliminar los contenedores Docker, borrar cualquier imagen Docker y borrar cualquier sesión de registro asociada.<\/p>
Este comando es útil para garantizar que tu servidor se mantenga despejado y funcione de forma óptima. Sin embargo, es esencial utilizar esta función con precaución. Antes de ejecutar kamal remove<\/strong>, asegúrate de que tienes copias de seguridad de los datos que deseas conservar.<\/p>
8. Reinicia Traefik<\/h3>
Cuando gestionas un equilibrador de carga y un proxy inverso, especialmente en un servidor NGINX, puede haber ocasiones en las que necesites reiniciar Traefik, el servicio que enruta tu tráfico HTTP. Esta necesidad suele surgir tras actualizaciones de los argumentos o etiquetas de Traefik, que requieren un reinicio para que los cambios surtan efecto.<\/p>
Para reiniciar Traefik utilizando Kamal, utiliza el siguiente comando:<\/p>
kamal traefik reboot<\/pre>
Esto reiniciará el servicio Traefik, implementando tus nuevas configuraciones. Sin embargo, en un entorno de producción, donde la estabilidad y el tiempo de actividad son críticos, opta por la función de reinicio continuo:<\/p>
kamal traefik reboot --rolling<\/pre>
Un rolling reboot reinicia metódicamente los contenedores Traefik de forma secuencial, asegurando que no haya tiempo de inactividad y manteniendo la funcionalidad de equilibrio de carga continua. Este enfoque más seguro garantiza que tus aplicaciones web sigan siendo accesibles a los usuarios mientras se realizan las actualizaciones en segundo plano.<\/p>
Buenas prácticas para implementar aplicaciones web con Kamal<\/h2>
Después de aprender a implementar tu aplicación web en un servidor, vamos a explorar algunas de las mejores prácticas con Kamal para una gestión fluida y eficiente de la aplicación web.<\/p>
Automatiza tu flujo de trabajo de implementación<\/h3>
Adoptar la automatización Kamal para las implantaciones transforma las tareas manuales repetitivas en una operación de un solo clic. Los comandos y scripts de Kamal te permiten automatizar la configuración inicial, las actualizaciones y el mantenimiento continuo de tus aplicaciones web, haciendo que el proceso de implementación sea más rápido y fiable al reducir los errores humanos.<\/p>
Integrar las herramientas de automatización en las canalizaciones CI\/CD mejora aun más la eficacia. Estas canalizaciones promueven la mejora continua y las actualizaciones sin fisuras, permitiendo un flujo ininterrumpido desde el desarrollo hasta la implementación.<\/p>
El hosting VPS de Hostinger es ideal para estas prácticas, ya que ofrece un Asistente con IA llamado Kodee<\/strong> que agiliza la automatización de scripts para gestionar y escalar tus aplicaciones web sin esfuerzo. <\/p>
Puedes hacerle consultas a Kodee para obtener instrucciones sobre cómo automatizar tu flujo de trabajo.<\/p>
Por ejemplo, inicia una consulta con un prompt como «¿Cómo automatizo las copias de seguridad del servidor de base de datos utilizando Kamal?»<\/p>
- Automatización<\/strong>. Agiliza tus flujos de trabajo. Desde las actualizaciones hasta el escalado, Kamal automatiza estas tareas, garantizando que se realicen de forma rápida y coherente. Esto significa menos tiempo en procesos manuales y más en desarrollo.<\/li>\n\n\n\n