操作说明

示例过程中，操作指引将全程在页面右侧陪伴您。该过程预计耗时10分钟。

在本次示例中，您将完成以下5个任务：

1. 创建一个简单的示例模板

2. 基于示例模板创建资源栈

3. 评估部署产生的费用和资源变更

4. 部署资源栈

5. 检查资源部署结果

操作步骤

在资源编排控制台首页，您可点击 点我开始，手把手带您轻松入门，进入示例流程。

步骤1：创建示例模板

模板是创建资源栈的配置说明，创建资源栈前，请先创建一个模板。您可在模板中按照terraform语法描述一组资源的配置，ROS即可为您一键创建对应资源，更多信息可参考 创建模板

1. 在模板列表，点击 创建模板

2. 在创建模板页，创建、编写模板，点击 立即创建

模板main.tf文件中声明了1个虚拟私有云和1个子网，具体内容如下：

# terraform块：Terraform的顶层配置块，用于设置Terraform本身的行为和需求
terraform {
  
  # required_providers块：指定此配置需要哪些提供商(provider)及其版本
  required_providers {
    ctyun = {

      # 天翼云Terraform提供商，由ctyun-it组织维护
      source  = "ctyun-it/ctyun"

      # version：指定所需的提供商版本，确保使用兼容的版本
      # 这里指定使用2.1.0版本，避免因版本更新导致的兼容性问题
      version = "2.1.0"
    }
  }
}

locals {

  # 生成当前时间戳的哈希值
  hash = sha256(timestamp())

  # 从哈希结果中截取字符（转为小写并移除特殊字符）
  random_string = substr(
    replace(
      lower(local.hash),
      "/[^a-z0-9]/",
      ""  # 移除所有非字母数字的字符
    ),
    0, 5  # 截取前10个字符
  )
}

# 资源池和企业项目
# provider块：配置并初始化ctyun提供商，用于与天翼云API进行认证和通信
provider "ctyun" {
}

# 创建VPC
# resource块：定义要创建的基础设施资源
# "ctyun_vpc"是资源类型，表示要创建一个天翼云的VPC(虚拟私有云)
# "vpc_test"是资源名称，在Terraform配置中用于引用此资源
resource "ctyun_vpc" "vpc_test" {

  # name：VPC的名称，在控制台上显示的名称
  name        = "ros-example-vpc-${local.random_string}"    
   
  # cidr：VPC的IP地址范围，使用CIDR表示法
  # 这里设置为192.168.0.0/16，表示VPC内可用的IP地址范
  cidr        = "192.168.0.0/16"

  # description：VPC的描述信息，用于说明此VPC的用途
  description = "example vpc"
}

# 创建子网
# resource块：定义要创建的子网资源
# "ctyun_subnet"是资源类型，表示要创建一个天翼云子网
# "subnet_test"是资源名称，用于在Terraform配置中引用此子网
resource "ctyun_subnet" "subnet_test" {

  # vpc_id：指定此子网所属的VPC ID
  # 这里通过引用之前创建的VPC资源的ID属性，建立了资源之间的依赖关系
  # Terraform会自动先创建VPC，再创建子网
  vpc_id      = ctyun_vpc.vpc_test.id

  # name：子网的名称，在控制台上显示的名称
  name        = "ros-example-subnet-${local.random_string}"

  # cidr：子网的IP地址范围，必须在所属VPC的CIDR范围内
  # 这里设置为192.168.1.0/24，表示此子网有256个IP地址(实际可用253个)
  cidr        = "192.168.1.0/24"

  # description：子网的描述信息
  description = "example subnet"

  # dns：为此子网中的云资源指定DNS服务器地址
  # 这里是一个列表，可以配置多个DNS服务器
  dns = [
    "114.114.114.114",  # 国内常用的公共DNS
    "8.8.8.8"           # Google的公共DNS
  ]
}

步骤2：基于示例模板创建资源栈

模板是创建资源栈的配置说明。示例模板已创建成功，您可基于示例模板创建资源栈。更多信息可查看 创建资源栈

1. 示例模板创建成功，您可以在模板详情中查看具体信息

2. 点击 创建资源栈，基于当前示例模板创建资源栈

3. 在创建页面，选择示例模板，点击 创建执行计划

步骤3：评估部署产生和费用和资源变更

资源栈已创建成功，您可通过浏览执行计划（执行计划是一套资源栈配置的记录），评估部署将产生的费用变更、资源变更。全部确认完毕后，再部署资源栈。更多信息可查看 查询执行计划

1. 在资源栈详情的执行计划列表，点击页面右上角 刷新icon 刷新状态，等待执行计划创建完成

2. 点击 刚创建的执行计划 ，进入详情查看部署配置内容

3. 在执行计划详情，为保证部署正确，您可检查以下内容：

• 资源配置信息：即 模板内容

• 费用变更明细：本次讲解仅为您创建了免费资源，后续您部署更复杂资源栈时，可分类查看包年包月、按需、免费资源的费用信息 

• 资源变更信息：本次讲解仅为您创建新资源，后续您管理资源栈时，可在此查看本次导入、新增、更新、替换、删除了哪些资源 

步骤4：部署资源栈

评估费用变更、资源变更后，您可部署资源栈，实现一键部署多个云资源。具体可查看 部署资源栈/执行计划

1. 在执行计划详情页，点击页面右上角 部署

2. 在部署侧边栏中再次检查以下信息后，点击 立即部署

• 当前资源栈：本次讲解是创建一个新资源栈，因此当前资源栈内容为空。后续您管理资源栈时，可在此查看部署前资源栈的模板、资源、输出参数等信息

• 待部署执行计划：查看即将部署的模板内容、资源变更情况

• 前置校验结果：校验您的余额、配额是否足以完成本次部署

步骤5：检查资源部署结果

资源栈部署通常需要2-60分钟，时间长短取决于资源规模。请您耐心等待。部署成功后，即可查验所有资源状态，更多信息您可查看 查询资源栈

1. 点击页面右上角 刷新icon 刷新状态，等待执行计划创建完成

2. 部署成功！点击 资源 页签，查看成功部署的资源清单

恭喜您成功上手！从现在开始，用资源编排管理您的云资源吧！