阶段设置

阶段设置是指对流水线的某个阶段的执行环境和执行条件等的设置。

包括环境变量、执行环境和执行条件，环境变量为key-value形式，键名必须唯一。

环境变量

设置该阶段可用的环境变量值，为key-value形式，环境变量的键名必须唯一。

• 该阶段的已有环境变量包括流水线的环境变量和阶段（包括所属并行阶段）中设置的环境变量。

• 如果阶段中的环境变量与流水线中的环境变量重复，则阶段执行时以阶段中设置的环境变量为准。

执行环境

• 默认

  设置该阶段的执行环境，可选择默认执行环境或者启动新的容器作为执行环境。

• Docker容器

  启动Docker容器作为执行环境时，请设置执行环境镜像，私有镜像需要设置认证。可指定ENTRYPOINT、ENV等设置，可以增加缓存路径，将执行环境中的若干个路径缓存下来，以此节省构建时间。

  

• Dockerfile路径

  Dockerfile路径，通过Dockerfile来构建所需镜像，需要指定Dockerfile路径和构建参数，同时也可以设置缓存路径。

  

• Dockerfile内容

  Dockerfile内容，通过Dockerfile来构建所需镜像，需要指定Dockerfile内容和构建参数，同时也可以设置缓存路径。

  设置阶段的执行环境为自定义容器环境时，可设置某阶段执行时的一个或者多个缓存路径，以节省构建时间。

  

执行条件

可设置该阶段在满足特定条件时执行，在不满足条件时跳过，以便更灵活的控制CI/CD项目。可将执行条件设置为以下一种：

• 总是执行

  该阶段的执行无前置条件，总是执行。默认为总是执行。

• 满足以下任意条件时执行

  可设置多个条件，满足任意条件之一时执行阶段。条件可设置为环境变量。

  

  • 执行条件中可用的环境变量包括CI/CD项目的全局环境变量和该阶段（包括所属并行阶段）中设置的环境变量。

  • 如果CI/CD项目和该阶段中有相同的环境变量key值，则以该阶段的环境变量值为准。

• 满足以下全部条件时执行

  可设置多个条件，所有条件都满足时执行阶段。条件可设置为环境变量。

  

  • 执行条件中可用的环境变量包括CI/CD项目的全局环境变量和该阶段（包括所属并行阶段）中设置的环境变量。

  • 如果CI/CD项目和该阶段中有相同的环境变量key值，则以该阶段的环境变量值为准。

阶段设置

• 阶段重命名，可自定义阶段名称，以便区别。

• 向左、向右新建阶段，可以在当前阶段的左面或者右面新建一个阶段。

• 禁用、启用阶段，搭配使用，启用后可以禁用，禁用后可以启用，禁用后在执行CI/CD时不会执行此阶段。

• 删除阶段，将当前阶段删除。