本文へ移動
Wagby11
マニュアルのグループを選ぶ

WAGBY11 MANUAL / 29

H2のテスト環境を構築する

AWSにH2のテスト環境を作成します。HTTPS公開、既存H2の初期コピー、配置済みアプリの起動・停止と確認方法を説明します。

最終更新日:

運用の小目次へ

1. このページで伝える機能

テスト環境は、開発したアプリがAWS上で動作することを確認し、少人数のテスターでUIや機能を試すための一時的な環境です。H2を使って構築し、実行IDから配置完了まで追跡できます。業務データを継続して保存する用途には、本番環境を使います。

H2テスト環境は、CloudFrontのAWS発行URLによるHTTPSで公開します。閲覧者の接続元IP・国による制限はありません。開発者PCにある既存H2を初期データとしてコピーすることもできます。この手順には、HTTPS、H2初期コピー、H2のstart/stopに対応した運用ツールが必要です。未対応の設定項目と表示された場合は、運用ツールを更新してください。

2. Wagby11で実現できること

2.1 H2用の設定を確定する

H2で生成・ビルドしたアプリを指定します。次は config/pipeline-test.yml の例です。アカウントID・パス・環境名・Pipeline/S3名を実際の値へ変更します。 赤字の4項目は、自分のAWSアカウントとアプリに合わせて変更します。

schema-version: 3
environment:
  name: wagby-test
  type: test
aws:
  region: ap-northeast-1
  expected-account-id: "123456789012"
  profile: wagby-test
app:
  directory: /path/to/application-h2
runtime:
  vcpu: 1
  memory-gib: 4
  mcp-enabled: false
pipeline:
  name: wagby-test
  bucket: wagby-test-input-123456789012-ap-northeast-1
  source-key: pipeline/source.zip
https:
  mode: cloudfront
  origin-prefix-list-id: pl-58a04531
変更する設定意味設定する値・確認方法
aws.expected-account-id配置先として期待するAWSアカウントの12桁のIDです。実際に認証したアカウントと照合し、別アカウントへの誤配置を防ぎます。認証情報そのものではありません。aws sts get-caller-identity --profile wagby-test --query Account --output text の結果を指定します。先頭のゼロなどを失わないよう、引用符で囲んだ文字列にします。
app.directory開発者PCにある、H2用に生成・ビルドしたアプリのルートフォルダです。その中のREST API・Web UIのJARと、必要な定義・資材を収集します。restapi、web-ui、designer などが入ったフォルダを指定します。Wagby11をインストールしたフォルダです。具体例:C:¥Wagby11.0.0。restapi/target 自体ではありません。絶対パス、またはこのYAMLファイルの場所からの相対パスを使います。
pipeline.bucket成果物とPipelineの入力を転送する、非公開のS3バケット名です。env create で、この名前の入力バケットを作成します。アプリの公開URLではありません。自分の環境で使う、他のS3バケットと重複しない名前に変更します。例の123456789012も自分のアカウントIDへ置き換え、環境名などで区別します。s3://やURLは付けません。
https.origin-prefix-list-id非公開ALBへのCloudFrontからの接続に使う、AWS管理プレフィックスリストのIDです。東京の例は pl-58a04531 です。確認コマンドで配置先リージョンの現在値を確認します。閲覧者のIP制限ではありません。

aws.profile は、事前準備でログインしたプロファイル名に合わせます。environment.name と pipeline.name も、使用する環境・Pipelineの名前を確認してください。サンプルの wagby-test を使う場合は、以降のコマンドでも同じ名前を使います。

本番のデータやパスワードはテスト環境に持ち込みません。H2用の https は必須です。--allow-cidr は指定できません。

アプリの準備は generate → package → doctor → deploy の順です。run だけでは転送用JARは作成されません。具体的なビルドコマンドと転送対象は入力アプリと設定を用意するを参照してください。生成をやり直したら、再度packageします。

HTTPSで公開する

H2テスト環境では、設定YAMLの最上位に次の https を必ず指定します。CloudFrontの標準証明書とAWS発行URLを使うため、独自ドメインやACM証明書の用意は不要です。

