AWS CloudShellまたはGitが利用できるターミナルで、リポジトリをクローンし、ルートディレクトリへ移動します。
git clone https://github.com/Kobayashi-Riku0226/cloudshokudo-devops-agent-hands-on.git
cd cloudshokudo-devops-agent-hands-on取得済みの場合はクローンを省略し、既存のリポジトリのルートディレクトリを開いてください。続いて、実施する構成のディレクトリへ移動します。以下の cd コマンドは、それぞれリポジトリのルートから実行してください。
cd serverless移動後は、serverless/README.mdに従って、デプロイ、動作確認、IAMポリシーの削除による障害再現、復旧を進めてください。各AWS CLIコマンドは serverless ディレクトリで実行します。
cd ec2移動後は、ec2/README.mdに従って、デプロイ、動作確認、nginxの設定ミスによる障害再現、DevOps Agentでの調査、復旧を進めてください。すでにリポジトリを取得して移動済みの場合は、EC2側のREADMEにある git clone とディレクトリ移動のコマンドを省略し、デプロイのコマンドから実行します。各AWS CLIコマンドは ec2 ディレクトリで実行します。
serverless から続けてEC2構成へ移動する場合は、cd ../ec2 を実行してください。
AWS DevOps Agentで調査するためのエージェントスペースは、以下の手順で作成します。
エージェントスペース(Agent Space)は、AWS DevOps Agentが調査できるAWSリソースや外部ツール、利用者のアクセス範囲を設定する単位です。ここでは、AWSマネジメントコンソールでハンズオン用のスペースを作成し、Webアプリを開くまでを説明します。
- ハンズオンに使用するAWSアカウントにサインインできること。
- AWS DevOps Agentの設定と、IAMロールの作成・ポリシーの設定に必要な権限があること。以下ではIAMロールの自動作成を使用します。
- リージョンは東京(
ap-northeast-1)を使用します。利用可能なリージョンは公式ドキュメントで確認できます。
この手順では、調査対象のリソースと同じAWSアカウントにスペースを作成します。このアカウントがプライマリアカウントになります。サンプルAPIの構築手順はserverless/README.mdを参照してください。
- AWSマネジメントコンソールで AWS DevOps Agent を検索して開きます。
- リージョンを東京(
ap-northeast-1)に切り替えます。 - Create Agent Space を選択します。
Agent Space details で次の値を設定します。名前と説明は任意に変更できます。
| 項目 | 設定例 |
|---|---|
| Name | cloudshokudo-devops-agent-hands-on |
| Description(任意) | クラウド食堂ハンズオン用の調査環境 |
| Agent response language(任意) | Japanese (Japan) |
- Give this Agent Space AWS resource access で、IAMロールを自動作成する選択肢を選びます。
- 作成されるロール名と付与される権限を確認します。ロール名は必要に応じて変更できます。
このロールは、エージェントがプライマリアカウント内のリソースを検出・調査するために使用します。アクセス範囲を絞る場合は、ポリシーテンプレートを使ってロールを作成する方法もあります。既存ロールを使用する場合は、AWS DevOps Agent用の権限と信頼ポリシーが設定されたものを選んでください。
- Agent Space Web Appの設定で、Webアプリを有効にします。
- Webアプリへのアクセス用IAMロールも、自動作成する選択肢を選びます。
- 付与される権限を確認します。
こちらは利用者がWebアプリにアクセスするためのロールです。手順3のAWSリソース調査用ロールとは用途が異なります。
- 必要に応じてタグを設定し、入力内容を確認して Create を選択します。
- 作成したスペースの詳細画面で Operator access を選択します。
- 新しいタブでWebアプリが開き、認証されることを確認します。Webアプリでは調査の実行や推奨事項の確認ができます。
作成時に権限エラーが出る場合は、操作中のIAMユーザーまたはロールがIAMロールを作成・設定できるか確認してください。Webアプリへの接続に失敗する場合は、手順4の設定とアクセス用ロールの権限を確認します。