# Pulumi Python 技能 ## 开发工作流程 ### 1\.项目设置 # 创建新的Python项目普鲁米新蟒蛇 # 或者使用特定于云的模板 pulumi 新的 aws-python pulumi 新的 azure-python pulumi 新 gcp-python **项目结构：** 我的项目/ ├── Pulumi.yaml ├── __main__.py ├──requirements.txt # 或 pyproject.toml └── venv/ # 虚拟环境 ### 2\.普鲁米电调集成使用 Pulumi ESC 进行集中机密和配置，而不是堆栈配置文件。 **将 ESC 环境链接到堆栈：** # 创建ESC环境 pulumi env init myorg/myproject-dev # 编辑环境 pulumi env 编辑 myorg/myproject-dev # 链接到 Pulumi 堆栈 pulumi 配置环境添加 myorg/myproject-dev **ESC 环境定义 (YAML)：** 价值观： # 静态配置 pulumi配置： aws:区域: us-west-2 myapp:instanceType: t3.medium # AWS 的动态 OIDC 凭证亚马逊：登录： fn::open::aws-登录：奥德克： roleArn: arn:aws:iam::123456789:role/pulumi-oidc 会话名称：pulumi-deploy # 从 AWS Secrets Manager 中提取机密秘密： fn::open::aws 秘密：区域：us-west-2 登录：${aws.login} 得到：数据库密码： SecretId：产品/数据库/密码 # 暴露环境变量环境变量： AWS_ACCESS_KEY_ID：${aws.login.accessKeyId} AWS_SECRET_ACCESS_KEY：${aws.login.secretAccessKey} AWS_SESSION_TOKEN：${aws.login.sessionToken} **验证ESC环境：** # 查看解析值（验证没有错误） pulumi env 打开 myorg/myproject-dev # 检查是否缺少必需的值 pulumi env 打开 myorg/myproject-dev --format json | jq . ### 3\. Python 模式 **基本资源创建：** 进口普鲁米将 pulumi_aws 导入为 aws # 从ESC获取配置配置 = pulumi.Config() instance_type = config.require("instanceType") # 创建带有适当标签的资源桶 = aws.s3.Bucket( “我的桶”，版本控制=aws.s3.BucketVersioningArgs( 启用=真， ), server_side_encryption_configuration=aws.s3.BucketServerSideEncryptionConfigurationArgs( 规则=aws.s3.BucketServerSideEncryptionConfigurationRuleArgs( apply_server_side_encryption_by_default=aws.s3.BucketServerSideEncryptionConfigurationRuleApplyServerSideEncryptionByDefaultArgs( sse_algorithm =“AES256”， ), ), ), 标签={ “环境”：pulumi.get_stack(), “管理者”：“Pulumi”， }, ） # 导出输出 pulumi.export("bucket_name",bucket.id) pulumi.export(“bucket_arn”,bucket.arn) **使用字典文字（简洁的替代方案）：** 进口普鲁米将 pulumi_aws 导入为 aws 桶 = aws.s3.Bucket( “我的桶”，版本控制={“启用”：True}，服务器端加密配置={ “规则”：{ “默认应用服务器端加密”：{ "sse_algorithm": "AES256", }, }, }, 标签={ “环境”：pulumi.get_stack(), “管理者”：“Pulumi”， }, ） **可重用性组件资源：** 进口普鲁米从 pulumi_aws 导入 lb WebServiceArgs 类： def __init__(self, 端口: pulumi.Input[int], image_uri: pulumi.Input[str]): self.port = 端口 self.image_uri = image_uri 类 WebService(pulumi.ComponentResource): url: pulumi.Output[str] def __init__(self, name: str, args: WebServiceArgs, opts: pulumi.ResourceOptions = None): super().__init__("custom:app:WebService", name, {}, opts) # 创建子资源，parent=self load_balancer = lb.LoadBalancer( f"{name}-lb", load_balancer_type =“应用程序”， # ... 配置 opts=pulumi.ResourceOptions(parent=self), ） self.url = load_balancer.dns_name self.register_outputs({ “url”：self.url， }) **跨堆栈依赖关系的堆栈引用：** 进口普鲁米 # 网络堆栈的参考输出 Networking_stack = pulumi.StackReference("myorg/networking/prod") vpc_id =networking_stack.get_output(“vpc_id”) subnet_ids = Networking_stack.get_output("private_subnet_ids") **使用输出：** 进口普鲁米 # 应用转换 uppercase_name = bucket.id.apply(lambda id: id.upper()) # 合并多个输出组合= pulumi.Output.all(bucket.id,bucket.arn).apply( lambda args：f“存储桶 {args[0]} 具有 ARN {args[1]}” ） # 使用 Output.concat 进行字符串插值 message = pulumi.Output.concat("存储桶 ARN："，bucket.arn) # 条件资源 is_prod = pulumi.get_stack() == "prod" 如果是_产品：警报 = aws.cloudwatch.MetricAlarm( “警报”， # ... 配置） ### 4\.将 ESC 与 pulumi env run 一起使用运行注入 ESC 环境变量的任何命令： # 使用 ESC 凭据运行 pulumi 命令 pulumi env run myorg/aws-dev -- pulumi up # 使用秘密运行测试 pulumi env 运行 myorg/test-env -- pytest # 打开环境并导出到shell pulumi env 打开 myorg/myproject-dev --format shell ### 5\.多语言组件在 Python 中创建可从任何 Pulumi 语言（TypeScript、Go、C#、Java、YAML）使用的组件。 **多语言组件的项目结构：** 我的组件/ ├── PulumiPlugin.yaml # 多语言必需 ├── pyproject.toml # 或requirements.txt └── __main__.py # 组件+入口点 **PulumiPlugin.yaml：** 运行时：Python **具有正确 Args 类的组件 (**main**.py):** 从输入 import 可选进口普鲁米从 pulumi 导入输入、输出、资源选项从 pulumi.provider.experimental 导入 component_provider_host 将 pulumi_aws 导入为 aws 类 SecureBucketArgs： """Args 类 - 对所有属性使用输入类型。""" def __init__( 自我, 存储桶名称：输入[str]，启用版本控制：可选[输入[布尔]] =无，标签：可选[输入[字典]] =无，）： self.bucket_name =bucket_name self.enable_versioning = enable_versioning 或 True self.tags = 标签类 SecureBucket(pulumi.ComponentResource): """具有加密和版本控制功能的安全 S3 存储桶。""" Bucket_id：输出[str] Bucket_arn：输出[str] # 构造函数必须有带有类型注释的“args”参数 def __init__( 自我, 名称：str， args：SecureBucketArgs， opts：可选[资源选项] = 无，）： super().__init__("myorg:storage:SecureBucket", name, {}, opts) 桶 = aws.s3.Bucket( f"{name}-桶", 桶=args.bucket_name, 版本控制={"启用": args.enable_versioning}, 服务器端加密配置={ “规则”：{ “默认应用服务器端加密”：{ "sse_algorithm": "AES256", }, }, }, 标签=args.tags, opts=ResourceOptions(父=自身), ） self.bucket_id = Bucket.id self.bucket_arn = Bucket.arn self.register_outputs({ “bucket_id”：self.bucket_id， “bucket_arn”：self.bucket_arn， }) # 多语言支持的入口点如果 __name__ == "__main__": 组件提供者主机（名称=“python组件”，组件=[SecureBucket], ） **多语言消费发布：** # 从 git 存储库使用 pulumi 包添加 github.com/myorg/my-component # 带版本标签 pulumi 包添加 github.com/myorg/my-component@v1.0.0 # 本地开发 pulumi 包添加 /path/to/local/my-component **多语言参数要求：** * 对所有属性使用 `pulumi.Input[T]` 类型提示 * Args 类必须具有带类型参数的 __init__` * 构造函数必须有带有类型注释的“args”参数 * 使用 `Optional[Input[T]]` 作为可选属性 ### 6\.部署工作流程 **验证和部署并进行错误恢复：** # 第 1 步：预览更改普鲁米预览 # 第 2 步：检查输出是否有错误或意外更改 # 如果出现错误，请修复代码并重新运行预览 # 步骤3：预览成功后才部署普鲁米向上 # 第 4 步：验证输出 pulumi堆栈输出 **对于基于 ESC 的部署：** # 第 1 步：验证 ESC 环境正确解析 pulumi env 打开 myorg/myproject-dev # 第2步：使用ESC环境进行预览 pulumi env run myorg/myproject-dev -- pulumi 预览 # 步骤3：使用ESC环境进行部署 pulumi env run myorg/myproject-dev -- pulumi up # 第 4 步：检查堆栈输出 pulumi堆栈输出 ## 配置和安全 * 对所有机密使用 Pulumi ESC — 切勿将机密提交到堆栈配置文件或 Pulumi.yaml * 启用 OIDC 身份验证而不是静态凭据 * 尽可能使用具有短 TTL 的动态机密 * 将最低权限 IAM 策略应用于 OIDC 角色 * 使用 ComponentResources 实现可重用的基础架构模式 * 利用 Python 类型提示获得更好的 IDE 支持和错误检测 ## 常用命令 # 环境命令 (pulumi env) pulumi env init // # 创建环境 pulumi env edit / # 编辑环境 pulumi env open / # 查看解析值 pulumi env run / -- # 使用环境变量运行 pulumi env version tag / # 标签版本 # 普鲁米命令 pulumi new python # 新项目 pulumi config env add / # 链接ESC环境 pulumi Preview # 预览更改 pulumi up # 部署 pulumi 堆栈输出 # 查看输出 pulumi destroy # 拆毁 # 依赖管理 pip install -rrequirements.txt # 安装 deps (pip) 诗歌 add pulumi-aws # 添加 dep (诗歌) uv add pulumi-aws # 添加 dep (uv) ## Python 特定配置 **使用 pip（默认）：** # Pulumi.yaml 运行时间：名称：蟒蛇选项：工具链：pip 虚拟环境：venv **使用诗歌：** # Pulumi.yaml 运行时间：名称：蟒蛇选项：工具链：诗歌 **使用紫外线：** # Pulumi.yaml 运行时间：名称：蟒蛇选项：工具链：紫外线虚拟环境：.venv **启用类型检查：** # Pulumi.yaml 运行时间：名称：蟒蛇选项：类型检查器：mypy # 或 Pyright ## 参考文献 * [references/pulumi-esc.md]() \- ESC 模式和命令 * [references/pulumi-patterns.md]() \- 常见基础设施模式 * [references/pulumi-python.md]() \- Python 特定指南 * [references/pulumi-best-practices-aws.md]() \- AWS 最佳实践 * [references/pulumi-best-practices-azure.md]() \- Azure 最佳实践 * [references/pulumi-best-practices-gcp.md]() \- GCP 最佳实践

蟒蛇的肺

包含技能