https:
  mode: cloudfront
  origin-prefix-list-id: pl-58a04531

origin-prefix-list-id は、配置先リージョンのAWS管理プレフィックスリスト com.amazonaws.global.cloudfront.origin-facing のIDです。上記は東京リージョンの例です。次のコマンドで現在値を確認し、別リージョンではそのリージョンのIDを指定します。

aws ec2 describe-managed-prefix-lists --profile wagby-test --region ap-northeast-1 --filters Name=prefix-list-name,Values=com.amazonaws.global.cloudfront.origin-facing --query 'PrefixLists[].{Id:PrefixListId,Name:PrefixListName}' --output table

このコマンドはPowerShellでも1行で実行できます。プレフィックスリストは、非公開ALBへのCloudFrontからの通信を許可する設定です。閲覧者の接続元IPを指定するものではありません。

公開方法接続先と接続元制限基盤作成時の指定
CloudFrontのHTTPShttps://<AWS発行名>.cloudfront.net。閲覧者のIP・国による制限はありません。https.mode: cloudfront を指定し、--allow-cidr は指定しません。指定するとエラーになります。

HTTPS構成の基盤作成コマンドは次のとおりです。以降の doctor、deploy、wait は通常と同じです。

macOS/Linux

./bin/wagby-cloud env create --config config/pipeline-test.yml --prepare-only
./bin/wagby-cloud env create --config config/pipeline-test.yml --timeout-seconds 3600

Windows(PowerShell)

.\bin\wagby-cloud.bat env create --config config/pipeline-test.yml --prepare-only
.\bin\wagby-cloud.bat env create --config config/pipeline-test.yml --timeout-seconds 3600

CloudFront、VPCオリジン、非公開ALB用のプライベートサブネットを作成します。ブラウザーからCloudFrontまではHTTPS、CloudFrontからALBまではAWS管理の非公開接続上のHTTPです。ALBへインターネットから直接接続できず、HTTPの公開URLへアクセスするとHTTPSへ転送されます。ログインや業務応答のキャッシュは無効にし、Cookie、ヘッダー、クエリ、各HTTPメソッドをアプリへ転送します。

既存のHTTP基盤をHTTPSへ自動変換する操作には対応していません。新しい環境名でHTTPS基盤を作成します。HTTPS設定を省略したH2環境や、接続元IPを制限するHTTP環境は、この運用ツールでは作成・操作できません。

既存H2を初期コピーする

既定では、開発者PCのH2データを転送しません。既存のテストデータから開始したい場合は、設定YAMLの既存の app に h2-seed-file を追加します。HTTPS環境でも使用できます。

app:
  directory: /path/to/application-h2
  h2-seed-file: restapi/data/wagby-api.mv.db

h2-seed-file は app.directory からの相対パス、または絶対パスです。設定YAMLからの相対パスではありません。空でない通常の .mv.db ファイルを指定し、シンボリックリンクは使いません。

  1. 対象のローカルアプリを正常終了し、H2ファイルが使用されていない状態にします。
  2. h2-seed-file を指定し、doctor --offline と deploy --prepare-only で入力を確認します。DBの排他ロックを確認し、使用中の場合はコピーを拒否します。
  3. 通常どおり deploy します。指定ファイルだけを元DBを変更せずにコピーし、コンテナ内のH2として使用します。
  4. 配置完了後、既存の認証情報でログオンし、必要なデータがあることを確認します。

macOS/Linux

./bin/wagby-cloud doctor --config config/pipeline-test.yml --offline
./bin/wagby-cloud deploy --config config/pipeline-test.yml --release test-001 --prepare-only
./bin/wagby-cloud deploy --config config/pipeline-test.yml --release test-001

Windows(PowerShell)

.\bin\wagby-cloud.bat doctor --config config/pipeline-test.yml --offline
.\bin\wagby-cloud.bat deploy --config config/pipeline-test.yml --release test-001 --prepare-only
.\bin\wagby-cloud.bat deploy --config config/pipeline-test.yml --release test-001

