为您的 Node.js 应用程序配置 CI/CD

先决条件

完成本指南中所有之前的部分,从 容器化 Node.js 应用程序 开始。您必须拥有一个 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
    

步骤二:设置工作流程

设置您的 GitHub Actions 工作流程,以构建、测试并将镜像推送到 Docker Hub。

  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 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/v8
              push: true
              target: prod
              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。

总结

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

相关信息

下一步

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