Azure DevOps 管道 yaml 文件 Docker 标签

Question

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

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

这些环境具有相同的手头实践配置，因为我想学习如何将特定的 docker 图像从暂存到生产部署。

在当前 state，我有 1 个 web 应用程序在暂存中，1 个 web 应用程序在生产中。

我的这个实验室的构建管道是尝试在我推送到 GitHub a 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 。当然，在构建过程中，它会获取当前date + build number ，但我想做的是定位来自 GitHub 的最新tag并将其传递给建造。

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

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

所以基本上我想在我的容器注册表中包含的内容如下：

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

这样，我将更容易快速检测到稍后在 Staging 和 Production 上运行的是哪个 docker 镜像。

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

更新：

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

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

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 覆盖为 map 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变量设置为基于最后一个标记的版本字符串。 当然，您可以设置一些其他变量。

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

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

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