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.comhttps://www.your-company.comhttps://backoffice.your-company.com など)。
  • プライベートかつ専用インフラ上で、高いパフォーマンスと堅牢なセキュリティを実現します。
  • ワンクリックでアップデートを適用でき、シンプルかつ手間のかからないメンテナンスが可能です。

約5分でコンテナを本番環境で稼働させることができます。Stackheroがインフラ、アップデート、セキュリティを管理するため、アプリケーション開発に集中できます。Docker CaaSクラウドホスティングの詳細もご覧ください。

GitHub プロジェクトで定義した環境変数は、docker-compose.yml ファイル内でも利用できます。たとえば、ステージング用(staging.my-company.com)と本番用(my-company.com)で異なるドメインにデプロイしたい場合に便利です。

  1. GitHub の Settings > Environments で、WEBSITE_DOMAIN という環境変数を作成します。
  2. ステージング環境には WEBSITE_DOMAIN を「staging.my-company.com」に設定します。
  3. 本番環境には 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"