Cloud to Code Import

Text size

Cloud to Code Import

The cloud2code import lets you import your cloud resources and customise your resource imports, including logging, filtering, and the output settings.

Usage

cloud2code import <provider> [options] [global flags]

Available Flags

Flag	Description	Required
--log-level or -l	Sets the logging level (debug, info, warn, error, panic, fatal).	No
--log-type	Sets the logging output format (console, json).	No
--tags	Filters resources by specified tags.	No
--include	Includes only the specified resource types.	No
--exclude	Excludes specific resource types from import.	No
--output-dir or -o	Specifies the output directory for Terraform state files (default: current directory).	No
--auto-import	Automatically create discovery on StackGen (default true).	No
--name	Name that you want to use for the discovery. If a discovery with the given name already exists, it will be updated instead of creating a new one.	No
--project	StackGen Project Id. Can also be set via STACKGEN_TEAM or PROJECT environment variables, or in ~/.stackgen/config.yaml.	No

StackGen Configuration

Cloud2Code can connect to your StackGen tenant using environment variables or a configuration file at ~/.stackgen/config.yaml.

Configuration File

Create a file at ~/.stackgen/config.yaml with the following format:

url: https://customer.cloud.stackgen.com
token: stackgen_******
project: <stackgen-project-id>

Environment Variables

Alternatively, you can set the following environment variables:

Variable	Description
STACKGEN_URL	URL of the StackGen server
STACKGEN_TOKEN	StackGen authentication token
STACKGEN_TEAM	StackGen Project Id
PROJECT	StackGen Project Id (alternative)

Precedence

When multiple sources are configured, the following precedence applies:

• StackGen URL: STACKGEN_URL env var > ~/.stackgen/config.yaml url field
• StackGen Token: STACKGEN_TOKEN env var > ~/.stackgen/config.yaml token field
• Project Id: --project flag > STACKGEN_TEAM env var > PROJECT env var > ~/.stackgen/config.yaml project field

If no project is specified through any of these sources, the discovery will be created in your personal workspace.

Examples

Usage

cloud2code import aws --region us-east-1 --include aws_s3_bucket,aws_instance --log-level debug --output-dir ./terraform

The above command will:

1. Import S3 buckets and EC2 instances from AWS (us-east-1).
2. Log details at debug level.
3. Save the Terraform files in the ./terraform directory.

Usage

cloud2code import azure --subscription-id <subscription_id> --resource-group my-rg --exclude azure_vm --name my-azure-discovery

The above command will:

1. Import all resources from an Azure Resource Group, except VMs.
2. Automatically create a discovery on StackGen (since --auto-import defaults to true) with the name my-azure-discovery.
3. Connect to StackGen using environment variables or ~/.stackgen/config.yaml (see StackGen Configuration).
4. If --project is not specified, the discovery will be created in your personal workspace.

Usage

cloud2code import gcp --project-id <project-id> --region us-central1 --credentials <creds> --project <stackgen-project-id> --include google_storage_bucket --name my-gcp-discovery

The above command will:

1. Import all the Google Storage Bucket resources present in us-central1 region.
2. Create a discovery named my-gcp-discovery on StackGen under the specified project.
3. Connect to StackGen using environment variables or ~/.stackgen/config.yaml (see StackGen Configuration).