Ghost 4.0 アップデート 502/503 エラー解決

先日Ghostがメジャーアップデート4.0を実施しましたが、公式フォーラムにも多数報告があるように、アップデート後に502/503エラーが起きることが確認されており、自身もアップデートに際し、同様のエラーを経験したので、解決方法を載せておきます。

1. Prepare for Update

アップデートに関して必要な環境は下記の通りになります。

• Node v14.16.0
• Ghost-CLI v1.16.3

まずはアップデートに際して、コンテンツディレクトリのバックアップをとります。

# Move to the ghost directory (this is depended on your environment)
$ cd /var/www/ghost

# Duplicate the content directory to backup directory
$ mkdir backup
$ cp -r content backup

次にNodeのバージョンを下記コマンドでチェックしv14.16.0(LTS)になっているか確認します。
もしバージョンが異なるようでしたら環境に応じてバージョンをアップ/ダウングレードしてください。
ここではnvmを使用した例を記述しておきます。

# Check the nodejs version
$ node -v

# If it is not v14.16.0, up/downgrade to the version (using nvm)
$ nvm install --lts --latest-npm
$ nvm alias default lts/*

最後にGhost-CLIを最新バージョンにアップデートします。

# Ensure your CLI is up to date
$ sudo npm install -g ghost-cli@latest

2. Update to Ghost 4.0

最後にGhostのバージョンをアップデートします。
Ghostではメジャーアップデートの前に最新のマイナーバージョンにする必要があります。
v3.Xをお使いの場合の例を記述しておきます。

# Upgrade to latest minor (3.X.X) version
$ ghost update --v3

# Upgrade to latest major (4.X.X) version
$ ghost update

3. After Update

アップデート後はGhost startコマンドより、Ghostを起動してもいいのですが、私自身の環境では、ここで502/503エラーを引き起こしました。私の場合そのまま起動せず、一旦再セットアップする方法にて解決しました。

# Stop Ghost first, then re-setup
$ ghost stop
$ ghost setup

ブログ設置情報に変更がない場合はそのままEnterを推し続けると、Ghostが起動します。
あとは自身のブログリンク(https://yourdomain.com/ghost)より確認してください。