开始使用 Terraform 和MongoDB Atlas Provider

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

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

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

先决条件

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

创建Atlas帐户。
获取您作为的组织ID Organization Owner。

提示
您可以在 Atlas 用户界面中组织的 General Settings 下找到您的组织 ID。
配置服务帐户 (SA) 身份验证。需要“组织所有者”角色才能查看“组织ID”、管理服务帐户以及创建或删除集群和其他项目资源。
安装 Terraform。

使用 Terraform 部署MongoDB Atlas

创建并导航到空目录。

mkdir terraform-proj
cd terraform-proj

创建 Terraform 文件。

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

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

填充支持文件。

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

注意

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

配置`main.tf` 内容。

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

字段	新值
`instance_size`	`"M0"`
`backing_provider_name`	您的提供商。可能的值为： `"AWS"` 、 `"AZURE"`或`"GCP"` 。
`region_name`	有关您可以使用的所有区域，请参阅云提供商和区域。

（可选）显示参数。

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

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

初始化您的项目。

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

terraform init

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

查看您的执行计划。

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

terraform plan

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

部署基础架构。

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

terraform apply

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

注意

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

验证部署

terraform apply 完成后，确认集群已部署。

新集群会出现在项目下的 Atlas 用户界面中。
如果已将输出值添加到 main.tf，则连接字符串会出现在 Terraform 输出中。

终止MongoDB Atlas实例

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

terraform destroy

警告

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

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

后续步骤

部署集群后，您可以：

创建组织和项目：如果您是Atlas的新用户，请参阅管理组织和项目。
探索高级配置：查看 atlas-basic 模块和Atlas Terraform Provider 文档以获取更完整的配置。
连接到集群：使用集群对象或 Terraform 输出值中的连接字符串。

其他资源：