201-use-case-create-and-manage-ecs-instance

Author: lsy1968

quickstarts/ECS/201-use-case-create-and-manage-ecs-instance/README.md

@@ -0,0 +1,52 @@
+## Introduction
+
+<!-- DOCS_DESCRIPTION_CN -->
+本示例用于在阿里云上创建一台ECS实例，涉及到专有网络VPC、虚拟交换机vSwitch、安全组、弹性计算实例等资源的创建和部署。
+详情可查看[创建一台ECS实例](https://help.aliyun.com/zh/ecs/developer-reference/terraform/)。
+<!-- DOCS_DESCRIPTION_CN -->
+
+<!-- DOCS_DESCRIPTION_EN -->
+This example is used to create an ECS instance on Alibaba Cloud, which involves the creation and deployment of resources such as Virtual Private Cloud, virtual Switches, security groups, and Elastic Compute Service instances.
+More details in [Create an ECS instance](https://help.aliyun.com/zh/ecs/developer-reference/terraform/).
+<!-- DOCS_DESCRIPTION_EN -->
+
+<!-- BEGIN_TF_DOCS -->
+## Providers
+
+| Name | Version |
+|------|---------|
+| <a name="provider_alicloud"></a> [alicloud](#provider\_alicloud) | n/a |
+| <a name="provider_random"></a> [random](#provider\_random) | n/a |
+
+## Modules
+
+No modules.
+
+## Resources
+
+| Name | Type |
+|------|------|
+| [alicloud_instance.instance](https://registry.terraform.io/providers/aliyun/alicloud/latest/docs/resources/instance) | resource |
+| [alicloud_security_group.group](https://registry.terraform.io/providers/aliyun/alicloud/latest/docs/resources/security_group) | resource |
+| [alicloud_security_group_rule.allow_all_tcp](https://registry.terraform.io/providers/aliyun/alicloud/latest/docs/resources/security_group_rule) | resource |
+| [alicloud_vpc.vpc](https://registry.terraform.io/providers/aliyun/alicloud/latest/docs/resources/vpc) | resource |
+| [alicloud_vswitch.vswitch](https://registry.terraform.io/providers/aliyun/alicloud/latest/docs/resources/vswitch) | resource |
+| [random_integer.default](https://registry.terraform.io/providers/hashicorp/random/latest/docs/resources/integer) | resource |
+| [alicloud_zones.default](https://registry.terraform.io/providers/aliyun/alicloud/latest/docs/data-sources/zones) | data source |
+
+## Inputs
+
+| Name | Description | Type | Default | Required |
+|------|-------------|------|---------|:--------:|
+| <a name="input_instance_type"></a> [instance\_type](#input\_instance\_type) | 定义一个字符串类型的变量instance\_type，默认值为"ecs.e-c1m1.large"，用于指定ECS实例类型 | `string` | `"ecs.e-c1m1.large"` | no |
+| <a name="input_region"></a> [region](#input\_region) | 定义一个变量region，默认值为"cn-beijing"，用于指定阿里云区域 | `string` | `"cn-beijing"` | no |
+| <a name="input_vpc_cidr_block"></a> [vpc\_cidr\_block](#input\_vpc\_cidr\_block) | 定义一个变量vpc\_cidr\_block，默认值为"172.16.0.0/16"，用于指定VPC的CIDR块 | `string` | `"172.16.0.0/16"` | no |
+| <a name="input_vsw_cidr_block"></a> [vsw\_cidr\_block](#input\_vsw\_cidr\_block) | 定义一个变量vsw\_cidr\_block，默认值为"172.16.0.0/24"，用于指定VSwitch的CIDR块 | `string` | `"172.16.0.0/24"` | no |
+<!-- END_TF_DOCS -->
+
+## Documentation
+<!-- docs-link --> 
+
+The template is based on Aliyun document: [Create an ECS instance](https://help.aliyun.com/zh/ecs/developer-reference/terraform/) 
+
+<!-- docs-link --> 

quickstarts/ECS/201-use-case-create-and-manage-ecs-instance/main.tf

@@ -0,0 +1,85 @@
+# 定义一个变量region，默认值为"cn-beijing"，用于指定阿里云区域
+variable "region" {
+  default = "cn-beijing"
+}
+
+# 配置阿里云provider，使用变量region中定义的区域
+provider "alicloud" {
+  region = var.region
+}
+
+# 定义一个字符串类型的变量instance_type，默认值为"ecs.e-c1m1.large"，用于指定ECS实例类型
+variable "instance_type" {
+  type    = string
+  default = "ecs.e-c1m1.large"
+}
+
+# 使用数据源查询可用区信息，通过指定的实例类型、资源创建类型（如VSwitch）以及磁盘种类来过滤结果
+data "alicloud_zones" "default" {
+  available_instance_type     = var.instance_type
+  available_resource_creation = "VSwitch"
+  available_disk_category     = "cloud_essd"
+}
+
+# 定义一个变量vpc_cidr_block，默认值为"172.16.0.0/16"，用于指定VPC的CIDR块
+variable "vpc_cidr_block" {
+  default = "172.16.0.0/16"
+}
+
+# 定义一个变量vsw_cidr_block，默认值为"172.16.0.0/24"，用于指定VSwitch的CIDR块
+variable "vsw_cidr_block" {
+  default = "172.16.0.0/24"
+}
+
+# 生成一个介于10000到99999之间的随机整数，用于确保某些资源名称的唯一性
+resource "random_integer" "default" {
+  min = 10000
+  max = 99999
+}
+
+# 创建名为vpc-test的VPC，并使用随机整数确保名称唯一性
+resource "alicloud_vpc" "vpc" {
+  vpc_name   = "vpc-test_${random_integer.default.result}"
+  cidr_block = var.vpc_cidr_block
+}
+
+# 创建安全组，名称包含随机整数以保证唯一性，并关联至上述VPC
+resource "alicloud_security_group" "group" {
+  security_group_name = "test_${random_integer.default.result}" # 替换了这里的字段名
+  vpc_id              = alicloud_vpc.vpc.id
+}
+
+# 创建一条允许所有TCP流量进入的安全组规则，与之前创建的安全组关联
+resource "alicloud_security_group_rule" "allow_all_tcp" {
+  type              = "ingress"
+  ip_protocol       = "tcp"
+  nic_type          = "intranet" # 修改了这里，将nic_type改为'intranet'
+  policy            = "accept"
+  port_range        = "1/65535"
+  priority          = 1
+  security_group_id = alicloud_security_group.group.id
+  cidr_ip           = "0.0.0.0/0"
+}
+
+# 创建VSwitch，名称中包含随机整数以确保唯一性，并与VPC、可用区关联
+resource "alicloud_vswitch" "vswitch" {
+  vpc_id       = alicloud_vpc.vpc.id
+  cidr_block   = var.vsw_cidr_block
+  zone_id      = data.alicloud_zones.default.zones[0].id
+  vswitch_name = "vswitch-test-${random_integer.default.result}"
+}
+
+# 创建ECS实例，设置多个参数如可用区、安全组、实例类型等，并使用随机整数保证实例名称的唯一性
+resource "alicloud_instance" "instance" {
+  availability_zone          = data.alicloud_zones.default.zones[0].id
+  security_groups            = [alicloud_security_group.group.id]
+  instance_type              = var.instance_type
+  system_disk_category       = "cloud_essd"
+  system_disk_name           = "test_foo_system_disk_${random_integer.default.result}"
+  system_disk_description    = "test_foo_system_disk_description"
+  image_id                   = "aliyun_2_1903_x64_20G_alibase_20240628.vhd"
+  instance_name              = "test_ecs_${random_integer.default.result}"
+  vswitch_id                 = alicloud_vswitch.vswitch.id
+  internet_max_bandwidth_out = 10
+  password                   = "Terraform@Example" # 用户根据自己实际情况修改
+}

quickstarts/ECS/201-use-case-create-and-manage-ecs-instance/provider.tf

@@ -0,0 +1,7 @@
+terraform {
+  required_providers {
+    alicloud = {
+      source = "aliyun/alicloud"
+    }
+  }
+}