Documentation sur Oracle Cloud Infrastructure

Installations manuelles et hors ligne

Cette section explique comment effectuer des installations manuelles et hors ligne de l'interface de ligne de commande OCI :

Installation manuelle

Au lieu d'utiliser les méthodes d'installation décrites dans Démarrage rapide ou à l'aide de l'image de conteneur de l'interface de ligne de commande OCI, vous pouvez installer manuellement l'interface de ligne de commande et ses dépendances à l'aide de pip. Avant de continuer, assurez-vous de répondre aux conditions requises.

Avant d'installer manuellement l'interface de ligne de commande :

  • Assurez-vous que votre chemin Python est correctement défini
  • Exécutez "python --version" ou "python3 --version" et assurez-vous que vous disposez de la version requise
  • Si vous effectuez l'installation sur Oracle Linux ou CentOS, vérifiez que les éléments suivants sont installés :
    • gcc
    • zlib-devel
    • python3-devel
    • dernière version d'OpenSSL 1.1.1
Note

Vous pouvez également télécharger les fichiers d'installation de l'interface de ligne de commande et effectuer une installation hors ligne.

Étape 1 : Installation de Python

Les instructions d'installation de Python varient pour chaque système d'exploitation pris en charge par l'interface de ligne de commande.

Note

L'interface de ligne de commande prend en charge uniquement les versions Python énumérées dans les exigences de l'interface de ligne de commande.
Windows

Installez une version prise en charge de Python à partir de la page Téléchargements de Python de Windows. Lors de l'installation, choisissez d'ajouter Python aux variables d'environnement et/ou PATH (selon l'invite).

Oracle Linux

Certaines versions d'Oracle Linux sont fournies avec des versions incompatibles de Python. Des composants supplémentaires peuvent donc être requis pour installer l'interface de ligne de commande. Avant d'installer l'interface de ligne de commande, exécutez les commandes suivantes sur une nouvelle image Oracle Linux.

Conseil

L'interface de ligne de commande est préinstallée sur Oracle Linux 9, Oracle Autonomous Linux versions 7 et 8 et Oracle Linux Cloud Developer 8.
Oracle Linux 8
sudo dnf -y update
sudo dnf -y groupinstall "Development Tools"
sudo dnf -y install gcc wget openssl-devel bzip2-devel libffi-devel
sudo dnf -y module enable python36  # for Oracle Linux 8
sudo dnf -y install python36  # for Oracle Linux 8

Python est disponible en tant que modules AppStream propres à la version dans Oracle Linux 8 et CentOS 8.

Utilisez dnf module list pour voir les modules Python actuellement disponibles. Par exemple :
$ sudo dnf module list | grep python
python36 3.6 [d] build, common [d] Python programming language, version 3.6
python38 3.8 [d] build, common [d] Python programming language, version 3.8
python39 3.9 [d] build, common [d] Python programming language, version 3.9
Ensuite, activez et installez un module Python. L'exemple suivant active et installe Python 3.9 :
sudo dnf -y module enable python39
sudo dnf -y install python39
python3.9

Remplacez python39 et python3.9 par python36 et python3.6 ou python38 et python3.8 pour installer et utiliser ces versions.

Oracle Linux 7
sudo yum -y update
sudo yum -y groupinstall "Development Tools"
sudo yum -y install gcc wget openssl-devel bzip2-devel libffi-devel
sudo yum install -y python3   # for Oracle Linux 7
Note

Pour Oracle Linux 7, notez que python3-devel se trouve dans le référentiel ol7_optional_latest, qui ne peut pas être activé par défaut. Pour installer python3-devel, exécutez la commande suivante à partir d'une invite d'interpréteur de commandes :
sudo yum install -y --enablerepo ol7_optional_latest python3-devel

Pour des détails sur l'installation et l'utilisation des nouvelles versions de Python disponibles pour Oracle Linux 7, consultez la documentation sur la bibliothèque de collections de logiciels Oracle Linux.

Oracle Linux 6
Note

