本文介绍使用 Terraform 创建工作空间的方法。

准备工作

1. 从 Terraform 官网下载安装所需的版本。详细操作，请参见 Terraform 官方文档。

2. 在 Terraform 中配置火山引擎账号信息

export VOLCENGINE_ACCESS_KEY="AKLTMWZkZWM******"
export VOLCENGINE_SECRET_KEY="Wm1Rd09U******"
export VOLCENGINE_REGION="cn-beijing"

参数说明如下表所示。

通过配置文件 provider 部分，指定身份认证信息

provider "volcengine" {
  access_key = "AKLTMWZkZWM******"
  secret_key = "Wm1Rd09U******"
  session_token = "sts token"
  region = "cn-beijing"
}

创建工作空间

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

variable "common" {
	  type = object({
	    region    = string
	  })
	  default = {
	    # 实例所处的地域
	    region = "cn-beijing" 
	  }
	}
provider "volcengine" {
	  # 火山引擎账号的 AK
	  access_key = "AK****************************" 
	  # 火山引擎账号的SK
	  secret_key = "****************************"  
	  region = var.common.region
	}
resource "volcengine_bioos_workspace" "foo" {
  name        = "test-workspace2"         //必填
  description = "test-description23"      //必填
  cover_path  = "template-cover/pic5.png" //选填
}

2. 初始化 Terraform 运行环境

terraform init

3. 进行资源规划

terraform plan

4. 创建工作空间

terraform apply

常见问题

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。