管道环境变量

标准的环境变量

所有执行管道都可以使用这些环境变量。

保留环境变量

这些环境变量具有预定义的值，不能被重写。

onExecute: - add_run_variables steplet_${steplet_number}_variable=${env1}

用户定义的环境变量

中定义的自定义环境变量的配置部分的管道YAML文件。

管道

在管道中，环境变量可以在配置部分。这里声明的环境变量可用于管道中的所有步骤。

—name: my_pipeline configuration: environmentVariables: readOnly: env1: value1 env2: value2

步骤

方法中可以声明环境变量配置管道中步骤的部分。来自此源的环境变量仅对声明它们的步骤可用。

步骤:—name: step_1 type: Bash configuration: environmentVariables: env1: value1 env2: value2

YAML模式参考

在声明环境变量时，必须遵循YAML语法约定并正确地引用和转义值，以确保pipeline能够正确地解析它们。

一般来说，YAML字符串是Unicode，可以不加引号。然而在美国，使用特殊字符有一定的规则。下面的字符串需要引号:

• 以一个特殊的字符开始，例如:：, {, }, [, ], ,, &, *, #, ?, |, -, <, >, =, !, %, @, )
• 以空白字符开始或结束
• 看起来像一个数字或布尔值(123，1.23，真正的，假，零）

例子

单引号

'此字符串'使用单引号"

双引号

"此字符串使用\ttab"

多行字符串

多行字符串可以使用:

• 折叠方式:用大于号(>)表示，其中每个换行符都转换为一个空格。
• 文字样式:用管道(|)表示，以保存换行。

折叠样式(>)

文字风格(|)

转义序列

YAML使用转义序列如下:

• \ n是否用于表示新行
• \ t是用来表示一个选项卡
• \ \用来表示斜杠
• Bash的风格“\”用于转义作为内容一部分且不应折叠的附加空格
• 末尾的\用于表示一个继续标记。这对于将长字符串分解为多行而不引入不必要的空格非常有用

环境变量配置

除了键-值语法之外，还可以在环境变量定义下使用以下属性来增强其配置。以下属性可用于在两者中声明的环境变量管道而且步骤配置部分。

pipeline:—name: my_pipeline configuration: environmentVariables: readOnly: env1: value1 env2: default: value1 description: env2描述值:—value1—value2—value3 steps:—name: my_step type: Bash configuration: environmentVariables: step_env1: default: value1 description: step env1描述值:—value1—value2—value3 allowCustom: true step_env2: value2 execution: onExecute: - echo "test"

当你使用自定义配置触发运行， UI使用YAML文件中的配置来控制用户的输入使用自定义配置运行面板:

在YAML中allowCustom是设置为真正的，您可以为该字段输入任何值来定义你自己的跑步价值。在上面的示例中，您可以为的输入自定义值step_env2，除了已经定义的值之外。注意，自定义值仅对特定的运行可用。

集成

使用集成的步骤可以通过环境变量访问集成的属性。环境变量的形式为:

int_ <集成名称> _ <标记>

对象的URL属性Artifactory集成命名myArtifactory通过一个环境变量:

$ printenv int_myArtifactory_url https://mycompany.com/artifactory/

您还可以通过使用集成的资源访问集成的属性。环境变量的形式为:

res_ < resource_name > _ <集成标签名称> _ <标记>

例如,一个图像资源中指定一个Artifactory集成注册表标签。您可以访问由Image资源使用的Artifactory集成的URL模板如下:

$ printenv res_myImage_registry_url https://mycompany.com/artifactory/

有关更多信息，请参见管道集成．

2022世界杯阿根廷预选赛赛程

中指定资源的步骤input2022世界杯阿根廷预选赛赛程resources可以通过环境变量访问该资源的属性。环境变量的形式为:

res_ <资源名称> _ <标记>

例如，您可以访问imageName财产的图像资源模板通过一个环境变量:

$ printenv res_myImage_imageName jfrog.local:5000/alpine37

有些资源维2022世界杯阿根廷预选赛赛程护可以作为环境变量访问的附加属性。这些资源类型包括:

• GitRepo

更多信息请参见管道资源2022世界杯阿根廷预选赛赛程．

基于资源的状态

此外，您可以向中指定的资源添加自己的属性output2022世界杯阿根廷预选赛赛程resources使用write_output效用函数．这可以用来创造有状态的管道．

可以将新附加的属性作为表单的环境变量访问res_{资源名称}_{键名}．例如，下面的代码在资源中创建三个属性模板．

sport="baseball" equipment="bat" field="diamond"

当在步骤中指定资源时inputsource，这些属性可以作为以下环境变量访问:

$ printenv res_myImage_baseball棒球$ printenv res_myImage_equipment bat $ printenv res_myImage_field钻石

有关运行状态的更多信息，请参见创建有状态的管道．

运行状态

您的管道可以定义自己的环境变量，并将它们添加到管道的运行状态中。这些对于管道运行中的所有步骤都是可用的。

使用用于运行状态管理的实用函数向当前运行状态添加新的环境变量。例如，步骤执行块中的以下行:

hero="Superman" villain="Lex Luthor"

将创建两个环境变量，可用于管道运行的当前和未来所有步骤:

英雄超人反派莱克斯·卢瑟

有关运行状态的更多信息，请参见创建有状态的管道．

管道状态

您的管道可以定义自己的环境变量，并将它们添加到管道状态中。这些对于管道的所有运行都是可用的。

使用用于管道状态管理的实用函数向当前运行状态添加新的环境变量。例如，步骤执行块中的以下行:

add_pipeline_variables动物=“狗”蔬菜=“胡萝卜”

将创建两个环境变量，可用于定义它们的管道的所有运行:

动物狗蔬菜胡萝卜

有关管道状态的更多信息，请参见创建有状态的管道．