Docker: 設定 GitHub Actions 工作流程
本文件是使用 GitHub Actions 部署指南的一部分。請在此處查看完整指南:學習如何透過 GitHub Actions 部署您的 Docker 容器。
👋 歡迎來到 Stackhero 文件!
Stackhero 提供一個即用型的 Docker cloud CaaS (Containers as a Service) 解決方案,帶來多種優勢,包括:
- 只需
docker-compose up即可輕鬆將您的容器部署到生產環境。- 使用 HTTPS 保護的可自訂域名(例如,https://api.your-company.com,https://www.your-company.com,https://backoffice.your-company.com)。
- 由專用私有 VM提供的最佳性能和強大的安全性。
- 只需點擊即可輕鬆更新。
節省時間並簡化您的生活:只需 5 分鐘即可嘗試 Stackhero 的 Docker CaaS cloud hosting 解決方案,並將您的容器部署到生產環境!
在本機端,進入您的 Git repository,建立一個名為 .github/workflows 的資料夾。在該資料夾內建立一個名為 deploy-to-stackhero.yml 的檔案,內容如下:
# File: .github/workflows/deploy-to-stackhero.yml
name: Deploy to Stackhero
description: Deploy branch "${{ github.ref_name }}" to Stackhero
on:
push:
# 這些分支在 push 時會觸發部署動作。
# 請務必在 GitHub(Settings > Environments)建立與分支名稱相符的環境。
# 並在該環境中新增 secret STACKHERO_CERTIFICATES_PASSWORD 與變數 STACKHERO_ENDPOINT。
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:
# secret STACKHERO_CERTIFICATES_PASSWORD 與變數 STACKHERO_ENDPOINT 必須在對應分支的環境中設定。
certificates_password: ${{ secrets.STACKHERO_CERTIFICATES_PASSWORD }}
endpoint: ${{ vars.STACKHERO_ENDPOINT }}
# deployment_command 為選填。若需自訂 Docker Compose 指令可使用。
deployment_command: ${{ vars.STACKHERO_DEPLOY_COMMAND }}
您可以使用以下指令提交您的變更:
git add -A .
git commit -m "Add GitHub Actions to deploy to Stackhero"
若要建立 production 分支,請執行:
git checkout -b production
然後將 production 分支推送到 GitHub:
git push --set-upstream origin production
當您的程式碼推送完成後,GitHub Actions 會自動將其部署到您的 production Stackhero 實例。您可以在 GitHub 專案的 Actions 分頁中監控部署進度。
GitHub Actions 部署到 production
就是這麼簡單。您現在已經完成自動化部署到 production 的 GitHub Actions 設定。