GitHub Actions生成.env文件后，如何对接Docker与AWS Elastic Beanstalk

针对Docker Cloud Build的处理方式 #

Docker Cloud Build默认直接拉取仓库代码，若不想将.env推送到仓库，可采用以下两种方案：

方案1：在GitHub Actions中生成.env后直接触发Docker Cloud Build #

将生成.env的逻辑与触发Docker Cloud Build的步骤整合，把.env作为构建上下文的一部分传递给Docker Cloud Build：

name: generate-env-and-build-docker
on:
  push:
    branches: ["test"]
jobs:
  build:
    runs-on: ubuntu-22.04
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      - name: Generate .env file
        run: |
          touch .env
          echo "${{ vars.APP_ENV }}" >> .env
      - name: Trigger Docker Cloud Build
        run: |
          # 替换为你的Docker Cloud凭证和构建ID
          curl -X POST \
            -H "Content-Type: application/json" \
            -H "Authorization: Bearer ${{ secrets.DOCKER_CLOUD_TOKEN }}" \
            -d '{
              "source": {
                "context": "https://github.com/你的用户名/你的仓库.git#test",
                "dockerfile_path": "Dockerfile"
              },
              "context_files": {
                ".env": "'$(base64 .env)'"
              }
            }' \
            https://cloud.docker.com/api/build/v1/source/你的构建ID/trigger

Docker Cloud Build会在构建时将.env注入到构建上下文，Dockerfile可正常读取该文件。

方案2：将.env作为GitHub Artifact上传，Docker Cloud Build拉取 #

在GitHub Actions中生成.env后上传为Artifact，再在Docker Cloud Build的构建脚本中拉取这个文件：

# GitHub Actions配置
name: generate-env-upload-artifact
on:
  push:
    branches: ["test"]
jobs:
  generate_env:
    runs-on: ubuntu-22.04
    steps:
      - name: Generate .env file
        run: |
          touch .env
          echo "${{ vars.APP_ENV }}" >> .env
      - name: Upload .env as artifact
        uses: actions/upload-artifact@v4
        with:
          name: env-file
          path: .env

在Docker Cloud Build的构建命令中添加拉取步骤：

# 替换为你的仓库信息和Artifact ID
curl -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
  -L https://api.github.com/repos/你的用户名/你的仓库/actions/artifacts/你的ArtifactID/zip > env.zip
unzip env.zip
# 执行后续Docker构建命令

针对AWS CodePipeline（Elastic Beanstalk）的处理方式 #

CodePipeline默认拉取仓库代码，要让它获取.env，可选择以下两种思路：

方案1：在CodeBuild阶段生成.env #

利用CodePipeline中的CodeBuild环节，在buildspec.yml中添加生成.env的逻辑，直接使用CodeBuild配置的环境变量：

# buildspec.yml
version: 0.2
phases:
  build:
    commands:
      # 从CodeBuild环境变量中读取并生成.env
      - echo "${APP_ENV}" > .env
      # 将.env与项目文件打包成Elastic Beanstalk部署包
      - zip -r deploy.zip .env *
artifacts:
  files:
    - deploy.zip

CodeBuild会将.env打包到部署包中，Elastic Beanstalk部署时即可获取该文件。

方案2：GitHub Actions生成.env后推送到临时构建分支 #

在GitHub Actions中生成.env后，推送到专门的临时分支（如test-build），再配置CodePipeline拉取该分支：

name: generate-env-push-to-build-branch
on:
  push:
    branches: ["test"]
jobs:
  generate_and_push:
    runs-on: ubuntu-22.04
    steps:
      - name: Checkout test branch
        uses: actions/checkout@v4
        with:
          ref: test
      - name: Generate .env file
        run: |
          touch .env
          echo "${{ vars.APP_ENV }}" >> .env
      - name: Push to build branch
        run: |
          git config --global user.name "GitHub Actions"
          git config --global user.email "actions@github.com"
          git checkout -b test-build
          git add .env
          git commit -m "Add generated .env for build"
          git push origin test-build --force

将CodePipeline的源分支设置为test-build，每次推送test分支后，Actions会更新test-build分支，CodePipeline即可拉取到包含.env的代码。

通用注意事项 #

• 确保APP_ENV的格式正确，每个环境变量键值对单独一行，避免换行符导致的解析问题。
• 若使用Docker构建，需确保Dockerfile中的COPY指令包含.env，或在docker build命令中使用--env-file .env参数加载环境变量。

内容的提问来源于stack exchange，提问作者Rick