Octo は、AWS コンソールまたは Terraform を利用して AWS アカウントを登録することができます。
この登録により、Octo は以下の機能を実行可能となります:
• 利用状況および請求データの取得
• 各種 API オペレーションの実行
• 必要に応じて、ペイヤーアカウント配下へのリンクアカウントの登録
現在、Octo に AWS アカウントを登録する方法は 2つのステップ があります。
AWS コンソール経由:
AWS アカウントにサインインし、アカウント内にスタックまたは StackSet をデプロイする必要があります。Terraform モジュールの利用:
提供されている Terraform モジュールを使用して、AWS アカウント内に必要なリソースをデプロイすることができます。
AWS コンソールを利用した登録方法
登録方法の選択:「Connect via AWS Console」を選択します。
基本情報の入力:このステップでは、アカウント ID と任意のアカウント名が保存されます。
API アクセスのセットアップ
このステップでは、AWS アカウントにスタックをデプロイします。これにより、Octo がアカウント内で API 操作を行うために必要な権限が設定されます。Open AWS create stack page をクリックします。現在サインインしている AWS アカウントの「スタック作成」ページが開きます。必ず意図したアカウントでスタックをデプロイしてください。デフォルトのリージョンは
us-east-1
です。スタック作成時には以下のデフォルト値を確認してください:
「I acknowledge that AWS CloudFormation might create IAM resources with custom names.」のチェックボックスにチェックを入れます。
スタックの内容を確認したら Create stack ボタンをクリックします。スタック作成に成功したら、Octo に戻ります。
Check and Confirm をクリックして、スタックのデプロイを検証します。
検証に成功すると、対象アカウントが リンクアカウント か ペイヤーアカウント かが確認されます。
複数 API アクセスのセットアップ – 任意(ペイヤーアカウントのみ)
このステップでは、StackSet を利用して、ペイヤーアカウント配下のすべてのリンクアカウントに API アクセスをデプロイします。
多数のリンクアカウントを Octo に登録したい組織に有効です。
Open AWS create stackset page をクリックします。
現在サインインしている AWS アカウントの StackSet 作成ページ が開きます。必ず、意図したアカウントで StackSet をデプロイしてください。
StackSet 作成ページ では、以下のガイドに従って設定を進めてください:
Check and Confirm をクリックして、StackSet のデプロイを検証します。
検証に成功した場合は、Next をクリックして次に進みます。
CUR と S3 バケットのセットアップ(ペイヤーアカウントのみ):このステップでは、アカウント内に CUR(Cost and Usage Report)定義 を作成するためのスタックをデプロイします。また、CUR データを保存するための S3 バケット もセットアップされます。追加のガイドはこちらをご参照ください:
Terraformを利用した登録方法
注意: この手順を実行するには、ローカル環境に Terraform がインストールされている必要があります。
登録方法の選択:Via other options をクリックし、Terraform を選択します。
基本情報の入力:このステップでは、入力された場合に アカウント ID と アカウント名 が保存されます。
まず、こちらのTerraform モジュール を確認してください。モジュールの詳細や必要な入力値については、README セクションをご参照ください。
terraform init
→ Terraform 構成ファイルを含む作業ディレクトリを初期化します。
terraform plan
→ 作成されるリソースを事前に確認します。
terraform apply
→ リソースを実際に作成します。
Terraform CLI に関する詳細情報は こちら を参照してください。
上記コマンド実行後、デプロイが正常に完了しているか確認してください。
Octo 上で Check and Confirm をクリックし、検証を実施します。
併せて、AWS アカウントのコンソールからリソースが正しく作成されているか確認することも可能です。
Octo 上での確認:Octo では以下のデプロイ状況を確認できます。
API Access
CUR および S3 バケット(ペイヤーアカウントのみ)
複数アカウント API アクセス – 任意(ペイヤーアカウントのみ)
登録完了:API Access が成功した場合、Confirm and Finish をクリックして登録を完了します。
ペイヤーアカウントについて
ペイヤーアカウントを StackSet を使用せずに登録した場合 でも、後から有効化することが可能です。その際は、上記の手順を実施しつつ、Terraform モジュール内で use_stackset を true に設定してください。これによりリソースが更新され、すべてのリンクアカウントが自動的に Octo に登録されます。改めてペイヤーアカウントを削除して再登録する必要はありません。