この初期コピーはDB全体が対象で、ユーザー情報とパスワードハッシュもS3・ECRの配置資材に含まれます。テスト用データを使い、添付ファイルの実体、全文検索索引、ログはコピーされないことに注意してください。AWS側のDBを開発者PCへ自動同期する機能はありません。

タスク交換・再配置のたびに、配置資材に含まれる初期コピーから開始します。AWS側で追加・変更したデータは引き継ぎません。初期データを変更して再配置する場合もローカルアプリを正常終了し、test-002 など新しいリリース名で deploy します。同じリリース名で異なる内容へ上書きすることはできません。

2.2 CloudFormationの定義を確認する

AWS上に作るネットワークや実行環境の構成は、CloudFormationのテンプレートとして用意されています。H2テスト環境用の定義は、AWS配置ツールの配布ZIPを展開したフォルダの templates/pipeline/ にあります。bin・lib・templates が入っているフォルダを基準にします。

以下は、templates/pipeline/ にある各ファイルの役割です。

ファイル名定義する内容使用されるタイミング
foundation-https.yamlHTTPS用の基盤です。CloudFront配信、VPCオリジン、プライベートサブネット内の非公開ALBを含みます。ECSやS3等も同じ基盤スタックで管理します。H2基盤の正本です。計画の出力先では foundation.yaml という名前で保存されます。
pipeline.yamlCodePipeline、Build・Verify用CodeBuild、工程別IAMロール、工程ログなど。Source→Build→Deployの順で実行し、Deployステージ内で配置とVerifyを順に行います。env create で 環境名-pipeline スタックを作成します。
application.yamlアプリを起動するECSタスク定義とECSサービス。配置するECRイメージ、CPU・メモリ、ログ、ネットワーク接続、新旧タスクの切り替えなど。deploy が起動したPipelineのDeploy工程で 環境名-pipeline-application スタックを作成・更新します。
pipeline.guardテンプレートが満たすべき構成・保護条件を検査するルールです。AWSリソースを作成するテンプレートではありません。テンプレートの検証に使用する付属資料です。通常のアプリ配置で編集する必要はありません。

通常の構築では、テンプレートを直接編集する必要はありません。pipeline-test.yml の環境名・バケット名、https.origin-prefix-list-id などを、ツールがテンプレートのパラメーターとして渡します。Parameters は外から受け取る値、Resources は作成するAWSリソース、Outputs は作成後に確認するURLや識別情報の出力です。

実際の作成に使うテンプレートは、配置ツールの実行JARに組み込まれています。同梱の templates/pipeline/ にあるファイルを書き換えるだけでは、ツールの動作は変わりません。構成の変更が必要な場合は、設定で変更できる範囲を確認し、ツール・テンプレートと既存のAWS構成への影響を検討します。

env create --prepare-only を実行すると、JAR内の3つのテンプレートと基盤のパラメーターを、設定ファイルと同じフォルダの .pipeline-work/アカウントID/リージョン/環境名/infrastructure/ へ出力します。出力先の基盤テンプレート名は foundation.yaml です。画面に表示される PREPARED: の出力先で、AWSに作成する前の内容を確認できます。この操作はAWSへ接続しません。

2.3 コマンド操作一覧

以下はCloudFrontのHTTPS環境を作成する手順です。H2初期コピーを指定した場合は、配置前にローカルアプリを正常終了してください。

順序操作確認すること
1config validate / doctor --offline設定とH2用の入力が正しい
2env create --prepare-only対象・HTTPS設定・構成を確認
3env create基盤とPipelineを作成。ここから課金
4doctor作成済みPipeline/S3と認証を照合
5deploy実行IDを記録。受付だけでは配置完了ではない
6wait / logs同じ実行IDで終了と工程ログを確認
7AWS出力のURLでブラウザー確認ログオン、登録・検索、添付を確認

macOS/Linux

./bin/wagby-cloud config validate --config config/pipeline-test.yml
./bin/wagby-cloud doctor --config config/pipeline-test.yml --offline
./bin/wagby-cloud env create --config config/pipeline-test.yml --prepare-only
./bin/wagby-cloud env create --config config/pipeline-test.yml --timeout-seconds 3600
./bin/wagby-cloud doctor --config config/pipeline-test.yml
./bin/wagby-cloud deploy --config config/pipeline-test.yml --release test-001

