App Service on AKS Hybrid のチュートリアルにはまった件

App Service on AKS on Azure Stack HCI (Preview) を評価していたときのこと、以下のチュートリアルに従って Node.js サンプル アプリ (nodejs-docs-hello-world) をデプロイしたのですが、ポッドが CrashLoopBackOff の無限ループに。ワークロード クラスターの再作成以外に止める方法がなさそう。

Azure Arc で App Service アプリを作成する (プレビュー)
https://learn.microsoft.com/ja-jp/azure/app-service/quickstart-arc

 

通常の Azure App Service でやってみると :) Application Error。サンプルがダメなの？って思いつつあったけど、

 

数日間いろいろと試してみた結果、 「4. コードをデプロイする」の 4 行のコマンドラインに太字の部分を追加することで解決。（2/16 追記、フィードバックが反映され、現在のDocsには太字部分が追加されています）。

git clone https://github.com/Azure-Samples/nodejs-docs-hello-world
cd nodejs-docs-hello-world
zip -r package.zip .
az webapp config appsettings set --resource-group  myResourceGroup --name <app-name> --settings SCM_DO_BUILD_DURING_DEPLOYMENT=true
az webapp deployment source config-zip --resource-group myResourceGroup --name <app-name> --src package.zip

 

ここ（↓）にたどり着くまで何日かかったことか（実は、こっちのチュートリアルの手順で気付いた）。ZIP デプロイの常識（？）なんでしょうけど。チュートリアルに一言（リンク）あればいいのに。（「ZIP デプロイを使用してデプロイします。」にあった。ちゃんと見ろって？）az webapp up コマンドにはビルド自動化の有効化の処理が含まれているんだそうですが、App Service on AKS on Azure Stack HCI (Preview) は現状 az webapp up に対応していないのでした。

App Service にファイルをデプロイする｜ZIP デプロイのビルド自動化を有効にする
https://learn.microsoft.com/ja-jp/azure/app-service/deploy-zip?tabs=cli#enable-build-automation-for-zip-deploy

ZIP パッケージから Azure App Service のアプリを直接実行する
https://learn.microsoft.com/ja-jp/azure/app-service/deploy-run-package

2/16 追記、フィードバックが反映され、現在のDocsには太字部分が追加されました（日本語版はまだ）。