Amazon Q '/dev' コマンドによって生成されたコード提案のテスト

デフォルトでは、 /dev コマンドを使用する場合、Amazon Q はチャットで表示されるコードを自動的にテストしません。コードを保存してから、個別にテストする必要があります。Amazon Q は、作業を完了するために必要なツールを備えた環境がないため、コードをテストできません。

Amazon Q がコードをテストできるようにするには、devfile を指定して dev 環境を起動できるようにする必要があります。

注記

/dev コマンドと の詳細についてはAmazon Q Developer Agent for software development、「」を参照してくださいAmazon Q Developer を使用した機能の開発。

開発環境とは

開発環境は、Amazon Q がチャットで提示する前にコードをテストできる Docker コンテナです。コンテナには、コードをテストするために必要なプリインストールされたツール、言語、フレームワークが含まれています。

Amazon Q はサンドボックスで Docker コンテナを起動します。つまり、コンテナは Amazon Q が生成する可能性のある問題のあるコードから保護するために AWS サービスから分離されます。

devfile とは

devfile は、devfile 仕様に準拠する YAML ファイルです。これは、コンテナ化された開発環境を定義するオープンスタンダード、つまり dev 環境を略して定義したものです。

devfile は以下を記述します。

• 開発環境として使用する Docker コンテナイメージの名前と場所。

• dev 環境の起動時に自動的に実行するコマンド。

devfile には他のタイプの情報を含めることができますが、前述の 2 つは Amazon Q に関連する情報です。

独自の devfile を指定するか、Amazon Q に生成させることができます。

仕組み

Amazon Q チャットパネルに/devコマンドを入力するたびに、Amazon Q はプロジェクトのルートで devfile を検索します。

devfile が存在する場合、Amazon Q:

1. サンドボックス内の dev 環境を起動します AWS。

2. コード提案を生成します (ただし、まだ提示されていません）。

3. devfile の手順を使用して、dev 環境で提案を構築してテストします。

4. テストに合格しなかった場合は、提案を繰り返し行います。Amazon Q は 3 つの反復を実行しますが、これは設定できません。

5. チャットウィンドウにテスト済みのコードを表示します。

6. 開発環境を終了します。

devfile が存在しない場合、Amazon Q は生成するかどうかを尋ねます。「はい」と言うと、Amazon Q はプロジェクトのコンテキストに基づいて devfile を生成します。この devfile の詳細については、「」を参照してくださいAmazon Q Developer の devfiles の例。devfile を生成した後、Amazon Q は使用を開始しません。devfile を呼び出すには、別の/devコマンドを入力する必要があります。

サンドボックスの仕様

開発環境が起動されるサンドボックスには、2 つの vCPUsと 4 GB のメモリがあります。CPU とメモリは設定できません。

Amazon VPC のサポート

Amazon Q は、Amazon Virtual Private Cloud (Amazon VPC) 内での開発環境の実行をサポートしていません。詳細については、「Amazon Virtual Private Cloud ユーザーガイド」の「Amazon VPC とは?」を参照してください。

トピック

• Amazon Q での devfile の設定

• Amazon Q のコード提案のテストを無効にする

• Amazon Q Developer の devfiles の例

• ユニバーサルイメージの内容