AWS CloudFormation がリソースタイプ向けのコントラクトテスト v2 をサポート

AWS CloudFormation は、カスタムリソースタイプの検証精度を高める「コントラクトテスト v2」のサポートを開始しました。従来の CRUD ハンドラーに関する基本的な検証に加え、リソースの実際の状態と要求状態の一致を確認するライブ状態検証、スキーマの後方互換性チェック、テスト入力のリンティング機能などが追加されています。新規リソースタイプはレジストリへの登録時に API 経由で、Java ベースのリソースタイプは Docker を使用してローカル環境で実行可能です。

開発サイクルの劇的な改善が期待できるアップデート

カスタムリソースタイプを開発しているエンジニアにとって、今回のアップデートは非常に大きな価値があります。

解決される課題と技術的メリット

これまでは、リソースの作成（Create）は成功しても、更新（Update）や削除（Delete）の際に意図しない状態になってしまうといった、ハンドラー間の整合性エラーを検知するのが困難でした。

コントラクトテスト v2 では、以下の機能によりこの課題を解決します：

• ライブ状態検証: 実際に AWS 上のリソース状態が、リクエスト通りになっているかを厳密にチェックします。
• スキーマ互換性の自動検証: スキーマ変更による破壊的変更を未然に防ぎます。
• リンティング機能: リージョンやアカウント ID のハードコードを検出し、ポータビリティの低いテストコードを排除します。

日本国内での利用について

最新のリージョン状況を確認したところ、東京リージョン (ap-northeast-1) および 大阪リージョン (ap-northeast-3) を含む、CloudFormation が利用可能なすべてのリージョンで本機能が利用可能です。国内の開発環境でも即座に導入できます。

運用上のアドバイスと次のステップ

Java ベースのリソースタイプを開発している場合は、Docker 環境を準備して cfn test --v2 を実行し、ローカルで詳細な HTML/JUnit レポートを確認することから始めてみてください。レジストリへのサブミッション前にこれらのテストをパスさせることで、デプロイ後の手戻りを大幅に削減できます。

参考ドキュメント: AWS CloudFormation contract tests documentation https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/contract-tests.html