Huawei Cloud ECS Terraform Module

Terraform module for creating ECS (Elastic Cloud Server) instances on Huawei Cloud.

Features

• ✅ ECS instance creation
• ✅ EIP (Elastic IP) creation and association (optional)
• ✅ Multiple network interface support
• ✅ Data disk support
• ✅ Volume attachment support
• ✅ User data support
• ✅ Enterprise project support
• ✅ Flexible and customizable

Usage

Simple Example

module "ecs" {
  source = "git::https://github.com/artifactsystems/terraform-huawei-ecs.git?ref=main"

  name               = "my-ecs-instance"
  image_id           = "your-image-id"
  flavor_id          = "s6.small.1"
  security_group_ids = ["sg-xxxxx"]
  availability_zone  = "tr-west-1a"
  key_pair_name      = "my-keypair"

  network_ids = [
    {
      uuid = "subnet-id"
    }
  ]

  tags = {
    Environment = "production"
    Project     = "myproject"
  }
}

Example with EIP

module "ecs" {
  source = "git::https://github.com/artifactsystems/terraform-huawei-ecs.git?ref=main"

  name               = "my-ecs-instance"
  image_id           = "your-image-id"
  flavor_id          = "s6.small.1"
  security_group_ids = ["sg-xxxxx"]
  availability_zone  = "tr-west-1a"
  key_pair_name      = "my-keypair"

  network_ids = [
    {
      uuid = "subnet-id"
    }
  ]

  # Create and attach EIP
  create_eip                = true
  eip_bandwidth_size        = 10
  eip_bandwidth_charge_mode = "traffic"

  tags = {
    Environment = "production"
  }
}

Example with Data Disks

module "ecs" {
  source = "git::https://github.com/artifactsystems/terraform-huawei-ecs.git?ref=main"

  name               = "my-ecs-instance"
  image_id           = "your-image-id"
  flavor_id          = "s6.medium.2"
  security_group_ids = ["sg-xxxxx"]
  availability_zone  = "tr-west-1a"
  key_pair_name      = "my-keypair"

  network_ids = [
    {
      uuid = "subnet-id"
    }
  ]

  # Add data disks
  data_disks = [
    {
      type = "SSD"
      size = 100
    },
    {
      type = "SSD"
      size = 200
    }
  ]

  tags = {
    Environment = "production"
  }
}

Example with User Data

module "ecs" {
  source = "git::https://github.com/artifactsystems/terraform-huawei-ecs.git?ref=main"

  name               = "my-ecs-instance"
  image_id           = "your-image-id"
  flavor_id          = "s6.small.1"
  security_group_ids = ["sg-xxxxx"]
  availability_zone  = "tr-west-1a"
  key_pair_name      = "my-keypair"

  network_ids = [
    {
      uuid = "subnet-id"
    }
  ]

  # Startup script
  user_data = <<-EOF
    #!/bin/bash
    apt-get update
    apt-get install -y nginx
    systemctl start nginx
    EOF

  tags = {
    Environment = "production"
  }
}

Terragrunt Usage

# terragrunt.hcl
terraform {
  source = "git::https://github.com/artifactsystems/terraform-huawei-ecs.git?ref=v1.0.0"
}

inputs = {
  name               = "my-instance"
  image_id           = "your-ubuntu-image-id"
  flavor_id          = "s6.small.1"
  security_group_ids = [dependency.security_group.outputs.security_group_id]
  availability_zone  = "tr-west-1a"
  key_pair_name      = "my-keypair"

  network_ids = [
    {
      uuid = dependency.vpc.outputs.public_subnets[0]
    }
  ]

  create_eip         = true
  eip_bandwidth_size = 10

  user_data = file("${get_terragrunt_dir()}/user-data.sh")

  tags = {
    Application = "MyApp"
    Environment = "production"
  }
}

Inputs

Name	Description	Type	Default	Required
create	Whether to create ECS instance	bool	true	no
name	Name of the ECS instance	string	-	yes
image_id	ID of the image	string	-	yes
flavor_id	Flavor ID (instance type)	string	-	yes
security_group_ids	List of security group IDs	list(string)	[]	no
availability_zone	Availability zone	string	null	no
key_pair_name	Name of the key pair	string	null	no
system_disk_type	System disk type	string	"SSD"	no
system_disk_size	System disk size in GB	number	40	no
network_ids	List of network configurations	list(object)	[]	no
data_disks	List of data disks	list(object)	[]	no
user_data	User data script	string	null	no
create_eip	Whether to create an EIP	bool	false	no
eip_bandwidth_size	Bandwidth size in Mbps	number	10	no
tags	Tags to apply to resources	map(string)	{}	no

Outputs

Name	Description
id	Instance ID
name	Instance name
status	Instance status
private_ip	Private IP address
public_ip	Public IP address (if EIP created)
eip_address	EIP address
eip_id	EIP ID

Requirements

• Terraform >= 1.0
• Huawei Cloud Provider >= 1.47.0

Common Instance Flavors

Flavor	vCPU	RAM	Description
s6.small.1	1	1 GB	Small workloads
s6.medium.2	1	2 GB	Light applications
s6.large.2	2	4 GB	Medium applications
s6.xlarge.2	4	8 GB	Large applications
s6.2xlarge.2	8	16 GB	Heavy workloads

Disk Types

• SSD: High performance SSD
• GPSSD: General purpose SSD
• SAS: High I/O SAS
• SATA: Capacity disk (cost-effective)

License

Apache 2.0

Contributing

Contributions are welcome! Please read the contributing guidelines first.