Oracle Linux 6 n'est plus recommandé. Il est préférable d'utiliser Oracle Linux 8.
sudo yum -y update
sudo yum -y groupinstall "Development Tools"
sudo yum -y install gcc wget openssl-devel bzip2-devel libffi-devel
wget https://www.python.org/ftp/python/3.6.3/Python-3.6.3.tgz
tar xvf Python-3.6.3.tgz
cd Python-3.6*/
./configure --enable-optimizations
sudo make altinstall
CentOS

Avant d'installer l'interface de ligne de commande, exécutez les commandes suivantes sur une nouvelle image CentOS.

CentOS Linux 8
sudo yum -y update
sudo yum -y groupinstall "Development Tools"
sudo yum -y install gcc wget openssl-devel bzip2-devel libffi-devel
sudo dnf -y module enable python36  
sudo dnf -y install python36

Python est disponible en tant que modules AppStream propres à la version dans CentOS 8.

Utilisez dnf module list pour voir les modules Python actuellement disponibles.

Par exemple :
sudo dnf module list | grep python
Cela produira une sortie similaire à la suivante :
python36 3.6 [d] build, common [d] Python programming language, version 3.6
python38 3.8 [d] build, common [d] Python programming language, version 3.8
python39 3.9 [d] build, common [d] Python programming language, version 3.9
Ensuite, activez et installez un module Python. L'exemple suivant active et installe Python 3.9 :
sudo dnf -y module enable python39
sudo dnf -y install python39
python3.9

Remplacez python39 et python3.9 par python36 et python3.6 ou python38 et python3.8 pour installer et utiliser ces versions.

CentOS Linux 7
sudo yum -y update
sudo yum -y groupinstall "Development Tools"
sudo yum -y install gcc wget openssl-devel bzip2-devel libffi-devel
sudo yum install -y python3 # for CentOS Linux 7

Pour plus de détails sur l'installation et l'utilisation des nouvelles versions de Python disponibles pour CentOS 7, consultez la documentation sur les collections de logiciels.

Ubuntu

Avant d'installer l'interface de ligne de commande, exécutez les commandes suivantes sur une nouvelle image Ubuntu.

Ubuntu 16, Ubuntu 18 et Ubuntu 20
sudo apt update
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev libsqlite3-dev wget libbz2-dev
sudo apt update && sudo apt install python3 python3-pip python3-venv
Mac OS X

Mac OS X est livré avec Python préinstallé.

Pour installer la dernière version de Python sur Mac OS X, voir la documentation officielle de Python.

Étape 2 : Création et configuration d'un environnement virtuel

Le module Python venv est un générateur d'environnement virtuel qui vous permet de créer des environnements Python isolés. Nous recommandons d'installer l'interface de ligne de commande dans un environnement virtuel.

Installation et activation de votre environnement virtuel

Une fois Python installé, configurez un environnement virtuel pour votre système d'exploitation à l'aide des étapes suivantes.

Windows
  1. Naviguez jusqu'au répertoire dans lequel vous souhaitez créer l'environnement virtuel.
  2. Créez l'environnement virtuel en exécutant la commande suivante : 
    python -m venv oracle-cli
  3. Activez l'environnement virtuel en exécutant la commande suivante : 
    oracle-cli/Scripts/activate
Linux et Mac
  1. Naviguez jusqu'au répertoire dans lequel vous souhaitez créer l'environnement virtuel.
  2. Créez l'environnement virtuel en exécutant l'une des commandes suivantes, selon la version de Python installée : 
    python3.8 -m venv oracle-cli
    python3.6 -m venv oracle-cli
  3. Activez l'environnement virtuel en exécutant la commande suivante : 
    source oracle-cli/bin/activate

Étape 3 : Installation de l'interface de ligne de commande

Vous pouvez télécharger l'interface de ligne de commande à partir de GitHub ou installer l'ensemble à partir de Python Package Index (PyPI).

Pour effectuer l'installation à l'aide du téléchargement GitHub :

  • Téléchargez et décompressez oci-cli.zip.
  • Éventuellement, validez le fichier téléchargé.

  • Exécutez la commande suivante.

    pip install oci_cli-*-py2.py3-none-any.whl

