本文介绍使用 Terraform 创建镜像仓库标准版实例的方法。 ## 准备工作 * 安装 Terraform。 :::warning 请安装 [Terraform v0.12.31](https://releases.hashicorp.com/terraform/0.12.31/) 版本。您可以通过`terraform version`命令查看版本信息。 ::: * 在 `~/.terraform.d/plugins/darwin_amd64` 添加 `terraform-provider-volcengine` 文件。 * 获取火山引擎账号的密钥和实例所在地域的信息。 |参数 |说明 | |---|---| |access_key |您火山引擎账号的 AccessKey ID（AK）。获取方式，请参见 [访问密钥使用指南](https://www.volcengine.com/docs/6291/65568)。 | |secret_key |您火山引擎账号的 Secret Access Key（SK）。获取方式，请参见 [访问密钥使用指南](https://www.volcengine.com/docs/6291/65568)。 | |region |您容器服务业务所在的地域。例如 `cn-guangzhou`。 | ## 操作步骤 1. 登录已安装的 Terraform 终端。 2. 创建一个文件夹，并在该文件夹中创建名为`main.tf`的配置文件。 ```bash variable "common" { type = object({ registry = string region = string }) default = { # 实例的名称 registry = "{your_instance_name}" # 实例所处的地域 region = "cn-guangzhou" } } provider "volcengine" { # 火山引擎账号的 AK access_key = "AKLT****" # 火山引擎账号的 SK secret_key = "WTJG****" region = var.common.region } resource "volcengine_cr_registry" "label" { name = var.common.registry delete_immediately=false # 设置实例的登录密码 password = "{your_password}" } output "create_registry" { value = volcengine_cr_registry.label } ``` 3. 初始化 Terraform 运行环境。 ```bash terraform init ``` 4. 进行资源规划。 ```bash terraform plan ``` 5. 创建实例并且设置实例密码。 :::warning 本命令需要执行两次，分别完成实例的创建和密码的设置。 ::: ```bash terraform apply -auto-approve ``` ## 操作结果执行完成后登录控制台，查看已创建的实例。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a61ea051dd669c1c681e5624573303e4.png =1268x) ## 常见问题 ### Q：执行 `terraform plan` 时报错 `permission denied`。 A：出现报错 `Error: Failed to instantiate provider "volcengine" to obtain schema: fork/exec /Users/bytedance/.terraform.d/plugins/darwin_amd64/terraform-provider-volcengine: permission denied` 的原因是没有授予 `terraform-provider-volcengine` 文件的执行权限。请授予相应的文件执行权限。授权命令示例： `chmod 755 ~/.terraform.d/plugins/darwin_amd64/terraform-provider-volcengine`。 ### Q：执行 `terraform plan` 时报错 `Error on reading XXX,XXX is not exist`。 A：`terraform apply` 以后会生成`terraform.tfstate` 这个文件，作用是记录本地资源创删状态。但是再次手动执行 `terraform apply` 后会误报资源已存在。解决的办法是手动删除这个文件，执行命令为 `rm terraform.tfstate terraform.tfstate.backup`。