meteor-cli-installation

Meteor CLI のインストールと修復

アプリケーションを変更したり、ユーザーが対象としていない状態を削除したりせずに、Meteor CLI を使用できるようにします。npx meteor は公式の npm インストーラーを実行し、ユーザー全体で使用できる Meteor インストールを作成します。インストーラーが npm のグローバルパッケージに恒久的に追加されることはありません。

判断フロー

1. マシンを変更する前に、リクエストの内容を分類します。
   • ユーザーが Meteor のセットアップを依頼した場合、または CLI を必要とするローカルでの作成、実行、テスト、ビルド、デプロイ操作を依頼した場合は、不足している CLI をインストールします。
   • 説明、レビュー、計画のみの場合は、不足している前提条件とインストールコマンドを報告し、実行はしません。
   • 状態を削除する復旧操作（meteor reset、meteor reset --db、npm キャッシュの消去、対象を絞ったグローバルメタデータのクリーンアップ、アンインストール、完全な再インストール）を行う前に、明示的な確認を求めます。
   • クリーンアップや再インストールが妥当と思われる根拠がある場合は、最も破壊的でない方法を、その理由、対象範囲、想定される状態の損失とともに提案します。ユーザーがその操作を明示的に確認するまで実行しません。
2. ホスト環境と対象プロジェクトを確認します。オペレーティングシステム、アーキテクチャ、node --version、npm --version、CLI の検索結果、および利用可能な場合は meteor --version を確認します。アプリケーション内では、リリースを選択する前に .meteor/release を読み取ります。
3. リクエストされたバージョンを区別します。
   • npx meteor@<version> の npm セレクターは、インストーラーパッケージを選択します。
   • Meteor アプリケーションは、.meteor/release にあるフレームワークリリースに固定されています。 プロジェクトが別のリリースを使用しているという理由だけで、ユーザー全体で使用する CLI を再インストールしないでください。 既存のローカルデータに対して Meteor 3.6-beta.3 または 3.6-rc.0 を選択する前に、ローカルデータベースの準備を読み取ります。 同梱の MongoDB 8 を使用するには、ホストの確認と、新しいリリースを開始する前の前リリースでの MongoDB 7 FCV の準備が必要です。
4. CLI が見つからない場合、PATH の問題、npm インストーラーの失敗、またはホストの前提条件に関する問題については、インストールと PATH に従います。
5. プロジェクトのリリース、キャッシュのリセット、開発バンドルの破損、アンインストール、またはクリーンな再インストールについては、リリース、リセット、再インストールに従います。 確認された問題を理由にユーザー全体で使用するインストールの再インストールを提案する前に、再インストールの判断ガイドを使用します。
6. meteor --version で結果を確認します。プロジェクトでの作業では、依頼された範囲で最小限の Meteor コマンドを実行し、.meteor/release のリリースが解決されることを確認します。実行したコマンド、選択したバージョン、削除した状態、および新しいシェルでユーザーが行う必要のある操作を報告します。

インストールのルール

状況	操作
サポートされている最新の CLI	npx meteor を実行します。
インストーラーパッケージを固定する場合	npx meteor@<version> install を実行し、報告された Meteor リリースを確認します。
Linux または macOS での代替方法	curl https://install.meteor.com/ | sh も引き続きドキュメントに記載されています。クロスプラットフォームで使用する主なコマンドには npx meteor を使用します。
npm のフォールバック	ドキュメントに記載された npx の復旧手順が失敗した場合に限り、npm install -g meteor --foreground-script を実行します。
既存のプロジェクトで別のリリースが必要な場合	プロジェクトの固定バージョン、または Meteor の --release コマンドを使用します。最初にユーザー全体で使用するインストールを置き換えないでください。

npx install meteor は絶対に実行しないでください。npm の meteor インストーラーをアプリケーションの package.json に追加しないでください。これはインストーラーであり、フレームワークのランタイムではありません。

状態の境界

状態	範囲	安全な操作
ユーザーの Meteor ディレクトリ	ユーザー用にダウンロードされたツール、リリース、開発バンドル、CLI の状態	npx meteor uninstall を実行すると、インストール全体が削除されます。許可を得たアンインストールまたはクリーンインストールの場合にのみ使用してください。
ユーザーのパッケージカタログメタデータ	ユーザーの Meteor ディレクトリ内で共有されるリリースおよびパッケージのメタデータ	通常のオンラインカタログ更新を優先してください。対象を絞ったメタデータの再構築は、高度な復旧手段として、確認を必須としてください。
.meteor/release	プロジェクトのフレームワークリリース	グローバルな再インストールではなく、meteor update --release <release> で変更してください。
.meteor/local	プロジェクトのビルドキャッシュ、生成された状態、ローカル開発用データベース	プロジェクトキャッシュに問題がある証拠がある場合は、データベースを保持する meteor reset を提案してください。meteor reset --db はデータベースを削除します。いずれも確認を得てから実行してください。
npm の npx キャッシュ	一時的なインストーラーパッケージのキャッシュ	npx 固有の障害が発生した場合に限り、消去を提案してください。通常の Meteor ビルドの問題には提案しないでください。確認を得てから実行してください。

文書化されたコマンドと、その層を特定する証拠がない限り、内部ツールや開発バンドルのディレクトリを個別に削除しないでください。プロジェクトキャッシュの破損には meteor reset を使用してください。ユーザー全体のインストール自体が破損している場合に限り、許可を得たうえで完全に再インストールしてください。ユーザー向けのキャッシュ削除手段として、非公開の Meteor 管理コマンドを決して提案しないでください。

引き継ぎ

• CLI は起動するが、アプリケーションが失敗する場合：meteor-debugging。
• アプリケーションを Meteor 2 から Meteor 3 に移行する必要がある場合：migrate-to-meteor-3。
• CLI とプロジェクトの状態を分類した後も、ビルドキャッシュまたはバンドラーの障害が続く場合：meteor-modern-build-stack または migrate-to-rspack。
• デプロイ認証情報、Galaxy、コンテナ、またはランタイム設定の場合：meteor-deployment。

参考資料

• インストールと PATH
• リリース、リセット、再インストール
• 再インストールの判断ガイド
• 評価ケース