Utility OCI

Le istanze che utilizzano le immagini della piattaforma Oracle Linux includono un set di utility (oci-utils) che consentono all'istanza di accedere alle informazioni sulle risorse dell'infrastruttura. Queste utility sono costituite da un componente di servizio e da strumenti della riga di comando che consentono di individuare o eseguire il provisioning automatico delle risorse.

Installazione di OCI Utilities

Le istanze avviate con Oracle Linux 7 o versioni successive includono automaticamente il pacchetto di utility Oracle Cloud Infrastructure (OCI) (oci-utils) installato. Le utility non sono disponibili in altre distribuzioni.

Per utilizzare le utility OCI, è necessario soddisfare i prerequisiti riportati di seguito.

Assicurarsi che il repository oci_included sia abilitato. Questo repository è abilitato per impostazione predefinita nelle immagini della piattaforma Oracle Linux. Questo repository contiene tutte le dipendenze dei pacchetti, inclusi i pacchetti SDK OCI e Python necessari. Tutti i pacchetti richiesti vengono installati con il pacchetto oci-utils.
Assicurarsi che le utility OCI dispongano di autorizzazioni sufficienti per accedere a Oracle Cloud Infrastructure effettuando una delle operazioni riportate di seguito.
- Creare il file di configurazione SDK per l'host. Per ulteriori informazioni, vedere SDK and CLI Configuration File.
  Nota
  
  Per creare il file di configurazione dell'SDK potrebbe essere necessario installare l'interfaccia CLI per l'ambiente in uso prima di eseguire il comando oci setup config. Per ulteriori informazioni, vedere Installazione dell'interfaccia CLI.
- Usare i principal dell'istanza aggiungendo l'istanza a un gruppo dinamico a cui è stato concesso l'accesso ai servizi Oracle Cloud Infrastructure. Per ulteriori informazioni, vedere Gestione dei gruppi dinamici.
- Configurare oci-utils per consentire a root di utilizzare i file di configurazione Oracle Cloud Infrastructure di un utente senza privilegi. Per ulteriori informazioni, vedere il file di configurazione situato nella directory /etc/oci-utils.conf.d dell'istanza.
Scegliere il metodo per accedere alle utility ed eseguire le procedure di impostazione per tale metodo, se necessario.
- OCI CLI da un'istanza o un host remoto: terminale CLI connesso a un'istanza o a un host remoto in cui è possibile eseguire le utility OCI. Per ulteriori informazioni sull'interfaccia CLI e su come iniziare a utilizzarla, vedere Command Line Interface (CLI) e CLI Quickstart.
- OCI Software Development Kit (SDK): un set di strumenti di sviluppo che consentono di scrivere codice e gestire le risorse OCI. Per ulteriori informazioni, vedere Software Development Kit and Command Line Interface (Kit di sviluppo software).

Per un video su come installare e configurare le utility OCI, vedere Enabling OCI Utilities in Oracle Linux on Oracle Cloud Infrastructure Instances nella Training Station di Oracle Linux.

Aggiornamento di OCI Utilities

Per eseguire l'aggiornamento alla versione più recente di oci-utils:

sudo yum update oci-utils

Utilizzo del daemon ocid

Il daemon ocid è il componente di servizio di oci-utils. Esegue il monitoraggio della presenza di modifiche nella configurazione VNIC e iSCSI dell'istanza e tenta di collegare o scollegare automaticamente i dispositivi man mano che appaiono o scompaiono, ad esempio quando vengono creati o eliminati utilizzando la console, l'interfaccia CLI o l'API di Oracle Cloud Infrastructure.

Per avviare il daemon ocid utilizzando systemd e impostare il servizio ocid per l'avvio automatico durante il boot del sistema:

sudo systemctl enable --now ocid.service

Per confermare che il servizio è attivo (in esecuzione):

sudo service ocid status

Ad esempio:

$ sudo service ocid status
Redirecting to /bin/systemctl status ocid.service
  ocid.service - Oracle Cloud Infrastructure utilities daemon
   Loaded: loaded (/etc/systemd/system/ocid.service; enabled; vendor preset: enabled)
   Active: active (running) since Thu 2021-02-04 18:01:25 GMT; 1min 42s ago
 Main PID: 16630 (python3)
   CGroup: /system.slice/ocid.service
           └─16630 /usr/bin/python3 /usr/lib/python3.6/site-packages/oci_util...

Feb 04 18:01:23 mor-demoinst-10 systemd[1]: Starting Oracle Cloud Infrastruc....
Feb 04 18:01:24 mor-demoinst-10 sudo[16705]:     root : TTY=unknown ; PWD=/ ...w
Feb 04 18:01:25 mor-demoinst-10 systemd[1]: Started Oracle Cloud Infrastruct....
Hint: Some lines were ellipsized, use -l to show in full.

