AWS Amplify

AWSにアプリケーションに必要なバックエンド環境をコマンドで構築できて、フロントエンドアプリからのつなぎ込みも簡単にできる、涙が出るほど便利なフレームワークです。
https://aws-amplify.github.io/

multienvプラグイン

そんなAWS Amplifyには、バックエンドの環境を複製したり、切り替えたりできるコマンドが提供されています。
それが、multienvプラグインです。
（まだ betaです）
https://aws-amplify.github.io/docs/cli/multienv?sdk=js

環境名に大文字を使用するとエラー

タイトルの通りですが、環境名にアルファベットの大文字を使用すると、エラーになります。

手順

まず、環境の新規作成を行います。

amplify init

ここで、既存の環境の初期化をするか、新たな環境を入力するかを聞かれます。

$ amplify init
Note: It is recommended to run this command from the root of your app 
directory
You're initializing your project with a beta version of the CLI which 
supports multiple environments of your project
? Do you want to use an existing environment? (Y/n) <- nを入力

すると環境名の入力を促されます。
ここで、大文字を含んだアルファベットの環境名を入力しました。

? Enter a name for the environment DevYS <- 大文字を含んだ環境名を入力

その後なんやかんや聞かれますが、既存の環境複製時は基本的に全てそのままEnterで進みます。
完了したら、実際にAWSバックエンドを構築します。

$ amplify push

これで、環境がめでたく複製されるはずだったのですが。。。

amplify　push のエラー

✖ An error occurred when pushing the resources to the cloud

Resource is not in the state stackUpdateComplete

失敗しますorz
この少し前に、Cloudformationのログが出ているので、見てみます。

CREATE_IN_PROGRESS functionnomadmatchinge620bc79                                   AWS::CloudFormation::Stack Fri Feb 08 2019 21:00:51 GMT+0900 (JST) Resource creation Initiated
CREATE_IN_PROGRESS hostingS3AndCloudFront                                          AWS::CloudFormation::Stack Fri Feb 08 2019 21:00:51 GMT+0900 (JST) Resource creation Initiated
CREATE_IN_PROGRESS nomad-matching-20190208205622-authcognito09b59faa-1BNMU3OAVOXEB AWS::CloudFormation::Stack Fri Feb 08 2019 21:00:51 GMT+0900 (JST) User Initiated             
CREATE_IN_PROGRESS authcognito09b59faa                                             AWS::CloudFormation::Stack Fri Feb 08 2019 21:00:52 GMT+0900 (JST) Resource creation Initiated
⠼ Updating resources in the cloud. This may take a few minutes...

CREATE_FAILED               S3Bucket                                                                  AWS::S3::Bucket            Fri Feb 08 2019 21:00:57 GMT+0900 (JST) Bucket name should not contain uppercase chara
cters                                                                                                                                                                                                                 
CREATE_IN_PROGRESS          nomad-matching-20190208205622-functionnomadmatchinge620bc79-1NL68GUN8AKBX AWS::CloudFormation::Stack Fri Feb 08 2019 21:00:51 GMT+0900 (JST) User Initiated

S3バケットの作成失敗が、最初に発生したエラーのようで、これが原因でCloudformationスタックがロールバックされているようです。

S3バケット作成エラーの原因を探る

もっと情報が欲しいのですが、S3を構築したCloudformationスタックは、ロールバックで削除されてしまっているので、既にありません。
AWS Amplifyでは、APIやAuth、Hostingといった機能単位でCloudformationスタックをネストして作成しています。
上記のS3バケットは、Hosting機能のNestedStackで作成されます。
（ルートスタックは、amplify init時に作成されています。）

このため、もう一度同じ操作をして、ネストされたHostingのCloudformationスタックがロールバックで削除されてしまう前に、（作成途中の段階で）みてみました。

「Bucket name should not contain uppercase characters」

...え？
S3バケットってそんなルールあったっけ...？

S3の命名規則が変更されていた

AWSのドキュメントを確認してみると、2018年3月1日から、命名規則が変わっていた模様。
全然気がつかなかった。

まとめ

AWS Amplifyとmultienvを使うとサクッと環境構築できますが、こんな落とし穴もありました。
知識共有と、トラブルシューティング手順の参考にでもなれば幸いです。