为 Rust 应用程序配置 CI/CD

先决条件

完成本指南前面的部分,从开发 Rust 应用程序开始。您必须拥有一个GitHub账户和一个Docker账户才能完成此部分。

概述

在本节中,您将学习如何设置和使用 GitHub Actions 来构建 Docker 镜像并将其推送到 Docker Hub。您将完成以下步骤:

  1. 在 GitHub 上创建一个新仓库。
  2. 定义 GitHub Actions 工作流。
  3. 运行工作流。

第一步:创建仓库

创建一个 GitHub 仓库,配置 Docker Hub 凭据,并推送源代码。

  1. 在 GitHub 上创建一个新仓库

  2. 打开仓库设置,然后前往机密和变量 > Actions

  3. 创建一个名为 DOCKER_USERNAME 的新仓库变量,并将您的 Docker ID 作为其值。

  4. 为 Docker Hub 创建一个新的个人访问令牌 (PAT)。您可以将此令牌命名为 docker-tutorial。确保访问权限包含 Read 和 Write。

  5. 在您的 GitHub 仓库中,将 PAT 作为仓库机密添加,名称为 DOCKERHUB_TOKEN

  6. 在您机器上的本地仓库中,运行以下命令,将 origin 更改为您刚创建的仓库。确保将 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 仓库,然后选择 Actions 标签页。

  2. 选择 set up a workflow yourself

    这会将您带到创建新 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 README

第三步:运行工作流

保存工作流文件并运行作业。

  1. 选择 Commit changes... 并将更改推送到 main 分支。

    推送提交后,工作流会自动启动。

  2. 前往 Actions 标签页。它会显示工作流。

    选择该工作流,可以看到所有步骤的详细信息。

  3. 工作流完成后,前往您在 Docker Hub 上的仓库

    如果您在该列表中看到新仓库,则表示 GitHub Actions 已成功将镜像推送到 Docker Hub。

总结

在本节中,您学习了如何为 Rust 应用程序设置 GitHub Actions 工作流。

相关信息

下一步

接下来,学习如何在部署到 Kubernetes 之前在本地测试和调试您的工作负载。

页面选项