Azure に Node.js + MongoDB Web アプリをデプロイします

Azure App Service は、Linux オペレーティング システムを使用する、高度にスケーラブルな自己適用型の Web ホスティング サービスを提供します。 このチュートリアルでは、Azure Cosmos DB for MongoDB データベースに接続された Azure App Service でセキュリティで保護された Node.js アプリを作成する方法について説明します。 このチュートリアルを終了すると、Azure App Service on Linux で実行される Express.js アプリが完成します。

この記事では、既に Node.js の開発に慣れており、Node と MongoDB がローカルにインストールされていることを前提としています。 アクティブなサブスクリプションを持つ Azure アカウントも必要です。 Azure アカウントがない場合は、無料で作成できます。

サンプル アプリケーション

このチュートリアルに従うには、リポジトリ (https://github.com/Azure-Samples/msdocs-nodejs-mongodb-azure-sample-app) からサンプル アプリケーションを複製またはダウンロードします。

git clone https://github.com/Azure-Samples/msdocs-nodejs-mongodb-azure-sample-app.git

アプリケーションをローカルで実行したい場合は、次のようにします。

• npm install を実行して、パッケージの依存関係をインストールします。
• .env.sample ファイルを .env にコピーし、DATABASE_URL の値に MongoDB の URL を設定します (たとえば mongodb://localhost:27017/ など)。
• npm start でアプリケーションを起動します。
• アプリを表示するには、http://localhost:3000 を参照します。

1. App Service と Azure Cosmos DB の作成

この手順では、Azure リソースを作成します。 このチュートリアルで使用する手順では、App Service と Azure Cosmos DB for MongoDB を含む既定でセキュリティで保護された一連のリソースを作成します。 作成手順では、次のように指定します。

• 名前: Web アプリの名前。 Web アプリの DNS 名の一部として https://<app-name>.azurewebsites.net の形式で使われる名前です。
• 世界でアプリを物理的に実行するためのリージョン。
• アプリのランタイム スタック。 アプリで使うノードのバージョンを選びます。
• アプリのホスティング プラン。 これは、アプリの一連の機能と容量のスケーリングを含む価格レベルです。
• アプリのリソース グループ。 リソース グループを使うと、アプリケーションに必要なすべての Azure リソースを (論理コンテナーに) グループ化できます。

Azure portal にサインインし、以下の手順に従って Azure App Service リソースを作成します。

2. データベース接続の設定

作成ウィザードによって、既に MongoDB URI が生成されていますが、アプリには DATABASE_URL 変数と DATABASE_NAME 変数が必要です。 この手順では、アプリに必要な形式でアプリ設定を作成します。

3. サンプル コードのデプロイ

この手順では、GitHub Actions を使って GitHub のデプロイを構成します。 これは、App Service にデプロイする多くの方法の 1 つにすぎませんが、デプロイ プロセスで継続的インテグレーションを実現する優れた方法でもあります。 既定では、GitHub リポジトリに git push があるたびにビルドとデプロイのアクションが起動されます。

4. アプリの参照

5. 診断ログのストリーミング

Azure App Service は、アプリケーションの問題を診断するために、コンソールに記録されたすべてのメッセージをキャプチャします。 サンプル アプリは、この機能を示すために、各エンドポイントにコンソール ログ メッセージを出力します。 たとえば、get エンドポイントでは、データベースから取得したタスクの数に関するメッセージと、何か問題が発生した場合のエラーメッセージが出力されます。

router.get('/', function(req, res, next) {
  Task.find()
    .then((tasks) => {      
      const currentTasks = tasks.filter(task => !task.completed);
      const completedTasks = tasks.filter(task => task.completed === true);

      console.log(`Total tasks: ${tasks.length}   Current tasks: ${currentTasks.length}    Completed tasks:  ${completedTasks.length}`)
      res.render('index', { currentTasks: currentTasks, completedTasks: completedTasks });
    })
    .catch((err) => {
      console.log(err);
      res.send('Sorry! Something went wrong.');
    });
});

6. Kudu を使用したデプロイされたファイルの検査

Azure App Service は、Kudu という Web ベースの診断コンソールを提供しており、Web アプリのサーバー ホスティング環境を調査することができます。 Kudu を使用して、Azure にデプロイされたファイルを表示し、アプリケーションのデプロイ履歴を確認し、ホスト環境で SSH セッションを開くこともできます。

7.リソースをクリーンアップする

完了したら、リソース グループを削除することで、Azure サブスクリプションからすべてのリソースを削除できます。

よく寄せられる質問

• この設定にはいくらかかりますか。
• 仮想ネットワークの背後でセキュリティで保護されている Azure Cosmos DB サーバーに他のツールで接続するにはどうすればよいですか。
• GitHub Actions でのローカル アプリの開発はどのように行いますか。
• GitHub Actions のデプロイが遅いのはなぜですか。

この設定にはいくらかかりますか。

作成リソースの価格は次のとおりです。

• App Service プランは Basic レベルで作成され、スケールアップまたはスケールダウンできます。 「App Service の価格」をご覧ください。
• Azure Cosmos DB サーバーは 1 つのリージョンで作成して、他のリージョンに配布することができます。 「Azure Cosmos DB の価格」をご覧ください。
• 仮想ネットワークでは、ピアリングなどの追加機能を構成しない限り、料金は発生しません。 「Azure Virtual Network の価格」を参照してください。
• プライベート DNS ゾーンでは、少額の料金が発生します。 「Azure DNS の価格」を参照してください。

仮想ネットワークの背後でセキュリティで保護されている Azure Cosmos DB サーバーに他のツールで接続するにはどうすればよいですか。

• コマンドライン ツールからの基本的なアクセスには、アプリの SSH ターミナルから mongosh を実行できます。 アプリのコンテナーには mongosh が付属していないため、手動でインストールする必要があります。 インストールされたクライアントは、アプリの再起動後は保持されない点に注意してください。
• MongoDB GUI クライアントから接続するには、マシンが仮想ネットワーク内にある必要があります。 たとえば、サブネットの 1 つに接続されている Azure VM、または Azure 仮想ネットワークとサイト間 VPN で接続されているオンプレミス ネットワーク内のマシンが該当します。
• ポータルの Azure Cosmos DB 管理ページの MongoDB シェルから接続するには、マシンも仮想ネットワーク内にある必要があります。 代わりに、ローカル コンピューターの IP アドレスに対して Azure Cosmos DB サーバーのファイアウォールを開くこともできますが、構成の攻撃対象領域が増えることになります。

GitHub Actions でのローカル アプリの開発はどのように行いますか。

App Service から自動生成されたワークフロー ファイルを例にとると、git push ごとに新しいビルドとデプロイの実行が起動されます。 GitHub リポジトリのローカル クローンから、必要な更新を行い、それを GitHub にプッシュします。 次に例を示します。

git add .
git commit -m "<some-message>"
git push origin main

GitHub Actions のデプロイが遅いのはなぜですか。

App Service から自動生成されるワークフロー ファイルは、ビルドしてからデプロイする、2 つのジョブの実行を定義しています。 各ジョブは独自のクリーンな環境で実行されるため、ワークフロー ファイルでは deploy ジョブが build ジョブからのファイルに確実にアクセスできるようにします。

• build ジョブの終了時に、ファイルを成果物としてアップロードします。
• deploy ジョブの開始時に、成果物をダウンロードします。

2 つのジョブのプロセスでかかる時間のほとんどは、成果物のアップロードとダウンロードに費やされます。 必要であれば、2 つのジョブを 1 つにまとめて、アップロードとダウンロードの手順を不要にすることで、ワークフロー ファイルを簡略化することができます。

次の手順