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 之前，您必须：

  • 创建 Atlas 帐户。

  • 获取您作为 的 组织 ID Organization Owner。

    提示

    您可以在 Atlas 用户界面中组织的 General Settings下找到您的组织 ID。

  • 配置 Atlas 组织API 密钥。

  • 安装 Terraform。

使用 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 创建资源之前不知道的值（例如连接字符串）非常有用。

如果要在部署项目后显示参数，请将一些输出代码行添加到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 功能来扩展本教程中介绍的基础知识，请参阅以下资源：

后退

基础架构即代码