設定 Java 應用程式的 CI/CD

先決條件

完成本指南的前幾節,從 將您的應用程式容器化 開始。您必須擁有 GitHubDocker 帳戶才能完成本節。

概觀

在本節中,您將學習如何設定和使用 GitHub Actions 來建置 Docker 映像並將其推送到 Docker Hub。您將完成以下步驟

  1. 在 GitHub 上建立新的儲存庫。
  2. 定義 GitHub Actions 工作流程。
  3. 執行工作流程。

步驟一:建立儲存庫

建立 GitHub 儲存庫、設定 Docker Hub 憑證,並推送您的原始程式碼。

  1. 在 GitHub 上 建立新的儲存庫

  2. 開啟儲存庫的**設定**,然後前往**密鑰和變數** > **動作**。

  3. 建立一個名為 `DOCKER_USERNAME` 的新**儲存庫變數**,並將您的 Docker ID 作為值。

  4. 為 Docker Hub 建立新的 個人存取權杖 (PAT)。您可以將此權杖命名為 `docker-tutorial`。請確保存取權限包含讀取和寫入。

  5. 將 PAT 作為**儲存庫密鑰**新增到您的 GitHub 儲存庫中,名稱為 `DOCKERHUB_TOKEN`。

  6. 在您機器上的本機儲存庫中,執行以下命令將來源更改為您剛才建立的儲存庫。請確保將 `your-username` 更改為您的 GitHub 使用者名稱,將 `your-repository` 更改為您建立的儲存庫的名稱。

    $ git remote set-url origin https://github.com/your-username/your-repository.git
    
  7. 執行以下命令來暫存、提交和推送您的本機儲存庫到 GitHub。

    $ git add -A
    $ git commit -m "my commit"
    $ git push -u origin main
    

步驟二:設定工作流程

設定您的 GitHub Actions 工作流程,以建置、測試和推送映像到 Docker Hub。

  1. 前往 GitHub 上的儲存庫,然後選擇**動作**索引標籤。該專案已經具有 `maven-build` 工作流程,可以使用 Maven 建置和測試您的 Java 應用程式。如果您願意,您可以選擇停用此工作流程,因為您在本指南中不會用到它。您將建立一個新的替代工作流程來建置、測試和推送您的映像。

  2. 選擇**新的工作流程**。

  3. 選擇**自行設定工作流程**。

    這會將您帶到一個頁面,用於在您的儲存庫中建立新的 GitHub 動作工作流程檔案,預設情況下位於 ` .github/workflows/main.yml` 下。

  4. 在編輯器視窗中,複製並貼上以下 YAML 設定。

    name: ci
    
    on:
      push:
        branches:
          - main
    
    jobs:
      build:
        runs-on: ubuntu-latest
        steps:
          - name: Login to Docker Hub
            uses: docker/login-action@v3
            with:
              username: ${{ vars.DOCKER_USERNAME }}
              password: ${{ secrets.DOCKERHUB_TOKEN }}
    
          - name: Set up Docker Buildx
            uses: docker/setup-buildx-action@v3
    
          - name: Build and test
            uses: docker/build-push-action@v6
            with:
              target: test
              load: true
    
          - name: Build and push
            uses: docker/build-push-action@v6
            with:
              platforms: linux/amd64,linux/arm64
              push: true
              target: final
              tags: ${{ vars.DOCKER_USERNAME }}/${{ github.event.repository.name }}:latest

    有關 `docker/build-push-action` 的 YAML 語法的更多資訊,請參閱 GitHub Action README步驟三:執行工作流程

    儲存工作流程檔案並執行作業。

    1. 選擇**提交變更...** 並將變更推送到 `main` 分支。

      推送提交後,工作流程會自動啟動。

    2. 前往**動作**索引標籤。它會顯示工作流程。

      選擇工作流程會顯示所有步驟的明細。

    3. 工作流程完成後,前往 Docker Hub 上您的 儲存庫摘要

      在本節中,您學習了如何為您的應用程式設定 GitHub Actions 工作流程。

      相關資訊