ngrokのアップグレード(v2 to v3)

ngrokが最近メジャーバージョンアップして、バージョン3がリリースされましたので、アップグレード手順を紹介します。

なお、設定ファイルは、下位互換性がなくなっているので、ngrok本体のアップグレード後には、設定ファイルのアップグレードが必要になります。

ngrok本体のアップグレード

当サイトの導入記事で紹介したように、Homebrewでcask（Mac用アプリケーション）としてngrokをインストールしている場合は、以下のコマンドで本体をアップグレードします。

% brew upgrade ngrok

ちなみに、ngrokには、ngrok update コマンドもありますが、このコマンドではメジャーバージョンアップはされません。

アップグレード後にバージョンを確認するには、以下を実行します。

% ngrok version
ngrok version 3.0.6

なお、この直後に、ngrokを起動すると以下のようなエラーが出るため、後述の設定ファイルのアップグレードが必要になります。

% ngrok http 3000
ERROR:  Error reading configuration file '/Users/<your-os-user>/.ngrok2/ngrok.yml': `version` property is required.
ERROR:  
ERROR:  If you're upgrading from an older version of ngrok, you can run:
ERROR:  
ERROR:      ngrok config upgrade
ERROR:  
ERROR:  to upgrade to the new format and add the version number.

設定ファイルのアップグレード

さきほどのエラーメッセージにも、公式サイトにも説明されている通り、設定ファイルのアップグレードも必要になります。

% ngrok config upgrade

これで、~/.ngrok2/ngrok.ymlファイルが更新されて、通常通りngrokが使用できるようになります。

本サイトの更新情報は、Twitterの株式会社プレセナ・ストラテジック・パートナーズエンジニア公式アカウントで発信しています。ご確認ください。

前へngrokの導入次へSlack

最終更新 7 か月前