Windows(PowerShell)

.\bin\wagby-cloud.bat config validate --config config/pipeline-test.yml
.\bin\wagby-cloud.bat doctor --config config/pipeline-test.yml --offline
.\bin\wagby-cloud.bat env create --config config/pipeline-test.yml --prepare-only
.\bin\wagby-cloud.bat env create --config config/pipeline-test.yml --timeout-seconds 3600
.\bin\wagby-cloud.bat doctor --config config/pipeline-test.yml
.\bin\wagby-cloud.bat deploy --config config/pipeline-test.yml --release test-001

返された実行IDを、以下の EXECUTION_ID に代入します。基盤作成時に記録されたSource失敗の実行と混同しないよう、deploy が返したIDを使います。

macOS/Linuxでの照会

EXECUTION_ID="ここに返された実行ID"
./bin/wagby-cloud status --config config/pipeline-test.yml --execution-id "$EXECUTION_ID" --watch
./bin/wagby-cloud logs --config config/pipeline-test.yml --execution-id "$EXECUTION_ID" --stage build --follow
./bin/wagby-cloud logs --config config/pipeline-test.yml --execution-id "$EXECUTION_ID" --stage verify
./bin/wagby-cloud wait --config config/pipeline-test.yml --execution-id "$EXECUTION_ID" --timeout-seconds 1800
./bin/wagby-cloud history --config config/pipeline-test.yml --limit 20

Windows(PowerShell)での照会

$EXECUTION_ID = "ここに返された実行ID"
.\bin\wagby-cloud.bat status --config config/pipeline-test.yml --execution-id "$EXECUTION_ID" --watch
.\bin\wagby-cloud.bat logs --config config/pipeline-test.yml --execution-id "$EXECUTION_ID" --stage build --follow
.\bin\wagby-cloud.bat logs --config config/pipeline-test.yml --execution-id "$EXECUTION_ID" --stage verify
.\bin\wagby-cloud.bat wait --config config/pipeline-test.yml --execution-id "$EXECUTION_ID" --timeout-seconds 1800
.\bin\wagby-cloud.bat history --config config/pipeline-test.yml --limit 20

これらは順に必ずすべて実行するものではなく、追従表示・ログ・待機を目的に応じて使い分けます。Ctrl-Cや待機時間切れでPC側の表示を止めても、AWS側の配置は続きます。wait の終了0が成功、1が失敗・停止等、2が入力不正、3が待機期限です。

Deployが進まないとき

ECSのデプロイサーキットブレーカーを有効にし、起動・ヘルスチェックの失敗が繰り返される場合は配置を失敗として扱います。更新時は直前に完了した配置へロールバックします。初回配置には戻り先がないため、失敗後はスタックの状態を確認して復旧します。これはすべての停止原因を一定時間内に検出する保証ではありません。

配置時間はモデル数、JARサイズ、AWSの混雑により変わります。固定の完了時間は保証しません。ヘルスチェックには起動猶予があり、新旧タスクの切り替え後にも待機があります。Deploy開始から10〜15分たっても進まない場合は、以下を確認します。この時間は診断を始める目安で、失敗判定の期限ではありません。

status --watch と wait は、実行状態に加えて現在のECSタスク数、直近のイベント・停止理由、アプリロググループを表示します。ECSは指定した過去の実行時点の状態ではなく、環境の現在値です。診断用の ecs:DescribeServices・ecs:ListTasks・ecs:DescribeTasks の権限がない場合もPipelineの照会は継続します。

aws cloudformation describe-stacks --profile wagby-test --region ap-northeast-1 --stack-name wagby-test-pipeline-application --query 'Stacks[0].{Status:StackStatus,Tags:Tags}' --output json
aws ecs describe-services --profile wagby-test --region ap-northeast-1 --cluster wagby-test --services wagby-test-app --query 'services[0].{Desired:desiredCount,Running:runningCount,Pending:pendingCount,Events:events[0:5]}' --output json
aws ecs list-tasks --profile wagby-test --region ap-northeast-1 --cluster wagby-test --service-name wagby-test-app --desired-status STOPPED
aws logs tail /wagby/wagby-test/application --profile wagby-test --region ap-northeast-1 --since 30m

