![\"\"](\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/46\/2022\/12\/Linux-cheat-sheet-FR-1024x283-1.png\/public\")
<\/a><\/figure>\n\n\n\n\n\n
Qu'est-ce que Kamal ?<\/h2>\n
Kamal est un outil de déploiement qui facilite le déploiement efficace des applications web. Il intègre les services et les opérations essentiels dans un flux de travail cohérent, ce qui rend le déploiement d’applications web avec Kamal plus rationnel et moins sujet aux erreurs.<\/p>\n <\/div>\n\n\n\n<\/p>
Conçu pour gérer et automatiser le déploiement des applications web, Kamal réduit la complexité souvent associée à la gestion manuelle des serveurs et des services. Il permet aux développeurs de se concentrer sur la création et la mise à jour de leurs applications web sans avoir à se préoccuper de la logistique de déploiement.<\/p>
Kamal prend en charge des déploiements allant d’un serveur métallique nu à une simple machine virtuelle. Il offre des déploiements sans temps d’arrêt, des redémarrages en continu, des ponts d’actifs, des constructions à distance et une gestion complète des services accessoires.<\/p>
Avec Kamal, vous pouvez déployer sans effort des applications web, configurer des serveurs, gérer des bases de données et équilibrer le trafic. Cet outil prend en charge divers environnements, ce qui le rend polyvalent pour le déploiement d’applications web sur différentes plateformes.<\/p>
Pourquoi utiliser Kamal pour le déploiement d’applications Web ?<\/h3>\n![\"Page](\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/46\/2024\/04\/image-15.png\/public\")
<\/figure><\/div>Choisir Kamal pour le déploiement de votre application web offre plusieurs avantages aux développeurs et aux entreprises. Voici ce qui distingue Kamal :<\/p>
\n- Simplicité <\/strong>– L’approche directe de Kamal en matière de déploiement permet d’éviter la courbe d’apprentissage souvent abrupte associée à d’autres outils de déploiement. Il simplifie le processus en permettant le déploiement d’applications à l’aide de quelques commandes Linux<\/a> seulement.<\/li>\n\n\n\n
- Automatisation <\/strong>– L’automatisation de Kamal pour les déploiements rationalise vos flux de travail. Des mises à jour à la mise à l’échelle, Kamal automatise ces tâches, garantissant qu’elles sont accomplies rapidement et de manière cohérente. Cela signifie moins de temps pour les processus manuels et plus de temps pour le développement.<\/li>\n\n\n\n
- Fiabilité <\/strong>– avec Kamal, vous pouvez vous attendre à des versions stables. Son processus de déploiement structuré minimise les erreurs qui peuvent survenir lors de déploiements manuels, garantissant ainsi le bon fonctionnement et la fiabilité de votre application web.<\/li>\n\n\n\n
- Adéquation <\/strong>– Kamal est exceptionnellement compatible avec les environnements VPS Linux. Son alignement avec les serveurs Linux signifie que vous pouvez exploiter tout le potentiel et la flexibilité du déploiement d’applications sur un hébergement VPS Linux.<\/li>\n<\/ul>
Comment déployer des applications Web à l’aide de Kamal<\/h2>
Dans cette section, vous apprendrez à utiliser Kamal pour rationaliser le processus de déploiement de votre application web.<\/p>
1. Préparer le déploiement<\/h3>
Qu’il s’agisse d’une machine locale ou d’un serveur virtuel, la préparation des conditions préalables garantit un déploiement fluide de l’application web avec Kamal. Dans cet exemple, nous utiliserons l’hébergement VPS<\/a> d’Hostinger pour configurer votre environnement en vue du déploiement d’une application web.<\/p>Le VPS d’Hostinger offre un serveur fiable qui prépare le terrain pour vos besoins de déploiement. Il offre des mesures de sécurité de premier ordre, une évolutivité facile pour croître en même temps que votre application, et Kodee, notre assistant IA pour simplifier vos processus de développement et de déploiement.<\/p>![\"\"](\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/46\/2022\/12\/FR-VPS-hosting_in-text-banner-1024x300-1.png\/public\")
<\/a><\/figure>Après avoir préparé votre VPS, accédez à votre serveur avec PuTTY ou tout autre client SSH. Ensuite, mettez à jour vos paquets Linux avec les commandes SSH<\/a> suivantes :<\/p>sudo apt-get update && sudo apt-get upgrade<\/pre>Ensuite, configurez l’environnement logiciel requis par votre application web, ce qui peut inclure l’installation d’un serveur web tel qu’Apache ou NGINX et la configuration d’une base de données telle que MySQL ou PostgreSQL. Il est également essentiel de sécuriser votre serveur à l’aide de pare-feu et de clés SSH pour un accès sécurisé.<\/p>
Si vous développez une application Rails, assurez-vous que Ruby on Rails est installé. Sinon, vous pouvez installer Docker<\/a> et gérer les conteneurs pour votre application.<\/p>2. Installer et déployer avec Kamal<\/h3>
Une fois que votre environnement est prêt, procédez à l’installation de Kamal. Pour ceux qui ont un environnement Ruby, installez Kamal globalement sur votre VPS Linux avec la commande suivante :<\/p>
gem install kamal<\/pre>Cela rend Kamal accessible à partir de n’importe quel répertoire de votre serveur.<\/p>
Si vous préférez la conteneurisation dans les déploiements de Kamal, tirez l’image Docker et définissez un alias dans votre fichier de configuration shell. Cela vous permet d’utiliser les commandes Kamal sans installer les dépendances sur votre serveur.<\/p>
Ensuite, naviguez vers le répertoire config <\/strong>et ouvrez le fichier deploy.yml.<\/strong> Ici, vous pouvez spécifier des détails tels que les étapes de déploiement, les adresses IP publiques et l’URL du référentiel pour le contrôle de version avec Kamal.<\/p>Votre fichier deploy.yml <\/strong>inclura également les détails du registre. Si vous utilisez Docker Hub, vous n’aurez pas besoin de spécifier un serveur car c’est le serveur par défaut.<\/p>Voici un exemple basique de ce que le contenu de deploy.yml <\/strong>pourrait inclure :<\/p># Your web app name. Used to uniquely configure containers.\nservice: hey\n# Your image host or container image name\nimage: 37s\/hey\nservers:\n - 192.168.0.1\n - 192.168.0.2\nregistry:\n # The container registry server, if you're not using 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#Configure a custom healthcheck\nhealthcheck:\n path: \/healthz\n port: 4000\n max_attempts: 7\n interval: 20s<\/pre>N’oubliez pas de sécuriser vos informations d’identification en remplaçant KAMAL_REGISTRY_PASSWORD <\/strong>par votre jeton d’accès au registre Docker.<\/p>Une fois le fichier de configuration configuré, il est temps de lancer le processus de déploiement. Pour le déploiement initial, exécutez :<\/p>
kamal setup<\/pre>Il prépare vos serveurs en créant des répertoires, en définissant des autorisations et en effectuant d’autres tâches nécessaires.<\/p>
Pour les déploiements ultérieurs, utilisez :<\/p>
kamal deploy<\/pre>Cette commande exécute les tâches décrites dans votre fichier deploy.yml<\/strong>, telles que les mises à jour de code, les migrations et les redémarrages de service.<\/p>3. Pousser les fichiers d’environnement<\/h3>
Pour déployer efficacement votre application web à l’aide de Kamal, il est essentiel de gérer méticuleusement vos fichiers d’environnement. Ces fichiers contiennent des variables d’environnement essentielles à la configuration de votre application dans les différents environnements de développement, de test et de production.<\/p>
Pour des raisons de sécurité, les fichiers ENV <\/strong>de votre application ne devraient jamais être inclus dans le contrôle de version. Au lieu de cela, utilisez les fonctions robustes de gestion de l’environnement de Kamal pour transférer ces fichiers sur votre serveur en toute sécurité.<\/p>Commencez par sécuriser votre fichier d’environnement dans un lieu de stockage sûr. Envisagez d’utiliser le VPS de Hostinger pour gérer de manière fiable les variables d’environnement de votre application, en veillant à ce qu’elles soient appliquées de manière sécurisée et maintenues de manière cohérente tout au long du déploiement.<\/p>
Ensuite, utilisez la commande kamal env push <\/strong>pour transférer le fichier vers votre serveur en toute sécurité.<\/p>Chaque fois que vous ajoutez de nouvelles variables d’environnement ou que vous modifiez des variables existantes dans votre fichier ENV<\/strong>, n’oubliez pas de pousser ces mises à jour vers vos serveurs distants à l’aide de la commande kamal env push<\/strong>. Avant d’exécuter la commande kamal deploy<\/strong>, effectuez cette étape pour vous assurer que votre processus de déploiement incorpore les variables mises à jour dans le conteneur de votre application.<\/p>Ces procédures sont essentielles pour faire fonctionner correctement les services et les conteneurs Docker<\/a>, car elles s’appuient sur les paramètres de configuration corrects fournis par les variables d’environnement.<\/p>4. Exécuter des commandes sur des serveurs<\/h3>
Pour simplifier la gestion de vos applications web, Kamal propose une fonction conviviale qui vous permet d’exécuter des commandes à travers votre infrastructure de serveurs de manière efficace.<\/p>
Par exemple, pour lancer une commande sur tous vos serveurs afin de vérifier la version de Ruby, vous devez utiliser :<\/p>
kamal app exec 'ruby -v'<\/pre>La sortie confirmera la version de Ruby sur chaque hôte de l’application, par exemple :<\/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>Pour cibler uniquement le serveur primaire, la commande serait la suivante :<\/p>
kamal app exec --primary 'cat .ruby-version'<\/pre>Si vous devez exécuter une commande liée à Rails sur tous les serveurs, par exemple pour vérifier la configuration de l’environnement Rails, vous devez saisir ce qui suit :<\/p>
kamal app exec 'bin\/rails about'<\/pre>Le résultat devrait ressembler à ceci :<\/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>Pour les tâches plus interactives comme le lancement d’une console Rails ou d’une session bash, Kamal simplifie le processus. Il suffit d’exécuter les commandes suivantes pour démarrer une session bash dans un nouveau conteneur d’image d’application ou dans le conteneur Docker en cours d’exécution :<\/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. Vérifier l’état du serveur avec Kamal Details<\/h3>
Comprendre l’état de vos serveurs est crucial pour maintenir leur santé et assurer le bon fonctionnement de vos applications. Kamal fournit un moyen efficace de surveiller cet état grâce à la commande details.<\/strong><\/p>L’exécution de kamal details <\/strong>vous donne un aperçu de vos conteneurs, de leur état et de leurs performances. Voici ce que vous verrez généralement :<\/p>Pour les conteneurs 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>Pour vos conteneurs d’application :<\/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>Cette sortie vous permet de vérifier rapidement que les conteneurs sont opérationnels et que les ports sont correctement mappés, ce qui indique un état de serveur sain.<\/p>
Pour une inspection plus ciblée, vous pouvez restreindre les détails à des conteneurs spécifiques à l’application ou à Traefik en utilisant respectivement kamal app details <\/strong>ou kamal traefik details.<\/strong><\/p>Ces commandes ciblées fournissent un accès direct aux journaux et aux spécificités des conteneurs, rationalisant ainsi le processus de gestion des configurations de l’environnement et simplifiant la gestion des erreurs dans les déploiements de Kamal.<\/p>
6. Déploiements rétroactifs<\/h3>
Lorsqu’un déploiement ne se déroule pas comme prévu, Kamal propose un processus de retour en arrière simple. Il s’agit de réactiver un conteneur Docker précédemment stable. Pour gérer un retour en arrière rapide et efficace, suivez les étapes suivantes :<\/p>
Tout d’abord, identifiez les anciens conteneurs disponibles à l’aide de la commande kamal app containers.<\/strong> La liste des conteneurs actifs et inactifs s’affichera. Recherchez le dernier conteneur actif par son image ou son ID avant l’échec du déploiement.<\/p>Par exemple, vous pouvez voir une sortie indiquant :<\/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>Pour revenir en arrière, exécutez kamal rollback [previous_image_tag]<\/strong>. Kamal arrêtera le conteneur problématique actuel et redémarrera le dernier conteneur stable. Le conteneur précédent étant déjà sur l’hôte, le retour en arrière s’effectue rapidement sans avoir à puiser à nouveau dans le registre.<\/p>Notez que les anciens conteneurs sont automatiquement purgés au bout de trois jours après un nouveau déploiement de kamal<\/strong>, il est donc conseillé de confirmer le succès de votre déploiement dans ce délai afin de conserver la possibilité d’un retour en arrière rapide.<\/p>Il est également essentiel de s’assurer que vous disposez d’une sauvegarde et d’une récupération appropriées avec Kamal afin de vous prémunir contre les problèmes imprévus. L’hébergement VPS d’Hostinger comprend des sauvegardes automatisées, améliorant de façon transparente vos capacités de retour en arrière.<\/p>
7. Nettoyer les serveurs avec Kamal Remove<\/h3>
La gestion de l’espace et des performances du serveur implique la suppression des applications inutilisées. Avec Kamal, le nettoyage de votre serveur est simple. Pour supprimer une application entière, exécutez la commande kamal remove.<\/strong><\/p>Kamal supprimera ensuite tous les composants associés à l’application sur le serveur, notamment en arrêtant et en supprimant les conteneurs Docker, en effaçant toute image Docker et en supprimant toutes les sessions de registre associées.<\/p>
Cette commande est pratique pour s’assurer que votre serveur ne soit pas encombré et qu’il fonctionne de manière optimale. Cependant, il est essentiel d’utiliser cette fonctionnalité avec prudence. Avant d’exécuter kamal remove<\/strong>, assurez-vous d’avoir des sauvegardes de toutes les données que vous souhaitez conserver.<\/p>8. Redémarrer Traefik<\/h3>
Lorsque vous gérez le proxy inverse et l’équilibreur de charge de votre serveur, il peut arriver que vous deviez redémarrer Traefik, le service qui achemine votre trafic HTTP. Ce besoin survient généralement après des mises à jour des arguments ou des étiquettes de Traefik, nécessitant un redémarrage pour que les changements soient pris en compte.<\/p>
Pour redémarrer Traefik à l’aide de Kamal, utilisez la commande suivante :<\/p>
kamal traefik reboot<\/pre>Cette opération redémarre le service Traefik et met en œuvre vos nouvelles configurations. Cependant, dans un environnement de production, où la stabilité et le temps de fonctionnement sont essentiels, optez pour la fonction de redémarrage progressif :<\/p>
kamal traefik reboot --rolling<\/pre>Un redémarrage progressif redémarre méthodiquement les conteneurs Traefik de manière séquentielle, garantissant ainsi l’absence de temps d’arrêt et le maintien d’une fonctionnalité d’équilibrage de charge continue. Cette approche plus sûre garantit que vos applications web restent accessibles aux utilisateurs pendant que les mises à jour se déroulent en arrière-plan.<\/p>
Meilleures pratiques pour le déploiement d’applications Web avec Kamal<\/h2>
Après avoir appris à déployer votre web app sur un serveur, explorons les meilleures pratiques de déploiement de Kamal pour une gestion fluide et efficace de l’application web.<\/p>
Automatiser le processus de déploiement<\/h3>
L’automatisation des déploiements par Kamal transforme les tâches manuelles répétitives en une opération en un seul clic. Les commandes et les scripts de Kamal vous permettent d’automatiser la configuration initiale, les mises à jour et la maintenance continue de vos applications web, ce qui rend le processus de déploiement plus rapide et plus fiable en réduisant les erreurs humaines.<\/p>
L’intégration des outils d’automatisation du déploiement de Kamal dans les pipelines CI\/CD améliore encore l’efficacité. Ces pipelines favorisent l’amélioration continue et les mises à jour transparentes, permettant un flux ininterrompu du développement au déploiement.<\/p>
L’hébergement VPS d’Hostinger est idéalement adapté à ces pratiques, offrant l’assistant IA Kodee pour rationaliser l’automatisation des scripts pour la gestion et la mise à l’échelle de vos applications web sans effort. Vous pouvez consulter Kodee pour obtenir des instructions sur l’automatisation de votre flux de déploiement.<\/p>
Par exemple, lancez un prompt VPS IA « Comment automatiser les sauvegardes du serveur de base de données à l’aide de Kamal ? »<\/p>
<\/figure><\/div>Choisir Kamal pour le déploiement de votre application web offre plusieurs avantages aux développeurs et aux entreprises. Voici ce qui distingue Kamal :<\/p>
- \n
- Simplicité <\/strong>– L’approche directe de Kamal en matière de déploiement permet d’éviter la courbe d’apprentissage souvent abrupte associée à d’autres outils de déploiement. Il simplifie le processus en permettant le déploiement d’applications à l’aide de quelques commandes Linux<\/a> seulement.<\/li>\n\n\n\n
- Automatisation <\/strong>– L’automatisation de Kamal pour les déploiements rationalise vos flux de travail. Des mises à jour à la mise à l’échelle, Kamal automatise ces tâches, garantissant qu’elles sont accomplies rapidement et de manière cohérente. Cela signifie moins de temps pour les processus manuels et plus de temps pour le développement.<\/li>\n\n\n\n
- Fiabilité <\/strong>– avec Kamal, vous pouvez vous attendre à des versions stables. Son processus de déploiement structuré minimise les erreurs qui peuvent survenir lors de déploiements manuels, garantissant ainsi le bon fonctionnement et la fiabilité de votre application web.<\/li>\n\n\n\n
- Adéquation <\/strong>– Kamal est exceptionnellement compatible avec les environnements VPS Linux. Son alignement avec les serveurs Linux signifie que vous pouvez exploiter tout le potentiel et la flexibilité du déploiement d’applications sur un hébergement VPS Linux.<\/li>\n<\/ul>
Comment déployer des applications Web à l’aide de Kamal<\/h2>
Dans cette section, vous apprendrez à utiliser Kamal pour rationaliser le processus de déploiement de votre application web.<\/p>
1. Préparer le déploiement<\/h3>
Qu’il s’agisse d’une machine locale ou d’un serveur virtuel, la préparation des conditions préalables garantit un déploiement fluide de l’application web avec Kamal. Dans cet exemple, nous utiliserons l’hébergement VPS<\/a> d’Hostinger pour configurer votre environnement en vue du déploiement d’une application web.<\/p>
Le VPS d’Hostinger offre un serveur fiable qui prépare le terrain pour vos besoins de déploiement. Il offre des mesures de sécurité de premier ordre, une évolutivité facile pour croître en même temps que votre application, et Kodee, notre assistant IA pour simplifier vos processus de développement et de déploiement.<\/p>
<\/a><\/figure>Après avoir préparé votre VPS, accédez à votre serveur avec PuTTY ou tout autre client SSH. Ensuite, mettez à jour vos paquets Linux avec les commandes SSH<\/a> suivantes :<\/p>
sudo apt-get update && sudo apt-get upgrade<\/pre>
Ensuite, configurez l’environnement logiciel requis par votre application web, ce qui peut inclure l’installation d’un serveur web tel qu’Apache ou NGINX et la configuration d’une base de données telle que MySQL ou PostgreSQL. Il est également essentiel de sécuriser votre serveur à l’aide de pare-feu et de clés SSH pour un accès sécurisé.<\/p>
Si vous développez une application Rails, assurez-vous que Ruby on Rails est installé. Sinon, vous pouvez installer Docker<\/a> et gérer les conteneurs pour votre application.<\/p>
2. Installer et déployer avec Kamal<\/h3>
Une fois que votre environnement est prêt, procédez à l’installation de Kamal. Pour ceux qui ont un environnement Ruby, installez Kamal globalement sur votre VPS Linux avec la commande suivante :<\/p>
gem install kamal<\/pre>
Cela rend Kamal accessible à partir de n’importe quel répertoire de votre serveur.<\/p>
Si vous préférez la conteneurisation dans les déploiements de Kamal, tirez l’image Docker et définissez un alias dans votre fichier de configuration shell. Cela vous permet d’utiliser les commandes Kamal sans installer les dépendances sur votre serveur.<\/p>
Ensuite, naviguez vers le répertoire config <\/strong>et ouvrez le fichier deploy.yml.<\/strong> Ici, vous pouvez spécifier des détails tels que les étapes de déploiement, les adresses IP publiques et l’URL du référentiel pour le contrôle de version avec Kamal.<\/p>
Votre fichier deploy.yml <\/strong>inclura également les détails du registre. Si vous utilisez Docker Hub, vous n’aurez pas besoin de spécifier un serveur car c’est le serveur par défaut.<\/p>
Voici un exemple basique de ce que le contenu de deploy.yml <\/strong>pourrait inclure :<\/p>
# Your web app name. Used to uniquely configure containers.\nservice: hey\n# Your image host or container image name\nimage: 37s\/hey\nservers:\n - 192.168.0.1\n - 192.168.0.2\nregistry:\n # The container registry server, if you're not using 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#Configure a custom healthcheck\nhealthcheck:\n path: \/healthz\n port: 4000\n max_attempts: 7\n interval: 20s<\/pre>
N’oubliez pas de sécuriser vos informations d’identification en remplaçant KAMAL_REGISTRY_PASSWORD <\/strong>par votre jeton d’accès au registre Docker.<\/p>
Une fois le fichier de configuration configuré, il est temps de lancer le processus de déploiement. Pour le déploiement initial, exécutez :<\/p>
kamal setup<\/pre>
Il prépare vos serveurs en créant des répertoires, en définissant des autorisations et en effectuant d’autres tâches nécessaires.<\/p>
Pour les déploiements ultérieurs, utilisez :<\/p>
kamal deploy<\/pre>
Cette commande exécute les tâches décrites dans votre fichier deploy.yml<\/strong>, telles que les mises à jour de code, les migrations et les redémarrages de service.<\/p>
3. Pousser les fichiers d’environnement<\/h3>
Pour déployer efficacement votre application web à l’aide de Kamal, il est essentiel de gérer méticuleusement vos fichiers d’environnement. Ces fichiers contiennent des variables d’environnement essentielles à la configuration de votre application dans les différents environnements de développement, de test et de production.<\/p>
Pour des raisons de sécurité, les fichiers ENV <\/strong>de votre application ne devraient jamais être inclus dans le contrôle de version. Au lieu de cela, utilisez les fonctions robustes de gestion de l’environnement de Kamal pour transférer ces fichiers sur votre serveur en toute sécurité.<\/p>
Commencez par sécuriser votre fichier d’environnement dans un lieu de stockage sûr. Envisagez d’utiliser le VPS de Hostinger pour gérer de manière fiable les variables d’environnement de votre application, en veillant à ce qu’elles soient appliquées de manière sécurisée et maintenues de manière cohérente tout au long du déploiement.<\/p>
Ensuite, utilisez la commande kamal env push <\/strong>pour transférer le fichier vers votre serveur en toute sécurité.<\/p>
Chaque fois que vous ajoutez de nouvelles variables d’environnement ou que vous modifiez des variables existantes dans votre fichier ENV<\/strong>, n’oubliez pas de pousser ces mises à jour vers vos serveurs distants à l’aide de la commande kamal env push<\/strong>. Avant d’exécuter la commande kamal deploy<\/strong>, effectuez cette étape pour vous assurer que votre processus de déploiement incorpore les variables mises à jour dans le conteneur de votre application.<\/p>
Ces procédures sont essentielles pour faire fonctionner correctement les services et les conteneurs Docker<\/a>, car elles s’appuient sur les paramètres de configuration corrects fournis par les variables d’environnement.<\/p>
4. Exécuter des commandes sur des serveurs<\/h3>
Pour simplifier la gestion de vos applications web, Kamal propose une fonction conviviale qui vous permet d’exécuter des commandes à travers votre infrastructure de serveurs de manière efficace.<\/p>
Par exemple, pour lancer une commande sur tous vos serveurs afin de vérifier la version de Ruby, vous devez utiliser :<\/p>
kamal app exec 'ruby -v'<\/pre>
La sortie confirmera la version de Ruby sur chaque hôte de l’application, par exemple :<\/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>
Pour cibler uniquement le serveur primaire, la commande serait la suivante :<\/p>
kamal app exec --primary 'cat .ruby-version'<\/pre>
Si vous devez exécuter une commande liée à Rails sur tous les serveurs, par exemple pour vérifier la configuration de l’environnement Rails, vous devez saisir ce qui suit :<\/p>
kamal app exec 'bin\/rails about'<\/pre>
Le résultat devrait ressembler à ceci :<\/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>
Pour les tâches plus interactives comme le lancement d’une console Rails ou d’une session bash, Kamal simplifie le processus. Il suffit d’exécuter les commandes suivantes pour démarrer une session bash dans un nouveau conteneur d’image d’application ou dans le conteneur Docker en cours d’exécution :<\/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. Vérifier l’état du serveur avec Kamal Details<\/h3>
Comprendre l’état de vos serveurs est crucial pour maintenir leur santé et assurer le bon fonctionnement de vos applications. Kamal fournit un moyen efficace de surveiller cet état grâce à la commande details.<\/strong><\/p>
L’exécution de kamal details <\/strong>vous donne un aperçu de vos conteneurs, de leur état et de leurs performances. Voici ce que vous verrez généralement :<\/p>
Pour les conteneurs 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>
Pour vos conteneurs d’application :<\/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>
Cette sortie vous permet de vérifier rapidement que les conteneurs sont opérationnels et que les ports sont correctement mappés, ce qui indique un état de serveur sain.<\/p>
Pour une inspection plus ciblée, vous pouvez restreindre les détails à des conteneurs spécifiques à l’application ou à Traefik en utilisant respectivement kamal app details <\/strong>ou kamal traefik details.<\/strong><\/p>
Ces commandes ciblées fournissent un accès direct aux journaux et aux spécificités des conteneurs, rationalisant ainsi le processus de gestion des configurations de l’environnement et simplifiant la gestion des erreurs dans les déploiements de Kamal.<\/p>
6. Déploiements rétroactifs<\/h3>
Lorsqu’un déploiement ne se déroule pas comme prévu, Kamal propose un processus de retour en arrière simple. Il s’agit de réactiver un conteneur Docker précédemment stable. Pour gérer un retour en arrière rapide et efficace, suivez les étapes suivantes :<\/p>
Tout d’abord, identifiez les anciens conteneurs disponibles à l’aide de la commande kamal app containers.<\/strong> La liste des conteneurs actifs et inactifs s’affichera. Recherchez le dernier conteneur actif par son image ou son ID avant l’échec du déploiement.<\/p>
Par exemple, vous pouvez voir une sortie indiquant :<\/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>
Pour revenir en arrière, exécutez kamal rollback [previous_image_tag]<\/strong>. Kamal arrêtera le conteneur problématique actuel et redémarrera le dernier conteneur stable. Le conteneur précédent étant déjà sur l’hôte, le retour en arrière s’effectue rapidement sans avoir à puiser à nouveau dans le registre.<\/p>
Notez que les anciens conteneurs sont automatiquement purgés au bout de trois jours après un nouveau déploiement de kamal<\/strong>, il est donc conseillé de confirmer le succès de votre déploiement dans ce délai afin de conserver la possibilité d’un retour en arrière rapide.<\/p>
Il est également essentiel de s’assurer que vous disposez d’une sauvegarde et d’une récupération appropriées avec Kamal afin de vous prémunir contre les problèmes imprévus. L’hébergement VPS d’Hostinger comprend des sauvegardes automatisées, améliorant de façon transparente vos capacités de retour en arrière.<\/p>
7. Nettoyer les serveurs avec Kamal Remove<\/h3>
La gestion de l’espace et des performances du serveur implique la suppression des applications inutilisées. Avec Kamal, le nettoyage de votre serveur est simple. Pour supprimer une application entière, exécutez la commande kamal remove.<\/strong><\/p>
Kamal supprimera ensuite tous les composants associés à l’application sur le serveur, notamment en arrêtant et en supprimant les conteneurs Docker, en effaçant toute image Docker et en supprimant toutes les sessions de registre associées.<\/p>
Cette commande est pratique pour s’assurer que votre serveur ne soit pas encombré et qu’il fonctionne de manière optimale. Cependant, il est essentiel d’utiliser cette fonctionnalité avec prudence. Avant d’exécuter kamal remove<\/strong>, assurez-vous d’avoir des sauvegardes de toutes les données que vous souhaitez conserver.<\/p>
8. Redémarrer Traefik<\/h3>
Lorsque vous gérez le proxy inverse et l’équilibreur de charge de votre serveur, il peut arriver que vous deviez redémarrer Traefik, le service qui achemine votre trafic HTTP. Ce besoin survient généralement après des mises à jour des arguments ou des étiquettes de Traefik, nécessitant un redémarrage pour que les changements soient pris en compte.<\/p>
Pour redémarrer Traefik à l’aide de Kamal, utilisez la commande suivante :<\/p>
kamal traefik reboot<\/pre>
Cette opération redémarre le service Traefik et met en œuvre vos nouvelles configurations. Cependant, dans un environnement de production, où la stabilité et le temps de fonctionnement sont essentiels, optez pour la fonction de redémarrage progressif :<\/p>
kamal traefik reboot --rolling<\/pre>
Un redémarrage progressif redémarre méthodiquement les conteneurs Traefik de manière séquentielle, garantissant ainsi l’absence de temps d’arrêt et le maintien d’une fonctionnalité d’équilibrage de charge continue. Cette approche plus sûre garantit que vos applications web restent accessibles aux utilisateurs pendant que les mises à jour se déroulent en arrière-plan.<\/p>
Meilleures pratiques pour le déploiement d’applications Web avec Kamal<\/h2>
Après avoir appris à déployer votre web app sur un serveur, explorons les meilleures pratiques de déploiement de Kamal pour une gestion fluide et efficace de l’application web.<\/p>
Automatiser le processus de déploiement<\/h3>
L’automatisation des déploiements par Kamal transforme les tâches manuelles répétitives en une opération en un seul clic. Les commandes et les scripts de Kamal vous permettent d’automatiser la configuration initiale, les mises à jour et la maintenance continue de vos applications web, ce qui rend le processus de déploiement plus rapide et plus fiable en réduisant les erreurs humaines.<\/p>
L’intégration des outils d’automatisation du déploiement de Kamal dans les pipelines CI\/CD améliore encore l’efficacité. Ces pipelines favorisent l’amélioration continue et les mises à jour transparentes, permettant un flux ininterrompu du développement au déploiement.<\/p>
L’hébergement VPS d’Hostinger est idéalement adapté à ces pratiques, offrant l’assistant IA Kodee pour rationaliser l’automatisation des scripts pour la gestion et la mise à l’échelle de vos applications web sans effort. Vous pouvez consulter Kodee pour obtenir des instructions sur l’automatisation de votre flux de déploiement.<\/p>
Par exemple, lancez un prompt VPS IA « Comment automatiser les sauvegardes du serveur de base de données à l’aide de Kamal ? »<\/p>
- Automatisation <\/strong>– L’automatisation de Kamal pour les déploiements rationalise vos flux de travail. Des mises à jour à la mise à l’échelle, Kamal automatise ces tâches, garantissant qu’elles sont accomplies rapidement et de manière cohérente. Cela signifie moins de temps pour les processus manuels et plus de temps pour le développement.<\/li>\n\n\n\n