DeploymentWindow - AWS CodePipeline

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

DeploymentWindow

创建条件时,可以添加DeploymentWindow规则。本节提供规则参数的参考。有关规则和条件的更多信息,请参阅舞台条件如何运作?

重要

如果规则和DeploymentWindow规则一起包含在输入条件中,则CloudWatchAlarm警报可能会在DeploymentWindow规则的部署窗口打开之前成功发出警报。CloudWatchAlarm部署窗口打开后, CodePipeline 不再检查CloudWatchAlarm警报。当管道执行进入阶段时,这可能会导致警报状态。

Rule type

  • 类别:Rule

  • 拥有者:AWS

  • 提供方:DeploymentWindow

  • 版本:1

配置参数

Cron

必需:是

定义允许部署的日期和时间的表达式。Cron 表达式由 6 个必填字段和一个用空格分隔的可选字段组成。cron 表达式字段允许您使用 cron 表达式指定计划模式,如下所示。

字段名称 允许的值 允许的特殊字符
不适用 *
分钟 0-59 , - * /
小时 0-23 , - * /
D ay-of-month 1-31 , - * ? / L W
1-12 或 JAN-DEC , - * /
一周中的某一天 1-7 或 SUN-SAT , - * ? / L #
年份(可选) 空,1970-2199 , - * /
  • '*'字符用于指定所有值。例如,分钟字段中的 “*” 表示 “每分钟”。

  • '?' day-of-month和 day-of-week字段允许使用字符。它用于指定 “无特定值”。当你需要在两个字段中的一个字段中指定某些内容,但不能在另一个字段中指定内容时,这很有用。

  • “-” 字符用于指定范围。例如,小时字段中的 “10-12” 表示 “10、11 和 12 小时”。

  • ',' 字符用于指定其他值。例如, day-of-week字段中的 FRI “MONWED、” 表示 “星期一、星期三和星期五”。

  • '/'字符用于指定增量。例如,秒字段中的 “0/15” 表示 “秒 0、15、30 和 45”。秒字段中的 “5/15” 表示 “秒 5、20、35 和 50”。在 '/' 之前指定 '*' 等同于指定 0 作为开头的值。

  • day-of-month和字段允许使用 'L' day-of-week 字符。这个字符是 “last” 的简写,但它在两个字段中的每个字段中都有不同的含义。例如,该 day-of-month字段中的值 “L” 表示 “该月的最后一天” ——1 月为 31 日,非闰年为 2 月,第 28 天。如果在 day-of-week字段中单独使用,则仅表示 “7” 或 “SAT”。但是,如果在 day-of-week字段中使用另一个值之后,则表示 “<specified_day>该月的最后一天” ——例如,“6L” 表示 “该月的最后一个星期五”。您还可以指定与该月最后一天的偏移量,例如 “L-3”,表示日历月中的某 third-to-last一天。

  • 该字段允许使用 'W' day-of-month 字符。此字符用于指定最接近给定日期的工作日(周一至周五)。例如,如果您要指定 “15W” 作为该 day-of-month字段的值,则含义是:“距离该月15日最近的工作日”。因此,如果15日是星期六,则触发器将在14日星期五触发。如果15日是星期日,则触发器将在16日星期一触发。如果15日是星期二,那么它将在15日星期二开火。

  • 也可以将 “L” 和 “W” 字符组合在一起,使 day-of-month表达式生成 “LW”,意思是 “该月的最后一个工作日”。

  • 该字段允许使用 '#' day-of-week 字符。此字符用于指定该<specified_day>月的 “第 n 个” 天。例如,该 day-of-week字段中的 “6 #3” 值表示该月的第三个星期五(第 6 天 = 星期五,“#3” = 该月的第三个星期五)。

  • 合法字符以及月份和星期的名称不区分大小写。

TimeZone

必需:否

部署时段的时区。正则表达式匹配以下格式的模式:

  • 地区/城市格式。该值与 Region/City or Region/City _City 格式的时区相匹配。例如,America/New_YorkEurope/Berlin

  • UTC格式。该值匹配字符串UTC(可选),后面加上 +HH: MM 或-HH: MM 格式的偏移量。例如、、或。UTC UTC+05:30 UTC-03:00如果未设置该参数,则这是默认格式。

  • 缩写格式。该值匹配时区的 3 到 5 个字符的缩写。例如,ESTIST

    有关有效 TimeZone ID 值的表,请参阅 https://docs.oracle.com/middleware/1221/ wcs/tag-ref/MISC/TimeZones .html。请注意,某些缩写是重复的缩写,例如CST中部标准时间、中国标准时间和古巴标准时间。

规则配置示例

YAML
- name: MyDeploymentRule ruleTypeId: category: Rule owner: AWS provider: DeploymentWindow version: '1' configuration: Cron: 0 0 9-17 ? * MON-FRI * TimeZone: PST inputArtifacts: [] region: us-east-1
JSON
[ { "name": "MyDeploymentRule", "ruleTypeId": { "category": "Rule", "owner": "AWS", "provider": "DeploymentWindow", "version": "1" }, "configuration": { "Cron": "0 0 9-17 ? * MON-FRI *", "TimeZone": "PST" }, "inputArtifacts": [], "region": "us-east-1" } ]

在您使用此规则时,以下相关资源可以为您提供帮助。