上のコマンドはPowerShellでも1行ずつ実行できます。停止タスクのARNを得たら、aws ecs describe-tasks --profile wagby-test --region ap-northeast-1 --cluster wagby-test --tasks タスクARN で stoppedReason とコンテナの exitCode を確認します。アプリの起動例外はBuildログではなく /wagby/環境名/application に出力されます。詳しくはAWS運用のトラブル切り分けを参照してください。

失敗した配置を復旧する

wait の期限やCtrl-CでAWSの処理は止まりません。PipelineはQUEUEDで、DeployとVerifyが同じステージにあるため、先行する配置が詰まると後続の配置も待機します。deploy --abort は未対応です。

  1. 対象アカウント、Pipeline名、実行ID、スタックの所有タグを確認し、後続の配置を投入しないようにします。history で既に投入した実行も確認します。
  2. 停止対象の実行IDを指定して、次のコマンドを実行します。--abandon はPipeline側の追跡を放棄する操作で、CloudFormationやECSの処理そのものを止めません。後続が待機している場合、先にその実行も停止し、スタック操作と競合させないでください。
aws codepipeline stop-pipeline-execution --profile wagby-test --region ap-northeast-1 --pipeline-name wagby-test --pipeline-execution-id 実行ID --abandon --reason "Recover failed test deployment"

初回配置が CREATE_IN_PROGRESS のままで復旧できない場合は、アプリスタックの削除により作成を取り消します。ROLLBACK_IN_PROGRESS は完了を待ちます。ROLLBACK_COMPLETE のアプリスタックは再更新できないため削除します。以下の削除ではH2データ・添付・セッションが失われます。対象が今回のテスト用アプリスタックであり、データが不要で、競合するPipeline/CodeBuildの処理がないことを確認して実行してください。

aws cloudformation delete-stack --profile wagby-test --region ap-northeast-1 --stack-name wagby-test-pipeline-application
aws cloudformation wait stack-delete-complete --profile wagby-test --region ap-northeast-1 --stack-name wagby-test-pipeline-application

既存アプリの更新失敗で UPDATE_ROLLBACK_COMPLETE なら、スタックを削除せず原因を修正して更新します。UPDATE_IN_PROGRESS や UPDATE_ROLLBACK_FAILED は、トラブル切り分けに従って復旧し、初回配置と同じ削除手順を適用しません。原因を修正し、generateとpackage、doctor、deploy --prepare-only をやり直して、test-002 など新しいリリース名で配置します。

2.4 URLと業務操作を確認する

接続先は基盤スタックのOutputsの Url で確認します。次のコマンドはスタックの出力を読むだけです。CloudFrontのHTTPS URLを開きます。HTTPSの証明書エラーがないこと、HTTPからHTTPSへ転送されることを確認します。続けてログオン、登録・検索、添付の保存と取得を別途確認します。H2初期コピーを使った場合は、コピー元の認証情報と既存データも確認します。

aws cloudformation describe-stacks --profile wagby-test --region ap-northeast-1 \
  --stack-name wagby-test-pipeline-foundation --query 'Stacks[0].Outputs' --output table

Windows(PowerShell)

aws cloudformation describe-stacks --profile wagby-test --region ap-northeast-1 --stack-name wagby-test-pipeline-foundation --query 'Stacks[0].Outputs' --output table

変更後のJARを用意したら、test-002 など新しいリリース名で deploy します。同じ内容の資材はS3で再利用されます。更新後のH2は初期化され、h2-seed-file を指定した場合は配置した初期コピーから開始します。添付と前のセッションも引き継ぎません。再ログオンして確認します。

2.5 起動・停止と片付け

配置済みのH2テスト環境は、運用ツールの stop で一時停止し、start で再開できます。夜間に停止して翌朝に再開する場合も、アプリを再生成・再ビルドしたり、新しいリリースを deploy したりする必要はありません。CloudFrontのHTTPS URLはそのまま使えます。

