RubyMine 2026.2 Help

教程:使用 Terraform 部署 AWS S3 存储桶

RubyMine 支持使用 Terraform 进行基础架构即代码管理,可以在不离开 IDE 的情况下定义、审核和更新云资源。 如创建功能存储、设置环境或保持配置在不同机器和 CI 流水线间一致等任务,都可直接通过代码而非云控制台进行处理。

本教程介绍如何在 RubyMine 中使用 Terraform 创建 AWS S3 存储桶。 将在 IDE 中使用相关功能编写和审核配置,应用以创建资源,最后销毁该资源。

开始之前

在开始教程前,请确保满足以下先决条件:

  • AWS 账户. 创建并激活 AWS 账号。 本教程适用 AWS 免费套餐,但在账户设置过程中需要有效的付款方法。 如需了解更多信息,请参阅 官方文档

  • 具有编程访问权限的 IAM 用户. 出于安全考虑,请勿在本教程中使用根账号。 请在 AWS 管理控制台中创建具备程序化访问权限的新用户,并附加 AmazonS3FullAccess 权限策略。

  • AWS CLI. 在您的计算机上 安装 AWS CLI。 您将使用其配置本地 AWS 凭据并验证账户访问。

设置环境

创建 IAM 用户并安装 AWS CLI 后,在本地配置凭据:

配置 AWS 凭据

  1. 在系统终端中运行以下命令以配置命名名称的配置文件:

    aws configure --profile terraform-user

    使用命名名称的配置文件,可以在同一台机器上管理多个 AWS 账户和配置。 此处指定的配置文件名称将在后续 Terraform 配置中使用。

  2. 根据提示输入以下详细信息:

    • AWS Access 密钥 ID:来自你创建的 IAM 用户。

    • AWS Secret Access 密钥:来自你创建的 IAM 用户。

    • 默认区域名称:您资源将被创建的区域。 例如, us-east-1eu-central-1。 有关受支持区域的更多信息,请参阅 官方文档

    • 默认输出格式:按 Enter 使用默认格式(JSON)。

  3. 运行以下命令,验证凭据是否配置正确:

    aws sts get-caller-identity --profile terraform-user

    若配置成功,命令将返回关于您的 IAM 用户的详细信息。

现在您的 AWS 凭据已配置并验证,请启动 RubyMine 并设置开发环境。

安装 Terraform 和 HCL 插件

此功能依赖于 Terraform and HCL插件,您需要安装并启用。

  1. Ctrl+Alt+S 打开设置,然后选择 Plugins

  2. 打开 插件市场 选项卡,找到 Terraform and HCL插件,然后点击 安装 (如果系统提示,重启 IDE)。

指定 Terraform 可执行文件的路径

要在 IDE 中使用运行配置运行 Terraform 命令,您需要在计算机上安装 Terraform。

  1. Ctrl+Alt+S 打开设置,然后选择 工具 | Terraform 工具

  2. 在大多数情况下,RubyMine 会自动检测到 Terraform 可执行文件的路径。 如果 IDE 未检测到版本和可执行文件的路径,请点击 检测与测试

    如果您的计算机上未安装 Terraform,请点击 安装

    Terraform 工具设置
  3. 如有必要,您可以在 Terraform 可执行文件路径 字段中手动指定 Terraform 的路径。

创建新项目

让我们创建一个新的空项目用于存储 Terraform 配置。

这是一个用于纯 Ruby 编程的基本项目。

  1. 启动 RubyMine。

    要开始一个新项目,请执行以下操作之一:

    • 请点击 新建项目 ,以进入欢迎界面。

    • 从主菜单中选择 文件 | 新建 | 项目

    • 点击主窗口标题中的 Project 小部件并选择 新建项目

      使用 Project 小部件创建一个新项目
  2. 在左侧列表中选择 空项目

  3. 名称 字段中,输入项目名称。

  4. Location 字段中,输入或选择项目位置的路径。

  5. 解释器 字段中选择您希望在项目中使用的 Ruby 解释器

  6. 点击 创建

    创建新空项目

创建 Terraform 配置

项目准备好后,可以开始定义基础架构。 在 Terraform 中,基础架构通过使用 HashiCorp 配置语言(HCL)编写的配置文件进行描述。 现在创建一个简单的 Terraform 配置来定义 AWS S3 存储桶。

创建新的 Terraform 文件

  1. Project 工具窗口(Alt+1 )中,右键点击项目根目录并选择 新建 | Terraform 文件

  2. 新建文件 对话框中,将新文件名称设置为 main ,并从列表中选择 配置 文件模板。 按下 Enter

    新建 Terraform 配置

    RubyMine 会在项目根目录下创建 main.tf 文件并在编辑器中打开。

