## 产品简介 OpenTofu 是 Terraform 的开源分支，也是一款基础设施即代码（Infrastructure as Code）工具，由 Tofu 社区维护，采用更开放的 Apache 2.0 协议。其核心功能、HCL 语法及云提供商生态与 Terraform 高度兼容，适合重视开源自由度的用户。火山引擎基于 CloudControl API 生成了全新的 OpenTofu Provider volcenginecc，该版本完全遵循 CloudControl API 设计理念和资源模型，为客户提供了更规范、便捷、一致的 OpenTofu 集成方式，您可以前往 [OpenTofu 官网](https://search.opentofu.org/provider/volcengine/volcenginecc/latest) 查看细节： ![图片](https://bytedance.larkoffice.com/space/api/box/stream/download/asynccode/?code=OGEyMTQ4ZWJhNGM3MTAyYzZmMzY1ODZjN2UwZjczODRfOUVrT2ZuVUswRW1EU1hOazRwTllXaWdhUTZMVnZ3UllfVG9rZW46V3YwcWI5YjBEb1hUcGp4aGRpemNpaGlsbkViXzE3NzM3NDkxNzQ6MTc3Mzc1Mjc3NF9WNA&add_watermark=true&scene_type=CCM =3050x) ## 快速安装 OpenTofu Provider volcenginecc ### 安装 OpenTofu 1. 访问 [OpenTofu 官网](https://opentofu.org.cn/docs/intro/install/)，选择对应操作系统的安装包并下载，并将 OpenTofu 可执行文件所在目录添加到系统环境变量中。 2. 在命令行中执行 tofu 验证配置路径是否可用，若为下图结果说明 Terraform 可以正常运行。 ![图片](https://bytedance.larkoffice.com/space/api/box/stream/download/asynccode/?code=Zjc0NTZmOGRiNDU2MTYxNGNmNDlkZDFjZWMyMmMxNjlfckh0am9sMEFGRUI3RGtiNVpyVjZOM0FIVWtJMGlDWG5fVG9rZW46VHN1RmIzaEszb2NLRGl4NXZRdWNtS2ZKbjhmXzE3NzM3NDkxNzQ6MTc3Mzc1Mjc3NF9WNA&add_watermark=true&scene_type=CCM =1378x) ### 配置凭证信息 1. 使用 OpenTofu 管理火山引擎的云资源前，您需要获取 AK/SK，密钥获取方式参考 [访问密钥](https://www.volcengine.com/docs/6291/65568)。 2. 本文以在环境变量中配置密钥为例： ```Plain Text $ export VOLCENGINE_ACCESS_KEY="your_public_key" $ export VOLCENGINE_SECRET_KEY="your_private_key" $ export VOLCENGINE_REGION="cn-beijing" ``` ### 配置 OpenTofu 脚本 1. 创建一个文件夹，并在文件夹下创建一个 OpenTofu 配置文件，配置文件名称为 main.tf。 2. 配置 OpenTofu Provider 信息，version 信息请从 [OpenTofu 官网](https://search.opentofu.org/provider/volcengine/volcenginecc/latest) 获取，添加内容如下 ```Plain Text terraform { required_providers { volcenginecc = { source = "volcengine/volcenginecc" version = "~> 0.0.6" } } } ``` 3. 编写 OpenTofu 创建 VPC 的脚本，配置方式参考：[volcenginecc_vpc_vpc](https://search.opentofu.org/provider/volcengine/volcenginecc/latest/docs/resources/vpc_vpc) ```Plain Text # Create VPC resource "volcenginecc_vpc_vpc" "VpcDemo" { vpc_name = "vpc-demo" description = "VpcDemo Example" cidr_block = "192.168.0.0/24" support_ipv_4_gateway = true project_name = "default" tags = [ { key = "env" value = "test" } ] } # Query VPC data "volcenginecc_vpc_vpc" "VpcDataSource" { id = volcenginecc_vpc_vpc.VpcDemo.id } ``` ### 执行 OpenTofu 脚本 1. 进入 main.tf 文件所在的目录，执行 tofu init 进行初始化，返回如下 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_bd68c95538345dc84797331df9025fb1.png =1394x) 2. 执行 tofu plan 创建执行计划，返回如下 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_7d4da33dc119e0649bd4fbea796e72ad.png =806x) 3. 执行 tofu apply 执行创建资源计划，根据提示输入 yes，创建完成结果可以前往产品控制台验证 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_bf71dd9700c511ae8f6f42bcc0aa95de.png =1584x) 4. 当不再需要所创建的资源时，可以通过 tofu destroy 命令销毁当前文件已创建的资源，请谨慎操作。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f9d3e0dede5b459c213fccf14831411b.png =1308x) ## OpenTofu 和 Terraform 的使用区别 OpenTofu 完全兼容 Terraform 语法，可复用。tf 文件，支持 tofu 命令，从 Terraform 迁移至 OpenTofu 的可参考 [OpenTofu 官网](https://opentofu.org.cn/docs/intro/migration/) 声明的注意事项。 ## 支持的云资源您可以前往 [OpenTofu 官网](https://search.opentofu.org/provider/volcengine/volcenginecc/latest) 查看当前支持编排的资源 ## Provider volcengine 和 volcenginecc [volcengine](https://registry.terraform.io/providers/volcengine/volcengine/latest/docs) 和 [volcenginecc](https://registry.terraform.io/providers/volcengine/volcenginecc/latest/docs) 是两个完全独立的 OpenTofu Provider，我们推荐客户优先集成 volcenginecc 版本。若有联合使用的场景，也可以通过下述配置 Provider 的方式实现 ```Plain Text terraform { required_providers { volcengine = { source = "volcengine/volcengine" version = ">= 0.0.173" } volcenginecc = { source = "volcengine/volcenginecc" version = ">= 0.0.6" } } } # use volcenginecc create vpc resource "volcenginecc_vpc_vpc" "tfcc_vpc" { vpc_name = "vpc-demo" cidr_block = "172.16.0.0/16" } # use volcengine create route_table resource "volcengine_route_table" "tf_route_table" { vpc_id = volcenginecc_vpc_vpc.tfcc_vpc.vpc_id route_table_name = "route-table-demo" } ```