起動・停止では、設定YAMLでAWS接続先と環境名を指定します。運用ツールは配置済みのアプリ構成とイメージを使い、CloudFormationでアプリの希望台数だけを0または1へ変更します。ローカルのJARやH2ファイルは読み直しません。--release や --allow-cidr の指定も不要です。

アプリを停止する

停止前に、必要なデータや添付ファイルを環境の外へ保存します。次のうち、利用しているOSのコマンドを実行してください。

macOS/Linux

./bin/wagby-cloud stop --config config/pipeline-test.yml --timeout-seconds 1800

Windows(PowerShell)

.\bin\wagby-cloud.bat stop --config config/pipeline-test.yml --timeout-seconds 1800

stop は、ECSの希望台数・実行中・待機中がすべて0となり、停止前の対象タスクがすべて STOPPED になるまで確認します。台数が0でもタスクの後片付け中の場合があるため、画面に STOPPED: と表示されるまで待ちます。

停止中も公開URLは保持されますが、アプリは利用できません。停止中は、アプリの正常な転送先がなくなるため、URLを開くと503が返る場合があります。これは停止中の応答であり、URLや証明書を作り直す必要はありません。

アプリを再開する

翌朝など、再び使うときに次のコマンドを実行します。配置済みの同じイメージから新しいタスクを起動し、ECSと実際のALB転送先の正常性を確認します。

macOS/Linux

./bin/wagby-cloud start --config config/pipeline-test.yml --timeout-seconds 1800

Windows(PowerShell)

.\bin\wagby-cloud.bat start --config config/pipeline-test.yml --timeout-seconds 1800

STARTED: と表示されたら、出力された同じURLを開き、ログオンと必要な業務操作を確認します。初期化とヘルスチェックに時間がかかるため、コマンドの受付直後には利用できない場合があります。ここで確認する起動状態と、status が表示する過去のPipeline実行結果は別です。

Pipelineが実行中・待機中の場合は、起動・停止を拒否します。完了を待ってから操作してください。タイムアウトやCtrl-CでPC側の待機を止めても、AWS側の処理は続く場合があります。同じ start または stop を再実行して状態を確認できます。停止が未完了のまま start は実行できないため、先に stop で停止完了を確認します。別PCやコンソールから同じ環境を同時操作しないでください。

環境を完全に片付ける

一時停止とは異なり、env delete による環境の自動削除には対応していません。

完全に片付けるときは、今回の環境の所有タグとスタック名を確認し、アプリスタック、Pipelineスタック、基盤スタックの順に扱います。S3の全バージョン・削除マーカー、ECRイメージの残存があると削除が完了しません。環境の取り違えを防ぐため、対象一覧とデータ不要の確認をしてから個別に削除します。CloudFront配信とVPCオリジンの削除・反映にも時間がかかるため、基盤スタックの削除完了まで確認します。タスク停止だけではCloudFront構成、ALB・KMS・保存領域などは残り、利用状況に応じた課金が続きます。

2.6 構成変更の仕様と制約

CPU・メモリは配置設定YAMLの runtime.vcpu と runtime.memory-gib で変更できます。対応範囲は1 vCPU/2〜8 GiB、2 vCPU/4〜16 GiB、4 vCPU/8〜30 GiBです。費用と必要な性能を確認して変更します。

変更後のYAMLを検査し、新しいリリース名で deploy します。タスク交換によりH2・添付・セッションは初期化されます。テスト環境のDBはH2のままとし、RDSやEFSを追加する構成変更はできません。

start/stopによる希望台数0/1の変更を除き、DBの変更、ネットワークの任意変更、タスク数の任意変更、コンテナの追加・分割、Pipelineの工程・順序の変更は許可しません。設定やテンプレートの任意編集でこれらを変更すると、標準コマンドが拒否するか、検証に失敗します。

--prepare-only はローカル計画の確認です。実際の更新前にはAWSの現在値と実行中の配置を確認し、必要なテストデータを保存します。タイムアウトしてもAWS処理は継続することがあるため、状態を照合して再実行します。

