为你的 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 上本地测试和调试你的工作负载。