PHP: Configurare le chiavi SSH

Questa documentazione fa parte della guida Distribuire con GitHub Actions. Consulta la guida completa qui: Come distribuire il tuo codice PHP utilizzando GitHub Actions.

👋 Benvenuti nella documentazione di Stackhero!

Stackhero offre una soluzione PHP cloud pronta all'uso che fornisce una serie di vantaggi, tra cui:

  • Distribuisci la tua applicazione in pochi secondi con un semplice git push.
  • Usa il tuo nome di dominio e beneficia della configurazione automatica dei certificati HTTPS per una sicurezza migliorata.
  • Goditi la tranquillità con backup automatici, aggiornamenti con un clic, e una tariffazione semplice, trasparente e prevedibile.
  • Ottieni prestazioni ottimali e una sicurezza robusta grazie a una VM privata e dedicata.

Risparmia tempo e semplificati la vita: ci vogliono solo 5 minuti per provare la soluzione di PHP cloud hosting di Stackhero!

Le chiavi SSH sono il metodo consigliato per consentire a GitHub Actions di connettersi in modo sicuro al tuo servizio PHP durante il deployment. In questa guida, creerai una coppia di chiavi SSH dedicata a questo scopo.

Per generare nuove chiavi SSH, esegui questo comando sul tuo computer:

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

Successivamente, recupera la chiave pubblica eseguendo:

cat /tmp/ssh_key.pub

Accedi alla dashboard Stackhero e seleziona il servizio PHP "Production". Clicca su "Configure" e segui questi passaggi:

  1. Sotto SSH public keys, clicca su "Add a public key".
  2. Imposta la Description su "GitHub Action".
  3. Incolla la chiave pubblica appena recuperata nel campo Key.

Accedi alle impostazioni del servizioAccedi alle impostazioni del servizio

Ora aggiungi la chiave privata al tuo progetto GitHub affinché possa essere utilizzata durante il deployment:

  • Vai su Settings, poi seleziona Environments e clicca su New environment.

    Configurazione degli ambienti GitHubConfigurazione degli ambienti GitHub

  • Nel campo Name, inserisci "production" e conferma.

    Impostazione dell'ambienteImpostazione dell'ambiente

  • Clicca sul pulsante No restriction e seleziona Selected branches and tags.

    Impostazione delle restrizioni dell'ambienteImpostazione delle restrizioni dell'ambiente

  • Clicca su Add deployment branch or tag rule, inserisci "production" nel campo Name pattern e clicca su Add rule.

    Impostazione del branch dell'ambienteImpostazione del branch dell'ambiente Impostazione del branch dell'ambienteImpostazione del branch dell'ambiente

  • Nella sezione Environment secrets, clicca su Add secret.

    Aggiungi un secretAggiungi un secret

Recupera la chiave privata generata in precedenza eseguendo:

cat /tmp/ssh_key

Nelle impostazioni dell'ambiente GitHub:

  • Per Name, inserisci STACKHERO_SSH_PRIVATE_KEY e incolla la chiave privata nel campo Value.

    Impostazione del secret della chiave privata SSHImpostazione del secret della chiave privata SSH

  • Nella sezione Environment variables, clicca su Add variable.

    Impostazione delle variabiliImpostazione delle variabili

  • Per Name, inserisci STACKHERO_ENDPOINT e incolla l'endpoint del tuo servizio PHP nel campo Value. Puoi trovare questo endpoint nella dashboard Stackhero.

    Impostazione della variabile endpointImpostazione della variabile endpoint

Se hai personalizzato il nome di dominio del tuo servizio, utilizza la versione personalizzata invece di <XXXXXX>.stackhero-network.com.

Per motivi di sicurezza, è consigliabile eliminare le chiavi SSH generate dal tuo computer dopo la configurazione:

rm /tmp/ssh_key /tmp/ssh_key.pub