この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので、ご注意ください。
いわさです。
先日、Azure Static Web Apps(SWA) CLIがGAとなりました。
SWA CLIから様々な機能を利用することが出来ますが、CLIを使ってStatic Web Appsへ直接デプロイすることができるようになりました。
従来はGitHubなどの利用が前提だったのですが、これで実質どこからでもデプロイができるようになったので、今回は AWS の Codeシリーズを使ってデプロイしてみました。
ローカルで実行
まずは、ローカル環境でデプロイできることを確認し、その後CodeCommitやCodeBuild, CodePipelineを設定していきます。
この記事ではmacOSを使っています。
事前に以下ドキュメントを参考に、インストールなどは済ませておきます。
ローカル環境では以下のようなファイル構成で準備しました。
$ tree
.
├── public
│ └── index.html
└── swa-cli.config.json
1 directory, 2 files
$ swa deploy -R hoge0528swa public
Welcome to Azure Static Web Apps CLI (1.0.1)
Deploying front-end files from folder:
/Users/iwasa.takahito/work/hoge0526swa/public
Checking Azure session...
✔ Successfully logged into Azure!
Checking project settings...
✔ Would you like to create a new Azure Static Web Apps project? … yes
✔ Choose a project name: … hoge0526swa
✔ Project created successfully!
✔ Successfully setup project!
Deploying to environment: preview
Deploying project to Azure Static Web Apps...
✔ Project deployed to https://jolly-dune-0f31e2b1e-preview.westus2.1.azurestaticapps.net ?
デプロイに成功したらアクセスしてみます。
$ curl https://jolly-dune-0f31e2b1e-preview.westus2.1.azurestaticapps.net
hoge swa
デプロイされていますね。デプロイされている環境がデフォルトではpreview
環境になる点にご注意ください。
デプロイトークンを使う
先程は事前にswa login
した環境からデプロイしていたのですが、AWSのCodeBuildコンテナからデプロイを行う想定でいます。
デプロイ時にデプロイトークンを使ったデプロイ方法もサポートされているので、まず事前にそちらを試してみます。
$ swa deploy -R hoge0528swa public --deployment-token asd55cd6874112341541b15b89c283d5515321513758e76a69d1d63002460313257d9321-b1d7d9f9-d228-44b5-a7d7-5050eebfec5201e20200
Welcome to Azure Static Web Apps CLI (1.0.1)
Deploying front-end files from folder:
/Users/iwasa.takahito/work/hoge0526swa/public
Deploying to environment: preview
Deploying project to Azure Static Web Apps...
✔ Project deployed to https://agreeable-hill-0ae55ba1e-preview.westus2.1.azurestaticapps.net ?
AWSで実行
ではここまでの内容を次はAWS上で実行したいと思います。
ソースコードはCodeCommitで管理し、CodeBuildのビルドコンテナ上でswa deploy
を実行しましょう。
まずは以下のようにCodeCommitへ初期状態のソースコードをPushしておきます。
次に、CodeBuildからデプロイを行うためにbuildspec.ymlを作成します。
以下のようにSWA CLIをインストールし、デプロイを行っています。
buildspec.yml
version: 0.2
phases:
install:
runtime-versions:
nodejs: 14
commands:
- npm_config_user=root npm install -g @azure/static-web-apps-cli
build:
commands:
- swa deploy public --deployment-token ${deployment_token}
注意点が2点あります。
1) Ubuntu standard:5.0 を使う
1点目は、マネージド型イメージを使う場合にはUbuntu standard:5.0
を選択しましょう。
SWA CLI では Node.js 14 からがターゲットとなっています。
一方で、CodeBuild のマネージド型イメージで Node.js 14 以上を使う場合は現時点ではUbuntu standard:5.0
を選択する必要があるようです。
2) デプロイトークンをシークレットに格納する
Don't store the deployment token in a public repository. It should be kept secret!
公式ドキュメントはこのように記載されています。
デプロイトークンをはリポジトリ上に格納せずに、パイプラインのシークレット機能へ格納しましょう。
以下ではプレーンテキストで保存してしまっていますが、Secret Managerなどのよりセキュアな保存方法を選択したほうが良いでしょう。
CodeBuildにおける環境変数の指定方法はこちらをご参照ください。
また、あとから気づいたのですがswa deploy
のdeployment-token
オプションで指定していますが、SWA_CLI_DEPLOYMENT_TOKEN
も対応しているそうなので、こちらも利用可能です。
デプロイ
今回はフロントエンドのビルドもないのでシンプルにデプロイするだけです。
必要に応じて利用しているフレームワークに応じたビルドステップを追加してください。
ここまでの設定で、問題なくデプロイ出来ました。
$ curl https://agreeable-hill-0ae55ba1e-preview.westus2.1.azurestaticapps.net
hoge swa from CodePipeline
さいごに
本日は、AWS CodePipeline から Azure Static Web Apps へのデプロイパイプラインを作ってみました。
gitリポジトリでAWS-Azure間で連携するとかのほうが楽な気はしますが、何らの理由でCodeシリーズに寄せたいがSWAを利用したいというケース(あるのか...?)の参考になればと思います。