网易云terraform实践

此文已由作者王慎为授权网易云社区发布。

欢迎访问网易云社区，了解更多网易技术产品运营经验。

一、terraform介绍

随着应用上云的常态化，资源栈动态管理的需求对用户也变得更加急切。资源编排(Resource Orchestration Service, ROS)能够简化云计算资源管理和自动化运维，达到基础设施即代码的目标(Infrastructure as Code, IaC)。使用资源编排，通过一个资源模版管理资源栈方式对用户而言，提升了资源栈的创建、更新和删除了效率。

terraform是业界流行的资源编排工具。通过实现云平台相关的terraform provider插件，terraform支持多云平台下的资源编排。

NCE组目前实现了网易云terraform provider插件，初步支持以下资源的编排能力

云主机、云硬盘、硬盘绑定
vpc、子网
路由表，安全组

二、使用示例

注册网易云账号， https://www.163yun.com/

注册完成后，登陆控制台，在用户中心创建Access Key。记录AccessKey 和Access Secret 用于后续api访问认证。

安装terraform

访问terraform官网下载terraform安装包 https://www.terraform.io/downloads.htm

下载得到zip包 terraform_0.11.6_darwin_amd64.zip，解压该zip文件后得到terraform可执行文件

根据实际规划拷贝terraform到相应目录，并配置PATH 环境变量

编写资源模版

2.在workspace目录下创建并编写资源模版 vi example.tf (资源描述模版文件以.tf为后缀)

在模版文件中编写以下内容:

provider "neteasecloud" {
    access_key = “your access key"
    access_secret = “your access secret"
}resource "neteasecloud_nvm" "tf_nvm"{
    instance_name = "mynvm"
    description = "simple nvm"
    image_id =  "aec95c0c-29ff-4172-a8fa-5641163e13a0"
    spec_type = "nvm.n2.small4"
    keypairs = [
     {
     name = “your key pair name"
     fingerprint = “your key pair finger print"
       }
        ]
         vpc_id        =  "d6d0777e-9748-4eea-b44e-4d6291799473"
    subnet_id     =  "a572a392-3630-449a-90fd-8d9884ea2fce"
    security_group_ids = ["4712b273-4a56-4a29-81d6-0db07be5e20d"]
     associate_public_ip_address = true
    internet_max_bandwidth = 20
    network_charge_type = "TRAFFIC"
    personalities = [
        {
            path = "/terraform.txt"
                     contents = "terraform injected"
        }
    ]
}

以上模版文件中 provider语句块定义了访问网易云相关认证信息，access_key 和 access_secret更加用户实际情况填入。

resource 语句块定义了一个资源，neteasecloud_nvm 为资源类型，这里表示网易云主机，tf_nvm为模版中唯一的资源id。resource语句内部定义了资源的相关属性。这里定义了云主机名称、镜像、规格、网络资源等基本信息，并为其分配的公网ip，指定了公网带宽和计费类型，最后向主机注入一条用户自定义数据。

执行资源编排流程

1.初始化工作空间

下载网易云terrraform provider插件，下载得到插件terraform-provider-neteasecloud

将terraform-provider-neteasecloud 放置在一个公共目录，如 /usr/local/bin/terraform-providers

在workspace下执行 terraform init -plugin-dir /usr/local/bin/terraform-providers 初始化工作空间

2.创建资源

执行 terraform apply 进行资源创建。terraform会输出执行计划，确认无误后输入yes，开始执行

terraform会交互式创建资源，等待创建完成后,terraform输出简单的统计信息。在网易云控制台查看已经创建好的云主机。

3.更新资源

3.1 修改已有资源：更新云主机规格，将刚才创建的主机规格从4核变更成2核

修改模版中spec_type = “nvm.n2.small4" 为 spec_type = “nvm.n2.small2" 后保存，再次执行terraform apply 完成云主机规格变更

变配中

规格变配完成

3.2 动态添加/删除资源：增加一块云硬盘并绑定到之前到云主机

在模版中增加以下内容并保存：

resource "neteasecloud_ncv" "tf_ncv"{
    name = "mydisk"
    capacity = 30
    }
    resource "neteasecloud_nvm_disk_attachment" "tf_attach" {
    instance_id = "${neteasecloud_nvm.tf_nvm.id}"
    disk_id = "${neteasecloud_ncv.tf_ncv.id}"
}

以上模版表示创建两个资源，一是云硬盘，二是主机硬盘绑定关系，在创建主机硬盘绑定关系中，使用terraform变量引用分别引用了主机和硬盘的id。

再次支持terraform apply, 做资源栈更新