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 avec 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 profitez de la configuration automatique des certificats HTTPS pour une sécurité renforcée.
  • Bénéficiez de la sauvegarde automatique, des mises à jour en un clic, ainsi que d'une tarification simple, transparente et prévisible.
  • Profitez d'une performance optimale et d'une sécurité renforcée grâce à une VM privée et dédiée.

Gagnez du temps et simplifiez-vous la vie : il suffit de 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 en toute sécurité à 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.

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

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

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 Clés publiques SSH, cliquez sur "Ajouter une clé publique".
  2. Indiquez "GitHub Action" dans le champ Description.
  3. Collez la clé publique que vous venez de récupérer dans le champ Clé.

Accéder aux paramètres du serviceAccéder aux paramètres du service

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

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

    Configuration des environnements GitHubConfiguration des environnements GitHub

  • Dans le champ Name, saisissez "production" et validez.

    Définir l'environnementDéfinir l'environnement

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

    Définir les restrictions d'environnementDéfinir les restrictions d'environnement

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

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

  • Sous Environment secrets, cliquez sur Add secret.

    Ajouter un secretAjouter 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 SSHDéfinir le secret de la clé privée SSH

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

    Définir les variablesDéfinir les variables

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

    Définir la variable endpointDé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.

Pour des raisons de sécurité, il est conseillé 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