Object Storage Service (OSS) バケットの管理、オブジェクトのアップロードとダウンロード、データの管理、および画像処理 (IMG) を実行する場合は、最初に OSS SDK for Python をインストールします。このトピックでは、OSS SDK for Python をインストールする方法について説明します。
準備
Python をインストールします。
OSS SDK for Python には、Python 2.6、2.7、3.3、3.4、3.5、3.6、3.7、3.8 以降が必要です。
説明 Windows に OSS SDK for Python をインストールする場合は、Visual C++ のバージョンが 15.0 以降であることを確認してください。
次のコマンドを実行して、Python のバージョンを確認します。
python --version
次の応答は、Python 3.8.2 がインストールされていることを示しています。
Python 3.8.2
OSS SDK for Python のダウンロード
python-devel のインストール
環境を準備した後、最初に python-devel パッケージをインストールする必要があります。
説明 OSS SDK for Python は、crcmod ライブラリを使用して巡回冗長検査 (CRC) の値を計算します。 crcmod ライブラリは、python-devel パッケージ内の Python.h ファイルに依存しています。 Python.h ファイルが存在しない場合、インストールは影響を受けませんが、C の crcmod 拡張機能はインストールに失敗します。この場合、Python 専用モードを使用して CRC の値を計算し、オブジェクトのアップロードとダウンロード時に CRC-64 を実行します。その結果、オブジェクトのアップロードやダウンロードなどの操作が非効率的な方法で実行されます。
Windows
Windows に Python をインストールすると、Python.h ファイルは Python と一緒にインストールされます。そのため、python-devel をインストールする必要はありません。
macOS
macOS に Python をインストールすると、Python.h ファイルは Python と一緒にインストールされます。そのため、python-devel をインストールする必要はありません。
CentOS
次のコマンドを実行して、python-devel をインストールします。
sudo yum install python-devel
RHEL
次のコマンドを実行して、python-devel をインストールします。
sudo yum install python-devel
Fedora
次のコマンドを実行して、python-devel をインストールします。
sudo yum install python-devel
Debian
次のコマンドを実行して、python-devel をインストールします。
sudo apt-get install python-dev
Ubuntu
次のコマンドを実行して、python-devel をインストールします。
sudo apt-get install python-dev
OSS SDK for Python のインストール
python-devel をインストールした後、次のいずれかの方法を使用して OSS SDK for Python をインストールできます。
pip
pip をインストールします。
Python 2.7.9 以降および Python 3.4 以降では、pip はデフォルトでインストールされています。
次のコマンドを実行して、最新バージョンの OSS SDK for Python をインストールします。
pip install oss2
ソースコード
GitHub にアクセスして、最新バージョンの OSS SDK for Python パッケージをダウンロードします。パッケージを解凍し、setup.py ファイルがディレクトリに存在するかどうかを確認します。
以前のバージョンの OSS SDK for Python をダウンロードする方法の詳細については、「過去のバージョン」をご参照ください。
次のコマンドを実行して、OSS SDK for Python をインストールします。
python setup.py install
OSS SDK for Python がインストールされているかどうかの確認
OSS SDK for Python をインストールした後、次の手順を実行して、OSS SDK for Python がインストールされているかどうかを確認します。
次のコマンドを実行して、Python 環境に入ります。
python
次のコマンドを実行して、OSS SDK for Python のバージョンを確認します。
import oss2
oss2.__version__
次の応答は、OSS SDK for Python 2.18.3 がインストールされていることを示しています。
'2.18.3'
よくある質問
「No module named _crcfunext」というエラーメッセージが返された場合はどうすればよいですか?
問題の説明
OSS SDK for Python を使用してアップロードおよびダウンロード操作を呼び出すと、ossutil や他の OSS SDK などの他のツールを使用するよりもはるかに遅くなります。
原因
crcmod ライブラリをコンパイルすると、_crcfunext.so ファイルは Python.h ファイルに依存します。このエラーは、システムに Python.h ファイルが存在しないために発生し、_crcfunext.so ファイルが生成に失敗します。 crcmod の詳細については、「crcmod の紹介」をご参照ください。
解決策
次の手順を実行して、C の crcmod 拡張機能がインストールされているかどうかを確認できます。
次のコマンドを実行して、Python 環境に入ります。
python
次のコマンドを実行して、crcmod モジュールに _crcfunext の C 拡張モジュールをインポートします。
import crcmod._crcfunext
次のエラーメッセージが表示された場合、C の crcmod 拡張機能はインストールに失敗します。
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
ImportError: No module named _crcfunext
オペレーティングシステムに基づいて解決策を選択します。
Windows
crcmod-1.7.win32-py2.7.msi または別のバージョンの .msi ファイルをダウンロードします。
説明 win32 システム用の crcmod ライブラリは、win64 システムとも互換性があります。
.msi ファイルをインストールし、Python のローカルインストールパスにある Lib\site-packages ディレクトリを crcmod のインストールパスとして指定します。例:D:\python\Lib\site-packages\。
.msi ファイルがインストールされた後、上記の手順を実行して、C の crcmod 拡張機能がインストールされているかどうかを確認します。
Linux
Linux の場合、次の手順を実行して問題を解決します。
次のコマンドを実行して、crcmod ライブラリをアンインストールします。
pip uninstall crcmod
python-devel をインストールします。詳細については、「python-devel をインストールする」をご参照ください。
次のコマンドを実行して、crcmod ライブラリを再インストールします。
pip install crcmod
上記の手順を実行した後も crcmod ライブラリがインストールに失敗する場合は、crcmod ライブラリをアンインストールします。次に、次のコマンドを実行して、インストールの失敗の詳細を表示します。
pip install crcmod -v
No module named 'Crypto' というエラーメッセージが返された場合はどうすればよいですか?
問題の説明
No module named 'Crypto' というエラーメッセージがプログラムの実行中に返されます。
原因
Crypto が存在しないか、crypto が存在します。
解決策
D:\python3.9\Lib\site-packages など、Python のローカルインストールパスに Crypto が存在するかどうかを確認します。
Crypto が存在しない場合は、次のコマンドを実行します。
python -m pip install --upgrade setuptools
最初の文字が小文字の crypto が存在する場合は、最初の文字を大文字に変更してプログラムを再起動します。
コマンドが内部コマンドまたは外部コマンドではないことを示すエラーメッセージが返された場合はどうすればよいですか?
Windows で、コマンドが内部コマンドまたは外部コマンドではないことを示すエラーメッセージが返された場合は、Path 環境変数を変更し、Python と pip のインストールパスを環境変数に追加します。 pip のインストールパスは、Python のインストールパスにある Scripts ディレクトリです。 Path 環境変数を変更した後、環境変数を有効にするためにコンピュータを再起動する必要がある場合があります。
OSS SDK for Python のインストールに失敗した場合はどうすればよいですか?
OSS SDK for Python のインストールに失敗した場合は、次のコマンドを実行して OSS SDK for Python をアンインストールします。次に、再インストールします。
pip uninstall oss2
OSS SDK for Python をアップグレードするにはどうすればよいですか?
次のコマンドを実行して、OSS SDK for Python をアップグレードします。
pip install --upgrade oss2