全部产品
Search
文档中心

:Instalasi

更新时间:Aug 13, 2025

Untuk mengelola bucket Object Storage Service (OSS), mengunggah dan mengunduh objek, mengelola data, serta melakukan pemrosesan gambar (IMG), Anda perlu memasang OSS SDK untuk Python terlebih dahulu. Topik ini menjelaskan cara memasang OSS SDK untuk Python.

Persiapan

  1. Pasang Python.

    OSS SDK untuk Python memerlukan Python 2.6, 2.7, 3.3, 3.4, 3.5, 3.6, 3.7, 3.8, atau versi yang lebih baru.

    Catatan

    Saat memasang OSS SDK untuk Python di Windows, pastikan bahwa versi Visual C++ adalah 15.0 atau yang lebih baru.

  2. Jalankan perintah berikut untuk memeriksa versi Python:

    python --version

    Respon berikut menunjukkan bahwa Python 3.8.2 telah dipasang:

    Python 3.8.2

Unduh OSS SDK untuk Python

Pasang python-devel

Setelah menyiapkan lingkungan, Anda harus memasang paket python-devel terlebih dahulu.

Catatan

OSS SDK untuk Python menggunakan pustaka crcmod untuk menghitung nilai cyclic redundancy check (CRC). Pustaka crcmod bergantung pada file Python.h dalam paket python-devel. Jika file Python.h tidak ada, instalasi tidak akan terpengaruh, tetapi ekstensi crcmod dalam C gagal dipasang. Dalam hal ini, mode Python-only digunakan untuk menghitung nilai CRC dan melakukan CRC-64 saat Anda mengunggah dan mengunduh objek. Akibatnya, operasi seperti unggah dan unduh objek dilakukan dengan cara yang tidak efisien.

Windows

Saat memasang Python di Windows, file Python.h dipasang bersama dengan Python. Oleh karena itu, Anda tidak perlu memasang python-devel.

macOS

Saat memasang Python di macOS, file Python.h dipasang bersama dengan Python. Oleh karena itu, Anda tidak perlu memasang python-devel.

CentOS

Jalankan perintah berikut untuk memasang python-devel:

sudo yum install python-devel                 

RHEL

Jalankan perintah berikut untuk memasang python-devel:

sudo yum install python-devel                 

Fedora

Jalankan perintah berikut untuk memasang python-devel:

sudo yum install python-devel                 

Debian

Jalankan perintah berikut untuk memasang python-devel:

sudo apt-get install python-dev                  

Ubuntu

Jalankan perintah berikut untuk memasang python-devel:

sudo apt-get install python-dev                  

Pasang OSS SDK untuk Python

Setelah memasang python-devel, Anda dapat menggunakan salah satu metode berikut untuk memasang OSS SDK untuk Python:

pip

  1. Pasang pip.

    Untuk Python 2.7.9 atau yang lebih baru dan Python 3.4 atau yang lebih baru, pip dipasang secara default.

  2. Jalankan perintah berikut untuk memasang versi terbaru dari OSS SDK untuk Python:

    pip install oss2                   

Kode sumber

  1. Kunjungi GitHub untuk mengunduh versi terbaru dari paket OSS SDK untuk Python. Dekompresi paket tersebut dan periksa apakah file setup.py ada di direktori.

    Untuk informasi lebih lanjut tentang cara mengunduh versi sebelumnya dari OSS SDK untuk Python, lihat Versi historis.

  2. Jalankan perintah berikut untuk memasang OSS SDK untuk Python:

    python setup.py install                   

Verifikasi apakah OSS SDK untuk Python telah dipasang

Setelah memasang OSS SDK untuk Python, lakukan langkah-langkah berikut untuk memverifikasi apakah OSS SDK untuk Python telah dipasang:

  1. Jalankan perintah berikut untuk masuk ke lingkungan Python:

    python
  2. Jalankan perintah berikut untuk memeriksa versi OSS SDK untuk Python:

    import oss2
    oss2.__version__                         

    Respon berikut menunjukkan bahwa OSS SDK untuk Python 2.18.3 telah dipasang.

    '2.18.3'

FAQ

Apa yang harus saya lakukan jika pesan kesalahan "No module named _crcfunext" muncul?

Deskripsi masalah

