Skip to content

README.md

Latest commit

 

History

History
94 lines (65 loc) · 4.84 KB

README.md

File metadata and controls

94 lines (65 loc) · 4.84 KB

Atlas CLI plugin for Terraform's MongoDB Atlas Provider

Code Health

This repository contains the Atlas CLI plugin for Terraform's MongoDB Atlas Provider.

It has the following commands to help with your Terraform configurations:

  • clusterToAdvancedCluster: Convert a mongodbatlas_cluster Terraform configuration to mongodbatlas_advanced_cluster (preview provider 2.0.0).

Installation

Install the Atlas CLI if you haven't done it yet.

Install the plugin by running:

atlas plugin install github.com/mongodb-labs/atlas-cli-plugin-terraform

If you have it installed and want to update it to the latest version, run:

atlas plugin update mongodb-labs/atlas-cli-plugin-terraform

If you want to see the list of installed plugins or check if this plugin is installed, run:

atlas plugin list

Convert mongodbatlas_cluster to mongodbatlas_advanced_cluster (preview provider 2.0.0)

Usage

Note: In order to use the Preview for MongoDB Atlas Provider 2.0.0 of mongodbatlas_advanced_cluster, you need to set the environment variable MONGODB_ATLAS_PREVIEW_PROVIDER_V2_ADVANCED_CLUSTER to true.

If you want to convert a Terraform configuration from mongodbatlas_cluster to mongodbatlas_advanced_cluster, use the following command:

atlas terraform clusterToAdvancedCluster --file in.tf --output out.tf

you can also use shorter aliases, e.g.:

atlas tf clu2adv -f in.tf -o out.tf

If you want to include the moved blocks in the output file, use the --includeMoved or the -m flag.

If you want to overwrite the output file if it exists, or even use the same output file as the input file, use the --replaceOutput or the -r flag.

You can use the --watch or the -w flag to keep the plugin running and watching for changes in the input file. You can have input and output files open in an editor and see easily how changes to the input file affect the output file.

You can find here some examples of input files (suffix .in.tf) and the corresponding output files (suffix .out.tf).

Dynamic blocks

dynamic blocks are used to generate multiple nested blocks based on a set of values. Given the different ways of using dynamic blocks, we recommend reviewing the output and making sure it fits your needs.

Dynamic blocks in tags and labels

You can use dynamic blocks for tags and labels. The plugin assumes that for_each has an expression which is evaluated to a map of strings. You can also combine the use of dynamic blocks in tags and labels with individual blocks in the same cluster definition, e.g.:

tags {
	key   = "environment"
	value = var.environment
}
dynamic "tags" {
	for_each = var.tags
	content {
		key   = tags.key
		value = replace(tags.value, "/", "_")
	}
}

Dynamic blocks in regions_config

You can use dynamic blocks for regions_config. The plugin assumes that for_each has an expression which is evaluated to a list or set of objects. Dynamic block and individual blocks for regions_config are not supported at the same time in a replication_specs.

Limitations

  • The plugin doesn't support regions_config without electable_nodes as there can be some issues with priority when they only have analytics_nodes and/or electable_nodes.
  • priority is required in regions_config and must be a numeric literal expression between 7 and 1, e.g. var.priority is not supported. This is to allow reordering them by descending priority as this is expected in mongodbatlas_advanced_cluster.
  • num_shards in replication_specs must be a numeric literal expression, e.g. var.num_shards is not supported. This is to allow creating a replication_specs element per shard in mongodbatlas_advanced_cluster.
  • dynamic blocks are currently supported only for tags, labels and regions_config. Coming soon: support for replication_specs.

Contributing

See our CONTRIBUTING.md guide.

License

MongoDB Atlas CLI is released under the Apache 2.0 license. See LICENSE.md