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 plataforma Docker cloud CaaS (Containers as a Service) lista para usar, diseñada para despliegues de contenedores rápidos y fiables:

• Despliegue en producción con un simple docker-compose up. No necesita configuración adicional: simplemente inicie sus contenedores.
• Elija su propio nombre de dominio, asegurado automáticamente con HTTPS (por ejemplo: https://api.su-empresa.com, https://www.su-empresa.com o https://backoffice.su-empresa.com).
• Disfrute de un alto rendimiento y una seguridad robusta sobre infraestructura privada y dedicada.
• Aplique actualizaciones con un solo clic para un mantenimiento sencillo y sin complicaciones.

Puede tener sus contenedores en producción en unos cinco minutos. Stackhero gestiona la infraestructura, las actualizaciones y la seguridad por usted, para que pueda centrarse en el desarrollo de sus aplicaciones. Lea más sobre el alojamiento cloud Docker CaaS.

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