Documentation

Terraformer

A CLI tool that generates tf/json and tfstate files based on existing infrastructure (reverse Terraform).

For more general information about capabilities, commands and other topics, you can read this.

Use with IONOS Cloud

Authentication

Proper credential must be configured, before it can be used. You can set the environment variables for HTTP basic authentication:

export IONOS_USERNAME="username"
export IONOS_PASSWORD="password"

Or you can use token authentication:

export IONOS_TOKEN="token"

---

Warning: API Basic Authentication Deprecation Notice

Effective March 15, 2024, IONOS account holders using 2-Factor Authentication will no longer be able to utilize Basic Authentication for accessing our APIs, SDKs, and all related tools. Token creation and deletion via APIs and ionosCTL will also be restricted.

Affected users are required to switch to token-based authorization. These tokens will be accessible through our new Token Manager in the Data Center Designer, launching at the beginning of February 2024. More information can be found here.

---

Build

In order to build Terraformer with IONOS Cloud Provider, you can run the following command:

go run build/main.go ionoscloud

This will create an executable named terraformer-ionoscloud.

Execution

You can execute the previously created executable and you can ask Terraformer to import various resources (if they are supported) in various ways. The command presented below imports all LAN resources:

./terraformer-ionoscloud import ionoscloud --resources=lan

The name of the resource must exist in the list of supported IONOS Cloud resources presented above and must match the exact naming.

For more details/options about how the executable can be used, please read this.

List of supported IONOS Cloud resources

• datacenter

• lan

• server

• volume

• nic

• firewall

• group

• backup_unit

• ipblock

• k8s_cluster

• k8s_node_pool

• target_group

• networkloadbalancer

• natgateway

• natgateway_rule

• application_loadbalancer

• networkloadbalancer_forwardingrule

• loadbalancer

• pg_cluster

• pg_user

• pg_database

• mongo_cluster

• mongo_user

• certificate

• private_crossconnect

• s3_key

• container_registry

• dataplatform_cluster

• dataplatform_node_pool

• share

• user

• container_registry_token

• application_loadbalancer_forwardingrule

• dns_zone

• dns_record

• logging_pipeline

• ipfailover

We allow only resources that provide valid terraform plans to be imported. If you do not see your resource in the tf plan, please enable TF_LOG=debug and check logs for a message that will let you know why the resource was not imported.

Notes:

• A server must have a NIC and a volume attached to be allowed to be imported by terraformer.

• A server must also have a BootVolume set.