注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

トラブルシューティングガイド

このガイドの手順に従って、Python 環境の作成で最も一般的な問題をデバッグします。

パッケージ解決中にチェックが失敗する

次のチェックの失敗については、コードリポジトリ内の「チェック」タブでチェックログを表示できます。これらのログを使用して、チェックが失敗した理由を特定できます。

新しい Mamba エラーメッセージ

Palantir は、環境初期化エラーメッセージのフォーマットを改善することで、オープンソースの Mamba コミュニティに貢献 ↗しました。2023年2月以降、Foundry サービスは、環境の失敗によって侵害される依存関係ツリーをより正確に表現するエラーに対応しています。

依存関係のツリー

次の例では:

  • 修正方法:パッケージにタイプミスがないことを確認するか、またはすべての要求されたパッケージが環境で使用可能であることを確認します。パッケージの存在をFoundryで検索する方法については、Pythonライブラリを探すを参照してください。

  • is installable and it requires:パッケージとその添付されたバージョンは環境にインストール可能で、しかし環境に追加の制約を導入します。

  • is uninstallable because it requires:パッケージとその添付されたバージョンは、依存関係の一部が環境で競合を生じさせるため、インストールできません。

    • 修正方法:メッセージの下にリストされた依存関係の問題の要件を調査し、その制約を緩和するか、またはこの特定のパッケージの制約を緩和します。
  • is installable with the potential options:パッケージには、環境にインストール可能な、競合しない一連のバージョンがあります。これらのバージョンの一つを選択すると、さらなる制約が導入される可能性があります。

  • conflicts with any installable versions previously reported:通常、上の行で言及されたバージョンと対比され、そのパッケージのすでに仮定されたバージョンが他の場所で決定され、このバージョンはしたがって満足できないことを示します。

    • 修正方法:同じ環境が同じパッケージの異なるバージョンを直接的または間接的に要求しないようにします。
  • is missing on the system:これは特に、欠けているvirtual package ↗を指します。一部のパッケージは特定のOS環境でのみ動作します。たとえば、cudatoolkit ↗パッケージは、__cudaというシステムレベルの機能の特定のバージョンが仮想パッケージとして環境に存在することを要求し、パッケージが既存のアーキテクチャで動作できるようにします。

  • which cannot be installed (as previously explained):パッケージは、既に説明された競合や、同じ制約を含む別のパッケージが原因でインストールできません。

レガシーMambaエラーメッセージ

以下は、新しいMambaエラーメッセージが導入される前の、レガシーエラーメッセージからの一般的なエラーメッセージのリストです。

パッケージが見つかりません

この場合、設定されたチャネルのいずれもパッケージAの依存関係を提供していません。