Tous les produits
Search
Centre de documentation

:Installation OSS SDK for Python 1.0

Dernière mise à jour :Aug 18, 2026

Pour gérer les compartiments Object Storage Service (OSS), charger et télécharger des objets, gérer les données ou traiter des images, installez le kit SDK OSS pour Python. Cette rubrique décrit la procédure d'installation.

Prérequis

  1. Installez Python.

    Le kit SDK OSS pour Python nécessite Python 2.6, 2,7, 3,3, 3,4, 3,5, 3,6, 3.7, 3.8 ou une version ultérieure.

    Remarque

    Lors de l'installation du kit SDK OSS pour Python sous Windows, assurez-vous que la version de Visual C++ est 15,0 ou ultérieure.

  2. Vérifiez la version de Python en exécutant la commande suivante :

    python --version

    La réponse suivante indique que Python 3.8.2 est installé :

    Python 3.8.2

Télécharger le kit SDK OSS pour Python

Installer python-devel

Une fois l'environnement préparé, installez d'abord le package python-devel.

Remarque

Le kit SDK OSS pour Python utilise la bibliothèque crcmod pour les calculs CRC (Cyclic Redundancy Check). Cette bibliothèque dispose d'une extension C offrant des performances élevées, mais elle dépend du fichier Python.h fourni par le package python-devel. Si Python.h est absent lors de l'installation du kit SDK, la compilation de l'extension C pour crcmod échoue. Le kit SDK reste fonctionnel, mais il bascule vers une implémentation purement Python de crcmod. Ce repli entraîne une baisse significative des performances pour les opérations nécessitant des vérifications CRC, telles que le chargement et le téléchargement d'objets.

Windows

Lors de l'installation de Python sous Windows, le fichier Python.h est installé conjointement avec Python. Par conséquent, il n'est pas nécessaire d'installer python-devel.

macOS

Lors de l'installation de Python sur macOS, le fichier Python.h est installé conjointement avec Python. Par conséquent, il n'est pas nécessaire d'installer python-devel.

CentOS

Installez python-devel en exécutant la commande suivante :

sudo yum install python-devel                 

RHEL

Installez python-devel en exécutant la commande suivante :

sudo yum install python-devel                 

Fedora

Installez python-devel en exécutant la commande suivante :

sudo yum install python-devel                 

Debian

Installez python-devel en exécutant la commande suivante :

sudo apt-get install python-dev                  

Ubuntu

Installez python-devel en exécutant la commande suivante :

sudo apt-get install python-dev                  

Installer le kit SDK OSS pour Python

Après avoir installé python-devel, utilisez l'une des méthodes suivantes pour installer le kit SDK OSS pour Python :

pip

  1. Installez pip.

    Pour Python 2.7.9 ou version ultérieure et Python 3.4 ou version ultérieure, pip est installé par défaut.

  2. Installez la dernière version du kit SDK OSS pour Python en exécutant la commande suivante :

    pip install oss2                   

Code source

  1. Accédez à GitHub pour télécharger la dernière version du package du kit SDK OSS pour Python. Décompressez le package et vérifiez la présence du fichier setup.py dans le répertoire.

    Pour plus d'informations sur le téléchargement d'une version antérieure du kit SDK OSS pour Python, consultez les versions historiques.

  2. Installez le kit SDK OSS pour Python en exécutant la commande suivante :

    python setup.py install                   

Vérifier l'installation

Après l'installation du kit SDK, vérifiez l'installation en suivant les étapes ci-dessous :

  1. Accédez à l'environnement Python en exécutant la commande suivante :

    python
  2. Vérifiez la version du kit SDK OSS pour Python en exécutant la commande suivante :

    import oss2
    oss2.__version__                         

    La réponse suivante indique que le kit SDK OSS pour Python 2.18.3 est installé.

    '2.18.3'

FAQ

Que faire en cas d'erreur 'No module named _crcfunext' ?

Description

