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 trovare 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 del pacchetto, inclusi i pacchetti OCI SDK 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 eseguendo una delle operazioni riportate di seguito.
    • Creare il file di configurazione SDK per l'host. Per ulteriori informazioni, vedere File di configurazione SDK e CLI.
      Nota

      Potrebbe essere necessario installare l'interfaccia CLI per l'ambiente in uso prima di eseguire il comando oci setup config per creare il file di configurazione dell'SDK. Per ulteriori informazioni, vedere Installazione dell'interfaccia CLI.
    • Utilizzare i principal delle istanze 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 di 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 eventuali procedure di impostazione per tale metodo, in base alle esigenze:

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

Aggiornamento delle utility OCI

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 del servizio di oci-utils. Esegue il monitoraggio delle modifiche nella configurazione VNIC e iSCSI dell'istanza e tenta di collegare o scollegare automaticamente i dispositivi mentre 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 in modo che venga avviato automaticamente 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.
        

Riferimento a OCI Utilities

Ulteriori informazioni su ciascuna utility, tra cui una descrizione, esempi di utilizzo e opzioni.

Gestione dei volumi

Gestione della rete

Visualizzazione delle informazioni di configurazione

Configurazione delle notifiche

Conversione dell'immagine minima di Oracle Linux

È inoltre possibile visualizzare l'opzione della utility OCI e informazioni dettagliate accedendo alle pagine man della utility OCI. Per informazioni su come accedere alle pagine man della utility OCI, vedere Opzioni comuni della utility OCI.

oci-compartimento

Utilizzare la utility oci-compartmentid per visualizzare l'OCID (Oracle Cloud Identifier) del compartimento in cui è in esecuzione l'istanza.

Utilizzo

oci-compartmentid [-h | --help]

Per visualizzare l'OCID compartimento dell'istanza:

sudo oci-compartmentid

Ad esempio:

$ sudo oci-compartmentid
ocid1.compartment1.oc1..OCID

Per informazioni sull'opzione della utility oci-compartmentid, vedere Opzioni comuni della utility OCI.

oci-growfs

Se espandi il volume di avvio di un'istanza basata su Linux Oracle Cloud Infrastructure (OCI), puoi quindi utilizzare la utility oci-growfs per espandere la partizione radice dell'istanza. Ciò consente di utilizzare completamente il volume di avvio appena espanso.

Nota

Sono supportati solo i file system XFS e ext4.

Per impostazione predefinita, un'istanza basata su Linux non utilizza automaticamente l'intero volume di avvio se il volume di avvio è maggiore o uguale a 50 GB. Se il volume di avvio collegato all'istanza è inferiore a 50 GB, quando si utilizza la utility oci-growfs non vengono apportate modifiche al sistema.

Utilizzo

/usr/libexec/oci-growfs [-y] [-n] [-h | --help]

Espansione della partizione radice di un'istanza

Per espandere la partizione radice dell'istanza:

  1. Utilizzare il comando lsblk per confermare che il sistema operativo ha identificato la nuova dimensione del volume di avvio.

    Ad esempio:

    lsblk
    NAME               MAJ:MIN RM  SIZE RO TYPE MOUNTPOINT
    sda                  8:0    0  100G  0 disk
    ├─sda1               8:1    0  100M  0 part /boot/efi
    ├─sda2               8:2    0    1G  0 part /boot
    └─sda3               8:3    0 98.9G  0 part
      ├─ocivolume-root 252:0    0 88.9G  0 lvm  /
      └─ocivolume-oled 252:1    0   10G  0 lvm  /var/oled
    sdb                  8:16   0   70G  0 disk
    

    Se la dimensione del volume del disco non è quella prevista, eseguire i comandi per eseguire nuovamente la scansione del volume di avvio. Vedere Rescanning the Disk for Volumes Attached to Linux-Based Instances.

  2. Eseguire la utility oci-growfs con l'opzione y per rispondere "yes" a tutti i prompt.

    sudo /usr/libexec/oci-growfs -y

    Ad esempio:

    $ sudo /usr/libexec/oci-growfs -y
    Volume Group: ocivolume 
    Mountpoint Data
    
    ---------------
    
    mountpoint: /
    
    source: /dev/mapper/ocivolume-root
    
    filesystem type: xfs
    
    source size: 58.9G
    
    type: lvm
    
    size: 58.9G
    
    physical devices: ['/dev/sda3']
    
    physical volumes: ['/dev/sda', '/dev/sda']
    
    partition number: ['3']
    
    volume group name: ocivolume
    
    volume group path: /dev/ocivolume/root
    
    Partition dry run expansion "/dev/sda3" succeeded.
    
    CHANGE: partition=3 start=2304000 old: size=144496607 end=146800606 new: size=207411167 end=209715166 
    
    Partition expand expansion "/dev/sda3" succeeded.
    update-partition set to true
    FLOCK: try exec open fd 9, on failure exec exits this program
    FLOCK: /dev/sda: obtained exclusive lock
    resizing 3 on /dev/sda using resize_sfdisk_gpt
    209715200 sectors of 512. total size=107374182400 bytes
    ## sfdisk --unit=S --dump /dev/sda
    label: gpt
    label-id: DEC7F1D7-BEBD-4622-9B47-8ADF594E82FD
    device: /dev/sda
    unit: sectors
    first-lba: 34
    last-lba: 209715166
    
    /dev/sda1 : start=        2048, size=      204800, type=C12A7328-F81F-11D2-BA4B-00A0C93EC93B, uuid=CEB6C9AA-4543-4CBF-A44E-D75D7BDDC644, name="EFI System Partition"
    /dev/sda2 : start=      206848, size=     2097152, type=0FC63DAF-8483-4772-8E79-3D69D8477DE4, uuid=340A48CC-18ED-4C1A-AAD7-90CDB8E0B600
    /dev/sda3 : start=     2304000, size=   144496607, type=E6D6D379-F507-44C2-A23C-238F2A3DF928, uuid=8BB84AB7-F5DF-47F1-B630-21442C9102C1
    padding 33 sectors for gpt secondary header
    max_end=209715166 tot=209715200 pt_end=146800606 pt_start=2304000 pt_size=144496607
    resize of /dev/sda returned 0.
    FLOCK: /dev/sda: releasing exclusive lock
    
    CHANGED: partition=3 start=2304000 old: size=144496607 end=146800606 new: size=207411167 end=209715166
    
    Extending /dev/sda3 succeeded.
    Device /dev/sda3 extended successfully.
    Logical volume /dev/ocivolume/root extended successfully.
    

Per informazioni sulle opzioni della utility oci-growfs, vedere Opzioni comuni della utility OCI.

oci-image-expand

Utilizzare la utility oci-image-expand per convertire l'istanza Oracle Linux Minimal per aggiungere servizi e pacchetti di un'immagine della piattaforma Oracle Linux standard. Con questa utility, l'istanza minima può ripristinare quasi le stesse funzionalità di un'immagine della piattaforma Oracle Linux standard.

Per informazioni sull'ultima immagine minima di Oracle Linux, vedere Immagini Oracle Linux 9.x.

La utility oci-image-expand richiede privilegi root.

Requisito

Installa le utility OCI sull'istanza minima. Per ulteriori informazioni, vedere Installazione delle utility OCI.

Tipi di conversione

La utility oci-image-expand fornisce due tipi di conversioni dell'istanza minima di Oracle Linux:

  • Predefinito: ripristina i servizi systemd della piattaforma Oracle Linux predefinita, i package di diagnostica, le impostazioni di configurazione cloud e configura e abilita lo swap nell'istanza. Il ripristino della funzionalità di piattaforma predefinita non aumenta il tempo di avvio dell'istanza. Questo tipo di conversione viene sempre applicato dalla utility oci-image-expand.

  • Reboot necessario: ripristina la funzionalità predefinita della piattaforma Oracle Linux, come descritto nel tipo di conversione Predefinito, e ripristina una o più delle seguenti funzioni selezionabili dall'utente: La scelta di una di queste funzioni selezionabili aumenta il tempo di avvio dell'istanza e richiede un riavvio per rendere effettivo.
Nota

L'esecuzione della utility oci-instance-expand influisce sulle impostazioni configurate dall'utente nell'istanza. Ad esempio, la utility ripristina cloud-init config per impostare le impostazioni predefinite dell'immagine della piattaforma Oracle Linux, sovrascrivendo le modifiche cloud-config configurate dall'utente. Inoltre, se si sceglie di ripristinare Ksplice, la utility ripristina il pacchetto oci-linux-config in modo che la nuova chiave di accesso venga memorizzata nel file di configurazione appropriato. Non eseguire la utility su istanze diverse dalle istanze minime.

I file di log della utility oci-image-expand si trovano in: /var/log/oci-image-expand.log

Utilizzo

oci-image-expand [-h | --help]

Ripristino della funzionalità di immagine predefinita della piattaforma

Per ripristinare la funzionalità di immagine predefinita della piattaforma Oracle Linux nell'istanza Oracle Linux Minimal:

Eseguire la utility oci-image-expand e premere Invio al prompt, senza effettuare alcuna selezione.

Ad esempio:

$ /usr/libexec/oci-image-expand
Please select the set of reboot required functions, if any
Selecting a function transitions from not selected [ ] to selected [+] or vice versa
 
[ ] 0) All reboot options

[ ] 1) Enable SELinux

[ ] 2) Enable Kdump

[ ] 3) Enable Ksplice
  
Select the desired options using their number (again to uncheck, ENTER when done):
ENTER

Ripristino della funzionalità di immagine della piattaforma necessaria per il riavvio

Per ripristinare la funzionalità di immagine della piattaforma Oracle Linux che richiede il riavvio di un'istanza per rendere effettivo:

  1. Eseguire la utility oci-image-expand.

    /usr/libexec/oci-image-expand
  2. Al prompt, effettuare una delle seguenti operazioni, quindi premere Invio:

    • Immettere zero per ripristinare tutte le funzioni della lista (SELinux, Kdump e Ksplice).
    • Immettere un singolo numero, compreso tra uno e tre, per ripristinare una delle funzioni dell'elenco.
    • Immettere due numeri, compresi tra uno e tre, per ripristinare due delle funzioni dell'elenco.

    Ad esempio, per ripristinare le funzionalità SELinux e Ksplice nell'istanza Oracle Linux Minimal:

    $ /usr/libexec/oci-image-expand
    Please select the set of reboot required functions, if any
    Selecting a function transitions from not selected [ ] to selected [+] or vice versa
     
    [ ] 0) All reboot options
    
    [+] 1) Enable SELinux
    
    [ ] 2) Enable Kdump
    
    [+] 3) Enable Ksplice
      
    Select the desired options using their number (again to uncheck, ENTER when done):
     1 3
    The following options were selected:
        Enable SELinux
        Enable Ksplice
    The chosen options will now be applied. Press any key to continue (within 10 seconds)
    Nota

    Se si cambia idea su una funzione selezionata, digitare di nuovo il numero prima di premere Invio per deselezionare la funzione. Se si è già premuto Invio, premere Ctrl+C per annullare l'operazione.

  3. Al prompt, immettere y per riavviare l'istanza.
    A reboot is required to enable and activate all restored services. 
    Do you wish to reboot now? (y/n)y

Per informazioni sull'opzione della utility oci-image-expand, vedere Opzioni comuni della utility OCI.

oci-instanceid

Utilizzare la utility oci-instanceid per visualizzare l'OCID (Oracle Cloud Identifier) dell'istanza.

Utilizzo

oci-instanceid [-h | --help]

Per visualizzare l'OCID dell'istanza di computazione:

sudo oci-instanceid

Ad esempio:

$ sudo oci-instanceid
ocid1.instance1.oc1.iad1.OCID

Per informazioni sull'opzione della utility oci-instanceid, vedere Opzioni comuni della utility OCI.

oci-iscsi-config

Utilizzare la utility oci-iscsi-config per elencare e configurare i dispositivi iSCSI collegati a un'istanza basata su Linux Oracle Cloud Infrastructure (OCI). Se eseguito senza opzioni dalla riga di comando, oci-iscsi-config elenca i dispositivi che richiedono attenzione.

Attenzione

Evitare di inserire informazioni riservate quando si assegnano descrizioni, tag o nomi descrittivi alle risorse cloud tramite la console, l'API o l'interfaccia CLI.

Utilizzo

oci-iscsi-config [subcommand] [-h | --help]

Comandi secondari

La utility oci-iscsi-config dispone dei comandi secondari seguenti.

comandi secondari della utility oci-iscsi-config

Comando secondario

Per ulteriori informazioni vedere...

show

Visualizzazione delle configurazioni iSCSI

sync

Sincronizzazione di un volume

create

Creazione e collegamento di un nuovo volume

attach

Collegamento di un volume esistente

detach

Scollegamento di un volume

destroy

Eliminazione di un volume

Per un video di formazione che mostra come utilizzare la utility oci-iscsi-config, vedere Using OCI Utilities for Managing iSCSI Storage for Oracle Cloud Infrastructure Instances nella Training Station di Oracle Linux.

Per informazioni sull'opzione della utility oci-iscsi-config, vedere Opzioni comuni della utility OCI.

Visualizzazione delle configurazioni iSCSI

Il comando secondario oci-iscsi-config show elenca i dispositivi iSCSI e le informazioni iSCSI per l'istanza. Questo comando secondario funziona con il daemon ocid per monitorare la creazione e l'eliminazione dei dispositivi tramite la console, l'interfaccia CLI o l'interfaccia API e rilevare automaticamente tali modifiche.

Se il daemon ocid non è in esecuzione, il comando secondario richiede privilegi root.

Uso

oci-iscsi-config show [-C | --compartments name] [-A | --all] [--output-mode mode] [--details] [--no-truncate] [-h | --help]

Per visualizzare un elenco di tutti i dispositivi collegati all'istanza:

  1. Eseguire il comando secondario oci-iscsi-config show.

    sudo oci-iscsi-config show

    Ad esempio:

    $ sudo oci-iscsi-config show
    Currently attached iSCSI devices:
              Volume name           |Attached device| Size |
    --------------------------------------------------------
             mor-demo-bv20          |      sdb      | 50G  |
    Block volumes information:
                  Name              | Size |          Attached to           |              OCID              |
    ----------------------------------------------------------------------------------------------------------
             mor-demo-bv30          | 50GB |               -                |ocid1.volume.oc1.OCID|
    
  2. Facoltativamente, utilizzare le opzioni --details e --no-truncate con il comando secondario oci-iscsi-config show per visualizzare informazioni più dettagliate non abbreviate nell'output:

    sudo oci-iscsi-config show --details --no-truncate

    Ad esempio:

    $ sudo oci-iscsi-config show --details --no-truncate
    Currently attached iSCSI devices:
                 Target                       |          Volume name           |          Volume OCID                       | Persistent portal  |   Current portal   |Session State|Attached device| Size |
    ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
    iqn.2015-12.com.oracleiaas:exampleuniqueID|         mor-demo-bv20          |ocid1.volume.oc1.iad.OCID  |  172.16.10.4:3260  |  172.16.10.4:3260  |  LOGGED_IN  |      sdb      | 50G  |
    
    Block volumes information:
                  Name              | Size |          Attached to           |              OCID                        |     IQN      | Compartment |Availability domain|
    ------------------------------------------------------------------------------------------------------------------------------------------------------------
             mor-demo-bv30          | 50GB |               -                |ocid1.volume.oc1.iad.OCID|      -       | virtdoc.dev  |DSdu:US-ASHBURN-AD-3|
    
  3. Facoltativamente, modificare la presentazione di output in modo che sia più leggibile utilizzando l'opzione --output-mode con il comando secondario oci-iscsi-config show:

    sudo oci-iscsi-config show --output-mode mode

    Ad esempio, per visualizzare la presentazione di output in modalità testo:

    $ sudo oci-iscsi-config show --output-mode text
    Currently attached iSCSI devices
    Volume name: mor-demo-bv20
    Attached device: sdb
    Size: 50G
    
    Block volumes information
    Name: mor-demo-bv30
    Size: 50GB
    Attached to: -
    OCID: ocid1.volume.oc1.iad..OCID

Dettagli opzioni

Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.

oci-iscsi-config mostra dettagli opzione

Opzione

descrizione

-A | --all

Visualizza tutti i dispositivi iSCSI. Per impostazione predefinita, vengono elencati solo i dispositivi non collegati a un'istanza.

-C | --compartments name

Visualizza i dispositivi iSCSI nel compartimento specificato o in tutti i compartimenti (se si specifica all per name).

Creazione e collegamento di un nuovo volume

Utilizzare il comando secondario oci-iscsi-config create per creare e collegare un volume a blocchi a un'istanza. Questo comando secondario richiede l'installazione e la configurazione dell'SDK OCI per Python. Per ulteriori informazioni sull'SDK OCI, vedere Kit di sviluppo software e interfaccia della riga di comando.

Questo comando secondario richiede privilegi root.

Uso

oci-iscsi-config create [-S | --size size] [-v | --volume-name name] [--attach-volume] [-c | --chap] [-h | --help]

Per creare e collegare un volume, utilizzare la utility oci-iscsi-config create con le opzioni -S, --volume-name e --attach-volume:

sudo oci-iscsi-config create -S size --volume-name=name --attach-volume

Ad esempio, per creare e collegare un volume della dimensione di 70 GB all'istanza, con il nome del volume mor-demo-by70:

$ sudo oci-iscsi-config create -S 70 --volume-name=mor-demo-by70 --attach-volume
Creating a new 70 GB volume
Volume name=mor-demo-by70 created
Attaching the volume to this instance
Attaching iSCSI device
iscsiadm attach Result: command executed successfully

Dettagli opzioni

Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.

oci-iscsi-config create Option Details

Opzione

descrizione

-v | --volume-name name

Imposta il nome visualizzato del volume. Evitare di inserire informazioni riservate per il nome visualizzato.

-c | --chap

Collega il dispositivo con il flag Richiedi credenziali CHAP.

Collegamento di un volume esistente

Utilizzare il comando secondario oci-iscsi-config attach per collegare un volume a blocchi esistente all'istanza e rendere disponibile il volume al sistema. L'SDK OCI per Python è necessario per selezionare i volumi utilizzando il rispettivo OCID. Per ulteriori informazioni sull'SDK OCI, vedere Kit di sviluppo software e interfaccia della riga di comando.

Questo comando secondario richiede privilegi root.

Nota

Quando si utilizza un IQN, il volume deve essere già collegato (assegnato) all'istanza nella console. Questa opzione può essere utilizzata per collegare più dispositivi contemporaneamente fornendo un elenco separato da virgole di IQN.

Uso

oci-iscsi-config attach [-I | --iqns IQN] [-O | --ocids OCID] [-u | --username name] [-p | --password password] [-c | --chap] [-h | --help]

Per collegare un volume a blocchi specifico all'istanza:

$ sudo oci-iscsi-config attach --iqns iqn.2015-12.com.oracleiaas:IQN

Dettagli opzioni

Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.

oci-iscsi-config attach Option Details

Opzione

descrizione

-I | --iqns IQN

Lista separata da virgole dei nomi qualificati iSCSI (iqns) del dispositivo o dei dispositivi iSCSI da collegare all'istanza.

-O | --ocids OCID

Lista separata da virgole degli OCID del dispositivo o dei dispositivi iSCSI da collegare all'istanza.

-u | --username name

Utilizzare il nome utente specificato come nome utente CHAP quando è necessaria l'autenticazione per collegare un dispositivo. Questa opzione non è necessaria quando l'SDK OCI per Python è disponibile.

-p | --password password

Utilizzare la password fornita come password CHAP quando è necessaria l'autenticazione per collegare un dispositivo. Questo argomento non è necessario quando l'SDK OCI per Python è disponibile.

-c | --chap

Collegare il dispositivo con il flag Richiedi credenziali CHAP.

Sincronizzazione di un volume

Utilizzare il comando secondario oci-iscsi-config sync per collegare i dispositivi a blocchi disponibili all'istanza ed eseguire le operazioni di sincronizzazione. Il comando secondario richiede privilegi root.

Uso

oci-iscsi-config sync [-a | --apply] [-y | --yes] [-h | --help]

Per collegare i dispositivi a blocchi disponibili all'istanza e sincronizzare le modifiche con OCI, utilizzare il comando secondario oci-iscsi-config sync con l'opzione --apply:

sudo oci-iscsi-config sync --apply

Ad esempio:

$ sudo oci-iscsi-config sync --apply
Attaching the volume to this instance
Attaching iSCSI device
iscsiadm attach Result: command executed successfully

Dettagli opzioni

Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.

oci-iscsi-config sync Dettagli opzione

Opzione

descrizione

-a | --apply

Eseguire le operazioni di sincronizzazione.

Scostamento di un volume

Utilizzare il comando secondario oci-iscsi-config detach per scollegare un dispositivo con l'IQN specificato (un ID univoco assegnato a un dispositivo). Se il volume (o qualsiasi partizione del volume) è installato, questa opzione cerca di disinstallarlo per primo.

Questo comando secondario richiede privilegi root.

Nota

È possibile scollegare più dispositivi contemporaneamente fornendo una lista separata da virgole di IQN.

Uso

oci-iscsi-config detach [-I | --iqns IQN] [-f | --force] [-h | --help]

Per scollegare un dispositivo specifico dall'istanza, utilizzare il comando secondario oci-iscsi-config detach con l'opzione -I.

sudo oci-iscsi-config detach -I IQN

Ad esempio:

$ sudo oci-iscsi-config detach -I  iqn.2015-12.com.oracleiaas:IQN
Detaching volume mor-demo-bv70 (iqn.2015-12.com.oracleiaas:IQN)
Volume [iqn.2015-12.com.oracleiaas:oracleiaas:IQN] is detached
Updating detached volume cache file: ['iqn.2015-12.com.oracleiaas:oracleiaas:IQN']

Per visualizzare l'IQN o l'OCID del volume che si desidera scollegare, utilizzare il comando secondario oci-iscsi-config show. Per informazioni, vedere Visualizzazione delle configurazioni iSCSI.

Dettagli opzioni

Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.

Dettagli opzione di scollegamento oci-iscsi-config

Opzione

descrizione

-f | --force

Continuare lo scollegamento anche se non è possibile disattivare il dispositivo.

-I | --iqns IQN

Lista separata da virgole dei nomi qualificati iSCSI (iqns) del dispositivo o dei dispositivi iSCSI da scollegare dall'istanza.

Eliminazione di un volume

Per eliminare un volume di storage a blocchi con l'OCID specificato, utilizzare il comando secondario oci-iscsi-config destroy.

Nota

È possibile eliminare più dispositivi contemporaneamente fornendo una lista di OCID separata da virgole.

Uso

oci-iscsi-config destroy [-O | --ocids OCID] [-y | --yes] [-h | --help]

Per eliminare un volume a blocchi specifico dall'istanza, utilizzare il comando secondario oci-iscsi-config-destroy con l'opzione -O:

sudo oci-iscsi-config destroy -O OCID

Ad esempio:

$ sudo oci-iscsi-config destroy -O ocid1.volume.oc1.OCID
WARNING: the volume(s) will be destroyed.  This is irreversible.  Continue?
y
Volume [ocid1.volume.oc1.iad.OCID] is destroyed

È possibile visualizzare l'OCID del volume utilizzando il comando secondario della utility oci-iscsi-config show. Per informazioni, vedere Visualizzazione delle configurazioni iSCSI.

Dettagli opzioni

Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.

oci-iscsi-config elimina dettagli opzione

Opzione

descrizione

-O | --ocids OCID

Lista separata da virgole degli OCID dei volumi a blocchi da eliminare.

oci-metadata

Utilizzare la utility oci-metadata per visualizzare o impostare i metadati per un'istanza di computazione basata su Oracle Linux. Se eseguito senza opzioni della riga di comando, oci-metadata elenca tutti i metadati disponibili.

Per ulteriori informazioni sui metadati dell'istanza, vedere Recupero dei metadati dell'istanza.

Utilizzo

oci-metadata [-h | --human-readable] [-j | --json] [-g | --get key] [--export] [--trim] [--value-only] [-u key_value] [-i | --instance-id OCID] [--help]

Recupero di tutti i metadati per l'istanza

Per visualizzare tutti i metadati per l'istanza, eseguire la utility oci-metadata senza opzioni:

sudo oci-metadata

Ad esempio:

$ sudo oci-metadata
Instance details:
  Display Name: my-example-instance
  Region: phx - us-phoenix-1 (Phoenix, AZ, USA)
  Canonical Region Name: us-phoenix-1
  Availability Domain: cumS:PHX-AD-1
  Fault domain: FAULT-DOMAIN-3
  OCID: ocid1.instance.oc1.phx.OCID
  Compartment OCID: ocid.compartment.oc1..OCID
  Instance shape: VM.Standard2.1
  Image ID: ocid1.image.oc1.phx.OCID
  Created at: 1569529065596
  state: Running
  agentConfig:
    managementDisabled: False
    monitoringDisabled: False
  Instance Metadata:
    ssh_authorized_keys: example-key
Networking details:
  VNIC OCID: ocid1.vnic.oc1.phx.OCID
  VLAN Tag: 2392
  Private IP address: 10.0.0.16
  MAC address: 02:00:17:03:D8:FE
  Subnet CIDR block: 10.0.0.0/24
  Virtual router IP address: 10.0.0.1

Recupero di metadati specifici per l'istanza

Per visualizzare i metadati dell'istanza per una chiave specificata, utilizzare l'opzione --get con la utility oci-metadata:

sudo oci-metadata --get key

Ad esempio, per visualizzare solo lo stato dell'istanza di computazione:

$ sudo oci-metadata --get state
Instance details:
Instance state: Running

Dettagli opzioni

Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.

Dettagli opzione oci-metadata

Opzione

descrizione

-g key | --get key

Recupera i dati solo per la chiave specificata. Le chiavi di metadati per un'istanza possono essere definite da Compute oppure è possibile creare chiavi personalizzate. Per ulteriori informazioni, vedere Chiavi di metadati.

--export

Utilizzato con le opzioni -g o --get, visualizzare un comando della shell per esportare la chiave come variabile di ambiente.

--trim

Utilizzata con l'opzione -g o --get, tagliare il percorso della chiave fino all'ultimo componente per rendere l'output più conciso. Ad esempio: da instance/metadata/ssh_authorized_keys a ssh_authorized_keys. Se la chiave corrisponde a più chiavi, viene visualizzata solo la prima chiave corrispondente.

--value-only

Utilizzata con le opzioni -g o --get, visualizza solo i valori che corrispondono alla chiave get.

-u key_value

Aggiornare il valore della chiave specifica (o delle chiavi). Per key_value, specificare una stringa, un valore JSON o un puntatore a un file con contenuto JSON nel seguente formato: key=file:/path/to/file

-i | --instance-id OCID

Recupera o aggiorna i metadati dell'istanza con l'OCID specifico. Per impostazione predefinita, oci-metadata funziona con i metadati dell'istanza a cui è stato eseguito il login.

oci-network-config

La utility oci-network-config consente di configurare le interfacce di rete per l'istanza. È necessario eseguire questa utility come utente root.

La utility oci-network-config mostra le schede VNIC (Virtual Network Interface Card) correnti di cui è stato eseguito il provisioning in Oracle Cloud Infrastructure (OCI) e configurate per questa istanza. Quando viene eseguito il provisioning di una VNIC secondaria in OCI, deve essere configurata in modo esplicito nell'istanza utilizzando la utility oci-network-config.

Le interfacce di rete configurate possono essere collocate all'interno di spazi di nomi di rete separati. Questa separazione è necessaria quando le VNIC si trovano in subnet (VCN diverse) con blocchi di indirizzi sovrapposti e le applicazioni di rete non sono associate direttamente alle interfacce. Gli spazi dei nomi di rete richiedono l'avvio esplicito delle applicazioni negli spazi dei nomi (con il comando ip netns exec ns) per stabilire l'associazione con l'interfaccia. Quando gli spazi di nomi non vengono utilizzati, l'instradamento basato su criteri viene configurato per fornire un instradamento predefinito al router virtuale della VNIC secondaria (gateway predefinito) quando l'indirizzo della VNIC è l'indirizzo di origine.

Le VNIC secondarie Bare Metal vengono configurate utilizzando le VLAN (in cui non esiste alcuna interfaccia fisica corrispondente). Queste VNIC vengono visualizzate come due interfacce aggiuntive durante la visualizzazione dei collegamenti IP, con i nomi in MACVLAN_FORMAT per la VLAN MAC e VLAN_FORMAT per la VLAN IP.

Utilizzo

oci-network-config [subcommand] [-q | --quiet] [-h | --help]

Comandi secondari

La utility oci-network-config dispone dei comandi secondari seguenti.

Per un video di formazione che mostra come utilizzare la utility oci-network-config, vedere Gestione dell'interfaccia di rete mediante OCI Utilities on Oracle Linux Instances nella Training Station di Oracle Linux.

Per informazioni sulle opzioni della utility oci-network-config, vedere Opzioni comuni della utility OCI.

Visualizzazione della configurazione di rete corrente

Il comando secondario oci-network-config show mostra le informazioni sulle VNIC configurate nell'istanza. Puoi visualizzare la configurazione di rete corrente, ad esempio le VNIC di cui è stato eseguito il provisioning e le configurazioni IP correnti per l'istanza. Le VNIC non ancora configurate vengono contrassegnate con ADD e le configurazioni IP che non dispongono più di una VNIC associata vengono contrassegnate con DELETE.

L'output di questo comando è l'azione predefinita se l'utility oci-network-config viene immessa senza opzioni.

Uso

oci-network-config show [--output-mode mode] [-I | --include item] [-X | --exclude item] [--details] [--no-truncate] [-h | --help]

Per visualizzare la configurazione di rete corrente:

sudo oci-network-config show

Ad esempio:

$ sudo oci-network-config show 
Network configuration
 State | Link | Status |  IP address |        VNIC        |        MAC        |
------------------------------------------------------------------------------
   -   | ens3 |   UP   | 10.2.20.254 |  hostname_ipv6_01  | 02:00:17:01:30:D5 |
  ADD  | ens4 |   UP   | 10.2.10.121 | vnic20220912090629 | 02:00:17:01:A9:0E |


Operating System level network configuration:
CONFIG      ADDR          SUBNET     BITS   VIRTROUTER      NS    IND      IFACE     VLTAG     VLAN    STATE        MAC                                                VNIC ID                                          
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
  -     10.2.20.254     10.2.20.0     24    10.2.20.1       -      2        ens3      3181      -        UP  02:00:17:01:30:D5 ocid1.vnic.oc1.uk-london-1.VNIC_OCID  
 ADD    10.2.10.121     10.2.10.0     24    10.2.10.1       -      3        ens4      1435      -        UP  02:00:17:01:A9:0E ocid1.vnic.oc1.uk-london-1.VNIC_OCID  

Per configurare le VNIC non ancora configurate (con l'etichetta ADD) ed eliminare gli indirizzi IP a cui non sono associate VNIC, utilizzare il comando secondario oci-network-config config. Per ulteriori informazioni, vedere Configurazione delle VNIC.

Dettagli opzioni

Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.

oci-network-config mostra dettagli opzione

Opzione

descrizione

-I | --include item

Includere un indirizzo IP o un'interfaccia VLAN precedentemente esclusa utilizzando l'opzione --exclude nella configurazione/deconfigurazione automatica. Per item, è possibile specificare un OCID VNIC, un indirizzo IP o un nome di interfaccia VLAN.

-X | --exclude item

Esclude in modo persistente un indirizzo IP o un'interfaccia VLAN dalla configurazione/deconfigurazione automatica. Per item, è possibile specificare un OCID VNIC, un indirizzo IP o un nome di interfaccia VLAN. Utilizzare l'opzione --include per includere di nuovo l'indirizzo IP o l'interfaccia VLAN.

Creazione e collegamento di una VNIC

Utilizzare il comando secondario oci-network-config attach-vnic per creare e collegare una VNIC a un'istanza. Con questo comando secondario puoi assegnare un indirizzo IP pubblico o privato alla nuova VNIC.

Importante

Il collegamento di una VNIC a un indirizzo IPv6 primario non è supportato da OCI.

Uso

oci-network-config attach-vnic [-I | --ip-address ip_address] [-ipv4 | --ipv4] [-ipv6 | --ipv6] [-i | --nic-index index] [--subnet subnet] [-n | --name name] [--assign-public-ip] [-h | --help]

Per creare una VNIC e collegare la VNIC a un'istanza, utilizzare il comando secondario oci-network-config attach-vnic con l'opzione -n:

sudo oci-network-config attach-vnic -n name

Ad esempio, per creare una VNIC denominata ex-demo-inst-10 e collegare la VNIC all'istanza:

$ sudo oci-network-config attach-vnic -n ex-demo-inst-10
creating VNIC: 10.102.119.140

Dettagli opzioni

Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.

oci-network-config attach-vnic Option Dettagli

Opzione

descrizione

-I | --ip-address ip_address

Assegnare l'indirizzo IP privato specificato alla VNIC. Se questa opzione non viene utilizzata, un indirizzo IP non utilizzato della subnet viene assegnato automaticamente alla VNIC.

-ipv4 | --ipv4

Assegnare un indirizzo IPv4 alla VNIC. Se si utilizza l'opzione --ipv4, alla VNIC viene assegnato un indirizzo IPv4 non utilizzato della subnet. Se si specifica l'opzione --ip-address con questa opzione, le opzioni --ipv4 e --ipv6 vengono ignorate.

-ipv6 | --ipv6

Assegnare un indirizzo IPv6 alla VNIC. Se si utilizza l'opzione --ipv6, alla VNIC viene assegnato un indirizzo IPv6 non utilizzato della subnet. Se si utilizza invece l'opzione --ip-address, le opzioni --ipv4 e --ipv6 vengono ignorate.

Importante: il collegamento di una VNIC a un indirizzo IPv6 primario non è supportato da OCI.

Il messaggio seguente viene visualizzato quando si esegue oci-network-config attach-vnic con l'opzione --ipv6.

# sudo oci-network-config attach-vnic --ipv6
Attaching a vnic with a primary ipv6 address is not yet supported by OCI.

-i | --nic-index index

Assegnare la VNIC alla scheda NIC fisica specificata. Per index, specificare il numero di indice assegnato alla scheda NIC fisica. Il valore predefinito è zero. Questa opzione viene utilizzata solo per le istanze Bare Metal.

--subnet subnet

Connettere la VNIC alla subnet specificata. Per subnet, specificare un OCID o un'espressione regolare corrispondente al nome visualizzato di tutte le subnet disponibili. Quando si utilizza --ip-address, la subnet viene derivata dall'indirizzo IP o viene derivata per impostazione predefinita dalla subnet della VNIC primaria.

-n | --name name

Impostare il nome visualizzato per la VNIC. Evitare di fornire informazioni riservate.

--assign-public-ip

Assegnare un indirizzo IP pubblico alla VNIC. Per impostazione predefinita, viene assegnato solo un indirizzo IP privato.

Configurazione delle VNIC

Il comando secondario oci-network-config configure aggiunge la configurazione IP per le VNIC non configurate ed elimina la configurazione IP delle VNIC di cui non viene più eseguito il provisioning. Questo comando sincronizza la configurazione IP dell'istanza con il provisioning OCI corrente.

Uso

oci-network-config configure [-n | --namespace format] [-r | --start-sshd] [-I | --include item] [-X | --exclude item] [-h | --help]

Per configurare tutte le VNIC nell'istanza, effettuare le operazioni riportate di seguito.

sudo oci-network-config configure

Ad esempio:

$ sudo oci-network-config configure
Configured 

Per configurare le VNIC nell'istanza, ad eccezione di una VNIC specifica, utilizzare il comando secondario oci-network-config configure con l'opzione -X:

sudo oci-network-config configure -X VNIC_OCID

Ad esempio:

$ sudo oci-network-config configure -X VNIC_OCID
Configured 

È possibile confermare la configurazione delle VNIC eseguendo il comando secondario oci-network-config show. Dopo la configurazione, nell'output non verrà visualizzata alcuna etichetta ADD o DELETE, a meno che non si scelga di escludere la configurazione di una VNIC. Per ulteriori informazioni, vedere Visualizzazione della configurazione di rete corrente.

Dettagli opzioni

Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.

oci-network-config configure Option Details

Opzione

descrizione

-n | --namespace format

Durante la configurazione, posizionare le interfacce nello spazio di nomi identificato dal formato specificato. Il formato può includere le variabili $nic e $vltag. Il nome predefinito è DEF_NS_FORMAT_BM per BM e DEF_NS_FORMAT_VM per VM. Quando si configurano più VNIC, assicurarsi che gli spazi di nomi siano univoci.

-r | --start-sshd

Avviare sshd nello spazio di nomi (se è presente -n).

-I | --include item

Includere un indirizzo IP o un'interfaccia VLAN precedentemente esclusa utilizzando l'opzione --exclude nella configurazione/deconfigurazione automatica. Per item, è possibile specificare un OCID VNIC, un indirizzo IP o un nome di interfaccia VLAN.

-X | --exclude item

Esclude in modo persistente un indirizzo IP o un'interfaccia VLAN dalla configurazione/deconfigurazione automatica. Per item, è possibile specificare un OCID VNIC, un indirizzo IP o un nome di interfaccia VLAN. Utilizzare l'opzione --include per includere di nuovo l'indirizzo IP o l'interfaccia VLAN.

Visualizzazione delle VNIC configurate

Il comando secondario oci-network-config show-VNICs mostra le informazioni sulle VNIC configurate nell'istanza.

Uso

oci-network-config show-vnics [--output-mode mode] [--details] [--ocid OCID] [--name name] [--ip-address primary_ip] [--no-truncate] [-h | --help]

Per visualizzare le informazioni sulle VNIC configurate nell'istanza:

sudo oci-network-config show-vnics

Ad esempio:

$ sudo oci-network-config show-vnics
VNICs Information:
              Name              |   Private IP  |                                           OCID                                           |       MAC       |
--------------------------------------------------------------------------------------------------------------------------------------------------------------
        ex-demo-inst-10         |10.102.119.140|     ocid1.vnic.oc1.iad.OCID                                                    |00:00:17:02:CC:CB|
        mor-demoinst-10         |10.102.118.251|     ocid1.vnic.oc1.iad.OCID                                                    |02:00:17:02:C6:B2|

Dettagli opzioni

Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.

oci-network-config show-vnics Dettagli opzione

Opzione

descrizione

--ocid OCID

Mostra informazioni sulla VNIC corrispondente all'OCID (Oracle Cloud Identifier) specificato.

--name name

Mostra informazioni sulla VNIC associata al nome specificato.

--ip-address primary_IP

Mostra informazioni sulla VNIC associata all'indirizzo IP primario specificato.

Visualizzazione di tutte le VNIC configurate

Utilizzare il comando secondario oci-network-config show-VNICs-all per visualizzare informazioni dettagliate su tutte le VNIC configurate in questa istanza.

Uso

oci-network-config show-vnics-all [--output-mode mode] [-h | --help]

Per visualizzare tutte le VNIC configurate nell'istanza:

sudo oci-network-config show-vnics-all

Ad esempio:

# sudo oci-network-config show-vnics-all
Virtual Network Interface Information:
        Name        |  Private IP |        MAC        | Config |                                           OCID                                          | Primary  |      Subnet      | Subnet cidr  |       State        | NIC  |   Public IP    |
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
  hostname_ipv6_01  | 10.2.20.254 | 02:00:17:01:30:D5 |   -    | ocid1.vnic.oc1.iad.OCID                                                |   True   | hostname_uk02_02 | 10.2.20.0/24 | AVAILABLE-ATTACHED |  -   | 140.238.76.113 |
      IP address details      
                      Private IP               |                                             OCID                                             |      
      ----------------------------------------------------------------------------------------------------------------------------------------      
                     10.2.20.254               | ocid1.privateip.oc1.iad.OCID |      
      
      
 vnic20220912090629 | 10.2.10.121 | 02:00:17:01:A9:0E |   -    | ocid1.vnic.oc1.iad.OCID                                               |    -     | hostname_uk02_01 | 10.2.10.0/24 | AVAILABLE-ATTACHED |  -   |       -        |
      IP address details      
                      Private IP               |                                             OCID                                             |      
      ----------------------------------------------------------------------------------------------------------------------------------------      
                     10.2.10.121               | ocid1.privateip.oc1.iad.OCID |      
       2603:c020:c003:3a10:b64c:8f35:7f9e:7e87 |   ocid1.ipv6.oc1.iad.OCID    |      

Per informazioni sulle opzioni oci-network-config show-vnics-all, vedere Opzioni comuni della utility OCI.

Aggiunta di un indirizzo secondario

Utilizzare la utility oci-network-config add-secondary-addr per aggiungere un indirizzo IP privato secondario con l'indirizzo IPv4 o IPv6 specificato a una VNIC esistente.

Uso

oci-network-config add-secondary-addr [-ipv4 | --ipv4] [-ipv6 | --ipv6] [-I | --ip-address ip_address] [-O | --ocid OCID] [-h | --help]

Per aggiungere un indirizzo IP secondario privato, in questo caso un indirizzo IPv6, a una VNIC esistente, utilizzare il comando secondario oci-network-config add-secondary-addr con le opzioni --ipv6 e --ocid:

sudo oci-network-config add-secondary-addr --ipv6 --ocid OCID

Ad esempio:

$ sudo oci-network-config add-secondary-addr --ipv6 --ocid ocid1.vnic.oc1.iad.OCID
Provisioning secondary private IPv6: 2603:c020:c003:3a10:b64c:8f35:7f9e:7e87
IP 2603:c020:c003:3a10:b64c:8f35:7f9e:7e87 has been assigned to vnic ocid1.vnic.oc1.iad.OCID

Dettagli opzioni

Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.

oci-network-config add-secondary-addr Dettagli opzione

Opzione

descrizione

-ipv4 | --ipv4

Specificare che un indirizzo secondario privato IPv4 venga aggiunto a una VNIC esistente. Questa opzione è quella predefinita se il comando viene immesso senza opzioni.

-ipv6 | --ipv6

Specificare che un indirizzo secondario privato IPv6 venga aggiunto a una VNIC esistente.

-I ip_address | --ip-address ip_address

Specificare l'indirizzo IP privato secondario da aggiungere alla VNIC.

-O | --ocid OCID

Assegnare l'indirizzo secondario alla VNIC associata all'OCID specifico.

Eliminazione della configurazione IP per le VNIC secondarie con provisioning eseguito

Utilizzare il comando secondario oci-network-config unconfigure per eliminare tutte le configurazioni IP per le VNIC secondarie di cui è stato eseguito il provisioning (tranne quelle esplicitamente escluse). Impossibile eliminare la VNIC primaria.

Uso

oci-network-config unconfigure [-I | --include item] [-X | --exclude item] [-h | --help]

Per eliminare tutte le configurazioni IP per le VNIC secondarie di cui è stato eseguito il provisioning, utilizzare il comando secondario oci-network-config unconfigure:

sudo oci-network-config unconfigure

Ad esempio:

$ sudo oci-network-config unconfigure
Unconfigured 

Dettagli opzioni

Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.

oci-network-config unconfigure Dettagli opzione

Opzione

descrizione

-I | --include item

Includere un indirizzo IP o un'interfaccia VLAN precedentemente esclusa utilizzando l'opzione --exclude nella configurazione/deconfigurazione automatica. Per item, è possibile specificare un OCID VNIC, un indirizzo IP o un nome di interfaccia VLAN.

-X | --exclude item

Escludi persistentemente un elemento (indirizzo IP o interfaccia VLAN) dalla configurazione/deconfigurazione automatica. Per item, è possibile specificare un OCID VNIC, un indirizzo IP o un nome di interfaccia VLAN. Utilizzare l'opzione --include per includere di nuovo l'indirizzo IP o l'interfaccia VLAN.

Rimozione di un indirizzo IPv6 secondario

Utilizzare il comando secondario oci-network-config remove-secondary-addr per rimuovere un indirizzo IP privato secondario con l'indirizzo IPv4 o IPv6 specificato da una VNIC esistente.

Uso

oci-network-config remove-secondary-addr [-I | --ip-address ip_address] [-h | --help]

Per rimuovere un indirizzo IPv6 secondario privato da una VNIC esistente, utilizzare il comando secondario oci-network-config remove-secondary-addr con l'opzione -I:

sudo oci-network-config remove-secondary-addr -I ip_address

Ad esempio, per rimuovere l'indirizzo IPv6 secondario, 2603:c020:c003:3a10:b64c:8f35:7f9e:7e87, da una VNIC esistente:

$ sudo oci-network-config remove-secondary-addr -I 2603:c020:c003:3a10:b64c:8f35:7f9e:7e87
Deconfigure secondary private IP 2603:c020:c003:3a10:b64c:8f35:7f9e:7e87

Dettagli opzioni

Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.

oci-network-config remove-secondary-addr Dettagli opzione

Opzione

descrizione

-I | --ip-address ip_address

Specificare l'indirizzo IP privato secondario da rimuovere dalla VNIC.

Scostamento di una VNIC

Utilizzare il comando secondario oci-network-config detach-vnic per scollegare ed eliminare la VNIC con l'OCID o l'indirizzo IP specifico dall'istanza. Questo comando secondario può essere utilizzato per rimuovere l'indirizzo IP assegnato da una VNIC esistente. Tuttavia, la VNIC primaria non può essere scollegata. Vengono eliminati anche tutti gli indirizzi IP privati secondari associati alla VNIC.

Uso

oci-network-config detach-vnic [-I | --ip-address ip_address] [-O | --ocid OCID] [-h | --help]

Per scollegare una VNIC dall'istanza, utilizzare il comando secondario oci-network-config detach-vnic con l'opzione --ocid:

sudo oci-network-config detach-vnic --ocid OCID

Ad esempio, per scollegare una VNIC con un OCID VNIC specifico dall'istanza:

$ sudo oci-network-config detach-vnic --ocid ocid1.vnic.oc1.iad.OCID
Detaching VNIC 10.2.10.121 [ocid1.vnic.oc1.iad.OCID]
VNIC [ocid1.vnic.oc1.iad.OCID] is detached.

Dettagli opzioni

Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.

oci-network-config detach-vnic Option Dettagli

Opzione

descrizione

-I | --ip-address ip_address

Scollegare la VNIC con l'indirizzo IP specificato.

--ocid OCID

Scollegare la VNIC con l'OCID specificato.

Visualizzazione delle informazioni sulla VCN

Il comando secondario oci-network-config show-vcns visualizza le informazioni sulla rete cloud virtuale (VCN) nel compartimento in cui risiede l'istanza.

Uso

oci-network-config show-vcns [--output-mode mode] [--details] [--ocid OCID] [--name name] [--no-truncate] [-h | --help]

Per visualizzare informazioni dettagliate sulla VCN in formato di output di testo, utilizzare il comando secondario oci-network-config show-vcns con le opzioni --details e --output-mode text:

sudo oci-network-config show-vcns --details --output-mode text

Ad esempio:

$ sudo oci-network-config show-vcns --details --output-mode text
Virtual Cloud Network Information:

Name: hostname_uk_01
IPv4 cidr block: 10.0.0.0/16
IPv6 cidr block: 2603:c020:c003:6c00::/56
OCID: ocid1.vcn.oc1..example_OCID
IPv4 cidr blocks: 10.0.0.0/16
DNS label: gtijskenuk01
State: AVAILABLE
Lifecycle state: AVAILABLE

Name: hostname_uk_02
IPv4 cidr block: 10.2.0.0/16
IPv6 cidr block: 2603:c020:c003:3a00::/56
OCID: ocid1.vcn.oc1..example_OCID
IPv4 cidr blocks: 10.2.0.0/16
DNS label: gtijskenuk02
State: AVAILABLE
Lifecycle state: AVAILABLE

Name: hostname_uk_ref
IPv4 cidr block: 10.253.0.0/16
IPv6 cidr block: 2603:c020:c007:9f00::/56
OCID: ocid1.vcn.oc1..example_OCID
IPv4 cidr blocks: 10.253.0.0/16
DNS label: gtijskenukref
State: AVAILABLE
Lifecycle state: AVAILABLE

Dettagli opzioni

Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.

oci-network-config show-vcns Dettagli opzione

Opzione

descrizione

--ocid OCID

Visualizzare la VCN con l'OCID specificato.

--name name

Visualizzare la VCN con il nome specificato.

Visualizzazione delle informazioni sulla subnet

Il comando secondario oci-network-config show-subnets mostra le informazioni sulla subnet nel compartimento in cui risiede questa istanza.

Uso

oci-network-config show-subnets [--output-mode mode] [--details] [--ocid OCID] [--name name] [--no-truncate] [-h | --help]

Per visualizzare informazioni dettagliate sulla subnet in formato di output JSON, utilizzare il comando secondario oci-network-config show-subnets con le opzioni --details e --output-mode json:

sudo oci-network-config show-subnets --details --output-mode json

Ad esempio:

$ sudo oci-network-config show-subnets --details --output-mode json
[
  {
    "Name": "Public Subnet-hostname_uk_01",
    "ipv4 cidr block": "10.0.0.0/24",
    "ipv6 cidr block": "2603:c020:c003:6c00::/64",
    "OCID": "ocid1.subnet.oc1..OCID",
    "VCN name": "hostname_uk_01",
    "VCN ocid": "ocid1.vcn.oc1..OCID",
    "Public": true,
    "Public ingress": true,
    "DNS label": "sub06230933270",
    "Domain name": "sub06230933270.gtijskenuk01.oraclevcn.com",
    "Lifecycle state": "AVAILABLE"
  },
  {
    "Name": "hostname_uk_ref_02",
    "ipv4 cidr block": "10.253.20.0/24",
    "ipv6 cidr block": "2603:c020:c007:9f20::/64",
    "OCID": "ocid1.subnet.oc1..OCID",
    "VCN name": "hostname_uk_ref",
    "VCN ocid": "ocid1.vcn.oc1..OCID",
    "Public": true,
    "Public ingress": true,
    "DNS label": "gtijskenukref02",
    "Domain name": "gtijskenukref02.gtijskenukref.oraclevcn.com",
    "Lifecycle state": "AVAILABLE"
  },
  {
    "Name": "hostname_uk_ref_01",
    "ipv4 cidr block": "10.253.10.0/24",
    "ipv6 cidr block": "2603:c020:c007:9f10::/64",
    "OCID": "ocid1.subnet.oc1..OCID",
    "VCN name": "hostname_uk_ref",
    "VCN ocid": "ocid1.vcn.oc1..OCID",
    "Public": true,
    "Public ingress": true,
    "DNS label": "gtijskenukref01",
    "Domain name": "gtijskenukref01.gtijskenukref.oraclevcn.com",
    "Lifecycle state": "AVAILABLE"
  },
]

Dettagli opzioni

Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.

oci-network-config show-subnets Dettagli opzione

Opzione

descrizione

--ocid OCID

Mostra informazioni sulla subnet che corrisponde all'OCID (Oracle Cloud Identifier) specificato.

--name name

Mostra informazioni sulla subnet associata al nome specificato.

oci-network-inspector

La utility oci-network inspector visualizza un report di rete dettagliato per un compartimento o una rete specifici configurati per l'istanza.

Utilizzo

oci-network-inspector [-C | --compartment OCID] [-N | --vcn OCID] [-h | --help]

Visualizzazione di un report dettagliato per una VCN specifica

Per visualizzare un report dettagliato per una VCN specifica, eseguire la utility oci-network-inspector e utilizzare l'opzione -N per specificare l'OCID VCN:

sudo oci-network-inspector -N OCID

Ad esempio:

$ sudo oci-network-inspector -N ocid1.compartment.oc1..OCID

Compartment: KVM_workspace (ocid1.compartment.oc1..OCID)

  vcn  : uk_02 (ocid1.vcn.oc1..OCID)
    Security List: Default Security List for uk_02
      Ingress: tcp              0.0.0.0/0:-                       ---:22
      Ingress: icmp             0.0.0.0/0:-                    code-4:type-3
      Ingress: icmp           10.2.0.0/16:-                 code-None:type-3
      Ingress: tcp                   ::/0:-                       ---:22
      Ingress: 58                    ::/0:-                       ---:-
      Egress : all                    ---:-                 0.0.0.0/0:-
      Egress : all                    ---:-                      ::/0:-

    Subnet  : uk02_02 (ocid1.subnet.oc1..OCID)
      ipv4 cidr block : 10.2.20.0/24
      ipv6 cidr block : 2603:c020:c003:3a20::/64
      DNS domain name : gtijskenuk0202.gtijskenuk02.oraclevcn.com
       Security List: Default Security List for uk_02
         Ingress: tcp              0.0.0.0/0:-                       ---:22
         Ingress: icmp             0.0.0.0/0:-                    code-4:type-3
         Ingress: icmp           10.2.0.0/16:-                 code-None:type-3
         Ingress: tcp                   ::/0:-                       ---:22
         Ingress: 58                    ::/0:-                       ---:-
         Egress : all                    ---:-                 0.0.0.0/0:-
         Egress : all                    ---:-                      ::/0:-

      Private IP      : 10.2.20.42(primary)  Host: gtijsken-amd-kvm-lon-flex3-vnicb752
        Vnic            : ocid1.vnic.oc1..OCID (AVAILABLE-ATTACHED)
        Vnic PublicIP   : None
        Instance        : amd_kvm_lon_flex3
          Instance State  : RUNNING
          Instance ocid   : ocid1.instance.oc1..OCID

      ...

Visualizzazione di un report dettagliato per un compartimento specifico

Per visualizzare un report di rete dettagliato per un compartimento specifico, eseguire la utility oci-network-inspector e utilizzare l'opzione -C per specificare un OCID compartimento:

sudo oci-network-inspector -C OCID

Ad esempio:

$ sudo oci-network-inspector -C ocid1.compartment.oc1..OCID

Compartment: scottb_sandbox (ocid1.compartment.oc1..OCID)

  vcn: scottb_vcn
    Security List: Default Security List for scottb_vcn
      Ingress: tcp              0.0.0.0/0:-                       ---:22
      Ingress: icmp             0.0.0.0/0:-                    code-4:type-3
      Ingress: icmp           10.0.0.0/16:-                 code-None:type-3
      Ingress: tcp              0.0.0.0/0:80                      ---:80
      Ingress: tcp              0.0.0.0/0:43                      ---:43
      Ingress: tcp              0.0.0.0/0:-                       ---:-
      Egress : all                    ---:-                 0.0.0.0/0:-

     Subnet: Public Subnet cumS:PHX-AD-3 Avalibility domain: cumS:PHX-AD-3
         Cidr_block: 10.0.2.0/24 Domain name: sub99999999999.scottbvcn.oraclevcn.com
       Security List: Default Security List for scottb_vcn
         Ingress: tcp              0.0.0.0/0:-                       ---:22
         Ingress: icmp             0.0.0.0/0:-                    code-4:type-3
         Ingress: icmp           10.0.0.0/16:-                 code-None:type-3
         Ingress: tcp              0.0.0.0/0:80                      ---:80
         Ingress: tcp              0.0.0.0/0:43                      ---:43
         Ingress: tcp              0.0.0.0/0:-                       ---:-
         Egress : all                    ---:-                 0.0.0.0/0:-

     ...

Per informazioni sull'opzione della utility oci-network-inspector, vedere Opzioni comuni della utility OCI.

oci-notifica

La utility oci-notify invia un messaggio a un argomento del servizio di notifiche. È necessario eseguire questa utility come utente root.

Un messaggio è composto da un'intestazione (titolo) e un file di messaggio. La configurazione del servizio Notifiche per l'argomento determina dove e come vengono consegnati i messaggi. Gli argomenti vengono configurati utilizzando la console, l'API o l'interfaccia CLI di Oracle Cloud Infrastructure (OCI).

Per ulteriori informazioni sul servizio Notifiche, incluse le modalità di creazione degli argomenti, vedere Panoramica sulle notifiche.

Utilizzo

oci-notify [subcommand] [-h | --help]

Comandi secondari

La utility oci-notify dispone dei comandi secondari seguenti.

Comandi secondari utility oci-notify

Comando secondario

Per ulteriori informazioni vedere...

config

Configurazione di un argomento del servizio notifiche in un'istanza

message

Pubblicazione di un messaggio in un argomento

Per informazioni sull'opzione della utility oci-notify, vedere Opzioni comuni della utility OCI.

Configurazione di un argomento del servizio notifiche in un'istanza

Utilizzare il comando secondario oci-notify config per scrivere l'OCID dell'argomento del servizio Notifiche nel file oci.conf. Dopo la configurazione, è possibile pubblicare i messaggi in questo argomento configurato.

Per impostazione predefinita, il percorso del file di configurazione è /etc/oci-utils/oci.conf. È possibile sostituire il percorso del file di configurazione utilizzando la variabile di ambiente OCI_CONFIG_DIR.

Uso

oci-notify config notifications_topic_OCID [-h | --help]

Per scrivere l'OCID di un argomento del servizio Notifiche configurato nel file oci.conf, utilizzare il comando secondario oci-notify config e specificare l'OCID dell'argomento del servizio Notifiche.

Ad esempio:

$ sudo oci-notify config ocid1.onstopic.oc1..OCID

Per informazioni sull'opzione della utility oci-notify-config, vedere Opzioni comuni della utility OCI.

Pubblicazione di un messaggio in un argomento

Il comando secondario oci-notify message consente di pubblicare il contenuto di un file o di una stringa di testo con il titolo specificato nell'argomento configurato.

Nota: quando il messaggio viene pubblicato, la utility oci-notify antepone il nome dell'istanza all'oggetto del messaggio. Ad esempio: instance_name:log messages

Uso

oci-notify message [-t | --title 'message_title'] [-f | --file message_file] [-h | --help]

Per inviare il contenuto del file /var/log/messages con il titolo 'logging messages' all'argomento configurato, utilizzare le opzioni --title e --file con il comando secondario oci-notify-message.

Ad esempio:

$ sudo oci-notify message --title 'logging messages' --file /var/log/messages

Per inviare una stringa di testo all'argomento configurato, immettere una riga di testo tra apici per il valore dell'opzione --file.

Ad esempio:

$ sudo oci-notify message --title 'sending a text' --file 'Today is a beautiful day'

Dettagli opzioni

Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.

Dettagli opzione oci-notify-message

Opzione

descrizione

-t | --title message_title

Specificare il titolo da utilizzare nell'intestazione del messaggio (ad esempio, 'log messages' se si inviano file di log). Il valore message_title deve essere racchiuso tra virgolette singole o doppie. Le intestazioni dei messaggi vengono troncate a 128 caratteri.

-f | --file message_file

Specificare il percorso completo o relativo della directory, l'URL HTTP o FTP del file di messaggio o la stringa di testo da inviare. I file più grandi vengono suddivisi in blocchi da 64 KB e inviati come messaggi separati. Il numero di chunk è limitato a 10.

Se il valore message_file specificato non viene riconosciuto come URL o il percorso della directory non esiste, il testo immesso per message_file viene inviato come stringa di testo. La lunghezza massima per le stringhe di testo è di 128 caratteri.

oci-public-ip

Utilizzare la utility oci-public-ip per visualizzare l'indirizzo IP pubblico dell'istanza di computazione corrente, in formato leggibile o JSON.

La utility oci-public-ip utilizza l'SDK Oracle Cloud Infrastructure (OCI) per trovare l'indirizzo IP (vedere Software Development Kits and Command Line Interface). Se l'indirizzo IP non può essere ottenuto con questo metodo, l'utility oci-public-ip prova quindi il protocollo Session Traversal Utilities for NAT (STUN) come ultima risorsa per trovare l'indirizzo IP. Per ulteriori informazioni su STUN, consultare l'articolo su STUN Wikepedia.

Utilizzo

oci-public-ip [-h | --human-readable] [-j | --json] [-g | --get] [-a | --all] [-s | --sourceip source_IP] [-S | --stun-server STUN_server] [-L | --list-servers] [--instance-id OCID] [--help]

Visualizzazione dell'indirizzo IP dell'istanza corrente

Eseguire il comando oci-public-ip senza opzioni per restituire l'indirizzo IP dell'istanza corrente:

sudo oci-public-ip

Ad esempio:

$ sudo oci-public-ip
Public IP address: 203.0.113.2

Visualizzazione dell'indirizzo IP di un'altra istanza

Per visualizzare l'indirizzo IP pubblico di un'altra istanza diversa dall'istanza corrente, utilizzare la utility oci-public-ip con l'opzione --instance-id.

Nota

Questa opzione richiede l'installazione e la configurazione dell'SDK OCI per Python. Per ulteriori informazioni, vedere Software Development Kits and Command Line Interface.
sudo oci-public-ip --instance-id OCID

Ad esempio:

$ sudo oci-public-ip --instance-id ocid1.instance.oc1.phx.OCID
Public IP address: 203.0.113.2

Visualizzazione di una lista di server STUN

Per visualizzare un elenco dei server STUN, utilizzare la utility oci-public-ip con l'opzione --list-servers.

sudo oci-public-ip --list-servers

Ad esempio:

$ sudo oci-public-ip --list-servers
stun.stunprotocol.org
stun.counterpath.net
stun.voxgratia.org
stun.callwithus.com
stun.ekiga.net
stun.ideasip.com
stun.voipbuster.com
stun.voiparound.com
stun.voipstunt.com

Dettagli opzioni

Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.

Opzioni utility oci-public-ip

Opzione

descrizione

-g | get

Stampa solo l'indirizzo IP.

--instance-id OCID

Visualizza l'indirizzo IP pubblico dell'istanza specificata anziché quello corrente. Richiede l'SDK OCI per Python da installare e configurare.

-L | --list-servers

Stampa un elenco dei server e delle uscite STUN noti.

-s | --sourceip source_IP

Specifica l'indirizzo IP di origine da utilizzare.

-S | --stun-server STUN_server

Specifica il server STUN da utilizzare.

dati volume oci

Utilizzare la utility oci-volume-data per visualizzare i dati relativi a un volume iSCSI specifico collegato a un'istanza di computazione basata su Oracle Linux.

La utility oci-volume-data richiede l'opzione -k (chiave) per visualizzare i dati di un volume iSCSI specifico. I valori dell'opzione chiave possono essere il nome visualizzato, l'OCID o iqn (nome qualificato iSCSI) del volume.

Uso

oci-volume-data [-h | --help] [-k KEY | --key KEY] [-p | --par {name, iqn, ocid, portal, chap, attachestate, avdomain, compartment, attached, size, state}] [-v | --value-only]

Visualizzazione di tutti i dati relativi a un volume iSCSI collegato

Per visualizzare tutti i dati relativi a un volume iSCSI collegato all'istanza di computazione:

sudo oci-volume-data -k OCID

Ad esempio:

$ sudo oci-volume-data -k OCID
             display name: name=oci1-iscsi-volume-1
                     ocid: ocid1.volume.oc1.OCID
                      iqn: iqn.2122-45.com.oracleiaas:IQN
                portal ip: 123.245.6.7
              portal port: 1234
                chap user: None
            chap password: None
      availability domain: DSdu:US-EAST-DOMAIN
              compartment: comparment1
           compartment id: ocid1.compartment.OCID
              attached to: oci-utils-instance
         attachment state: --
                     size: 70GB
                    state: AVAILABLE

Visualizzazione di dati specifici su un volume iSCSI collegato

Se si desidera, utilizzare le opzioni -k, -p e -v (solo valore) con la utility oci-volume-data per limitare l'elemento da visualizzare per il volume iSCSI.

oci-volume-data -k OCID -p size -v

Ad esempio, per visualizzare solo le dimensioni di un volume iSCSI, in questo caso 70 GB:

$ oci-volume-data -k ocid1.volume.OCID -p size -v
70GB

Per ulteriori informazioni sui valori delle opzioni supportate (ad esempio, dimensione, stato, compartimento e così via), vedere la pagina man per oci-volume-data. Per informazioni sull'accesso alle pagine man della utility OCI, vedere Opzioni comuni della utility OCI.

Dettagli opzioni

Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.

Opzioni utility oci-volume-data

Opzione

descrizione

-k KEY | --key KEY

obbligatorio. La chiave per identificare il volume. Il valore KEY può essere l'OCID, l'IQN o il nome visualizzato del volume.

-p | --par

Specifica l'indirizzo IP di origine da utilizzare.

-v | --value-only

Mostrare solo i valori nell'output.

Riepilogo delle utility OCI

Riepilogo dei componenti delle utility OCI.

Nome descrizione
ocid Componente del servizio di oci-utils, che viene eseguito come daemon avviato da systemd. Questo servizio esegue la scansione delle modifiche nelle configurazioni dei dispositivi iSCSI e VNIC e inserisce 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 radice dell'istanza alla dimensione configurata.
oci-image-expand Converte l'istanza Oracle Linux Minimal per aggiungere servizi e pacchetti di un'immagine della piattaforma Oracle Linux standard.
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 viene specificata alcuna opzione 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 tutti i metadati personalizzati forniti, 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, 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 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 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 la modalità di esecuzione di un task di utility.

La tabella riportata di seguito elenca le opzioni e i relativi valori supportati, comuni tra le utility OCI.

Opzione descrizione
--help Visualizza le informazioni della Guida relative alla 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à di utility OCI disponibili.

  • json: visualizza l'output in formato JSON.
  • human-readable: visualizza l'output in formato leggibile dall'utente.
  • parsable: visualizza l'output in un formato analizzabile.
  • table: visualizza l'output in una tabella.
  • text: visualizza l'output testuale.

--no-truncate

Non accorcia i valori nell'output visualizzato.

--truncate

Riduce i valori nell'output visualizzato.

-y| --yes

Risposte "sì" a tutti i prompt.

-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