メインコンテンツへスキップ

mabl CLI のインストールに関するトラブルシューティング

Molly Exten
  • 更新

mabl CLI のインストール時に課題が発生した場合は、このガイドを使って、mabl CLI コマンドが動作しない一般的な問題のトラブルシューティングを行ってください。

権限エラー

mabl CLI をインストールする際に「Access denied」や EACCES: permission denied などのメッセージが表示された場合、権限エラーが発生している可能性があります。権限エラーは、mabl CLI の Node パッケージをグローバルにインストールするための権限が不足していることを示しています。

この課題を解決するには、npm を更新して、グローバルパッケージを自分が所有し、完全にアクセスできるディレクトリにインストールするようにしてください。次のいくつかの方法があります:

  • nvm や nvm-windows などの Node バージョンマネージャーを使いましょう。NVM は、グローバルパッケージのインストールをユーザー所有のディレクトリで自動的に管理します。
  • コマンドnpm config setを使うか、.npmrcファイルを直接編集して、npmのグローバルパッケージディレクトリを手動で更新してください。

npm を更新すると、sudo コマンドを使う必要がなくなり、よくある権限エラーを回避できます。npm を更新した後、もう一度 mabl CLI のインストール をお試しください。

「コマンドが見つかりません」エラー

ターミナルやコマンドプロンプトでmablコマンドを実行した際に「Command not found」などのエラーが表示される場合は、オペレーティングシステム（OS）が実行しようとしているものを見つけられていません。

ターミナルでコマンドを実行すると、OSはシステムのPATH環境変数に登録されているディレクトリを検索します。たとえば、mabl --versionを実行すると、OSはPATH変数内でmabl CLIがインストールされているディレクトリを探します。そのディレクトリがインストールされていない、またはPATH変数に含まれていない場合、システムはどこにあるか分からず、mabl: Command not foundのようなメッセージを返します。

この課題を解決するには、npm のグローバルパッケージディレクトリを手動でシステムの PATH に追加できます。

MacおよびLinuxユーザー

  1. ターミナルで、npm root -g を実行して、npm のグローバルパッケージのディレクトリを確認してください。
  2. echo $PATH を実行して、ステップ1で指定したディレクトリがリストに含まれているか確認してください。
  3. ディレクトリが表示されていない場合は、PATH変数に追加してください。PATH変数は、通常ホームディレクトリ（~）内のシェルの設定ファイル（たとえば、.zshrc、.bashrc、または.profile）にあります。設定ファイルをテキスト編集者で開き、次のような行を追加します。/path/to/your/npm/global/packagesはステップ1の出力に置き換えてください。
export PATH="/path/to/your/npm/global/packages:$PATH
  1. 設定ファイルを保存した後、変更を反映するためにターミナルを再起動してください。
  2. お使いのOSがmabl CLIコマンドを認識できるか確認するには、ターミナルでmabl -vを実行してください。

Windows ユーザー

  1. コマンドプロンプトで、npm root -g を実行して、npm のグローバルパッケージのディレクトリを取得してください。
  2. Windowsの検索バーで「環境変数」と入力し、システム環境変数の編集をクリックしてください。
  3. システムのプロパティで、環境変数をクリックしてください。
  4. ログインしているユーザーのPATH変数を選択し、編集をクリックしてください。
  5. ステップ1で作成したディレクトリをPATH変数に追加してください。
  6. 変更を保存してください
  7. お使いのOSがmabl CLIコマンドを認識できるか確認するには、コマンドプロンプトでmabl -vを実行してください。

「コマンドが見つかりません」というエラーが引き続き発生する場合

PATHを更新した後でも「Command not found」というエラーが表示される場合、mabl CLI が正しくインストールされていない、またはまったくインストールされていない可能性があります。この場合は、mabl CLI を再インストールすることをおすすめします。

サポートされていない Node.js バージョン

mabl CLI をインストールする際に、npm WARN notsup Unsupported engine のような Node.js バージョン要件に関するメッセージが表示された場合、コマンドラインで現在有効になっている Node バージョンが mabl CLI の最小要件を満たしていません。

このような場合は、次のトラブルシューティング手順を試してください。

  1. コマンドラインで node -v を実行して、現在アクティブな Node のバージョンを確認してください。mabl CLI を使用するには、サポートされている Long Term Support (LTS) バージョンの Node が必要です。
  2. ご利用中のバージョンが古い場合は、Node.js のウェブサイトからサポートされているバージョンをダウンロードしてインストールしてください。
  3. お使いのマシンに複数のNodeのバージョンがある場合は、nvmやnvm-windowsなどのNodeバージョンマネージャー（NVM）の利用を検討すると、管理が簡単になります。または、システムのPATHを手動で調整して、希望するNodeバージョンが古いバージョンよりも優先されるように設定できます。

Node をインストールまたはアップデートした後、mabl CLI のインストールをもう一度お試しください。

プロキシ課題

mabl CLI をインストールする際にこのようなエラーが表示された場合は、npm のプロキシ設定を行う必要があるかもしれません。

  • ETIMEDOUT - 接続タイムアウト
  • ECONNREFUSED - 接続が拒否されました
  • UNABLE_TO_GET_ISSUER_CERT_LOCALLY - SSL証明書の課題で、プロキシに関連することがよくあります。
  • SELF_SIGNED_CERT_IN_CHAIN - よくあるSSLプロキシエラーの一つです

ご自身の組織でインターネットアクセスを管理するために企業用ファイアウォールやプロキシサーバーを使用しているか分からない場合は、IT部門やネットワーク管理者に確認してください。正しいプロキシアドレスとポートを教えてもらえます。

npm のプロキシ設定を構成する

次のコマンドを使ってnpmのプロキシを設定してください。http://proxy.example.com:8080は、ご自身のプロキシアドレスとポートに置き換えてください。

# Set HTTP proxy  
npm config set proxy http://proxy.example.com:8080
# Set HTTPS proxy  
npm config set https-proxy http://proxy.example.com:8080

npmでプロキシ設定を行った後、もう一度mabl CLI のインストールをお試しください。

関連記事