Resource Orchestration Service:Déployer NGINX sur une instance ECS à l'aide de Terraform

# ============================================================
# Basic network-layer resources: VPC → VSwitch → SecurityGroup
# ============================================================

resource "alicloud_vpc" "vpc" {
  cidr_block = "192.168.0.0/16"  # VPC CIDR block, which holds up to 65,534 private IP addresses
}

resource "alicloud_vswitch" "vsw" {
  vpc_id     = alicloud_vpc.vpc.id  # References the VPC ID. Terraform establishes the dependency automatically
  cidr_block = "192.168.0.0/24"    # Subnet CIDR block, which must be a subset of the VPC CIDR block
  zone_id    = "cn-beijing-h"      # This scenario uses zone H in the China (Beijing) region as an example
}

resource "alicloud_security_group" "security_group" {
  name   = "sg-for-nginx"           # Security group name
  vpc_id = alicloud_vpc.vpc.id      # Binds the security group to the same VPC
}

# ============================================================
# Security group rules: inbound SSH + inbound Web + all outbound traffic allowed
# ============================================================

# Inbound rule 1: opens SSH port 22 (for remote management)
resource "alicloud_security_group_rule" "allow_ssh" {
  security_group_id = alicloud_security_group.security_group.id  # Associates the rule with the security group
  type              = "ingress"     # Inbound direction
  cidr_ip           = "0.0.0.0/0"  # Allows access from all IP addresses (restrict the IP range in production environments)
  policy            = "accept"      # Accept policy
  ip_protocol       = "tcp"         # TCP protocol
  port_range        = "22/22"       # Port range: port 22 only
  priority          = 1             # Priority: 1 (highest)
}

# Inbound rule 2: opens web ports 80 to 443 (HTTP/HTTPS access to NGINX)
resource "alicloud_security_group_rule" "allow_web" {
  security_group_id = alicloud_security_group.security_group.id
  type              = "ingress"
  cidr_ip           = "0.0.0.0/0"
  policy            = "accept"
  ip_protocol       = "tcp"
  port_range        = "80/443"      # Port range: 80 to 443
  priority          = 1
}

# Outbound rule: allows all outbound traffic (the ECS instance can access external networks such as yum repositories)
resource "alicloud_security_group_rule" "allow_egress" {
  security_group_id = alicloud_security_group.security_group.id
  type              = "egress"      # Outbound direction
  cidr_ip           = "0.0.0.0/0"
  policy            = "accept"
  ip_protocol       = "tcp"
  port_range        = "1/65535"     # All ports
  priority          = 1
}

#!/bin/bash -v
# ---- Format and mount the data disk ----
cat >> /root/InitDataDisk.sh << "EOF"
#!/bin/bash
echo "p
n
p
w
" |  fdisk -u /dev/vdb
EOF
/bin/bash /root/InitDataDisk.sh
rm -f /root/InitDataDisk.sh
mkfs -t ext4 /dev/vdb1
cp /etc/fstab /etc/fstab.bak
mkdir /disk1
echo `blkid /dev/vdb1 | awk '{print $2}' | sed 's/\"//g'` /disk1 ext4 defaults 0 0 >> /etc/fstab
mount -a

# ---- Install and start NGINX ----
yum install -y nginx
/usr/sbin/nginx

# ============================================================
# Compute layer: ECS instance (data disk + NGINX initialization)
# ============================================================

resource "alicloud_instance" "instance" {
  availability_zone          = "cn-beijing-h"
  security_groups            = [alicloud_security_group.security_group.id]  # Binds security groups in array format
  host_name                  = "app-for-nginx"
  instance_type              = "ecs.c6e.large"        # Instance type (compute optimized, 2 vCPUs and 4 GiB of memory)
  system_disk_size           = 100                     # System disk size
  system_disk_category       = "cloud_essd"            # System disk type
  image_id                   = "centos_7_9_x64_20G_alibase_20210318.vhd"  # CentOS 7.9 image
  vswitch_id                 = alicloud_vswitch.vsw.id # Binds the instance to the vSwitch
  password                   = "<YourPassword>"        # Replace with the actual password at deployment (must contain uppercase and lowercase letters, digits, and special characters)
  internet_charge_type       = "PayByTraffic"          # Pay-by-traffic billing for the public bandwidth
  internet_max_bandwidth_out = 30                      # 30 Mbit/s outbound public bandwidth
  instance_charge_type       = "PostPaid"              # Billing type (pay-as-you-go or subscription)
  user_data                  = file("${path.cwd}/user-data.sh")  # Loads the initialization script

  data_disks {              # Data disk configuration
    size     = 100          # Data disk size
    category = "cloud_essd" # Data disk type
  }
}

# Outputs the NGINX access URL
output "nginx_ip" {
  value = "http://${alicloud_instance.instance.public_ip}:80"
}

Paramètres de déploiement

Méthodes de déploiement

# Prompt

