Docker: Configurar variáveis de ambiente e segredos

Esta documentação faz parte do guia Implementar com GitHub Actions. Consulte o guia completo aqui: Saiba como implementar os seus contentores Docker utilizando o GitHub Actions.

👋 Bem-vindo à documentação da Stackhero!

A Stackhero oferece uma solução Docker cloud CaaS (Containers as a Service) pronta a usar que proporciona uma série de benefícios, incluindo:

• Implemente facilmente os seus containers em produção com apenas um docker-compose up.
• Nome de domínio personalizável seguro com HTTPS (por exemplo, https://api.sua-empresa.com, https://www.sua-empresa.com, https://backoffice.sua-empresa.com).
• Desempenho ótimo e segurança robusta alimentados por uma VM privada e dedicada.
• Atualizações sem esforço com apenas um clique.

Poupe tempo e simplifique a sua vida: são necessários apenas 5 minutos para experimentar a solução de hospedagem cloud Docker CaaS da Stackhero e implementar os seus containers em produção!

Obter o nome de domínio e a palavra-passe dos certificados

Para permitir que o GitHub Actions se ligue ao seu serviço Docker Stackhero, irá precisar de duas informações: o nome de domínio do seu serviço e a palavra-passe dos certificados.

1. No dashboard Stackhero, selecione o seu serviço Docker "production" e clique no botão "Configure".

   Obter definições do serviço

2. Copie tanto o "Domain name" como a "Docker certificates password" para utilizar nos próximos passos.

   Obter definições do serviço

Definir o nome de domínio e a palavra-passe dos certificados no GitHub

1. No GitHub, abra o seu projeto.

2. Vá a Settings > Environments e clique em New environment.

   Configurar ambientes no GitHub

3. No campo Name, escreva "production" e confirme.

   Definir o ambiente

4. Clique no botão No restriction e escolha Selected branches and tags.

   Definir restrições do ambiente

5. Clique em Add deployment branch or tag rule, introduza "production" no campo Name pattern e depois clique em Add rule.

   Definir branch do ambiente Definir branch do ambiente

6. Em Environment secrets, clique em Add secret.

   Adicionar segredo

7. Para o segredo, utilize STACKHERO_CERTIFICATES_PASSWORD como nome e cole a sua palavra-passe dos certificados no campo Value.

   Definir o segredo da palavra-passe dos certificados

8. Em Environment variables, clique em Add variable.

   Definir variáveis

9. Utilize STACKHERO_ENDPOINT como nome e cole o endpoint do seu serviço Docker no campo Value. Pode encontrar este endpoint no seu dashboard Stackhero.

   Definir variável endpoint

Se personalizou o nome de domínio do seu serviço, lembre-se de utilizar o seu domínio personalizado em vez de <XXXXXX>.stackhero-network.com.

Personalizar o ficheiro de configuração Docker Compose

Se o ficheiro docker-compose.yml já está na raiz do seu projeto e não necessita de personalizações, pode ignorar esta secção.

Por predefinição, o GitHub Actions irá procurar o ficheiro docker-compose.yml na raiz do seu projeto. Se precisar de utilizar um ficheiro diferente ou uma configuração personalizada, pode ajustar o comando de implementação. Por exemplo, se estiver a utilizar o nosso boilerplate de início rápido com Node.js e Docker, pode criar uma nova variável de ambiente chamada STACKHERO_DEPLOY_COMMAND e defini-la como:

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