Installations manuelles et hors ligne

Cette section explique comment effectuer des installations manuelles et hors ligne de l'interface de ligne de commande (CLI) 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 d'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 que les exigences sont respectées.

Avant d'installer manuellement l'interface de ligne de commande, effectuez les opérations suivantes :

Assurez-vous que votre chemin Python est défini correctement
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, assurez-vous que les éléments suivants sont installés :
- GCC,
- zlib-devel,
- python3-devel,
- dernière version d'OpenSSL 1.1.1.

Remarque

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

Etape 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.

Remarque

L'interface de ligne de commande prend uniquement en charge les versions Python répertoriées dans Exigences relatives à l'interface de ligne de commande.

Windows

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

Oracle Linux

Certaines versions d'Oracle Linux sont fournies avec des versions incompatibles de Python et peuvent nécessiter des composants supplémentaires 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 de flux d'application propres à une version dans Oracle Linux 8 et CentOS 8.

Utilisez dnf module list pour visualiser 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 activera et installera 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 par 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

Remarque

Pour Oracle Linux 7, python3-devel se trouve dans le référentiel ol7_optional_latest, qui peut ne pas être activé par défaut. Pour installer python3-devel, exécutez la commande suivante à partir d'une invite de shell :

sudo yum install -y --enablerepo ol7_optional_latest python3-devel

Vous trouverez des détails sur l'installation et l'utilisation de versions plus récentes de Python disponibles pour Oracle Linux 7 dans la documentation de la bibliothèque de collections de logiciels Oracle Linux.

Oracle Linux 6

Remarque

Oracle Linux 6 n'est plus recommandé. Envisagez plutôt 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 de flux d'application propres à une version dans CentOS 8.

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

Par exemple :

sudo dnf module list | grep python

Cette commande produit un résultat semblable à ce qui suit :

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 activera et installera 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 par 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

Vous trouverez des détails sur l'installation et l'utilisation de versions plus récentes de Python disponibles pour CentOS 7 dans 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

Python est préinstallé sur Mac OS X.

Pour installer la dernière version de Python sur Mac OS X, reportez-vous à la documentation Python officielle.

Etape 2 : création et configuration d'un environnement virtuel

Le module Python venv est un générateur d'environnements virtuels qui permet de créer des environnements Python isolés. Nous vous 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 en suivant les étapes ci-après.

Windows

Accédez au répertoire dans lequel créer l'environnement virtuel.
Créez l'environnement virtuel en exécutant la commande suivante :
```
python -m venv oracle-cli
```
Activez l'environnement virtuel en exécutant la commande suivante :
```
oracle-cli/Scripts/activate
```

Linux et Mac

Accédez au répertoire dans lequel créer l'environnement virtuel.
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
```
Activez l'environnement virtuel en exécutant la commande suivante :
```
source oracle-cli/bin/activate
```

Etape 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 le package à partir de PyPI (Python Package Index).

Pour effectuer l'installation à l'aide du téléchargement GitHub, procédez comme suit :

Téléchargez et décompressez le fichier oci-cli.zip.
Validez éventuellement le fichier téléchargé.

Exécutez la commande ci-dessous.

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, reportez-vous à Utilisation de l'interface de ligne de commande.

Installation hors ligne

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

Procédure d'installation hors ligne :

Accédez à la page de version de l'interface de ligne de commande OCI sur GitHub et sélectionnez la version de l'interface de ligne de commande à installer.
Faites défiler vers le bas jusqu'à la section Ressources de la page de version, puis cliquez sur le fichier ZIP pour le télécharger.
Validez éventuellement le fichier téléchargé.
Copiez le fichier ZIP vers le système cible.
Décompressez le fichier ZIP.
Exécutez le programme d'installation approprié pour la plate-forme :
1. Sur Unix et Linux, exécutez bash install.sh --offline-install.
2. Sur Windows, exécutez install.ps1 -OfflineInstall.
Suivez les invites d'installation.

Pour le dépannage des installations hors ligne, reportez-vous à Problèmes courants ou soumettez un problème sur GitHub.

Installation sans environnement virtuel

Nous déconseillons d'installer l'interface de ligne de commande dans votre installation Python à l'échelle du système. Installez-la plutôt à l'aide du programme d'installation ou d'un environnement virtuel.

Si vous tentez d'installer l'interface de ligne de commande dans votre installation Python à l'échelle du système à l'aide de la dernière version de pip, vous risquez de rencontrer des conflits avec des packages distutils installés. Vous trouverez ci-dessous un exemple de message d'erreur correspondant :

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.

Vous pouvez également installer l'interface de ligne de commande pour l'utilisateur à l'aide de la commande suivante, mais cette approche n'est pas prise en charge :

pip install --user oci-cli

Validation du checksum de version

Une fois le package de l'interface de ligne de commande téléchargé, vous pouvez valider le checksum SHA-256. En fonction du système d'exploitation, suivez les instructions ci-dessous pour comparer la valeur SHA-256 fournie dans la version GitHub à la valeur obtenue lorsque vous effectuez cette procédure pour votre système d'exploitation.

Windows

Ouvrez un shell de commande.
Passez au répertoire dans lequel se trouve le fichier de téléchargement.
Exécutez la commande suivante pour générer la valeur de checksum, où filename est le nom du fichier téléchargé sur votre ordinateur :
```
certutil -hashfile filename SHA256
```
Vérifiez que la valeur de checksum renvoyée correspond à la valeur SHA-256 fournie dans la version GitHub. Si les valeurs ne concordent pas, téléchargez à nouveau le fichier et répétez cette procédure.

Mac OS

Ouvrez une fenêtre de terminal.
Exécutez la commande suivante, où fileLocation est le chemin complet du fichier sur votre ordinateur :
```
shasum -a 256 fileLocation 
```
Cette commande doit renvoyer une valeur de checksum.
Vérifiez que la valeur de checksum renvoyée correspond à la valeur SHA-256 fournie dans la version GitHub. Si les valeurs ne concordent pas, téléchargez à nouveau le fichier et répétez cette procédure.

Linux

Ouvrez une session de terminal.
Exécutez la commande suivante, où fileLocation est le chemin complet du fichier sur votre ordinateur :
```
sha256sum fileLocation
```
Cette commande doit renvoyer une valeur de checksum.
Vérifiez que la valeur de checksum renvoyée correspond à la valeur SHA-256 fournie dans la version GitHub. Si les valeurs ne concordent pas, téléchargez à nouveau le fichier et répétez cette procédure.

Documentation Oracle Cloud Infrastructure