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 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 étape manuelle n'est nécessaire.
  • Profitez de sauvegardes automatiques, de mises à jour en un clic et d'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, conçue spécifiquement pour vos applications.

Simplifiez votre workflow 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 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