AWS CloudFormation¶

AWS CloudFormation 使您能够以可预测和重复的方式创建和配置 AWS 基础设施部署。它帮助您利用 Amazon EC2、Amazon Elastic Block Store、Amazon SNS、Elastic Load Balancing 和 Auto Scaling 等 AWS 产品，在云中构建高度可靠、高度可扩展、经济高效的应用程序，而无需担心创建和配置底层 AWS 基础设施。AWS CloudFormation 使您可以使用模板文件将资源集合作为一个单元（堆栈）一起创建和删除。

先决条件任务¶

要使用这些操作符，您必须完成以下几件事：

使用 AWS 控制台或 AWS CLI 创建必要的资源。
通过 pip 安装 API 库。
pip install 'apache-airflow[amazon]'
详细信息请参阅Airflow® 的安装
设置连接.

通用参数¶

aws_conn_id

引用 Amazon Web Services 连接 ID。如果此参数设置为 None，则使用默认的 boto3 行为，不进行连接查找。否则，使用存储在连接中的凭据。默认值：aws_default

region_name

AWS 区域名称。如果此参数设置为 None 或省略，则将使用 AWS 连接额外参数中的 region_name。否则，使用指定的值而不是连接值。默认值：None

verify

是否验证 SSL 证书。

False - 不验证 SSL 证书。
path/to/cert/bundle.pem - 要使用的 CA 证书包的文件名。如果要使用与 botocore 使用的 CA 证书包不同的 CA 证书包，可以指定此参数。

如果此参数设置为 None 或省略，则将使用 AWS 连接额外参数中的 verify。否则，使用指定的值而不是连接值。默认值：None

botocore_config

提供的字典用于构造 botocore.config.Config。此配置可用于配置避免节流异常、超时等。

例如，有关参数的更多详细信息，请参阅 botocore.config.Config¶

{
    "signature_version": "unsigned",
    "s3": {
        "us_east_1_regional_endpoint": True,
    },
    "retries": {
      "mode": "standard",
      "max_attempts": 10,
    },
    "connect_timeout": 300,
    "read_timeout": 300,
    "tcp_keepalive": True,
}

如果此参数设置为 None 或省略，则将使用 AWS 连接额外参数中的 config_kwargs。否则，使用指定的值而不是连接值。默认值：None

注意

指定一个空字典，{}，将覆盖 botocore.config.Config 的连接配置。

操作符¶

创建 AWS CloudFormation 堆栈¶

要创建新的 AWS CloudFormation 堆栈，请使用 CloudFormationCreateStackOperator。

tests/system/amazon/aws/example_cloudformation.py

create_stack = CloudFormationCreateStackOperator(
    task_id="create_stack",
    stack_name=cloudformation_stack_name,
    cloudformation_parameters=cloudformation_create_parameters,
)

删除 AWS CloudFormation 堆栈¶

要删除 AWS CloudFormation 堆栈，可以使用 CloudFormationDeleteStackOperator。

tests/system/amazon/aws/example_cloudformation.py

delete_stack = CloudFormationDeleteStackOperator(
    task_id="delete_stack",
    stack_name=cloudformation_stack_name,
)

传感器¶

等待 AWS CloudFormation 堆栈创建状态¶

要等待 AWS CloudFormation 堆栈创建状态，直到它达到终端状态，可以使用 CloudFormationCreateStackSensor。

tests/system/amazon/aws/example_cloudformation.py

wait_for_stack_create = CloudFormationCreateStackSensor(
    task_id="wait_for_stack_create",
    stack_name=cloudformation_stack_name,
)

等待 AWS CloudFormation 堆栈删除状态¶

要等待 AWS CloudFormation 堆栈删除状态，直到它达到终端状态，可以使用 CloudFormationDeleteStackSensor。

tests/system/amazon/aws/example_cloudformation.py

wait_for_stack_delete = CloudFormationDeleteStackSensor(
    task_id="wait_for_stack_delete",
    stack_name=cloudformation_stack_name,
)

参考¶

CloudFormation 的 AWS boto3 库文档