Documentazione dell'infrastruttura Oracle Cloud

Installazioni manuali e offline

In questa sezione viene descritto come eseguire installazioni manuali e offline dell'interfaccia CLI (Command Line Interface) OCI.

Installazione manuale

Anziché utilizzare i metodi di installazione descritti in Quickstart o utilizzando l'immagine del contenitore CLI OCI, è possibile installare manualmente l'interfaccia CLI e le relative dipendenze utilizzando pip. Prima di procedere, assicurarsi di soddisfare i requisiti.

Prima di installare manualmente l'interfaccia CLI:

  • Assicurarsi che il percorso Python sia impostato correttamente
  • Eseguire "python --version" o "python3 --version" e assicurarsi di disporre della versione richiesta
  • Se si esegue l'installazione su Oracle Linux o CentOS, è installato quanto segue:
    • gcc
    • zlib-devel
    • sviluppo python3
    • l'ultima versione di OpenSSL 1.1.1
Nota

è anche possibile scaricare i file di installazione dell'interfaccia CLI ed eseguire un'installazione offline.

Passaggio 1: installazione di Python

Le istruzioni di installazione di Python possono variare per ciascun sistema operativo supportato dall'interfaccia CLI.

Nota

L'interfaccia CLI supporta solo le versioni Python elencate nei requisiti dell'interfaccia CLI.
Finestre

Installare una versione supportata di Python dalla pagina dei download per Windows Python. Durante l'installazione, scegliere di aggiungere Python alle variabili PATH e/o ambiente (a seconda del prompt).

Oracle Linux

Alcune versioni di Oracle Linux sono dotate di versioni incompatibili di Python e potrebbero richiedere componenti aggiuntivi per installare l'interfaccia CLI. Prima di installare l'interfaccia CLI, eseguire i comandi riportati di seguito su una nuova immagine di Oracle Linux.

Suggerimento

L'interfaccia CLI è installata per impostazione predefinita su Oracle Linux 9, Oracle Autonomous Linux versioni 7 e 8 e 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 è disponibile come moduli Application Stream specifici della versione in Oracle Linux 8 e CentOS 8.

Utilizzare dnf module list per visualizzare i moduli Python attualmente disponibili. Ad esempio:
$ 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
Quindi, abilitare e installare un modulo Python. L'esempio seguente abiliterà e installerà Python 3.9:
sudo dnf -y module enable python39
sudo dnf -y install python39
python3.9

Sostituire python39 e python3.9 con python36 e python3.6 o python38 e python3.8 per installare e utilizzare tali versioni.

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
Nota

Per Oracle Linux 7, tenere presente che python3-devel si trova nel repository ol7_optional_latest che potrebbe non essere abilitato per impostazione predefinita. Per installare python3-devel, eseguire le seguenti operazioni da un prompt della shell:
sudo yum install -y --enablerepo ol7_optional_latest python3-devel

I dettagli su come installare e utilizzare le versioni più recenti di Python disponibili per Oracle Linux 7 sono disponibili nella documentazione della libreria di raccolte software di Oracle Linux.

Oracle Linux 6
Importante

Oracle Linux 6 ha raggiunto la fine del supporto. Prendi in considerazione l'utilizzo di Oracle Linux 9.
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

Prima di installare l'interfaccia CLI, eseguire i comandi riportati di seguito su una nuova immagine 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 è disponibile come moduli Application Stream specifici della versione in CentOS 8.

Utilizzare dnf module list per visualizzare i moduli Python attualmente disponibili.

Ad esempio:
sudo dnf module list | grep python
Ciò produrrà un output simile al seguente:
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
Quindi, abilitare e installare un modulo Python. L'esempio seguente abiliterà e installerà Python 3.9:
sudo dnf -y module enable python39
sudo dnf -y install python39
python3.9

Sostituire python39 e python3.9 con python36 e python3.6 o python38 e python3.8 per installare e utilizzare tali versioni.

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

I dettagli su come installare e utilizzare le versioni più recenti di Python disponibili per CentOS 7 sono disponibili nella documentazione delle raccolte software.

Ubuntu

Prima di installare l'interfaccia CLI, eseguire i comandi riportati di seguito su una nuova immagine di Ubuntu.

Ubuntu 16, Ubuntu 18 e 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 è dotato di Python preinstallato.

Per installare la versione più recente di Python su Mac OS X, vedere la documentazione ufficiale di Python.

Passo 2: creazione e configurazione di un ambiente virtuale

Il modulo Python venv è un generatore di ambienti virtuali che consente di creare ambienti Python isolati. È consigliabile installare l'interfaccia CLI in un ambiente virtuale.

Installazione e attivazione dell'ambiente virtuale

