本文介绍使用 Terraform 创建镜像仓库标准版实例的方法。

准备工作

• 安装 Terraform。

  注意

  请安装 Terraform v0.12.31 版本。您可以通过terraform version命令查看版本信息。

• 在 ~/.terraform.d/plugins/darwin_amd64 添加 terraform-provider-volcengine 文件。
  

  

  terraform-provider-volcengine

  35.57MB

  

• 获取火山引擎账号的密钥和实例所在地域的信息。

  参数	说明
  access_key	您火山引擎账号的 AccessKey ID（AK）。获取方式，请参见 访问密钥使用指南。
  secret_key	您火山引擎账号的 Secret Access Key（SK）。获取方式，请参见 访问密钥使用指南。
  region	您容器服务业务所在的地域。例如 cn-guangzhou。

操作步骤

1. 登录已安装的 Terraform 终端。

2. 创建一个文件夹，并在该文件夹中创建名为main.tf的配置文件。

   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 运行环境。

   terraform init
   

4. 进行资源规划。

   terraform plan
   

5. 创建实例并且设置实例密码。

   注意

   本命令需要执行两次，分别完成实例的创建和密码的设置。

   terraform apply -auto-approve
   

操作结果

执行完成后登录控制台，查看已创建的实例。

常见问题

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。