PHP: Configurer les clés SSH

Cette documentation fait partie du guide Déployer avec GitHub Actions. Consultez le guide complet ici : Comment déployer votre code PHP à l'aide de GitHub Actions.

👋 Bienvenue sur la documentation de Stackhero !

Stackhero propose une solution PHP cloud prête à l'emploi qui offre de nombreux avantages, notamment :

• Déployez votre application en quelques secondes avec un simple git push.
• Utilisez votre propre nom de domaine et bénéficiez de la configuration automatique des certificats HTTPS pour une sécurité renforcée.
• Profitez de la tranquillité d'esprit avec des sauvegardes automatiques, des mises à jour en un clic, et une tarification simple, transparente et prévisible.
• Obtenez des performances optimales et une sécurité robuste grâce à une VM privée et dédiée.

Gagnez du temps et simplifiez-vous la vie : il ne faut que 5 minutes pour essayer la solution PHP cloud hosting de Stackhero !

Les clés SSH sont la méthode recommandée pour permettre à GitHub Actions de se connecter de façon sécuritaire à votre service PHP lors du déploiement. Dans ce guide, vous allez créer une paire de clés SSH dédiée à cet usage.

Générer les clés SSH

Pour générer de nouvelles clés SSH, exécutez cette commande sur votre ordinateur :

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

Ajouter la clé publique

Ensuite, récupérez la clé publique en exécutant :

cat /tmp/ssh_key.pub

Rendez-vous sur votre tableau de bord Stackhero et sélectionnez votre service PHP « Production ». Cliquez sur « Configurer » et suivez ces étapes :

1. Sous SSH public keys, cliquez sur « Add a public key ».
2. Indiquez « GitHub Action » dans le champ Description.
3. Collez la clé publique que vous venez de récupérer dans le champ Key.

Accéder aux paramètres du service

Ajouter la clé privée

Ajoutez maintenant la clé privée à votre projet GitHub afin qu'elle soit utilisée lors du déploiement :

• Allez dans Settings, puis sélectionnez Environments et cliquez sur New environment.

  Configuration des environnements GitHub

• Dans le champ Name, saisissez « production » et confirmez.

  Définir l'environnement

• Cliquez sur le bouton No restriction puis sélectionnez Selected branches and tags.

  Définir les restrictions d'environnement

• Cliquez sur Add deployment branch or tag rule, saisissez « production » dans le champ Name pattern et cliquez sur Add rule.

  Définir la branche de l'environnement Définir la branche de l'environnement

• Dans la section Environment secrets, cliquez sur Add secret.

  Ajouter un secret

Récupérez la clé privée générée précédemment en exécutant :

cat /tmp/ssh_key

Dans les paramètres d'environnement GitHub :

• Pour Name, saisissez STACKHERO_SSH_PRIVATE_KEY et collez votre clé privée dans le champ Value.

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

• Dans la section Environment variables, cliquez sur Add variable.

  Définir les variables

• Pour Name, saisissez STACKHERO_ENDPOINT et collez l'endpoint de votre service PHP dans le champ Value. Vous trouverez cet endpoint dans votre tableau de bord Stackhero.

  Définir la variable endpoint

Si vous avez personnalisé le nom de domaine de votre service, utilisez la version personnalisée à 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 générées de votre ordinateur après la configuration :

rm /tmp/ssh_key /tmp/ssh_key.pub