Pour effectuer l'installation à l'aide de PyPI, exécutez la commande suivante :

pip install oci-cli

Pour plus d'informations sur le démarrage d'une session d'interface de ligne de commande, voir Utilisation de l'interface de ligne de commande.

Installation hors ligne

Si vous avez installé une version prise en charge de Python, vous pouvez effectuer une installation hors ligne de l'interface de ligne de commande OCI.

Pour effectuer une installation hors ligne :
  1. Allez à la page des versions de l'interface de ligne de commande OCI dans GitHub et sélectionnez la version de l'interface de ligne de commande à installer.
  2. Faites défiler la page des versions vers le bas jusqu'à la section des ressources et cliquez sur le fichier zip pour le télécharger.
  3. Éventuellement, validez le fichier téléchargé.
  4. Copiez le fichier zip sur le système cible.
  5. Décompressez le fichier zip.
  6. Exécutez le programme d'installation approprié pour la plate-forme :
    1. Sous Unix et Linux, exécutez bash install.sh --offline-install
    2. Sous Windows, exécutez install.ps1 -OfflineInstall
  7. Suivez les invites d'installation.

Pour résoudre les problèmes d'installation hors ligne, consultez Problèmes communs ou créez un problème dans GitHub.

Installation sans environnement virtuel

Il n'est pas recommandé d'installer l'interface de ligne de commande à l'échelle du système Python. Il est préférable de l'installer à l'aide du programme d'installation ou de l'environnement virtuel.

Si vous tentez d'installer l'interface de ligne de commande à l'échelle du système Python à l'aide de la dernière version pip, il se peut que certains ensembles installés distutils soient en conflit. Voici un exemple de message d'erreur qui s'affiche dans ce cas :

sudo pip install oci-cli
...
...
Cannot uninstall 'requests'. It is a distutils installed project and thus we cannot accurately determine which files belong to it which would lead to only a partial uninstall.

Une autre option consiste à installer l'interface de ligne de commande pour l'utilisateur à l'aide de la commande suivante, bien que cette approche ne soit pas prise en charge :

pip install --user oci-cli

Validation du total de contrôle de la version

Une fois l'ensemble de l'interface de ligne de commande téléchargé, vous pouvez valider le total de contrôle SHA-256. Selon votre système d'exploitation, utilisez les instructions suivantes pour comparer la valeur SHA-256 fournie dans la version de Github à la valeur obtenue lors de l'exécution de cette procédure pour votre système d'exploitation.

Windows
  1. Ouvrez un interpréteur de commandes.
  2. Accédez au répertoire dans lequel se trouve le fichier téléchargé.
  3. Exécutez la commande suivante pour générer la valeur du total de contrôle, où filename est le nom du fichier téléchargé sur votre ordinateur :
    certutil -hashfile filename SHA256
  4. Vérifiez que la valeur du total de contrôle retournée correspond à la valeur SHA-256 fournie dans la version de Github. Si les valeurs ne correspondent pas, téléchargez le fichier à nouveau et répétez cette procédure.
Mac OS
  1. Ouvrez une fenêtre de terminal.
  2. Exécutez la commande suivante, où fileLocation est le chemin complet du fichier sur votre ordinateur :
    shasum -a 256 fileLocation
    Cette commande doit retourner une valeur de total de contrôle.
  3. Vérifiez que la valeur du total de contrôle retournée correspond à la valeur SHA-256 fournie dans la version de Github. Si les valeurs ne correspondent pas, téléchargez le fichier à nouveau et répétez cette procédure.
Linux
  1. Ouvrez une session de terminal.
  2. Exécutez la commande suivante, où fileLocation est le chemin complet du fichier sur votre ordinateur :
    sha256sum fileLocation

    Cette commande doit retourner une valeur de total de contrôle.

  3. Vérifiez que la valeur du total de contrôle retournée correspond à la valeur SHA-256 fournie dans la version de Github. Si les valeurs ne correspondent pas, téléchargez le fichier à nouveau et répétez cette procédure.