管道扩展使用

名称空间

类中定义扩展步骤和资源2022世界杯阿根廷预选赛赛程名称空间，以确保集合中的所有步骤和资源具有唯一的名称。2022世界杯阿根廷预选赛赛程名称空间通过步骤或资源模型定义的存储库路径指定。

• 扩展步骤定义必须存储在表单的子目录路径中:步骤/ <名称> / < stepTypeName >．
• 扩展资源定义必须存储在表单的子目录路径中:2022世界杯阿根廷预选赛赛程资源/ <名称> / < resourceTypeName >．

例子

中的样例扩展教程我们在一起教程命名空间，在存储库的目录结构中定义:

您可以根据需要在名称空间目录下定义任意多的步骤或资源。2022世界杯阿根廷预选赛赛程例如:

当在管道DSL文件中使用扩展名时，必须使用其名称空间来引用扩展名，以便识别。例如:

2022世界杯阿根廷预选赛赛程资源:—名称:MyResource类型:mycompanyname/ResourceTypeX # <——扩展资源配置:…管道:—名称:MyPipeline配置:environmentVariables: readOnly: my_env_var: "hello"步骤:—名称:MyStep_1类型:mycompanyname/StepTypeA # <——扩展步骤配置:…—名称:MyStep_2类型:mycompanyname/ steptypeb# <——扩展步骤配置:…

版本控制

所有管道扩展步骤和资源都可以单独进行版本控制2022世界杯阿根廷预选赛赛程Git标签在它们的源代码控制存储库中。然后，这些版本可以通过管道扩展管理UI．

标记扩展版本

用于控制步骤或资源版本的Git标签必须是这样的形式:

<名称> / < TypeName > @ < semver >

在哪里< TypeName >扩展步骤或资源类型的名称。<的格式semver >必须符合语义版本标准（Major.Minor.Patch）.

例如，绑定教程的当前提交版本HealthCheck到1.0.0版本，您就可以了起草新版本给它赋一个标签教程/ HealthCheck@1.0.0．

发布扩展版本

当存储库作为扩展源添加时，加载的每个扩展都是最新的该扩展步骤或资源的版本。

要释放正确标记了Git的资源或步骤，请将鼠标悬停在其行的最右侧区域以显示释放图标，然后单击它。

在随后的发布扩展对话框，从下拉菜单中选择发布标签，然后单击确认．

一旦确认，该版本将被列入发布扩展。

资源的发布版本现在将始终对该版本号的用户可用，即使从扩展源同步了新版本之后也是如此。

扩展可以在特定日期退出使用。这个过程的细节描述在管理管道扩展．

使用扩展版本

默认情况下，是对扩展步骤或资源的引用类型始终使用最新的同步版本(列于最新的）.

要使用特定的版本(例如，已知的好版本)，您可能有资格的类型声明以使用特定的版本，可选的syntaxVersion标签。

例如，要使用1.0.0版本的示例教程/ HealthCheck步骤:

step: - name: Step_1 type: tutorials/HealthCheck syntaxVersion: 1.0.0 #使用一个特定的版本配置:…

类似地，您可以使用syntaxVersion标记来限定类型指定版本的资源的。

2022世界杯阿根廷预选赛赛程资源:-名称:MyResource类型:教程/测试syntaxVersion: 0.2.0 #使用一个特定的版本配置:…

不存在的版本号或已退役的版本号将在管道运行时导致错误。