Riepilogo OCI Utilities

Un riepilogo dei componenti delle utility OCI.


Nome	Descrizione
`ocid`	Componente di servizio di `oci-utils`, che viene eseguito come daemon avviato da `systemd`. Questo servizio analizza le modifiche nelle configurazioni dei dispositivi iSCSI e VNIC e memorizza nella cache i metadati OCI e l'indirizzo IP pubblico dell'istanza.
`oci-compartmentid`	Visualizza l'OCID (Oracle Cloud Identifier) del compartimento in cui è in esecuzione l'istanza.
`oci-growfs`	Espande il file system root dell'istanza alla dimensione configurata.
`oci-image-expand`	Converte l'istanza Oracle Linux Minimal per aggiungere servizi e pacchetti di un'immagine standard della piattaforma Oracle Linux.
`oci-instanceid`	Visualizza l'OCID dell'istanza.
`oci-iscsi-config`	Elenca o configura i dispositivi iSCSI collegati a un'istanza di computazione. Se non vengono specificate opzioni dalla riga di comando, vengono elencati i dispositivi che richiedono attenzione.
`oci-metadata`	Visualizza i metadati per l'istanza di computazione. Se non vengono specificate opzioni della riga di comando, vengono elencati tutti i metadati disponibili. I metadati includono l'OCID dell'istanza, il nome visualizzato, il compartimento, la forma, l'area, il dominio di disponibilità, la data di creazione, lo stato, l'immagine e qualsiasi metadati personalizzato fornito dall'utente, ad esempio una chiave pubblica SSH.
`oci-network-config`	Elenca o configura le schede VNIC (Virtual Network Interface Card) collegate all'istanza di computazione. Quando viene eseguito il provisioning di una VNIC secondaria nel cloud, questa deve essere configurata in modo esplicito nell'istanza utilizzando questo script o comandi simili.
`oci-network-inspector`	Visualizza un report dettagliato per un determinato compartimento o rete.
`oci-notify`	Invia un messaggio a un argomento del servizio di notifica.
`oci-public-ip`	Visualizza l'indirizzo IP pubblico del sistema corrente in formato leggibile dall'utente o JSON.
`oci-volume-data`	Visualizza i dati relativi a un volume iSCSI specifico collegato all'istanza.

Opzioni comuni della utility OCI

Molte delle utility di Oracle Cloud Infrastructure (OCI) hanno le stesse opzioni o gli stessi argomenti disponibili quando le utility vengono eseguite dalla riga di comando. Queste opzioni e argomenti consentono di definire ulteriormente il tipo di informazioni prodotte dall'utility o il modo in cui viene eseguito un task dell'utility.

Nella tabella seguente sono elencate le opzioni e i relativi valori supportati comuni nelle utility OCI.


Opzione	Descrizione
`--help`	Visualizza le informazioni della Guida sulla utility, ad esempio l'uso della utility, le opzioni disponibili e i valori supportati per ciascuna opzione. Ad esempio, per visualizzare la Guida per la utility `oci-metadata`: `$ sudo oci-metadata --help usage: oci-metadata [-h] [-j] [-g KEY] [--value-only] [--export] [--trim] [-u KEY=VALUE [KEY=VALUE ...]] [-i OCID] [--help] Utility for displaying metadata for an instance running in the Oracle Cloud Infrastructure. optional arguments: -h, --human-readable Display human readable output (default) -j, --json Display json output ... --help Display this help`
`--all`	Mostra tutti gli elementi o i valori nell'output.
`--details`	Mostra informazioni dettagliate nell'output.
`--output-mode`	Consente di definire la modalità di visualizzazione dell'output della utility. Di seguito sono riportate le modalità disponibili della utility OCI. `json`: visualizza l'output in formato JSON. `human-readable`: visualizza l'output in formato leggibile. `parsable`: visualizza l'output in formato analizzabile. `table`: visualizza l'output in una tabella. `text`: visualizza l'output testuale.
`--no-truncate`	Non riduce i valori nell'output visualizzato.
`--truncate`	Riduce i valori nell'output visualizzato.
`-y\| --yes`	Risposte "sì" a tutte le domande.
`-n \| --no`	Risposte "no" a tutti i prompt.
`-q \| --quiet`	Elimina i messaggi informativi.

Nota

è anche possibile visualizzare le pagine man per ciascuna utility OCI immettendo man oci-utility dalla riga di comando. Ad esempio, per visualizzare le pagine manuali incorporate per la utility oci-metadata:

man oci-metadata