RubyMine 借助智能辅助功能帮助您构建有效的 Terraform 配置。 通过定义提供商开始构建配置。

添加 AWS 提供商

  1. main.tf 文件中,开始输入 provider 代码块:

    provider ""
  2. 调用代码补全(Ctrl+Space ),并从 补全建议列表中选择 aws

    provider "aws" { }

    执行上述操作时,RubyMine 还会在文件顶部插入 terraform 代码块。 该代码块定义 所需提供商及其配置所需的版本。

    完成这些步骤后,配置应大致如下:

    terraform { required_providers { aws = { source = "hashicorp/aws" version = "6.36.0" } } } provider "aws" { }
  3. provider 代码块内,使用代码补全添加 regionprofile 实参。

  4. 设置实参的值,例如:

    provider "aws" { region = "eu-west-1" profile = "terraform-user" }

    region 决定 Terraform 资源的创建区域, profile 指定使用的 AWS 凭据。

现在 AWS 提供商已配置好,让我们来定义 S3 存储桶资源。

添加 S3 存储桶资源

  1. main.tf 文件中,开始输入 resource。 然后使用代码补全(Ctrl+Space )选择 aws_s3_bucket 资源类型。 将资源名称设置为 tutorial_bucket。 您的配置应如下所示:

    resource "aws_s3_bucket" "tutorial_bucket" {}
  2. resource 代码块内,开始输入 bucket ,并用代码补全添加实参。 指定一个唯一的存储桶名称,例如:

    resource "aws_s3_bucket" "tutorial_bucket" { bucket = "ij-idea-terraform-tutorial-bucket-123" }

现在配置已就绪,可以运行 Terraform 命令以创建 S3 存储桶。

运行 Terraform

你可以在 RubyMine 中通过编辑器装订区域图标或运行/调试配置直接运行 Terraform 命令。

本节将初始化项目、预览计划变更、应用配置以创建 S3 存储桶,然后移除它以避免不必要的费用。

初始化项目

terraform init 命令会初始化 Terraform 项目,下载所需提供商并准备工作目录。 同时还会创建 .terraform.lock.hcl 文件,记录项目使用的精确提供商版本,确保多次运行和不同环境下行为一致。

  1. main.tf 文件中,点击装订区域的 运行运行 Terraform

  2. 请从下拉列表中选择 初始化 命令。

项目初始化后,预览 Terraform 即将在应用更改前生成的执行方案。

在 RubyMine 中,可以通过装订区域图标和运行/调试配置运行 Terraform 命令,并可添加实参或设置环境变量自定义执行。 本教程将添加 -out 实参,用于将执行方案保存到文件。 这样就可以预览方案,之后再次应用相同变更。

预览执行方案

  1. 转到 运行 | 编辑配置。 或者,按 Alt+Shift+F10 ,然后 0

  2. 点击(添加运行/调试配置添加新配置 并开始输入 Terraform

    Terraform run configuration
  3. 请从列表中选择 Terraform Plan 配置类型。

  4. 为运行/调试配置命名,例如 Plan S3 Bucket

  5. 程序参数 字段中,指定 -out=tfplan 实参。

  6. 点击 运行

执行方案详情会显示在 运行 工具窗口中。 同时,由于我们指定了 -out=tfplan 实参,Terraform 将方案保存到项目根目录的 tfplan 文件中。 方案审核无误后,可以使用该文件应用配置,在您的 AWS 账户中创建 S3 存储桶资源。

应用配置

  1. 前一过程类似,创建新的运行/调试配置。 请从列表中选择 Terraform Apply 配置类型。

  2. 为运行/调试配置命名,例如 Apply S3 Bucket

  3. 程序参数 字段中,指定 tfplan 实参。

    Terraform 在创建资源时,将使用存储在 tfplan 文件中的执行方案。

  4. 点击 运行

  5. 应用配置后,请在 AWS 管理控制台确认 S3 存储桶是否成功创建。

清理

销毁 S3 存储桶

  1. main.tf 文件中,点击装订区域的 运行运行 Terraform

  2. 请从下拉列表中选择 Destroy 命令。

  3. 流程完成后,请在 AWS 管理控制台中确认 S3 存储桶已被移除。

摘要

本教程中,您已经学会了如何:

  • 配置 Terraform 可执行文件路径并设置您的 AWS 环境

  • 在 RubyMine 中创建 Terraform 配置

  • 配置 AWS 提供商并定义 S3 存储桶资源

  • 通过装订区域图标和运行/调试配置,运行 Terraform 命令以初始化、方案规划、应用与销毁基础架构

2026年 7月 14日