Docker: Configurar las variables de entorno y secretos

Esta documentación forma parte de la guía Despliegue con GitHub Actions. Consulte la guía completa aquí: Aprenda a desplegar sus contenedores Docker utilizando GitHub Actions.

👋 ¡Bienvenido a la documentación de Stackhero!

Stackhero ofrece una solución Docker cloud CaaS (Containers as a Service) lista para usar que proporciona una serie de beneficios, incluyendo:

• Despliega fácilmente tus contenedores en producción con solo un docker-compose up.
• Nombre de dominio personalizable asegurado con HTTPS (por ejemplo, https://api.tu-empresa.com, https://www.tu-empresa.com, https://backoffice.tu-empresa.com).
• Rendimiento óptimo y seguridad robusta gracias a una VM privada y dedicada.
• Actualizaciones sin esfuerzo con solo un clic.

Ahorra tiempo y simplifica tu vida: ¡solo toma 5 minutos probar la solución de alojamiento en la nube Docker CaaS de Stackhero y desplegar tus contenedores en producción!

Obtener el nombre de dominio y la contraseña de los certificados

Para permitir que GitHub Actions se conecte a su servicio Docker de Stackhero, necesitará dos datos: el nombre de dominio de su servicio y la contraseña de los certificados.

1. En el panel de Stackhero, seleccione su servicio Docker "production" y haga clic en el botón "Configure".

   Obtener la configuración del servicio

2. Copie tanto el "Domain name" como la "Docker certificates password" para usarlos en los siguientes pasos.

   Obtener la configuración del servicio

Definir el nombre de dominio y la contraseña de los certificados en GitHub

1. En GitHub, abra su proyecto.

2. Vaya a Settings > Environments y haga clic en New environment.

   Configuración de entornos en GitHub

3. En el campo Name, escriba "production" y confirme.

   Definir el entorno

4. Haga clic en el botón No restriction y seleccione Selected branches and tags.

   Definir restricciones de entorno

5. Haga clic en Add deployment branch or tag rule, introduzca "production" en el campo Name pattern y luego haga clic en Add rule.

   Definir la rama del entorno Definir la rama del entorno

6. En Environment secrets, haga clic en Add secret.

   Añadir secreto

7. Para el secreto, utilice STACKHERO_CERTIFICATES_PASSWORD como nombre y pegue su contraseña de certificados en el campo Value.

   Definir el secreto de la contraseña de los certificados

8. En Environment variables, haga clic en Add variable.

   Definir variables

9. Utilice STACKHERO_ENDPOINT como nombre y pegue el endpoint de su servicio Docker en el campo Value. Puede encontrar este endpoint en su panel de Stackhero.

   Definir la variable endpoint

Si ha personalizado el nombre de dominio de su servicio, recuerde utilizar su dominio personalizado en lugar de <XXXXXX>.stackhero-network.com.

Personalizar el archivo de configuración Docker Compose

Si el archivo docker-compose.yml ya está en la raíz de su proyecto y no necesita personalizaciones, puede saltarse esta sección.

Por defecto, GitHub Actions buscará el archivo docker-compose.yml en el directorio raíz de su proyecto. Si necesita utilizar un archivo diferente o una configuración distinta, puede ajustar el comando de despliegue. Por ejemplo, si está utilizando nuestro boilerplate de Node.js y Docker para empezar, puede crear una nueva variable de entorno llamada STACKHERO_DEPLOY_COMMAND y establecerla así:

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