Node.js: Configurer les clés SSH

Cette documentation fait partie du guide Déployer avec GitHub Actions. Consultez le guide complet ici : Découvrez comment déployer votre code Node.js avec GitHub Actions.

👋 Bienvenue sur la documentation de Stackhero !

Stackhero propose un environnement Node.js cloud prêt à l'emploi, conçu pour accélérer vos déploiements :

• Déployez en production en quelques secondes grâce à un simple git push. Aucun outil supplémentaire ni configuration manuelle n'est nécessaire.
• Utilisez votre propre nom de domaine et profitez de certificats HTTPS automatiques, pour sécuriser votre application sans configuration additionnelle.
• Sauvegardes automatiques, mises à jour en un clic et tarification prévisible vous permettent de vous concentrer sur le développement de vos fonctionnalités, pendant que Stackhero gère l'infrastructure.
• Basé sur une infrastructure privée et dédiée pour garantir des performances constantes et une sécurité renforcée.

Gagnez du temps et simplifiez la gestion opérationnelle : votre application peut être en ligne sur l'hébergement Node.js cloud de Stackhero en seulement quelques minutes.

Les clés SSH permettent à GitHub Actions de se connecter de façon sécurisée à votre service Node.js lors du déploiement de votre code. Cette étape est essentielle pour protéger vos services Stackhero.

Sur votre ordinateur, vous pouvez générer de nouvelles clés SSH avec :

ssh-keygen -C "" -f /tmp/ssh_key -N ""

Ajouter la clé publique

Pour afficher la clé publique que vous venez de créer, exécutez :

cat /tmp/ssh_key.pub

Ensuite, dans votre tableau de bord Stackhero, sélectionnez votre service Node.js de production et cliquez sur le bouton Configurer.

Accéder aux paramètres du service

Poursuivez avec ces étapes :

1. Dans Clés publiques SSH, cliquez sur Ajouter une clé publique.
2. Pour Description, saisissez GitHub Action.
3. Pour Clé, collez la clé publique copiée précédemment.

Accéder aux paramètres du service

Ajouter la clé privée

Passez maintenant sur GitHub et ouvrez le repository de votre projet. Cliquez sur Settings, puis sélectionnez Environments. Choisissez New environment.

Configuration des environnements GitHub

Saisissez "production" pour le Name et validez.

Définir l'environnement

Cliquez sur le bouton No restriction, puis choisissez Selected branches and tags.

Définir les restrictions d'environnement

Cliquez ensuite sur Add deployment branch or tag rule, saisissez "production" dans le champ Name pattern, puis cliquez sur Add rule.

Définir la branche d'environnement

Définir la branche d'environnement

Dans Environment secrets, cliquez sur Add secret.

Ajouter un secret

Pour récupérer la clé privée générée, exécutez :

cat /tmp/ssh_key

Sur GitHub, utilisez STACKHERO_SSH_PRIVATE_KEY comme Name et collez votre clé privée dans le champ Value.

Définir le secret de la clé privée SSH

Ensuite, dans Environment variables, cliquez sur Add variable.

Définir les variables

Saisissez STACKHERO_ENDPOINT comme Name et collez l'endpoint de votre service Node.js dans le champ Value. Vous trouverez cet endpoint sur votre tableau de bord Stackhero.

Définir la variable endpoint

Si vous avez configuré un nom de domaine personnalisé pour votre service, utilisez votre domaine personnalisé à la place de <XXXXXX>.stackhero-network.com.

Supprimer les clés générées

Pour des raisons de sécurité, il est recommandé de supprimer les clés SSH de votre ordinateur une fois qu'elles ont été ajoutées sur Stackhero et GitHub :

rm /tmp/ssh_key /tmp/ssh_key.pub