Les opérations de chargement et de téléchargement avec le kit SDK OSS pour Python sont beaucoup plus lentes qu'avec d'autres outils, tels que ossutil ou d'autres kits SDK.

Causes

Lors de la compilation de la bibliothèque crcmod, le fichier _crcfunext.so dépend du fichier Python.h. L'erreur survient car le fichier Python.h est absent du système, ce qui empêche la génération du fichier _crcfunext.so. Pour plus d'informations sur crcmod, consultez l'introduction à crcmod.

Solutions

Vérifiez si les extensions C de crcmod sont installées en suivant les étapes ci-dessous :

  1. Accédez à l'environnement Python en exécutant la commande suivante :

    python
  2. Importez le module d'extension C _crcfunext du module crcmod en exécutant la commande suivante :

    import crcmod._crcfunext

    Si le message d'erreur suivant s'affiche, l'installation des extensions C de crcmod a échoué :

    Traceback (most recent call last):
    File "<stdin>", line 1, in <module>
    ImportError: No module named _crcfunext                                 
  3. Sélectionnez une solution adaptée à votre système d'exploitation :

    Windows

    1. Téléchargez crcmod-1,7.win32-py2,7.msi ou un fichier .msi d'une autre version.

      Remarque

      La bibliothèque crcmod pour les systèmes win32 est également compatible avec les systèmes win64.

    2. Installez le fichier .msi et spécifiez le répertoire Lib\site-packages du chemin d'installation local de Python comme chemin d'installation de crcmod. Exemple : D:\python\Lib\site-packages\.

    3. Une fois l'installation terminée, vérifiez à nouveau l'installation de l'extension C de crcmod.

    Linux

    Sous Linux, résolvez le problème en suivant les étapes ci-dessous :

    1. Désinstallez la bibliothèque crcmod en exécutant la commande suivante :

      pip uninstall crcmod
    2. Installez python-devel. Pour plus d'informations, consultez la section Installer python-devel.

    3. Réinstallez la bibliothèque crcmod en exécutant la commande suivante :

      pip install crcmod

      Si l'installation de la bibliothèque crcmod échoue après avoir effectué les étapes précédentes, désinstallez la bibliothèque crcmod. Ensuite, affichez les détails de l'échec de l'installation en exécutant la commande suivante :

      pip install crcmod -v

Que faire en cas d'erreur « No module named 'Crypto' » ?

Description

Votre programme échoue avec une erreur No module named 'Crypto'.

Causes

Cette erreur se produit car le module Crypto requis n'est pas installé, ou bien un répertoire nommé crypto existe au lieu de Crypto.

Solutions

Vérifiez la présence de Crypto dans le chemin d'installation local de Python, par exemple D:\python3.9\Lib\site-packages.

  • Si Crypto n'existe pas, exécutez la commande suivante :

    python -m pip install --upgrade setuptools
  • Si un répertoire nommé crypto existe (avec un « c » minuscule), renommez-le en Crypto et essayez d'exécuter à nouveau votre programme.

Que faire si un message d'erreur indiquant que la commande n'est pas une commande interne ou externe est renvoyé ?

Sous Windows, si un message d'erreur indiquant que la commande n'est pas une commande interne ou externe est renvoyé, modifiez la variable d'environnement Path et ajoutez-y les chemins d'installation de Python et de pip. Le chemin d'installation de pip correspond au répertoire Scripts situé dans le chemin d'installation de Python. Après avoir modifié la variable Path, ouvrez une nouvelle fenêtre d'invite de commandes ou redémarrez votre ordinateur pour que les modifications prennent effet.

Que faire en cas d'échec de l'installation du kit SDK ?

Si l'installation du kit SDK échoue, désinstallez-le en exécutant la commande suivante, puis tentez de l'installer à nouveau.

pip uninstall oss2            

Comment mettre à niveau le kit SDK OSS pour Python ?

Mettez à niveau le kit SDK OSS pour Python en exécutant la commande suivante :

 pip install --upgrade oss2