注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
トラブルシューティングガイド
カスタム環境の初期化が遅い
初期化が遅いことは、通常、環境の定義が大きすぎるか、複雑すぎることを示しています。環境に含まれるパッケージの数に応じて、初期化時間は超線形に増加する傾向があります。また、Foundry ではよく使われる環境を事前に初期化することが多いため、デフォルトプロファイルに基づいてカスタム環境を作成した場合、遅さは事前に初期化された環境をもらえなくなったためである可能性が高いです。環境作成プロセスの詳細については、環境作成の概要を参照してください。
以下を試してみてください:
- 元に戻す - 環境の設定に変更が加えられた後、初期化が遅くなった場合、変更を元に戻してみてください。たとえ1つのパッケージを追加するだけでも、初期化時間が劇的に増加することがあります。
- 簡略化する - 環境定義から不要なパッケージを削除します。小さく、特化した環境は、大きく、汎用的な環境よりもはるかに高性能です。
- バージョンを固定する - 環境設定パネルでパッケージのバージョン制約を追加し、環境の選択で説明されているように行います。
pythonのような多くの可能なバージョンがあるパッケージや、scipyのような複雑な依存関係グラフを持つパッケージに対してこれを行うのが最も効果的です。特定のパッケージを追加すると環境が遅くなった場合、そのパッケージのバージョンを固定してみてください。- 注意点: バージョンの固定を追加すると、環境が満たせなくなる可能性があります。環境の初期化に失敗した場合、固定を緩和してみてください。例えば、
python=3.6.10はそのバージョンのみに一致しますが、python=3.6はpython 3.6.xのいずれかに一致するため、満たす可能性が高くなります。 - 1つのオプションは、環境（ピンなし）が解決されるのを待ってから、選択されたバージョンを確認し（解決された環境の表示を参照）、初期化パフォーマンスが十分に高速になるまで、それらの特定のバージョンのピンを追加することです。通常、多くの依存関係を持つパッケージのバージョンを固定し、他のすべてのパッケージは固定しないままにするのが最適です。
- 注意点: バージョンの固定を追加すると、環境が満たせなくなる可能性があります。環境の初期化に失敗した場合、固定を緩和してみてください。例えば、
環境の初期化に失敗する
環境の初期化に失敗した場合、環境の起動エラーログを表示して、何が問題だったのかに関する追加情報を確認できます。
ログの最初の行には、「実行がゼロ以外の終了コードで失敗しました：」という文字列の後に、整数のエラーコードが続きます。このエラーコードは、特定の失敗モードを示しています。
コード1 - 環境解決エラー
このエラーは、指定されたパッケージの一部（および/またはその依存関係）が互換性がないか、インストールできないことを示しています。環境設定パネルでの最近の変更が初期化の失敗を引き起こした場合、変更を元に戻してみてください。以下に、一般的な環境解決エラーのリストを示します。
新しい Mamba エラーメッセージ
Palantir は、環境初期化エラーメッセージのフォーマットを改善することで、オープンソースの Mamba コミュニティに貢献しました ↗。2023年2月以降、Foundry サービスは、環境の失敗によって侵害される依存関係ツリーをより密接に表現するエラーを利用できます。
これらの新しいメッセージを理解する方法、解釈する方法、および修復する方法についてのアドバイスについては、新しいエラーメッセージを参照してください。
レガシー Mamba エラーメッセージ
以下は、新しい Mamba エラーメッセージが導入される前の、レガシーなエラーメッセージの一般的なエラーメッセージのリストです。
パッケージが見つからない
この場合、設定されたチャネルのいずれも、パッケージ A 依存関係を提供していません。