terraform-provider-mongodbatlas

command module
v0.8.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 25, 2018 License: MPL-2.0 Imports: 2 Imported by: 0

README

terraform-provider-mongodbatlas

Build Status GitHub release codecov GitHub downloads

Terraform provider for MongoDB Atlas.

Requirements

  • Terraform 0.11.x
  • Go 1.10 (to build the provider plugin)

Installing the Provider

Follow the instructions to install it as a plugin. After placing it into your plugins directory, run terraform init to initialize it.

Usage

# Configure the MongoDB Atlas Provider
provider "mongodbatlas" {
  username = "${var.mongodb_atlas_username}"
  api_key = "${var.mongodb_atlas_api_key}"
}

# Create a Cluster
resource "mongodbatlas_cluster" "test" {
  # ...
}

Also look at the example under /examples.

Importing resources

Currently, only mongodbatlas_cluster, mongodbatlas_database_user, mongodbatlas_vpc_peering_connection and mongodbatlas_ip_whitelist can be imported.

To import any of these resources, you need the project ID (aka. group ID). This can be found in the project settings screen.

# Import a cluster
terraform import mongodbatlas_cluster.example <project ID>-<cluster name>

# Import a database user
# NOTE: you'll see a plan diff for the password, this is unavoidable since the user read API omits it
terraform import mongodbatlas_database_user.example <project ID>-<username>

# Import an ip whitelist
terraform import mongodbatlas_ip_whitelist.example <project ID>-<cidr>

# Import an vpc peering
# specify the peering connection id( pcx-xxxxxxxxx )
terrform import mongodbatlas_vpc_peering_connection.example <project ID>-<pcx id>

Building the Provider

Clone and build the repository

go get github.com/akshaykarle/terraform-provider-mongodbatlas
make build

Symlink the binary to your terraform plugins directory:

ln -s $GOPATH/bin/terraform-provider-mongodbatlas ~/.terraform.d/plugins/

Updating the Provider

go get -u github.com/akshaykarle/terraform-provider-mongodbatlas
make build

NOTE

The mongodbatlas_container resource does not destroy the container (vpc) in mongo atlas. This is due to a limitation of the mongo atlas API as it doesn't support deleting this resource.

Contributing

  • Install project dependencies: go get github.com/kardianos/govendor
  • Run tests: make test
  • Build the binary: make build

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL