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 Oracle Linux vengono fornite con il pacchetto di utility Oracle Cloud Infrastructure (OCI) (oci-utils) installato. Queste utility non sono disponibili su altre distribuzioni.

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

Il repository oci_included è abilitato. Questo repository è abilitato per impostazione predefinita nelle immagini della piattaforma Oracle Linux. Il repository contiene tutti i pacchetti necessari, inclusi i pacchetti SDK OCI e Python necessari. Il pacchetto oci-utils fornisce tutte le dipendenze.
Le utility OCI dispongono delle autorizzazioni necessarie per accedere a Oracle Cloud Infrastructure. Ciò può essere ottenuto effettuando una delle seguenti operazioni:
- 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 prima di eseguire il comando oci setup config. Per ulteriori informazioni, vedere Installazione dell'interfaccia CLI.
- Utilizza i principal dell'istanza aggiungendo l'istanza a un gruppo dinamico che ha accesso ai servizi Oracle Cloud Infrastructure. Per ulteriori informazioni, vedere Gestione dei gruppi dinamici.
- Configurare oci-utils per consentire all'account root di utilizzare i file di configurazione OCI di un utente senza privilegi. Per ulteriori informazioni, vedere il file di configurazione nella directory /etc/oci-utils.conf.d dell'istanza.
Dopo avere verificato che le utility OCI dispongano delle autorizzazioni necessarie, selezionare i metodi seguenti da utilizzare per accedere alle utility ed eseguire le impostazioni necessarie per tale metodo:
- CLI OCI da un'istanza o da 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 che mostra come installare e configurare le utility OCI, vedere Enabling OCI Utilities in Oracle Linux on Oracle Cloud Infrastructure Instances.

Aggiornamento di OCI Utilities

Per eseguire l'aggiornamento alla versione più recente di oci-utils, eseguire il comando seguente:

sudo dnf update oci-utils

Utilizzo del daemon ocid

Il daemon ocid è il componente di servizio di oci-utils. Monitora le 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 immediatamente il daemon ocid con systemd e avviarlo automaticamente al boot del sistema, eseguire il comando seguente:

sudo systemctl enable --now ocid.service

Per confermare che il servizio è attivo (in esecuzione), eseguire il comando seguente:

sudo service ocid status

L'output è simile al seguente:

$ 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; preset: disabled)
     Active: active (running) since date and time; 9s ago
 Invocation: edd65c2c534949f3a3fb1a77d0aecccf
   Main PID: 361841 (python3)
      Tasks: 4 (limit: 72765)
     Memory: 127.3M (peak: 127.8M)
        CPU: 1.424s
     CGroup: /system.slice/ocid.service
             └─361841 /usr/bin/python3 /usr/lib/python3.12/site-packages/oci_utils/impl/ocid_main.py --no-daemon
date and time hostname systemd[1]: Starting ocid.service - Oracle Cloud Infrastructure utilities daemon...
date and time hostname systemd[1]: Started ocid.service - Oracle Cloud Infrastructure utilities daemon.

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`	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 compartimento o una rete specifici.
`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 definiscono ulteriormente il tipo di informazioni prodotte dall'utility o il modo in cui viene eseguita un'attività.

Nella tabella seguente sono elencate le opzioni e i relativi valori possibili 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 possibili 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. Di seguito sono riportate le opzioni disponibili. `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

è 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