Azure DevOps Pipeline yaml 文件 Docker 标签

Question

你好，我的专家 friend 们。 我知道这个问题可能听起来很简单，但我正在寻求一些建议和最佳实践来遵循/学习。

我在 azure 中有一个测试基础设施，分为 2 个环境。一个是Staging，另一个是Production。

这些环境具有与现有实践相同的配置，因为我想了解如何从暂存到生产部署特定的 Docker 镜像。

在当前状态下，我有 1 个处于暂存状态的 Web 应用程序和 1 个处于生产状态的 Web 应用程序。

本实验室的构建管道仅在我向 GitHub 推送 Tag 时尝试触发暂存中的构建管道，并且我通过按如下方式设置管道来实现此目的:

trigger:
  batch: true
  tags:
    include:
      - '*'
  branches:
    exclude:
    - Staging

这会使用一些 C# 代码运行 docker 构建并将其部署到容器注册表。 但在我当前的管道中，在 Docker 任务下:

- task: Docker@2
    name: 'dockerBuildAndPush'
    displayName: 'docker - Build & Push'
    inputs:
      repository: $(imageRepository)
      Dockerfile: $(dockerfilePath)
      containerRegistry: ${{ variables.dockerRegistryServiceConnection }}
      buildContext: ${{ variables.buildContext }}
      tags: |
        $(Build.BuildNumber)
        latest

如您所见，我有一个基于 Build.BuildNumber 的 tags 当然，在构建过程中，它会获取当前的日期+构建号，但我想做的是定位来自 GitHub 的最新标签并将其传递给构建。

这就是我感到困惑的地方，并且不太确定要遵循的最佳实践。

假设我在 GitHub 上使用标签 v1.0 推送更新，有没有办法使用管道来选择标签编号并将其自动传递到构建？或者我每次推送到 GitHub 之前都必须在管道中手动更新 Tag 值？

所以基本上我想要在容器注册表中拥有的内容如下:

• Github 推送标签 v1.0
• Azure 容器注册表有一个构建 Docker build:v1.0

这样，我以后就可以更轻松地快速检测到哪个 docker 镜像正在 Staging 和 Production 上运行。

很抱歉，如果我无法清楚地解释我的困境，如果是这种情况，请随时询问更多信息。

更新:

非常感谢戴夫的回复和解决方案。我会尽快调查。 是的，我一直在寻找一些更容易实现的东西来理解整个过程并对其充满信心。

在当前状态下，我按以下顺序管理我的管道。

parameters:
  - name: tag
    type: string
    default: 'v1.1'

trigger:
  batch: true
  tags:
    include:
      - '*'
  branches:
    exclude:
    - Staging

并在我的 docker 任务中将标签设置为参数

- task: Docker@2
    name: 'dockerBuildAndPush'
    displayName: 'docker - Build & Push'
    inputs:
      repository: $(imageRepository)
      Dockerfile: $(dockerfilePath)
      containerRegistry: ${{ variables.dockerRegistryServiceConnection }}
      buildContext: ${{ variables.buildContext }}
      tags: '${{ parameters.tag }}'

这个过程完全按照预期进行。在门户的容器注册表中，我有一个名为“v.1.1”的版本

我面临的问题是在该图像的发布阶段。

在发布的标签中，我有 $(Build.BuildNumber) ，当然，当我设置参数变量来构建该镜像时，我没有内部版本号，但有v1.1。

我一直在阅读，我可以使用 yaml 文件中的特定变量名称覆盖 BuildNumber，以将 Build.BuildNumber 映射到参数，并且在发布管道中我可以保留 Build.BuildNumber 作为引用。但我并不是 100% 清楚如何做到这一点。

Answer 1

您可以使用GitVersion从您的存储库标签生成版本号。

这可以在您的管道中使用，如下所示:

  - task: UseDotNet@2
    displayName: Use .NET Core CLI
    inputs:
      version: "6.x"
  - task: DotNetCoreCLI@2
    displayName: Install GitVersion
    continueOnError: true
    inputs:
      command: "custom"
      custom: "tool"
      arguments: "install GitVersion.Tool --version 5.* --global"
  - task: PowerShell@2
    displayName: Set build version
    inputs:
      targetType: "inline"
      script: |
        Write-Host "##vso[build.updatebuildnumber]$(dotnet-gitversion /showvariable FullSemVer)"

上面的示例将 Build.BuildNumber 变量设置为基于最后一个标记的版本字符串。当然，您可以设置一些其他变量。

您还可以customise GitVersion 通过将 GitVersion.yml 文件添加到存储库来选择版本号的方式。

这个答案应该作为您的起点 - 它不会产生您想要的格式，如果您想要一个非常具体的格式，您将需要查看配置选项等。

此外，请查看 GitVersion 可以运行的不同模式，因为它们会影响为标记提交之间的任何提交生成的版本号!