如何自定义 CI/CD 配置文件中的输入参数?
极狐GitLab 是一个一体化的 DevOps 平台,内置 CI/CD 功能。在极狐GitLab 15.11 中,我们引入了一项令人兴奋的新功能,允许用户为可包含的配置文件定义输入参数。 通过在 CI 模板中使用输入参数的功能,您可以将模板中的任何关键字替换为参数,包括阶段、脚本或作业名称。 例如,您可以向所有作业添加前缀,以更好地将它们与您要包含配置的流水线隔离。
极狐GitLab 为 GitLab 的中文发行版,中文版本对国内用户更友好,可以一键私有化部署,也可以选择使用 SaaS,私有化部署详情可以查看官网指南。
这些输入参数可以针对每个配置文件声明为强制参数或可选参数,从而减少对全局变量的需求,并使 CI/CD 模板更加健壮和隔离。 输入参数的范围仅限于包含的配置,这意味着它们对流水线的其余部分没有影响。 这允许您声明和强制执行约束,例如通过强制模板输入。
这一功能开发是 CI/CD 组件目录长期路线图的第一个里程碑,这是一项新功能,允许用户搜索和重用具有适合其用例的特定参数的单一用途 CI/CD 配置单元。
在这篇技术博客文章中,我们将提供有关如何使用输入参数定义 CI/CD 模板以及如何在包含模板时使用它们的分步说明。
步骤1:创建一个模版YAML文档
第一步是创建一个模板 YAML 文档,该文档描述了模板可以使用哪些输入参数。 模板的第二部分是作业的定义,其中可能包括对使用插值格式 $[[ input-name ]] 的值的引用。 您应该在两个部分之间使用三条虚线。
下面是一个部署模板.yml 的示例:
spec:
inputs:
website:
environment:
default: test
---
deploy:
stage: deploy
script: echo "deploy $[[ inputs.website ]] to $[[ inputs.environment ]]"
在此模板中,我们定义了两个输入参数:网站和环境。 环境参数有默认值。 在内容部分,我们定义了一个插入输入参数的作业。
步骤 2:将模板包含在 CI 配置中
在主 CI 配置文件 .gitlab-ci.yml 中,引用模板并使用 input 关键字添加输入参数。
以下是包含带有输入参数的deploy-template.yml的示例:
include:
- local: deploy-template.yml
inputs:
website: my-website.example.com
在此示例中,我们在项目中包含了本地模板。 注意:您可以将输入与其他包含类型一起使用,例如 include:project、include:template、include:remote。
在下面的示例中,我们使用输入为作业名称添加前缀,并使阶段也变得动态。
spec:
inputs:
website:
environment:
default: staging
stage:
default: test
job_prefix:
default: ""
---
"$[[ inputs.job_prefix ]]deploy":
stage: $[[ inputs.stage ]]
script: echo "deploy $[[ inputs.website ]] to $[[ inputs.environment ]]"
然后我们可以将其从 .gitlab-ci.yml 中包含到输入参数中:
include:
- local: deploy-template.yml
inputs:
stage: deploy
website: http://example.com
environment: production
job_prefix: "my-app-"
就是这样! 您已成功创建接受输入的 CI 模板并在流水线配置中使用它们。 通过使用带有输入的模板,您可以简化流水线配置并使模板更加模块化和可重用。