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 dans la documentation Stackhero !

Stackhero offre une plateforme PHP cloud conçue pour des déploiements rapides et fiables :

• Déployez votre application PHP en production en quelques secondes avec un simple git push.
• Utilisez votre propre domaine, avec des certificats HTTPS automatiques configurés pour vous. Aucune intervention manuelle n'est nécessaire.
• Comptez sur des sauvegardes automatiques, des mises à jour en un clic et une tarification claire et prévisible. Stackhero s'occupe de ces aspects pour que vous puissiez vous concentrer sur votre code.
• Bénéficiez d'une performance et d'une sécurité élevées sur une infrastructure privée et dédiée, spécialement conçue pour vos applications.

Rendez votre flux de travail plus fluide et gagnez du temps. Prendre en main l'hébergement PHP cloud de Stackhero ne prend que quelques minutes.

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