Menggunakan OSS SDK untuk Python untuk memanggil operasi unggah dan unduh jauh lebih lambat dibandingkan menggunakan alat lain, seperti ossutil atau OSS SDK lainnya.

Penyebab

Saat mengkompilasi pustaka crcmod, file _crcfunext.so bergantung pada file Python.h. Kesalahan terjadi karena file Python.h tidak ada di sistem, yang menyebabkan file _crcfunext.so gagal dibuat. Untuk informasi lebih lanjut tentang crcmod, lihat pengenalan crcmod.

Solusi

Anda dapat melakukan langkah-langkah berikut untuk memeriksa apakah ekstensi crcmod dalam C telah dipasang:

  1. Jalankan perintah berikut untuk masuk ke lingkungan Python:

    python
  2. Jalankan perintah berikut untuk mengimpor modul ekstensi C dari _crcfunext dalam modul crcmod:

    import crcmod._crcfunext

    Jika pesan kesalahan berikut muncul, ekstensi crcmod dalam C gagal dipasang:

    Traceback (most recent call last):
    File "<stdin>", line 1, in <module>
    ImportError: No module named _crcfunext                                 
  3. Pilih solusi berdasarkan sistem operasi Anda:

    Windows

    1. Unduh crcmod-1.7.win32-py2.7.msi atau file .msi versi lainnya.

      Catatan

      Pustaka crcmod untuk sistem win32 juga kompatibel dengan sistem win64.

    2. Pasang file .msi dan tentukan direktori Lib\site-packages di jalur instalasi lokal Python sebagai jalur instalasi crcmod. Contoh: D:\python\Lib\site-packages\.

    3. Lakukan langkah-langkah sebelumnya untuk memeriksa apakah ekstensi crcmod dalam C telah dipasang setelah file .msi dipasang.

    Linux

    Untuk Linux, lakukan langkah-langkah berikut untuk menyelesaikan masalah:

    1. Jalankan perintah berikut untuk mencopot pemasangan pustaka crcmod:

      pip uninstall crcmod
    2. Pasang python-devel. Untuk informasi lebih lanjut, lihat Pasang python-devel.

    3. Jalankan perintah berikut untuk memasang ulang pustaka crcmod:

      pip install crcmod

      Jika pustaka crcmod gagal dipasang setelah Anda melakukan langkah-langkah sebelumnya, copot pemasangan pustaka crcmod. Kemudian, jalankan perintah berikut untuk melihat detail kegagalan instalasi:

      pip install crcmod -v

Apa yang harus saya lakukan jika pesan kesalahan No module named 'Crypto' muncul?

Deskripsi masalah

Pesan kesalahan No module named 'Crypto' muncul selama eksekusi program.

Penyebab

Tidak ada Crypto atau crypto yang tersedia.

Solusi

Periksa apakah Crypto ada di jalur instalasi lokal Python, seperti D:\python3.9\Lib\site-packages.

  • Jika Crypto tidak ada, jalankan perintah berikut:

    python -m pip install --upgrade setuptools
  • Jika crypto, yang huruf pertamanya adalah huruf kecil, ada, ubah huruf pertama menjadi huruf besar dan mulai ulang program.

Apa yang harus saya lakukan jika pesan kesalahan yang menunjukkan bahwa perintah bukan perintah internal atau eksternal muncul?

Di Windows, jika pesan kesalahan yang menunjukkan bahwa perintah bukan perintah internal atau eksternal muncul, ubah variabel lingkungan Path dan tambahkan jalur instalasi Python dan pip ke variabel lingkungan. Jalur instalasi pip adalah direktori Scripts di jalur instalasi Python. Setelah Anda memodifikasi variabel lingkungan Path, Anda mungkin perlu me-restart komputer agar variabel lingkungan berlaku.

Apa yang harus saya lakukan jika OSS SDK untuk Python gagal dipasang?

Jika OSS SDK untuk Python gagal dipasang, jalankan perintah berikut untuk mencopot pemasangan OSS SDK untuk Python. Kemudian, pasang ulang.

pip uninstall oss2            

Bagaimana cara memperbarui OSS SDK untuk Python?

Jalankan perintah berikut untuk memperbarui OSS SDK untuk Python:

 pip install --upgrade oss2