Infra Import
Infra Import is an infrastructure-as-code generator based on TerraCognita, our open source CLI tool. Designed to streamline your infrastructure management. With this tool, you can effortlessly generate reverse Terraform code from existing manually-deployed infrastructure
Connect it to your manually-deployed cloud infrastructure and Infra Import will create your Stacks and push them to the predefined Catalog repository.
Our main use cases involve taking over an existing infrastructure:
- Consider a scenario where an individual or a team creates a proof-of-concept (POC) infrastructure. After successfully validating the POC, the infrastructure team aims to transform it into a production template that can be reused for deploying other applications.
- Alternatively, over time, an infrastructure may have already been deployed and used in production. The infrastructure team may now seek to effortlessly migrate it to infrastructure-as-code.
This is where Infra Import comes into play, simplifying the process by automatically generating infrastructure-as-code and state files for a running infrastructure.
Introduction
Infra Import connects to your cloud provider to retrieve previously created cloud infrastructure, generates associated Terraform code, and stores it in a Git repository. This process requires following a few prerequisite steps to provide Cycloid with the necessary access for these operations.
Additionally, we strongly recommend tagging resources on your cloud provider to enable more specific filtering of what you would like to import.
Infra Import is a beta feature based on our Open-Source Software Terracognita as well as AWS, Azure, GCP and VMware vSphere Terraform providers.
We provide this feature "as is", and some cloud resource imports might not work, even if listed in the Cycloid portal. Common issues could stem from the external Terraform providers mentioned above. For this reason, Infra Import is excluded from our standard support SLA.
Infra Import is not designed to generate fully functional Terraform code. It is the responsibility of your DevOps team to review and adapt the generated code before using it. The goal of Infra Import is to support and empower your DevOps team in creating new Cycloid stacks faster from existing deployed resources on a best-effort basis.
Prerequisites
To use Infra Import make sure you have these set up on your Cycloid account:
| prerequisite | required | description |
|---|---|---|
| Cloud provider credentials | Yes | To allow Infra Import to fetch your cloud resources |
| Catalog repository | Yes (with write access) | To store the generated Terraform code in a Cycloid stack format |
| Config repository | Yes (Stack & Project mode) | To store project related artifacts in case you choose to create a project during the Infra Import process |
| [Object storage | Yes (Stack & Project mode) | To store the .tfstate file. Can be an S3 bucket on AWS, bucket on GCP Cloud Storage, or OpenStack's Swift container. |