Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rizalmf/terraform-provider-idcloudhost
My personal idcloudhost terraform provider
https://github.com/rizalmf/terraform-provider-idcloudhost
cloud-automation terraform
Last synced: 4 months ago
JSON representation
My personal idcloudhost terraform provider
- Host: GitHub
- URL: https://github.com/rizalmf/terraform-provider-idcloudhost
- Owner: rizalmf
- License: mit
- Created: 2024-08-10T14:53:26.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-08-18T23:45:29.000Z (5 months ago)
- Last Synced: 2024-09-28T13:21:34.885Z (4 months ago)
- Topics: cloud-automation, terraform
- Language: Go
- Homepage: https://registry.terraform.io/providers/rizalmf/idcloudhost/latest
- Size: 103 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Unofficial Terraform Provider for IDCloudHost
This is my personal idcloudhost terraform provider. It allows managing resources within compute and storage resources.
## Example Usage
### 1. Load providers
```hcl
terraform {
required_providers {
idcloudhost = {
source = "rizalmf/idcloudhost"
version = "~> 1.2.0"
}
}
}
```
### 2. Configure the idcloudhost provider
```hcl
provider "idcloudhost" {
# you can obtain by create new access as API Token on idcloudhost dashboard
apikey="XXXXXXXXXXXXXXXXX"
## optional. if unset will use your user default location
default_location="jkt01" # jkt01(SouthJKT-a), jkt02(NorthJKT-a), jkt03(WestJKT-a), sgp01(Singapore)
}
```
### 3. Create s3 bucket storage
```hcl
# id = STORAGE NAME
# changable field:
# - billing_account_id
resource "idcloudhost_s3" "mybucket" {
name = "mybucket"
billing_account_id = 000000
}
```
### 4. Create a VPC network
```hcl
# id = PRIVATE NETWORK UUID
# changable field:
# - name
resource "idcloudhost_private_network" "myprivatenetwork" {
# network_uuid =
name = "mynetwork"
# (optional). if unset will use your user default location
# this field overwrite "default_location"
# you can not change location on update
location = "jkt01" # jkt01(SouthJKT-a), jkt02(NorthJKT-a), jkt03(WestJKT-a), sgp01(Singapore)
lifecycle {
ignore_changes = [ location ]
}
}
```
### 5. Create Floating IP
```hcl
# id = FLOAT IP ADDRESS
# changable field:
# - name
# - billing_account_id
resource "idcloudhost_float_ip" "myfloatip" {
# address =
name = "myfloatnetwork"
billing_account_id = 000000
# (optional). if unset will use your user default location
# this field overwrite "default_location"
# you can not change location on update
location = "jkt01" # jkt01(SouthJKT-a), jkt02(NorthJKT-a), jkt03(WestJKT-a), sgp01(Singapore)
lifecycle {
ignore_changes = [ location ]
}
}
```
### 6. Create Vm
```hcl
# id = VM UUID
# changable field:
# - name
# - ram
# - vcpu
# - disks
# - float_ip_address
# - desired_status
resource "idcloudhost_vm" "myvm" {
# uuid =
# disks_uuid =
name = "myvm"
billing_account_id = 000000
username = "myusername"
password = "Mypassword1"
os_name = "ubuntu"
os_version = "22.04-lts"
vcpu = 2
ram = 2048 #mb
disks = 20 #gb
# bind existing private network
private_network_uuid = idcloudhost_private_network.myprivatenetwork.network_uuid
# (optional) assign to floating ip network. if not, vm doesnt have public ip
float_ip_address = idcloudhost_float_ip.myfloatip.address
# add plan will ignored. changing vcpu & ram require desired_status = "stopped"
desired_status = "stopped" # "stopped", "running"
# (optional). if unset will use your user default location
# this field overwrite "default_location"
# you can not change location on update
location = "jkt01" # jkt01(SouthJKT-a), jkt02(NorthJKT-a), jkt03(WestJKT-a), sgp01(Singapore)
lifecycle {
ignore_changes = [ location, os_name, os_version, username, password, billing_account_id ]
}
}
```
### 7. Create Load Balancer (Vms target only)
```hcl
# prepare a local values
locals {
# forwarding rules
lb_rules = [
{ source_port = 8080, target_port=80 }
]
# target servers
lb_targets = [
{ uuid="XXXX-XXXXXXX-XXXXXXX-XXXXXX" }, # uuid of vm1
{ uuid="XXXX-XXXXXXX-XXXXXXX-XXXXXX" }, # uuid of vm2
{ uuid="XXXX-XXXXXXX-XXXXXXX-XXXXXX" }, # uuid of vm3
]
}
# id = UUID
# changable field:
# - name
# - billing_account_id
# - targets
# - rules
resource "idcloudhost_loadbalancer" "mylb" {
# uuid =
name = "myloadbalancer"
billing_account_id = 000000
# bind existing private network
private_network_uuid = idcloudhost_private_network.myprivatenetwork.network_uuid
# (optional) assign to floating ip network. if not, lb doesnt have public ip
float_ip_address = idcloudhost_float_ip.anotherfloatip.address
# (optional). if unset will use your user default location
# this field overwrite "default_location"
# you can not change location on update
location = "jkt01" # jkt01(SouthJKT-a), jkt02(NorthJKT-a), jkt03(WestJKT-a), sgp01(Singapore)
dynamic "rules" {
for_each = locals.lb_rules
content {
source_port = rules.value.source_port
target_port = rules.value.target_port
}
}
dynamic "targets" {
for_each = locals.lb_targets
content {
target_uuid = targets.value.target_uuid
target_type = targets.value.target_type
}
}
lifecycle {
ignore_changes = [ location, private_network_uuid ]
}
}
```
## Next Development
- Resource LB Network(Load Balancer)
- ✅ Resource VM add desired_status (v1.2.0)
- ✅ Specific resource location (v1.1.0)
- ✅ Support terraform import (v1.1.0)
- ✅ Docs (v1.0.6)
- ✅ Github Action workflow (1.0.5)
- ✅ Resource Float IP (v1.0.4)
- ✅ Resource VM (v1.0.3)
- ✅ Resource Private Network (v1.0.3)
- ✅ Resource S3 (v1.0.3)