Tous les produits
Search
Centre de documentation

:Installation

Dernière mise à jour :Oct 10, 2026

Pour gérer les compartiments Object Storage Service (OSS), charger et télécharger des objets, gérer les données et effectuer un traitement d'image (IMG), installez d'abord le SDK OSS pour Python. Cette rubrique explique comment installer le SDK OSS pour Python.

Prérequis

  1. Installez Python.

    Le 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 SDK OSS pour Python sur 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 SDK OSS pour Python

Installer python-devel

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

Remarque

Le SDK OSS pour Python utilise la bibliothèque crcmod pour calculer la valeur du contrôle de redondance cyclique (CRC). La bibliothèque crcmod dépend du fichier Python.h inclus dans le package python-devel. Si le fichier Python.h est absent, l'installation n'est pas bloquée, mais les extensions C de crcmod ne peuvent pas être installées. Dans ce cas, le mode Python seul est utilisé pour calculer la valeur CRC et effectuer le CRC-64 lors du chargement et du téléchargement d'objets. Par conséquent, les opérations telles que le chargement et le téléchargement d'objets sont exécutées de manière inefficace.

Windows

Lors de l'installation de Python sur Windows, le fichier Python.h est installé conjointement avec Python. Vous n'avez donc pas besoin d'installer python-devel.

macOS

Lors de l'installation de Python sur macOS, le fichier Python.h est installé conjointement avec Python. Vous n'avez donc pas besoin 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 SDK OSS pour Python

Après avoir installé python-devel, utilisez l'une des méthodes suivantes pour installer le 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 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 SDK OSS pour Python. Décompressez le package et vérifiez si le fichier setup.py existe dans le répertoire.

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

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

    python setup.py install                   

Vérifier l'installation du SDK OSS pour Python

Après avoir installé le SDK OSS pour Python, vérifiez son 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 SDK OSS pour Python en exécutant la commande suivante :

    import oss2
    oss2.__version__                         

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

    '2.18.3'

FAQ

Que faire si le message d'erreur « No module named _crcfunext » s'affiche ?

Description du problème

L'utilisation du SDK OSS pour Python pour appeler les opérations de chargement et de téléchargement est beaucoup plus lente que l'utilisation d'autres outils, tels que ossutil ou d'autres SDK OSS.

Causes

Lors de la compilation de la bibliothèque crcmod, le fichier _crcfunext.so dépend du fichier Python.h. L'erreur se produit 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 dans le module crcmod en exécutant la commande suivante :

    import crcmod._crcfunext

    Si le message d'erreur suivant s'affiche, cela signifie que les extensions C de crcmod n'ont pas pu être installées :

    Traceback (most recent call last):
    File "<stdin>", line 1, in <module>
    ImportError: No module named _crcfunext                                 
  3. Sélectionnez une solution en fonction de 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. Vérifiez si les extensions C de crcmod sont installées après l'installation du fichier .msi en suivant les étapes précédentes.

    Linux

    Pour 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 si le message d'erreur No module named 'Crypto' s'affiche ?

Description du problème

Le message d'erreur No module named 'Crypto' s'affiche lors de l'exécution du programme.

Causes

Aucun module Crypto n'existe, ou bien le module crypto existe.

Solutions

Vérifiez si Crypto existe 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 crypto (avec une minuscule) existe, changez la première lettre en majuscule et redémarrez le programme.

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

Sur Windows, si un message d'erreur indiquant que la commande n'est pas une commande interne ou externe s'affiche, modifiez la variable d'environnement Path et ajoutez les chemins d'installation de Python et de pip à cette variable. 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 d'environnement Path, vous devrez peut-être redémarrer votre ordinateur pour que les modifications prennent effet.

Que faire si l'installation du SDK OSS pour Python échoue ?

Si l'installation du SDK OSS pour Python échoue, désinstallez le SDK OSS pour Python en exécutant la commande suivante. Ensuite, réinstallez-le.

pip uninstall oss2            

Comment mettre à niveau le SDK OSS pour Python ?

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

 pip install --upgrade oss2