本页内容
- 先决条件
- 我们要做什么
- 为 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。