Documentazione dell'infrastruttura Oracle Cloud

Avvio rapido

Questa sezione descrive come installare e configurare rapidamente l'interfaccia CLI (Command Line Interface, interfaccia a riga di comando OCI).

Installazione dell'interfaccia CLI

Elementi della sezione

Questa sezione contiene istruzioni di installazione rapida per gli ambienti indicati di seguito.

Oracle Linux 9

Se si utilizza Oracle Linux 9, è possibile utilizzare dnf per installare l'interfaccia CLI.

Nota

Si consiglia di eseguire regolarmente sudo dnf update per assicurarsi che il sistema sia aggiornato installando gli RPM aggiornati disponibili.

Per utilizzare dnf per installare l'interfaccia CLI:

sudo dnf -y install oraclelinux-developer-release-el9
sudo dnf install python39-oci-cli

L'interfaccia CLI verrà installata nei pacchetti del sito Python:

  • /usr/lib/python3.9/site-packages/oci_cli
  • /usr/lib/python3.9/site-packages/services

Documentazione ed esempi verranno installati nella directory /usr/share/doc/python39-oci-cli-<version>/.

Per disinstallare l'interfaccia CLI:

sudo dnf remove python39-oci-cli

Oracle Linux 8

Se si utilizza Oracle Linux 8, è possibile utilizzare dnf per installare l'interfaccia CLI.

Suggerimento

Oracle Linux 8 utilizza Python 3.6 per impostazione predefinita. Per migliorare le prestazioni, è consigliabile eseguire l'aggiornamento a Python versione 3.9 o successiva e installare una versione compatibile dell'interfaccia CLI. Per istruzioni dettagliate, vedere il manuale istruzioni di installazione manuale.
Nota

Si consiglia di eseguire regolarmente sudo dnf update per assicurarsi che il sistema sia aggiornato installando gli RPM aggiornati disponibili.

Per utilizzare dnf per installare l'interfaccia CLI:

sudo dnf -y install oraclelinux-developer-release-el8
sudo dnf install python36-oci-cli

L'interfaccia CLI verrà installata nei pacchetti del sito Python:

  • /usr/lib/python3.6/site-packages/oci_cli
  • /usr/lib/python3.6/site-packages/services

Documentazione ed esempi verranno installati nella directory /usr/share/doc/python36-oci-cli-<version>/.

Per disinstallare l'interfaccia CLI:

sudo dnf remove python36-oci-cli

Oracle Linux 7

Se si utilizza Oracle Linux 7, è possibile utilizzare yum per installare l'interfaccia CLI.

Suggerimento

Oracle Linux 7 utilizza Python 3.6 per impostazione predefinita. Per migliorare le prestazioni, è consigliabile eseguire l'aggiornamento a Python versione 3.9 o successiva e installare una versione compatibile dell'interfaccia CLI. Per istruzioni dettagliate, vedere le istruzioni di installazione manuale.

Per utilizzare yum per installare l'interfaccia CLI:

sudo yum install python36-oci-cli

L'interfaccia CLI verrà installata nei pacchetti del sito Python:

  • /usr/lib/python3.6/site-packages/oci_cli
  • /usr/lib/python3.6/site-packages/services

Documentazione ed esempi verranno installati nella directory /usr/share/doc/python36-oci-cli-<version>/.

Per disinstallare l'interfaccia CLI:

sudo yum remove python36-oci-cli

Mac OS

È possibile utilizzare Homebrew per installare, aggiornare e disinstallare l'interfaccia CLI su Mac OS.

Per installare l'interfaccia CLI su Mac OS con Homebrew:

brew update && brew install oci-cli

Per aggiornare l'installazione CLI su Mac OS utilizzando Homebrew: 

brew update && brew upgrade oci-cli

Per disinstallare l'interfaccia CLI su Mac OS utilizzando Homebrew: 

brew uninstall oci-cli

Windows

È possibile installare l'interfaccia CLI su Windows utilizzando il programma di installazione MSI o PowerShell.

Per installare CLI su Windows utilizzando il programma di installazione MSI, effettuare le operazioni riportate di seguito.
Nota

Il programma di installazione CLI MSI sovrascriverà qualsiasi versione esistente dell'interfaccia CLI nel sistema Windows. Se è necessario installare più versioni dell'interfaccia CLI, per le installazioni successive creare un ambiente virtuale e utilizzare il metodo di installazione manuale. Per ulteriori informazioni, vedere Installazioni manuali e offline.
  1. Scaricare il programma di installazione MSI OCI CLI per Windows da GitHub.
  2. Eseguire l'eseguibile del programma di installazione scaricato.
  3. Selezionare la directory locale del sistema in cui si desidera installare l'interfaccia CLI, quindi selezionare Next.
  4. Al termine dell'installazione, selezionare Fine.

