為你的 Rust 應用程式配置 CI/CD

先決條件

完成本指南之前的部分,從 開發你的 Rust 應用程式 開始。你必須擁有一個 GitHub 帳戶和一個 Docker 帳戶才能完成本節。

概述

在本節中,你將學習如何設定和使用 GitHub Actions 來構建和推送你的 Docker 映象到 Docker Hub。你將完成以下步驟

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

第一步:建立倉庫

建立一個 GitHub 倉庫,配置 Docker Hub 憑據,並推送你的原始碼。

  1. 在 GitHub 上建立一個新的倉庫

  2. 開啟倉庫的 **設定**,然後轉到 **Secrets 和變數** > **Actions**。

  3. 建立一個名為 DOCKER_USERNAME 的新 **倉庫變數**,並將你的 Docker ID 作為值。

  4. 為 Docker Hub 建立一個新的 個人訪問令牌 (PAT)。你可以將此令牌命名為 docker-tutorial。確保訪問許可權包括讀和寫。

  5. 在你的 GitHub 倉庫中,將 PAT 新增為 **倉庫金鑰**,名稱為 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
    

第二步:設定工作流程

為構建、測試和推送映象到 Docker Hub 設定你的 GitHub Actions 工作流程。

  1. 轉到 GitHub 上的倉庫,然後選擇 **Actions** 選項卡。

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

    這將帶你到一個頁面,用於在你的倉庫中建立一個新的 GitHub Actions 工作流程檔案,預設情況下位於 .github/workflows/main.yml

  3. 在編輯器視窗中,複製並貼上以下 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 push
            uses: docker/build-push-action@v6
            with:
              push: true
              tags: ${{ vars.DOCKER_USERNAME }}/${{ github.event.repository.name }}:latest

    有關 docker/build-push-action 的 YAML 語法的更多資訊,請參閱 GitHub Action 自述檔案

第三步:執行工作流程

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

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

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

  2. 轉到 **Actions** 選項卡。它將顯示工作流程。

    選擇工作流程將顯示所有步驟的分解。

  3. 工作流程完成後,轉到你的 Docker Hub 上的倉庫

    如果你在列表中看到新的倉庫,則意味著 GitHub Actions 成功將映象推送到 Docker Hub。

總結

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

相關資訊

下一步

接下來,學習如何在部署之前在 Kubernetes 上本地測試和除錯你的工作負載。