Docker: 在 docker-compose.yml 中使用環境變數

本文件是使用 GitHub Actions 部署指南的一部分。請在此處查看完整指南：學習如何透過 GitHub Actions 部署您的 Docker 容器。

歡迎來到 Stackhero 文件中心

Stackhero 提供一個即時可用的 Docker 雲端 CaaS（Containers as a Service） 平台，專為快速且可靠的容器部署而設計：

• 只需一行 docker-compose up 指令即可部署到生產環境。無需額外設定：直接啟動您的容器即可。
• 自行選擇您的網域名稱，系統會自動以 HTTPS 進行安全防護（例如：https://api.your-company.com、https://www.your-company.com 或 https://backoffice.your-company.com）。
• 享有高效能與強大安全性的專屬私有基礎架構。
• 一鍵套用更新，讓維護變得簡單且省時。

您的容器大約五分鐘內即可在生產環境上線。Stackhero 為您管理基礎架構、更新與安全性，讓您能專注於應用程式的交付。深入了解 Docker CaaS 雲端主機服務。

您可以在 GitHub 專案中定義環境變數，這些變數會在您的 docker-compose.yml 檔案中可用。這對於需要部署到不同網域（例如 staging.my-company.com 與 my-company.com）時非常有幫助。

1. 在 GitHub，前往 Settings > Environments，建立一個名為 WEBSITE_DOMAIN 的環境變數。
2. 對於 staging 環境，將 WEBSITE_DOMAIN 設為「staging.my-company.com」。
3. 對於 production 環境，將 WEBSITE_DOMAIN 設為「my-company.com」。

接著，更新您的 .github/workflows/deploy-to-stackhero.yml 檔案，將 WEBSITE_DOMAIN 變數傳遞給 Stackhero GitHub Action：

name: Deploy to Stackhero
description: Deploy branch "${{ github.ref_name }}" to Stackhero

on:
  push:
    branches: [ "production", "staging" ]

jobs:
  Deploy:
    environment: ${{ github.ref_name }}
    runs-on: ubuntu-latest
    steps:
    - uses: stackhero-io/github-actions-deploy-docker-containers-to-stackhero@v1
      with:
        certificates_password: ${{ secrets.STACKHERO_CERTIFICATES_PASSWORD }}
        endpoint: ${{ vars.STACKHERO_ENDPOINT }}
        deployment_command: ${{ vars.STACKHERO_DEPLOY_COMMAND }}
      env:
        WEBSITE_DOMAIN: ${{ vars.WEBSITE_DOMAIN }}

現在，請將您的 docker-compose.yml 檔案更新為使用 WEBSITE_DOMAIN 變數，而非硬編碼的網域名稱：

services:
  test:
    image: nginx
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.test.rule=Host(`${WEBSITE_DOMAIN}`)" # 使用 WEBSITE_DOMAIN 環境變數作為網域名稱。
      - "traefik.http.routers.test.tls.certresolver=letsencrypt"