Terraform overview
What is the Terraform provider?
In addition to its REST API, ECI provides an official Terraform provider, elice-dev/eci. It lets you declaratively define and version-control VMs, block storage, networks, and public IPs.
- Official registry: registry.terraform.io/providers/elice-dev/eci
- Source: github.com/elice-dev/terraform-provider-eci
Do not use the OpenStack provider
ECI is not OpenStack-compatible. Use elice-dev/eci above, not terraform-provider-openstack.
Prerequisites
- Terraform 1.0 or higher installed
- A user access token: issue one from Admin > User Access Token in the portal (expires in 30/90 days or 6/12 months)
- A zone ID: the UUID of the zone to deploy VMs in. Get it from Infrastructure > Zone in the portal, or via the
eci_zonedata source
Provider configuration
# versions.tf
terraform {
required_version = ">= 1.0"
required_providers {
eci = {
source = "elice-dev/eci"
version = ">= 0.0.11" # pricing_id and eci_pricing are supported from 0.0.11
}
}
}
# provider.tf
provider "eci" {
api_endpoint = "https://portal.elice.cloud/api"
api_access_token = var.api_access_token # inject via env var or tfvars
zone_id = var.zone_id
}
| Field | Description |
|---|---|
api_endpoint | Required. Portal API URL. Commercial zone: https://portal.elice.cloud/api; public zone: https://portal.gov.elice.cloud/api; integrated organizations: https://<organization>.elice.io/api |
api_access_token | Required. Access token issued from the portal. The environment variable TF_VAR_api_access_token is recommended |
zone_id | Required. UUID of the zone resources will be placed in |
Do not commit the token
Inject api_access_token through a .tfvars (gitignored) file or an environment variable. If a token is committed, delete it from the portal immediately.
Main resources and data sources
| Resource | Description |
|---|---|
eci_virtual_machine | VM definition (specs, name, credentials) |
eci_virtual_machine_allocation | Allocates the VM to a host and starts it |
eci_block_storage | Block storage (OS disk or data disk) |
eci_block_storage_snapshot | Block storage snapshot |
eci_virtual_network | Virtual network (including firewall_rules) |
eci_subnet | Subnet |
eci_network_interface | Network interface |
eci_public_ip | Public IP |
| Data source | Description |
|---|---|
eci_zone | Look up a zone (name + region_id) |
eci_region | Look up a region |
eci_instance_type | Instance type (name → UUID) |
eci_pricing | Pricing (name + pricing_type) |
eci_block_storage_image | OS image |
tags is a required argument on every resource. If you don't need tags, set tags = {}. This provider does not support terraform import, so resources created in the portal cannot be brought into code.
For the full schema of each resource, see the official provider docs.
Next steps
- Quickstart — first VM from creation to SSH
- Cheatsheet — frequently used commands and patterns
- Spot VM — automated provisioning at spot pricing