Docs 菜单
Docs 主页
/
MongoDB Atlas
/
程序化访问
/
基础架构即代码

开始使用 Terraform 和MongoDB Atlas Provider

在此页面上

  • 先决条件
  • 使用 Terraform 部署MongoDB Atlas
  • 终止MongoDB Atlas实例
  • 后续步骤

您可以使用 Terraform 通过Atlas Terraform提供商以代码形式管理MongoDB Atlas基础架构。 Atlas Terraform提供商通过简化以代码形式预配、管理和控制Atlas基础架构的进程，实现基础架构部署的自动化。

本指南将向您介绍如何在现有MongoDB Atlas组织和项目中创建、修改和销毁Atlas集群。

配置好测试环境后，继续使用来自MongoDB和 HashiCorp 的额外资源对 Terraform 托管的基础架构进行试验。

先决条件

在使用 Terraform 部署MongoDB Atlas之前，您必须：

使用 Terraform 部署MongoDB Atlas

1

创建并导航到空目录。

mkdir terraform-proj
cd terraform-proj
2

创建 Terraform 文件。

创建main.tf 、 provider.tf 、 variables.tf和versions.tf文件。

touch main.tf provider.tf variables.tf versions.tf
3

填充支持文件。

请参阅 atlas-basic 模块 并将内容复制到您在上一步中创建的文件中（单击Source Code 处的链接可查看内容）。

注意

您的Atlas公钥和私钥是秘密。 考虑将它们存储为 环境变量。

4

配置main.tf 内容。

更新main.tf文件中的以下字段：

字段
新值

instance_size

"M0"

backing_provider_name

您的提供商。 可能的值为： "AWS" 、 "AZURE"或"GCP" 。

region_name

有关您可以使用的所有区域，请参阅云提供商和区域。

5

（可选）显示参数。

您可以将 Terraform 配置中的信息输出到终端窗口。 这对于在Atlas创建资源之前不知道的值非常有用，例如 连接string 。

如果要在部署项目后显示参数，请将一些输出代码行添加到main.tf文件中。 有关示例，请参阅MongoDB Terraform 博文。

6

初始化您的项目。

要初始化项目，请运行以下命令：

terraform init

此命令还会下载并安装MongoDB Atlas Provider（如果尚未安装）。

7

查看您的执行计划。

要查看执行计划，请运行以下命令：

terraform plan

Terraform 详细说明了其计划进行的更改。 如果输出不符合您的预期，则您的main.tf文件可能存在问题。

8

部署基础架构。

要部署基础架构，请运行以下命令：

terraform apply

当出现Do you want to perform these actions?提示时，输入yes 。

注意

预配新的Atlas资源可能需要几分钟时间。 Atlas Terraform提供商程序每十秒更新一次，直到完成。

终止MongoDB Atlas实例

要删除在 Terraform目录中创建的所有资源，请运行以下命令：

terraform destroy

警告

如果删除了所有资源，则无法恢复。

当出现Do you really want to destroy all resources?提示时，输入yes 。

后续步骤

要探索更高级的配置，请使用其他Atlas资源、 Atlas Terraform Provider 配置和 Terraform 功能来扩展本教程中介绍的基础知识，请参阅以下资源：

后退

基础架构即代码

来年

迁移到 Flex 集群