GitHub - GoogleCloudPlatform/terraformer: CLI tool to generate terraform files f...
source link: https://github.com/GoogleCloudPlatform/terraformer
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
README.md
Terraformer
CLI tool to generate tf
and tfstate
files from existing infrastructure
(reverse Terraform).
- Disclaimer: This is not an official Google product.
- Status: beta - need improve documentations, bugs etc..
- Created by: Created by Waze SRE.
Capabilities
- Generate
tf
+tfstate
files from existing infrastructure for all supported objects by resource. - Remote state can be uploaded to a GCS bucket.
- Connect between resources with
terraform_remote_state
(local and bucket). - Compatible with terraform 0.12 syntax.
- Save
tf
files with custom folder tree pattern.
Terraformer use terraform providers and built for easy to add new supported resources. For upgrade resources with new fields you need upgrade only terraform providers.
Import current state to terraform configuration from google cloud
Usage:
import google [flags]
Flags:
-b, --bucket string gs://terraform-state
-c, --connect (default true)
-h, --help help for google
-o, --path-output string (default "generated")
-p, --path-patter string {output}/{provider}/custom/{service}/ (default "{output}/{provider}/{service}/")
-r, --resources strings firewalls,networks
-s, --state string local or bucket (default "local")
--projects strings
-z, --zone string
Supported providers
- Google cloud
- AWS
Permissions
Readonly permissions
How to use Terraformer
Installation
- Run
git clone <terraformer repo>
- Run
GO111MODULE=on go mod vendor
- Run
go build -v
- Copy your Terraform provider's plugin(s) to
~/.terraform.d/plugins/{darwin,linux}_amd64
, as appropriate.
Links for download terraform providers:
Information on provider plugins: https://www.terraform.io/docs/configuration/providers.html
Use with GCP
terraformer import google --resources=gcs,forwardingRules,httpHealthChecks --connect=true --zone=europe-west1-a --projects=aaa,fff
List of supported GCP services:
addresses
autoscalers
backendBuckets
backendServices
disks
firewalls
forwardingRules
globalAddresses
globalForwardingRules
healthChecks
httpHealthChecks
httpsHealthChecks
images
(bug: Either raw_disk or source_disk configuration is required.)instanceGroupManagers
instanceGroups
instanceTemplates
instances
networks
regionAutoscalers
regionBackendServices
regionDisks
regionInstanceGroupManagers
routers
routes
securityPolicies
sslPolicies
subnetworks
targetHttpProxies
(bug with proxy_id uint64 issue)targetHttpsProxies
targetSslProxies
targetTcpProxies
urlMaps
vpnTunnels
gcs
monitoring
dns
cloudsql
(bug, bug)
Your tf
and tfstate
files are written by default to
generated/gcp/zone/service
.
Use with AWS
Example:
terraformer import aws --resources=vpc,subnet --connect=true --regions=eu-west-1
Import current State to terraform configuration from aws
Usage:
import aws [flags]
Flags:
-b, --bucket string gs://terraform-state
-c, --connect (default true)
-h, --help help for aws
-o, --path-output string (default "generated")
-p, --path-patter string {output}/{provider}/custom/{service}/ (default "{output}/{provider}/{service}/")
--regions strings eu-west-1,eu-west-2,us-east-1
-r, --resources strings vpc,subnet,nacl
-s, --state string local or bucket (default "local")
List of support AWS services:
elb
alb
auto_scaling
rds
iam
igw
nacl
s3
sg
subnet
vpc
vpn_connection
vpn_gateway
route53
elasticache
Contributing
If you have improvements or fixes, we would love to have your contributions. Please read CONTRIBUTING.md for more information on the process we would like contributors to follow.
Developing
Terraformer built for easy to add new providers and not only cloud providers.
Process for generating tf
+ tfstate
files:
- Call GCP/AWS/other api and get list of resources.
- Iterate over resources and take only ID (we don't need mapping fields!!!)
- Call to provider for readonly fields.
- Call to infrastructure and take tf + tfstate.
Infrastructure
- Call to provider for refresh method and get all data.
- Convert refresh data to go struct.
- Generate HCL file -
tf
files. - Generate
tfstate
files.
All mapping of resource is made by providers and Terraform. Upgrades are needed only for providers.
GCP compute resources
For GCP compute resources, use generated code from
gcp_terraforming/gcp_compute_code_generator
.
To regenerate code:
go run gcp_terraforming/gcp_compute_code_generator/*.go
Similar projects
Recommend
About Joyk
Aggregate valuable and interesting links.
Joyk means Joy of geeK