You need to enable JavaScript to run this app.
文档中心
云控制API

云控制API

请输入
  • 文档首页
    • 云控制APICloudControlAPI的关联产品Pulumi
复制全文
下载 pdf
我的收藏
CloudControlAPI的关联产品
Pulumi
复制全文
下载 pdf
我的收藏
Pulumi
更多 Pulumi 的说明和使用参考：了解 cc 版本的 Pulumi​
产品简介​
Pulumi 是一款基础架构即代码的自动化工具，支持使用如 Go、Java、Python、JavaScript、C# 等常见编程语言编写编排模板，以实现云基础设施的构建、部署和管理。​
火山引擎基于 CloudControl API 生成了全新的 Pulumi Provider Volcenginecc，该版本完全遵循 CloudControl API 设计理念和资源模型，为客户提供了更规范、便捷、一致的 Pulumi 集成方式，您可以前往 Pulumi 官网 查看细节：​
​​​
快速安装 Pulumi Provider Volcenginecc​
安装 Pulumi​
  1. 访问 Pulumi 官网，选择对应操作系统的安装包并下载，并将 Pulumi 可执行文件所在目录添加到系统环境变量中。​
  1. 在命令行中执行pulumi验证配置路径是否可用，若为下图结果说明 Pulumi 可以正常运行。​
​​​
配置凭证信息​
  1. 使用 Pulumi 管理火山引擎的云资源前，您需要获取 AK/SK，密钥获取方式参考 访问密钥。​
  1. 本文以在环境变量中配置密钥为例：​
​
$ export VOLCENGINE_ACCESS_KEY="your_public_key"​
$ export VOLCENGINE_SECRET_KEY="your_private_key"​
$ export VOLCENGINE_REGION="cn-beijing"​
​
新建 Pulumi 项目​
  1. 使用 pulumi new在本地新建一个工作目录，并且根据提示选择合适的模板，并且按照提示输入项目名称、项目描述、堆栈名称等信息。​
​​​
  1. 项目创建完成后将会生成文件目录​
​​​
其中​
  • __main__.py：用于编写需要执行的 IaC 的代码。​
  • Pulumi.yaml：包含项目元信息，例如项目名称、描述、语言等。​
  • Pulumi.dev.yaml：存储堆栈的配置信息，例如区域。​
  • requirements.txt：列出项目依赖的Python 模块。 ​
  1. 安装对应的依赖包，如Python的安装方式：pip install -r requirements.txt​
执行 Pulumi 脚本​
  1. 编写 IaC 代码​
​
import pulumi​
import pulumi_volcenginecc as ve​
import os​
​
# 从环境变量获取访问密钥或提供默认值（生产环境中请使用安全的方式管理凭证）​
access_key = os.getenv("VOLCENGINE_ACCESS_KEY", "")​
secret_key = os.getenv("VOLCENGINE_SECRET_KEY", "")​
​
provider = ve.Provider("volcengine",​
access_key=access_key,​
secret_key=secret_key,​
region="cn-beijing",​
endpoints={​
"cloudcontrolapi": "cloudcontrol.cn-beijing.volcengineapi.com"​
}​
)​
args = ve.iam.UserArgs(​
user_name="pulumi-python-user-demo",​
description="pulumi user description update",​
display_name="pulumi-python-user-diplay",​
policies=[​
ve.iam.UserPolicyArgs(policy_name="ReadOnlyAccess", policy_type="System"),​
ve.iam.UserPolicyArgs(policy_name="TOSReadOnlyAccess", policy_type="System")​
],​
tags=[​
ve.iam.UserTagArgs(key="usage", value="pulumi-test")​
]​
)​
user = ve.iam.User("pulumi-python-user-demo", args, opts=pulumi.ResourceOptions(provider=provider))​
​
  1. 进入 __main__.py 文件所在的目录，执行pulumi up返回如下​
​​​
  1. 选择details查看执行详情确认信息没问题​
​​​
  1. 选择yes执行部署​
​​​
  1. 前往相关产品控制台查看创建结果​
​​​
支持的云资源​
您可以前往 Pulumi 官网 查看当前支持编排的资源​
Provider volcengine 和 volcenginecc​
volcengine 和 volcenginecc 是两个完全独立的 Pulumi Provider，我们推荐客户优先集成 volcenginecc 版本。若有联合使用的场景，也可以通过配置两个 Provider 的方式实现。​
​
import pulumi​
import pulumi_volcenginecc as vecc​
import pulumi_volcengine as ve​
​
policy = ve.iam.Policy("ve-policy",​
description="-policy",​
policy_document="{\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"auto_scaling:DescribeScalingGroups\"],\"Resource\":[\"*\"]}]}",​
policy_name="ve-policy"​
)​
​
user = vecc.iam.User("vecc-user",​
user_name="vecc-user",​
description="vecc-user",​
display_name="vecc-user",​
policies=[vecc.iam.UserPolicyArgs(policy_name="ve-policy", policy_type="Custom")],​
opts=pulumi.ResourceOptions(depends_on=[policy])​
)​
​
最近更新时间：2026.03.17 18:21:28
这个页面对您有帮助吗？
有用
有用
无用
无用