Node.js対応のサーバーへ公開する

Node.jsの公開先で、コード・データ・秘密情報を準備し、起動と公開前確認を進める順序を説明します。

目次

Node.jsは、ウェブサイトのプログラムを動かすための道具です。このガイドでは、Node.js対応のサーバーにEmDashを置く順序を説明します。ここでいうサーバーは、読者がいつでもアクセスできるように、サイトのプログラムを動かし続ける場所です。

公開には、コードの配置、記事や画像の保存先、秘密情報、起動と再起動の設定が必要です。サーバーを管理する制作担当者と一緒に進めます。契約先によって設定画面が違うため、ここでは共通の作業順序を説明します。

まだ公開先を選んでいなければ、公開する場所の選び方から始めます。すでに決まっている場合は、制作担当者に「契約先の管理画面」「コードを置くフォルダー」「確認用URL」を案内してもらってから進みましょう。

1. 公開先で使えるものを確認する

確認項目確認する相手・場所
Node.jsの対応版契約先の実行環境。参照手順の基準は22.23.4以上
常時起動自動停止・スリープ・再起動の設定
データの保存先再配置しても消えないディスク、または外部DB・ストレージ
HTTPSとドメイン公開URL・証明書・通信の振り分け設定
操作できる担当者サーバー、秘密情報、バックアップの管理者

DB(データベース)は記事や設定を保存する仕組みです。SQLiteはその方式の一つで、ファイルへ保存します。画像などを残す場所はストレージと呼びます。

SQLiteを使う場合は、公開先のNode.jsで文章を検索する機能であるFTS5を使えるかも確認します。版番号だけで判断せず、公式Node.js公開ガイド(別タブで開く)の確認方法をその環境で試します。

2. 公開するコードと保存先を分ける

テーマなどのコードを置く場所と、記事のDB・アップロード画像を残す場所を決めます。公開のたびにコードのフォルダーが入れ替わるサービスでは、同じ場所へDBを置くと消える恐れがあります。

1台のサーバーでSQLiteとローカル画像を使う構成、外部DBと外部ストレージを使う構成では準備が違います。複数台を動かす場合も、各台が別々の記事を持つ構成にしないよう確認します。保存するデータの整理

3. 設定と秘密情報を渡す

制作担当者が、Astroで作ったサイトをNode.js向けに出力する部品「Node用アダプター」と、EmDashのDB・画像の接続設定を確認します。公開URLは EMDASH_SITE_URL などで正しく伝えます。EMDASH_SITE_URLは、プログラムを動かす環境へ設定値を渡す「環境変数」の一つです。公開用ファイルを作るときと、サーバーで動かすときの両方へ、必要な値を渡します。

暗号化キーや接続用パスワードは、ホスティングの秘密情報の設定へ入れます。.env を置いただけで本番起動時に自動読込されるとは限りません。既存データを移すときは、そのデータに必要な暗号化キーも引き継ぎます。

4. ビルドして起動する

次のコマンドは、制作担当者が公開先または公開用ファイルを作る専用環境で実行します。手元のパソコンで実行すると、そのパソコン上での作業になるため、実行場所を先に確認してください。

契約先のコマンド入力画面か自動実行の設定で、サイトの package.json があるフォルダーを指定します。package.json は、使う部品や実行する作業をまとめたファイルです。必要なnpmの部品をそろえ、前の設定を済ませてから進めます。

npm run build

ビルドは公開用ファイルを作る作業です。成功したら、公開先の起動コマンドへ次を設定します。

node ./dist/server/entry.mjs

ログに起動状態が出ても、まだ読者へ接続先を切り替えません。サーバーの管理機能で再起動後も起動する設定を確認します。予約公開などの定期処理も、Node.jsで動いているプログラムが止まっている間は動きません。

5. 読者へ開く前の確認

検証用URLで、公開ページ、管理画面へのログイン、テスト下書きの保存、画像のアップロードと表示を確認します。プラグインがあれば実行環境も確認します。管理者は、EmDashの版に合わせてデータの保存形式を更新する作業(内部DB移行)が残っていないかを調べます。

再起動後にも記事と画像が残ること、テストの予約が動くこと、バックアップを別環境へ戻せることまで見ます。トップページの表示に加えて、保存・予約・復元の操作が成功するところまで確かめてください。

確認が済んだら、公開切り替えの手順で読者の接続先を変えます。問題が起きた場合に、いつ旧サイトへ戻すかも先に決めておきます。作業後は手元の画面を閉じても、公開先のサイトが動くことを確かめましょう。

公開URLを環境ごとに指定する方法は、siteUrl・EMDASH_SITE_URL・SITE_URLの優先順で試せます。

公式の参照元

関連ガイド

メニュー
ホーム公式ドキュメント (別タブで開く)

キーワードを入力すると、ガイドの内容から探せます。