DSW インスタンスでは、ターミナルを使用してサードパーティの Python ライブラリのインストール、表示、アンインストール、更新ができます。DSW はイメージ環境への変更を自動的に保存します。
サードパーティ ライブラリのインストール
DSW は、Python 2、Python 3、PyTorch、TensorFlow 2.0 など、複数の開発者環境を提供します。デフォルトでは、サードパーティライブラリは Python 3 環境にインストールされます。別の環境にライブラリをインストールするには、ライブラリをインストールする前にその環境に切り替える必要があります。次のコマンド形式を使用します。
# Python 3 環境にライブラリをインストールします。
pip install <yourLibraryName>
# Python 2 環境にライブラリをインストールします。
source activate python2
pip install <yourLibraryName>
# TensorFlow 2.0 環境にライブラリをインストールします。
source activate tf2
pip install <yourLibraryName><yourLibraryName> を、インストールするサードパーティライブラリの名前に置き換えます。たとえば、pip install bottle コマンドを実行して bottle ライブラリをインストールできます。
Jupyter Notebook のセルでインストールコマンドを実行する場合は、コマンドの前に感嘆符 (!) を追加する必要があります。例： !pip install bottle。
パッケージが正常にインストールされても Notebook で見つからない場合は、カーネルを再読み込みする必要があります。
サードパーティ ライブラリの表示
次のコマンドを実行して、インストールされているサードパーティライブラリを表示できます。
pip listサードパーティ ライブラリのアンインストール
次のコマンドを実行して、インストール済みのサードパーティライブラリをアンインストールできます。
pip uninstall <yourLibraryName><yourLibraryName> を、インストール済みのサードパーティライブラリの名前に置き換えます。
アンインストールできるのは、自分でインストールしたサードパーティライブラリのみです。
サードパーティ ライブラリの更新
次のコマンドを実行して、インストール済みのサードパーティライブラリを更新できます。
pip install --upgrade numpy==<versionNumber><versionNumber> を、インストールする numpy のバージョン番号に置き換えます。
pip ソースの表示または変更
次のコマンドを実行して、pip 構成ファイルを表示できます:
pip config list応答では、global.index-url パラメーターの値がグローバル pip ソースの URL です。以下に応答のサンプルを示します：
global.index-url='https://mirrors.aliyun.com/pypi/simple/'
global.trusted-host='mirrors.aliyun.com'
install.trusted-host='mirrors.aliyun.com'サードパーティライブラリをインストールする際に一時的に pip ソースを設定するには、次のコマンドを使用します：
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple <yourLibraryName>
# SSL 認証エラーが発生した場合は、--trusted-host パラメーターを追加してみてください。例:
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn <yourLibraryName>グローバル pip ソースを変更するには、pip 設定ファイルを編集します。ファイルのデフォルトパスは ~/.config/pip/pip.conf です。次のコマンドを実行して設定ファイルを編集できます：
vim ~/.config/pip/pip.conf次の例では、ソースを Tsinghua の pip ソースに変更する方法を示します。index-url と trusted-host パラメーターを変更し、ファイルを保存して終了します。変更後の pip.conf ファイルは次のようになります：
[global]
trusted-host=pypi.tuna.tsinghua.edu.cn
index-url = https://pypi.tuna.tsinghua.edu.cn/simple/
[install]
trusted-host=pypi.tuna.tsinghua.edu.cnよくある質問
Q：DSW インスタンスを停止した後、pip でインストールしたパッケージや作成したコードは失われますか？
A：いいえ、システムディスクとしてクラウドディスクを使用している場合、データは失われません。インスタンスディスク上のデータ (/mnt/workspace および /root ディレクトリ内の環境を含む) は保存されます。インスタンスを再起動すると、すべての環境とファイルが維持されます。インスタンスを削除する操作のみが、すべてのデータを完全に削除します。
Q：インストールしたサードパーティパッケージが動作しないのはなぜですか？
A：pip コマンドを使用してパッケージをインストールしたにもかかわらず、import コマンドで見つけられない場合は、まずサービスまたはカーネルを再起動してください。エラーが解決しない場合は、現在の環境を確認してください。デフォルトでは、DSW はサードパーティパッケージを Python 3 環境にインストールします。別の環境にパッケージをインストールするには、まずその環境に切り替えてからインストールを実行する必要があります。例：
# Python 2 環境にインストールします。
source activate python2
pip install --user xxx
# TensorFlow 2.0 環境にインストールします。
source activate tf2
pip install --user xxxxxx を、インストールするサードパーティパッケージの名前に置き換えます。
Q: 依存関係の競合またはバージョンのエラーにより、DSW で pip install を使用したパッケージのインストールに失敗しました。どうすればよいですか？
この問題は通常、環境の非互換性が原因で発生します。次の手順を順番に実行して、問題をトラブルシューティングできます:
推奨されるソリューション：イメージを変更します。現在のインスタンスを停止し、新しい DSW インスタンスを作成して、別の公式イメージを選択できます。たとえば、現在の PyTorch 2.1 イメージが機能しない場合は、PyTorch 2.3 イメージまたは modelscope シリーズのイメージを試すことができます。
modelscopeシリーズのイメージは、通常、より優れた互換性を提供します。特定のバージョンをインストールします。パッケージの公式ドキュメントを確認して、現在の DSW 環境 (Python および CUDA のバージョンを含む) と互換性のあるバージョンを見つけます。その後、
pip install package_name==x.y.zを実行します。ダウンロードソースを変更します。Tsinghua University のソースなど、別のミラーを試すことができます：
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple <yourLibraryName>。
Q: DSW ターミナルにライブラリをインストールしましたが、Jupyter Notebook にインポートすると見つからないのはなぜですか？
A：この問題は、ターミナルと Jupyter Notebook が異なる Python 環境を使用しているために発生する可能性があります。which python コマンドを実行して、どの Python 環境が使用されているかを確認できます。または、Notebook で必要なライブラリをインストールすることもできます。例：
Q: コードで CUDA ドライバーのバージョンが低すぎるというエラーが報告されます。DSW で NVIDIA ドライバーを手動でアップグレードする必要がありますか？
A：いいえ、ドライバーのバージョンをアップグレードする必要はありません。DSW インスタンスのドライバーと CUDA はプリインストール済みでロックされています。手動で変更しないでください。ドライバーまたは CUDA を変更すると、インスタンスが破損し、復旧できなくなる可能性があります。正しいアプローチは、DSW イメージを変更することです。現在のインスタンスを停止し、新しいインスタンスを作成して、より高い CUDA およびドライバーバージョンを持つ公式イメージを選択できます。
たとえば、公式イメージ modelscope:1.9.4-pytorch2.0.1tensorflow2.13.0-gpu-py38-cu118-ubuntu20.04 を使用できます。イメージ名では、`cu118` は CUDA のバージョンが 11.8 であることを示します。
Q：DSW で Docker を使用してアプリケーションをデプロイできますか？
A：Lingjun リソースで Docker を使用するには、チケットを送信してホワイトリストに追加してもらう必要があります。ただし、Lingjun リソースではない DSW インスタンスは、現在、インスタンスコンテナー内での Docker の実行をサポートしていません。
Q：DSW インスタンスで unzip または 7z コマンドが利用できません。ファイルを解凍するにはどうすればよいですか？
apt-get コマンドを使用してインストールできます。
unzipをインストールするには、ターミナルでapt-get update && apt-get install -y unzipを実行します。その後、unzip your_file.zipコマンドを使用できます。p7zip(7z 用) をインストールするには、ターミナルでapt-get update && apt-get install -y p7zip-fullを実行します。その後、7z x your_file.7zコマンドを使用できます。
Q：サードパーティパッケージのインストールが停止するか、タイムアウトします。原因は何ですか？
A：パッケージのインストールが停止、タイムアウト、または非常に遅い場合は、通常、ネットワークの問題が原因です。次のようにトラブルシューティングして問題を解決できます：
手順 1：ネットワーク接続の確認
ターミナルで ping www.aliyun.com コマンドを実行して、インターネット接続をテストできます。ネットワークが接続されていない場合は、手順 2 に進んでゲートウェイの設定を確認します。
手順 2：ゲートウェイ設定の確認
インスタンス設定ページで、Internet Access Gateway のタイプを確認できます：
パブリックゲートウェイ：デフォルトでは、DSW は Public Gateway を使用してインターネットにアクセスします。DSW インスタンスの設定ページでゲートウェイのタイプを確認できます。パブリックゲートウェイを使用する場合、帯域幅が制限され、ネットワーク速度が大きなファイルのダウンロード要件を満たさない場合があります。この場合、専用ゲートウェイを使用することを選択できます。
専用ゲートウェイ：専用ゲートウェイは、より高速なネットワークアクセスを提供します。専用ゲートウェイを選択した後、インターネット NAT ゲートウェイを作成し、Elastic IP Address (EIP) をアタッチし、Virtual Private Cloud (VPC) で SNAT を設定する必要があります。そうしないと、パブリックネットワークにアクセスできません。詳細については、「専用ゲートウェイでパブリックネットワークのアクセス速度を向上させる」をご参照ください。
手順 3：pip ダウンロードソースの変更を試す
DSW はデフォルトで Alibaba Cloud のミラーソースを使用します。ただし、ピーク時やネットワークの変動により問題が発生する可能性があります。他の国内ミラーソースに切り替えることを推奨します：
# Tsinghua ソースを使用してインストール (推奨)
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn <yourLibraryName>
# USTC ソースを使用してインストール
pip install -i https://pypi.mirrors.ustc.edu.cn/simple --trusted-host pypi.mirrors.ustc.edu.cn <yourLibraryName>
# Douban ソースを使用してインストール
pip install -i https://pypi.doubanio.com/simple --trusted-host pypi.doubanio.com <yourLibraryName>
デフォルトの pip ソースを永続的に変更するには、「pip ソースの表示または変更」をご参照ください。
手順 4：オフラインインストールを使用する
ネットワークが利用できないか不安定な場合は、パッケージをオフラインでインストールできます：
ネットワーク接続が良好なローカルコンピューターで、
.whl形式のインストールパッケージをダウンロードします：# ローカルコンピューターで実行 pip download <yourLibraryName> -d ./packagesダウンロードした
.whlファイルを DSW インスタンスにアップロードします。ファイルのアップロード方法の詳細については、「ファイルのアップロードとダウンロード」をご参照ください。Data Science Workshop (DSW) でオフラインインストールするには：
pip install /path/to/your-package.whl
Q: DSW WebIDE で root 権限を取得するにはどうすればよいですか？
A：ほとんどの公式 DSW イメージは、デフォルトで root ユーザーとして実行されます。ターミナルを開いたときにコマンドプロンプトが root@... であれば、すでに root 権限を持っています。pip を使用してパッケージをインストールする際に表示される、root ユーザーとしてコマンドを実行しないように促す警告メッセージは、安全に無視できます。root ユーザーとしてログインしていない場合、これはイメージの設定です。root ログインをサポートするイメージに切り替える必要があります。
Q：DSW で X サーバーを起動するにはどうすればよいですか？
DSW では X サーバーを起動できません。