3. AIへの指示例

AWSへの転送時に、改版履歴の更新もAIへ依頼できます。履歴を確定してから生成・ビルドし、その成果物を転送します。記録の方針は、AWSへ転送する前に記録するを参照してください。

AIにAWS配置ツールを使ってもらう例です。対象アカウント・環境名・費用の条件を伝えます。

最小限の指示例

ビルド済みのH2アプリを、AWSのテスト環境へ配置してください。

AIはアプリのDB種別、アカウント、環境名、CloudFront HTTPSの必須設定、H2初期コピーの要否を確認し、設定と実行手順を補います。 未指定の仕様はAIが資料やファイルから類推して補います。費用やデータ保持など、判断に必要な条件は確認します。最小限の指示だけで次の詳細例と同じ構成になるとは限りません。

より詳細な指示例

転送前に、今回確定した設計変更をAppSchemaの改版履歴へ記録してください。既存の採番方針に従い、担当が未指定なら確認してください。同じ版の再転送で設計に変更がなければ履歴を重複追加せず、配置成功を先に記録しないでください。履歴更新後に検証・生成・ビルドし、その成果物を転送してください。
config/pipeline-test.ymlを使ってH2テスト環境を作成してください。MCPは無効、1 vCPU/4 GiB、東京リージョンとします。AWS発行URLでHTTPS公開し、接続元IP・国の制限は設けません。https.modeをcloudfrontとし、対象リージョンのCloudFront管理プレフィックスリストIDを確認してください。--allow-cidrは指定しません。既存のrestapi/data/wagby-api.mv.dbをapp.h2-seed-fileで初期コピーします。ローカルアプリが正常終了していることを確認してください。最初に対象アカウント、アプリ、公開方法、概算費用を示してください。config validate、doctor --offline、env create --prepare-only、deploy --prepare-onlyで確認後に基盤を作り、test-001でdeployしてください。返された実行IDでwaitし、Pipeline成功、HTTPSログイン画面、既存データの確認を区別して報告してください。タスク交換時は配置した初期コピーへ戻り、AWS側の更新、添付、セッションを引き継がない前提です。

起動・停止をAIへ依頼する例

config/pipeline-test.ymlのH2テスト環境をstopしてください。対象アカウントと環境を確認し、停止前に必要なデータを環境外へ保存済みか確認してください。AWS側の更新データと添付が失われる前提です。停止前のタスクがすべてSTOPPEDになるまで確認し、基盤とURLは残してください。

翌朝の再開は、実際に起動したいときに別途依頼します。次の例は、未来の時刻の予約ではなく、その時点で起動する指示です。

config/pipeline-test.ymlのH2テスト環境をstartしてください。再ビルド・再デプロイせず、配置済みの同じイメージを使ってください。配置時の初期H2から始める前提で、ECS・ALBの正常性と同じURLのログイン画面を確認してください。

会話の進め方の例

発言者やり取り
利用者H2で画面確認をしたいです。AWSのテスト環境を作ってください。
AI対象アカウント、H2用アプリ、HTTPS設定と初期コピーの要否を確認し、1 vCPU/4 GiBの構成と費用・初期化条件を提示します。
利用者このアカウントでHTTPS公開し、接続元制限なしで進めてください。既存H2を初期コピーし、AWS側の更新は消えて構いません。
AI事前検査、基盤作成、転送を実行し、実行IDで完了を確認します。URLと、ログオン後に確認する項目を報告します。

4. 編集されるAppSchemaの例

標準のH2を使う場合は、DBのための database ブロックをAppSchemaへ追加しません。CPUやメモリなどは上記の配置YAMLで指定します。配置によってモデルや画面のAppSchemaを書き換える必要はありません。

5. 参考資料

guide:データベース接続
designer/docs/appschema/markdown/guide/02-environment/02-database.md
reference:データベース設定
designer/docs/appschema/markdown/reference/25-database.md
Java共通基盤:データベース構成とマイグレーション
designer/docs/java/markdown/29_database_migrations.md