Per installare CLI su Windows utilizzando PowerShell:

  1. Aprire la console PowerShell utilizzando l'opzione Esegui come amministratore.

  2. Il programma di installazione consente il completamento automatico mediante l'installazione e l'esecuzione di uno script. Per consentire l'esecuzione di questo script, è necessario abilitare il criterio di esecuzione RemoteSigned.

    Per configurare il criterio di esecuzione remota per PowerShell, eseguire il comando seguente.

    Set-ExecutionPolicy RemoteSigned
  3. Forza PowerShell per utilizzare TLS 1.2 per Windows 2012 e Windows 2016:
    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
  4. Scaricare lo script del programma di installazione:
    Invoke-WebRequest https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.ps1 -OutFile install.ps1
  5. Eseguire lo script del programma di installazione con o senza prompt:
    1. Per eseguire lo script del programma di installazione con prompt, eseguire il comando seguente:
      iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.ps1'))

      Rispondere ai prompt dello script di installazione.

    2. Per eseguire lo script del programma di installazione senza chiedere all'utente di accettare le impostazioni predefinite, eseguire il comando seguente:
      ./install.ps1 -AcceptAllDefaults

Linux e UNIX

Nota

Lo script del programma di installazione installa automaticamente l'interfaccia CLI e le relative dipendenze, Python e virtualenv. Prima di eseguire il programma di installazione, accertarsi di soddisfare i requisiti.
Nota

Oracle Linux 8 e Oracle Linux Cloud Developer 7 hanno l'interfaccia CLI preinstallata.
  1. Aprire un terminale.
  2. Per eseguire lo script del programma di installazione, eseguire il comando seguente:
    bash -c "$(curl -L https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh)"
    Nota

    Per eseguire un'installazione 'silent' che accetta tutti i valori predefiniti senza prompt, utilizzare il parametro --accept-all-defaults.
  3. Rispondere ai prompt dello script di installazione.

Altri ambienti

Per installare l'interfaccia CLI in un ambiente non elencato qui, vedere Installazioni manuali e offline.

Verifica dell'installazione CLI OCI

  1. Dal prompt di comando eseguire il seguente comando:
    oci --version

Prompt script installazione

Lo script di installazione richiede le seguenti informazioni.

  • Se non è installata una versione compatibile di Python:
    • Windows e Linux: viene richiesto di fornire una posizione per l'installazione dei file binari e degli eseguibili. Lo script installerà Python per te.
    • MacOS: viene notificato che la versione di Python in uso non è compatibile. È necessario eseguire l'aggiornamento per poter procedere con l'installazione. Lo script non installerà Python automaticamente.
  • Quando viene richiesto di aggiornare l'interfaccia CLI alla versione più recente, rispondere con Y per sovrascrivere un'installazione esistente.
  • Quando viene richiesto di aggiornare il percorso PATH, rispondere con Y per richiamare l'interfaccia CLI senza fornire il percorso completo dell'eseguibile. Questo aggiungerà oci.exe al tuo PATH.

Impostazione del file di configurazione

Prima di utilizzare l'interfaccia CLI, è necessario creare un file di configurazione contenente le credenziali necessarie per l'utilizzo di Oracle Cloud Infrastructure. È possibile creare questo file utilizzando una finestra di dialogo di impostazione o manualmente utilizzando un editor di testo.

Utilizzare la finestra di dialogo Imposta

Per visualizzare la guida dell'interfaccia CLI durante il primo processo di impostazione, utilizzare il comando setup config:
oci setup config
Questo comando richiede le informazioni necessarie per creare il file di configurazione e le chiavi pubbliche e private dell'API. La finestra di dialogo di impostazione utilizza queste informazioni per generare una coppia di chiavi API e creare il file di configurazione. Dopo aver creato le chiavi API, caricare la chiave pubblica utilizzando la console.

Per ulteriori informazioni su come trovare le informazioni richieste, vedere:

Impostazione manuale

Se si desidera impostare manualmente le chiavi pubbliche/private dell'API e scrivere il proprio file di configurazione, vedere Configurazione di SDK e strumenti.

Suggerimento

Utilizzare il comando oci setup keys per generare una coppia di chiavi da includere nel file di configurazione.

Verifica del file di configurazione

Assicurarsi che il file di configurazione sia completo

Un file di configurazione appropriato deve avere almeno un nome di profilo (ad esempio [DEFAULT]) e le voci specificate nella sezione Voci file: utente, impronta digitale, key_file, tenancy, area e un pass_phrase facoltativo.

Nota

Per un file di configurazione di esempio, vedere la sezione Configurazione di esempio.

Conferma informazioni utente e impronta digitale

Puoi confermare le informazioni sull'utente e sull'impronta digitale eseguendo il login alla console OCI, aprendo il menu del profilo in alto a destra, quindi selezionando il tuo nome utente.

Una volta selezionato il nome utente, l'OCID verrà visualizzato nel pannello Informazioni utente. Questo OCID deve essere la voce utente nel file di configurazione.

È possibile trovare l'impronta digitale passando alla sezione Chiavi API nella colonna Risorse in basso a sinistra.

Aggiunta di commenti al file di configurazione

Assicurarsi di non aggiungere commenti in linea al file di configurazione. Aggiungere tutti i commenti su una nuova riga. Ad esempio:
[DEFAULT]
user=ocid1.user.oc1..<unique_ID>
fingerprint=<your_fingerprint>
key_file=~/.oci/oci_api_key.pem
tenancy=ocid1.tenancy.oc1..<unique_ID>
# Some comment
region=us-ashburn-1

Altri metodi di autenticazione

L'interfaccia CLI supporta inoltre l'autenticazione basata su token, principal dell'istanza e principal risorsa per alcuni servizi. Per ulteriori informazioni, vedere Metodi di autenticazione SDK.