Dopo l'installazione di Python, impostare un ambiente virtuale per il sistema operativo utilizzando la procedura riportata di seguito.

Finestre
  1. Passare alla directory in cui si desidera creare l'ambiente virtuale.
  2. Creare l'ambiente virtuale eseguendo il comando seguente: 
    python -m venv oracle-cli
  3. Attivare l'ambiente virtuale eseguendo il comando seguente: 
    oracle-cli/Scripts/activate
Linux e Mac
  1. Passare alla directory in cui si desidera creare l'ambiente virtuale.
  2. Creare l'ambiente virtuale eseguendo uno dei seguenti comandi, a seconda della versione di Python installata: 
    python3.8 -m venv oracle-cli
    python3.6 -m venv oracle-cli
  3. Attivare l'ambiente virtuale eseguendo il comando seguente: 
    source oracle-cli/bin/activate

Passo 3: Installazione dell'interfaccia della riga di comando

È possibile scaricare l'interfaccia CLI da GitHub o installare il pacchetto da Python Package Index (PyPI).

Per eseguire l'installazione utilizzando il download di GitHub:

  • Scaricare ed estrarre il file oci-cli.zip.
  • Facoltativamente, convalidare il file scaricato.

  • Eseguire il comando riportato di seguito.

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

Per eseguire l'installazione utilizzando PyPI, eseguire il comando seguente:

pip install oci-cli

Per informazioni su come avviare una sessione dell'interfaccia CLI, vedere Using the CLI.

Installazione non in linea

Se è installata una versione supportata di Python, è possibile eseguire un'installazione non in linea dell'interfaccia CLI OCI.

Per eseguire un'installazione non in linea:
  1. Andare alla pagina della release dell'interfaccia CLI OCI in GitHub e selezionare la versione dell'interfaccia CLI che si desidera installare.
  2. Scorrere fino alla sezione Asset della pagina di rilascio e fare clic sul file zip per scaricarlo.
  3. Facoltativamente, convalidare il file scaricato.
  4. Copiare il file zip nel sistema di destinazione.
  5. Decomprimere il file zip.
  6. Eseguire il programma di installazione appropriato per la piattaforma:
    1. Su Unix e Linux, eseguire bash install.sh --offline-install
    2. Su Windows, eseguire install.ps1 -OfflineInstall
  7. Seguire i prompt di installazione.

Per la risoluzione dei problemi di installazione offline, vedere Problemi comuni o creare un problema all'indirizzo GitHub.

Installazione senza un ambiente virtuale

Si sconsiglia di installare l'interfaccia CLI in Python a livello di sistema e si consiglia di installare l'interfaccia CLI utilizzando il programma di installazione o l'ambiente virtuale.

Nei casi in cui si sta tentando di installare la CLI in Python a livello di sistema utilizzando la versione pip più recente, è possibile che si verifichino conflitti con alcuni pacchetti installati in distutils. Di seguito è riportato un messaggio di errore di esempio quando si verifica questa situazione:

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.

Un'altra opzione è quella di installare l'interfaccia CLI per l'utente utilizzando il comando seguente, sebbene questo approccio non sia supportato.

pip install --user oci-cli

Convalida del checksum di rilascio

Una volta scaricato il pacchetto CLI, è possibile convalidare il checksum SHA-256. A seconda del sistema operativo in uso, utilizzare le istruzioni riportate di seguito per confrontare il valore SHA-256 fornito nella release Github con il valore ottenuto durante il completamento di questa procedura per il sistema operativo.

Finestre
  1. Aprire una shell dei comandi.
  2. Spostarsi nella directory in cui si trova il file di download.
  3. Eseguire il comando seguente per generare il valore di checksum, dove filename è il nome del file scaricato sul computer:
    certutil -hashfile filename SHA256
  4. Verificare che il valore di checksum restituito corrisponda al valore SHA-256 fornito nella release Github. Se i valori non corrispondono, scaricare di nuovo il file e ripetere questa procedura.
Mac OS
  1. Aprire una finestra di terminale.
  2. Eseguire il comando seguente, dove fileLocation è il percorso completo del file sul computer:
    shasum -a 256 fileLocation
    Questo comando deve restituire un valore di checksum.
  3. Verificare che il valore di checksum restituito corrisponda al valore SHA-256 fornito nella release Github. Se i valori non corrispondono, scaricare di nuovo il file e ripetere questa procedura.
Linux
  1. Aprire una sessione del terminale.
  2. Eseguire il comando seguente, dove fileLocation è il percorso completo del file sul computer:
    sha256sum fileLocation

    Questo comando deve restituire un valore di checksum.

  3. Verificare che il valore di checksum restituito corrisponda al valore SHA-256 fornito nella release Github. Se i valori non corrispondono, scaricare di nuovo il file e ripetere questa procedura.