本页内容

  • 先决条件
  • 我们要做什么
  • 为 IAM Role 编写 Terraform 配置文件
  • 使用 Terraform 配置文件创建 IAM Role
  • 使用 Terraform 删除已创建的 IAM Role
  • 结论

在本文中,我们将了解如何创建 IAM Role。在继续之前,我假设你已熟悉 Terraform 和 AWS IAM Role 的基础知识。如果你想了解更多关于 IAM Role 的内容,可以查阅相关资料。在本文中,我们将创建一个角色并为其分配管理员权限。

先决条件

  • 具备 Terraform 的基础知识。
  • 系统中已安装 Terraform。
  • AWS 账户(如果没有,请先创建一个)。
  • 一个 AWS IAM 用户的 'access_key' 和 'secret_key'。(可查阅相关资料,了解如何在 AWS 上创建带有 'access_key' 和 'secret_key' 的 IAM 用户。)

我们要做什么

  • 编写用于创建 IAM Role 的 Terraform 配置文件。
  • 使用 Terraform 配置文件创建 IAM Role。
  • 使用 Terraform 删除已创建的 IAM Role。

为 IAM Role 编写 Terraform 配置文件

创建一个专用目录,你可以在其中创建 terraform 配置文件。

使用以下命令创建一个目录,并将当前工作目录切换到该目录。

mkdir terraform cd terraform/

我使用 "vim" 作为编辑器来写入文件,你可以使用自己选择的编辑器,复制粘贴以下配置来创建 variables.tf、terraform.tfvars 和 main.tf

创建 'main.tf',它负责在 AWS 上创建 IAM Role。这个 main.tf 将从 variables.tf 和 terraform.tfvars 中读取变量的值。

vim main.tf

provider "aws" {
      region     = "${var.region}"
      access_key = "${var.access_key}"
      secret_key = "${var.secret_key}"
}
data "aws_iam_policy_document" "cross_account_assume_role_policy" {
  statement {
    effect = "Allow"

    principals {
      type        = "AWS"
      identifiers = var.principal_arns
    }

    actions = ["sts:AssumeRole"]
  }
}

resource "aws_iam_role" "cross_account_assume_role" {
  name               = var.name
  assume_role_policy = data.aws_iam_policy_document.cross_account_assume_role_policy.json
}

resource "aws_iam_role_policy_attachment" "cross_account_assume_role" {
  count = length(var.policy_arns)

  role       = aws_iam_role.cross_account_assume_role.name
  policy_arn = element(var.policy_arns, count.index)
}

上述配置中使用的参数的含义:

  • assume_role_policy -(必需)授予实体承担该角色权限的策略。
  • policy_arn(必需)- 你要应用的策略的 ARN

创建 'variables.tf',其中包含变量的声明和定义。

这里,

"principal_arns" 变量保存被允许承担并使用该角色的 AWS 账户编号。你甚至可以在这里传入一个账户编号列表。

"policy_arns" 变量保存我们需要附加到将要创建的角色上的策略的 ARN。你甚至可以在这里传入一个策略 ARN 列表。

vim variables.tf

variable "access_key" {
     description = "Access key to AWS console"
}
variable "secret_key" {
     description = "Secret key to AWS console"
}
variable "region" {
     description = "Region of AWS VPC"
}
variable "name" {
  default = "
myrole
"
  type        = "string"
  description = "The name of the role. "
}
variable "principal_arns" {
  default = ["
123456789012
"]
  type        = list(string)
  description = "ARNs of accounts, groups, or users with the ability to assume this role."
}

variable "policy_arns" {
  default = ["
arn:aws:iam::aws:policy/AdministratorAccess
"]
  type        = list(string)
  description = "List of ARNs of policies to be associated with the created IAM role"
}

创建 'variables.tf' 后,不要忘记修改赋给变量的值。你必须修改高亮显示的值,因为这些值特定于我的环境。其余变量可以保持原样。如果你不想为正在创建的角色分配管理员访问权限,可以通过定义你所选策略的 Policy ARN 来更改。

创建 'terraform.tfvars',其中包含上述文件中定义的 access_key 和 secret_key 变量的定义。我们将这两个变量的声明连同 region 一起放在 'terraform.tfvars' 文件中。

创建 IAM Role 时我们并不特别需要某个特定的 region,我之所以把这个变量保留在这里,是为了让你了解这个 region 变量,并可以在其他资源创建文件中使用它。

以下密钥需要替换为你的 IAM 用户的密钥。在指定这些密钥之前,你需要从 AWS 控制台创建它们,并且不要与任何人共享这些密钥。

vim terraform.tfvars

region = "
eu-west-3
"
access_key = "
AKIAQ6GAIA5XFLXF6HOV
"
secret_key = "
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
"

现在,你应该有 3 个文件,即 variables.tf、terraform.tfvars 和 main.tf

使用 Terraform 配置文件创建 IAM Role

在执行以下命令之前,请确保你已配置好有效的 access_key 和 secret_key。

要使用的第一个命令是 'terraform init'。该命令会下载并安装配置中使用的 provider 的插件。在我们的例子中是 AWS。

terraform init

要使用的第二个命令是 'terraform plan'。该命令用于查看将在基础设施上发生的更改。

terraform plan

'terraform apply' 命令将在 AWS 上创建 main.tf 文件中提到的资源。系统会提示你输入以创建资源。

terraform apply

当你执行上述命令后,成功完成时,你可以看到新增了资源,且销毁了 0 个。

你可以转到 AWS IAM 控制台的 Role 下,验证 IAM Role 是否已创建。

使用 Terraform 删除已创建的 IAM Role

如果你不再需要利用 main.tf 文件中提到的配置所创建的资源,可以使用 "terraform destroy" 命令删除所有这些资源。

terraform destroy

结论

在本文中,我们了解了创建具有管理员权限的 IAM Role 的步骤。我们还了解了如何仅用一条命令就删除 IAM Role。