Help me create an ECS instance and deploy the NGINX service by using a Terraform template.
Requirements:
1. Create a new VPC and `vSwitch` as the basic network.
2. The security group allows inbound access on port 22 (SSH) and ports 80 to 443 (web access).
3. The ECS instance requires a public IP address, with an outbound bandwidth of 30 Mbit/s.
4. Attach a 100 GB data disk, format it, and mount it to /disk1.
5. Install and start NGINX automatically through a user_data script.
6. zone_id, instance_type, system_disk_category, and data_disk_category all require AssociationProperty dynamic filtering.
7. The billing type parameter requires conditional visibility (the subscription duration is displayed only for subscription billing).

Q1 : Le déploiement échoue avec le message d'erreur « The specified InstanceType is not available in the zone »**

Cause : Le type d'instance ECS sélectionné n'est pas disponible dans la zone spécifiée.

Solution :

• Dans le modèle avancé, AssociationProperty fonctionne conjointement avec ResourcesForParameterConstraints pour filtrer automatiquement les types d'instance disponibles, ce qui évite ce problème.

• Si vous utilisez le modèle de base, vérifiez la disponibilité du type d'instance dans la zone cible sur la page des Elastic Compute Service (ECS) pricing.

Q2 : L'instance ECS est créée, mais la page NGINX n'est pas accessible

Étapes de dépannage :

• Vérifiez que la règle du groupe de sécurité autorise le trafic entrant sur le port 80 (vérifiez la règle allow_web).

• Connexion à l'instance ECS, puis exécutez systemctl status nginx pour vérifier que NGINX fonctionne correctement.

• Vérifiez si le script user_data s'est exécuté avec succès : consultez cat /var/log/messages | grep cloud-init.

• Vérifiez que l'instance ECS dispose d'une adresse IP publique (une adresse IP publique est attribuée automatiquement lorsque internet_max_bandwidth_out > 0).

Q3 : L'échec d'exécution du script user_data empêche le montage du disque de données

Cause : L'image peut être incompatible ou le nom du périphérique du disque de données peut ne pas correspondre.

Solution :

• Le chemin /dev/vdb utilisé dans le script user_data correspond au nom de périphérique par défaut du disque de données. Assurez-vous que le bloc data_disks est configuré dans le modèle.

• Si vous utilisez une image autre que CentOS, vous devrez peut-être ajuster la commande de partitionnement (par exemple, utiliser parted au lieu de fdisk).

• Si aucun disque de données n'est requis, vous pouvez supprimer le bloc data_disks ainsi que la partie du script user_data dédiée au montage du disque.

Q4 : Comment convertir un modèle Terraform en modèle ROS ?

Méthode 1 : Conversion dans la console

• Dans la console ROS, sélectionnez Templates > My Templates > Create Template.

• Rédigez d'abord le modèle dans l'onglet de modèle Terraform.

• Basculez vers l'onglet de modèle ROS et sélectionnez YAML en haut à droite. Le système convertit automatiquement le modèle Terraform au format suivant :

ROSTemplateFormatVersion: '2015-09-01'
Transform: Aliyun::Terraform-v1.2
Workspace:
  .metadata: |-
    { ... }  # Parameter grouping and constraint configuration
  main.tf: |-
    ...      # Terraform template content
  user-data.sh: |-
    ...      # Initialization script content

Méthode 2 : Utilisation de Template Transformer

• Installation de Template Transformer.

• Exécutez la commande de conversion :

rostran transform templates/terraform/alicloud/main.tf --target-format json

Q5 : Comment déployer un autre service web, tel qu'Apache ou Tomcat ?

Points de modification :

• Modifiez les commandes d'installation et de démarrage dans user-data.sh :

  • Apache : yum install -y httpd && systemctl start httpd

  • Tomcat : installez le JDK, puis téléchargez et démarrez Tomcat.

• Ajustez la plage de ports de la règle du groupe de sécurité (par exemple, Tomcat utilise par défaut le port 8080).

• Modifiez le numéro de port dans la sortie.

Q6 : Comment utiliser un VPC existant au lieu d'en créer un nouveau ?

Solution : Modifiez le VPC et le vSwitch pour sélectionner des ressources existantes :

variable "vpc_id" {
  type = string
  description = <<EOT
  {
    "Label": { "zh-cn": "Existing VPC" },
    "AssociationProperty": "ALIYUN::ECS::VPC::VPCId"
  }
  EOT
}
variable "vswitch_id" {
  type = string
  description = <<EOT
  {
    "Label": { "zh-cn": "Existing VSwitch" },
    "AssociationProperty": "ALIYUN::VPC::VSwitch::VSwitchId",
    "AssociationPropertyMetadata": {
      "VpcId": "$${vpc_id}"
    }
  }
  EOT
}

Ensuite, remplacez vswitch_id dans alicloud_instance par var.vswitch_id, et supprimez les blocs de ressources alicloud_vpc et alicloud_vswitch.

Pour plus d'informations sur les problèmes de déploiement des ressources, consultez la FAQ.