Docker: Configurare variabili d'ambiente e segreti

Questa documentazione fa parte della guida Distribuire con GitHub Actions. Consulta la guida completa qui: Scoprite come distribuire i vostri container Docker utilizzando GitHub Actions.

👋 Benvenuti nella documentazione di Stackhero!

Stackhero offre una soluzione Docker cloud CaaS (Containers as a Service) pronta all'uso che fornisce numerosi vantaggi, tra cui:

• Distribuisci facilmente i tuoi container in produzione con un semplice docker-compose up.
• Nome di dominio personalizzabile protetto con HTTPS (ad esempio, https://api.tua-azienda.com, https://www.tua-azienda.com, https://backoffice.tua-azienda.com).
• Prestazioni ottimali e sicurezza robusta grazie a una VM privata e dedicata.
• Aggiornamenti senza sforzo con un solo clic.

Risparmia tempo e semplifica la tua vita: bastano 5 minuti per provare la soluzione di hosting cloud Docker CaaS di Stackhero e distribuire i tuoi container in produzione!

Ottenere il nome di dominio e la password dei certificati

Per consentire a GitHub Actions di connettersi al vostro servizio Docker Stackhero, avrete bisogno di due informazioni: il nome di dominio del servizio e la password dei certificati.

1. Nel pannello di controllo Stackhero, selezionate il vostro servizio Docker "production" e fate clic sul pulsante "Configure".

   Ottenere le impostazioni del servizio

2. Copiate sia il "Domain name" che la "Docker certificates password" per utilizzarli nei passaggi successivi.

   Ottenere le impostazioni del servizio

Impostare il nome di dominio e la password dei certificati su GitHub

1. In GitHub, aprite il vostro progetto.

2. Andate su Settings > Environments, quindi fate clic su New environment.

   Configurazione degli ambienti GitHub

3. Nel campo Name, inserite "production" e confermate.

   Impostazione dell'ambiente

4. Fate clic sul pulsante No restriction e scegliete Selected branches and tags.

   Impostazione delle restrizioni dell'ambiente

5. Fate clic su Add deployment branch or tag rule, inserite "production" nel campo Name pattern e poi fate clic su Add rule.

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

6. Sotto Environment secrets, fate clic su Add secret.

   Aggiungi secret

7. Per il secret, usate STACKHERO_CERTIFICATES_PASSWORD come nome e incollate la vostra password dei certificati nel campo Value.

   Impostazione del secret della password dei certificati

8. Sotto Environment variables, fate clic su Add variable.

   Impostazione delle variabili

9. Usate STACKHERO_ENDPOINT come nome e incollate l'endpoint del vostro servizio Docker nel campo Value. Potete trovare questo endpoint nel vostro pannello di controllo Stackhero.

   Impostazione della variabile endpoint

Se avete personalizzato il nome di dominio del vostro servizio, ricordate di utilizzare il vostro dominio personalizzato invece di <XXXXXX>.stackhero-network.com.

Personalizzare il file di configurazione Docker Compose

Se il file docker-compose.yml si trova già nella root del vostro progetto e non avete bisogno di personalizzazioni, potete saltare questa sezione.

Per impostazione predefinita, GitHub Actions cercherà il file docker-compose.yml nella directory principale del progetto. Se avete bisogno di utilizzare un file diverso o una configurazione personalizzata, potete modificare il comando di deploy. Ad esempio, se utilizzate il nostro boilerplate Node.js e Docker per iniziare, potete creare una nuova variabile d'ambiente chiamata STACKHERO_DEPLOY_COMMAND e impostarla così:

docker compose --env-file env.list --file docker/docker-compose.yml --file docker/docker-compose.production.yml up --build --remove-orphans -d