roles pattern¶

概要¶

roles patternモジュールでは、Runtime環境上にDevOpsを実践するための役割を定義するIAM Roleを作成します。

想定する適用対象環境¶

roles patternは、Runtime環境で使用されることを想定しています。

依存するpattern¶

roles patternモジュールはusers patternモジュールとbind_role patternモジュールとセットで実行します。各モジュールの役割、実行順序は以下のとおりです。

1. users pattern：Delivery環境にIAMユーザーを作成します
2. bind_role pattern：Runtime環境のIAMロールへスイッチロールするIAMポリシーを作成し、Delivery環境のIAMユーザーへアタッチします
3. roles pattern：Runtime環境のIAMロールを作成します

構築されるリソース¶

このpatternでは、以下のリソースが構築されます。

モジュールの理解に向けて¶

roles patternではIAMロール、IAMロールに付与するIAMポリシーを作成します。

roles patternでは、以下の役割を定義するIAM Roleを作成します。

なおロール名の%sは、本patternの入力パラメータであるsystem_nameの値をCamelCaseとして変換した文字列に置き換えてください。例えばsystem_nameに"epona"を指定した場合、管理者ロールの名前はEponaAdminRoleとなります。

IAMロールの権限追加について¶

モジュールの理解に向けてに記載している通り、Eponaでは各IAMロールに必要と思われるIAMポリシーをアタッチしています。 本patternで作成するIAMロールにデフォルトで付与するIAMポリシーの詳細はこちらを確認ください。 しかし、プロジェクトによってはIAMロールに追加のIAMポリシーを与えたい場合も考えられます。 そのため、additional_XXX_role_policy（XXXは各ロール名）パラメータを用意しています。 追加したいIAMポリシーのARNをリスト形式で指定するとIAMロールに追加できます。

サンプルコード¶

roles patternを使用したサンプルコードを、以下に記載します。

module "roles" {
  source       = "git::https://gitlab.com/eponas/epona.git//modules/aws/patterns/roles?ref=v0.2.6"
  admins       = ["taro", "hanako"]
  approvers    = ["taro", "yoko"]
  costmanagers = ["taro", "ryota"]
  developers   = ["hanako", "chiharu"]
  operators    = ["hanako", "ayaka"]
  viewers      = ["hanako", "yoshiki"]

  additional_developer_role_policies = [
    "arn:aws:iam::aws:policy/AWSCodePipelineApproverAccess"
  ]

  account_id  = "XXXXXXXXXX"
  system_name = "hori"
  tags = {
    Owner              = "hori"
    Environment        = "runtime"
    RuntimeEnvironment = "production"
    ManagedBy          = "epona"
  }
}

関連するpattern¶

roles patternに関連するpatternを、以下に記載します。

入出力リファレンス¶

Requirements¶

Inputs¶

Outputs¶

No output.

※ このドキュメントはクリエイティブコモンズ(Creative Commons) 4.0 の「表示—継承」に準拠しています。

※ このドキュメントに記載されている会社名、製品名は、各社の登録商標または商標です。

© 2021 TIS Inc.