Referencia de utilidades de OCI

Obtenga más información sobre cada utilidad, incluida una descripción, los ejemplos de uso y las opciones.

Volúmenes
Redes
Información de configuración
Notificaciones
Expansión de la imagen mínima

También puede ver la opción de la utilidad OCI y la información detallada accediendo a las páginas del comando man de la utilidad OCI. Para obtener información sobre cómo acceder a las páginas del comando man de la utilidad OCI, consulte Opciones comunes de la utilidad OCI.

Utilidades

oci-compartmentid

Utilice la utilidad oci-compartmentid para mostrar el identificador de Oracle Cloud (OCID) del compartimento en el que se ejecuta la instancia.

Sintaxis

oci-compartmentid [-h | --help]

Para ver el OCID del compartimento de la instancia:

sudo oci-compartmentid

Por ejemplo:

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

Para obtener información sobre la opción de la utilidad oci-compartmentid, consulte Opciones comunes de la utilidad OCI.

oci-growfs

Si amplía el volumen de inicio de una instancia basada en Oracle Cloud Infrastructure (OCI) Linux, puede utilizar la utilidad oci-growfs para ampliar la partición raíz de la instancia. Esto le permite utilizar por completo el volumen de inicio recién ampliado.

Nota

Solo se admiten los sistemas de archivos XFS y ext4.

Por defecto, una instancia basada en Linux no utiliza automáticamente todo el volumen de inicio si el volumen de inicio es superior o igual a 50 GB. Si el volumen de inicio asociado a la instancia es inferior a 50 GB, no se realizan cambios en el sistema cuando se utiliza la utilidad oci-growfs.

Sintaxis

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

Ampliación de la partición raíz de una instancia

Para ampliar la partición raíz de la instancia:

  1. Utilice el comando lsblk para confirmar que el sistema operativo ha identificado el nuevo tamaño del volumen de inicio.

    Por ejemplo:

    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
    

    Si el volumen de disco no tiene el tamaño esperado, ejecute los comandos para volver a explorar el volumen de inicio. Consulte Nueva exploración del disco para volúmenes asociados a Instancias Basadas en Linux.

  2. Ejecute la utilidad oci-growfs con la opción y para responder "yes" a todas las peticiones de datos.

    sudo /usr/libexec/oci-growfs -y

    Por ejemplo:

    $ 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.
    

Para obtener información sobre las opciones de la utilidad oci-growfs, consulte Opciones comunes de la utilidad OCI.

oci-imagen-expandir

Use la utilidad oci-image-expand para convertir la instancia mínima de Oracle Linux a fin de agregar servicios y paquetes de una imagen de plataforma estándar de Oracle Linux. Con esta utilidad, la instancia mínima puede restaurar casi la misma funcionalidad que una imagen de plataforma estándar de Oracle Linux.

Para obtener información sobre la última imagen mínima de Oracle Linux, consulte Imágenes de Oracle Linux 9.x.

La utilidad oci-image-expand requiere privilegios de usuario root.

Requisito

Instale las utilidades de OCI en la instancia mínima. Para obtener más información, consulte Instalación de las herramientas de OCI.

Tipos de conversión

La utilidad oci-image-expand proporciona dos tipos de conversiones de instancias mínimas de Oracle Linux:

  • Valor por defecto: restaura los servicios systemd por defecto de la plataforma Oracle Linux, los paquetes de diagnóstico, los valores de configuración de la nube y configura y activa el intercambio en la instancia. La restauración de la funcionalidad de la plataforma por defecto no aumenta el tiempo de inicio de la instancia. Este tipo de conversión siempre se aplica mediante la utilidad oci-image-expand.

  • Reboot Required (Reinicio necesario): restaura la funcionalidad predeterminada de la plataforma Oracle Linux, como se describe en el tipo de conversión Default (Predeterminado), y restaura una o más de las siguientes funciones que puede seleccionar el usuario:
    • Activar SELinux: restaura el modo de aplicación SELinux.
    • Activar Kdump: agrega la capacidad kdump y la regeneración de kdump initramfs.
    • Activar Ksplice: instala Ksplice y activa el servicio Ksplice. Para obtener información, consulte Oracle Ksplice y la Guía del usuario de Oracle Linux Ksplice.
    La elección de cualquiera de estas funciones seleccionables aumenta el tiempo de inicio de la instancia y requiere que se aplique un reinicio.
Nota

La ejecución de la utilidad oci-instance-expand afecta a la configuración configurada por el usuario en la instancia. Por ejemplo, la utilidad restaura cloud-init config a la configuración de imagen de plataforma de Oracle Linux por defecto, sobrescribiendo así los cambios de cloud-config configurados por el usuario. Además, si decide restaurar Ksplice, la utilidad vuelve a instalar el paquete oci-linux-config para que la nueva clave de acceso se almacene en el archivo de configuración adecuado. No ejecute la utilidad en instancias que no sean instancias mínimas.

Los archivos log de la utilidad oci-image-expand se encuentran en: /var/log/oci-image-expand.log

Sintaxis

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

Restauración de la funcionalidad de imagen de plataforma por defecto

Para restaurar la funcionalidad de imagen de plataforma de Oracle Linux por defecto en la instancia mínima de Oracle Linux:

Ejecute la utilidad oci-image-expand y pulse Intro en el indicador, sin realizar ninguna selección.

Por ejemplo:

$ /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

Restauración de la funcionalidad de imagen de plataforma necesaria para reiniciar

Para restaurar la funcionalidad de imagen de la plataforma Oracle Linux que requiere un reinicio de la instancia para que surta efecto:

  1. Ejecute la utilidad oci-image-expand.

    /usr/libexec/oci-image-expand
  2. En el indicador, realice una de las siguientes acciones y, a continuación, pulse Intro:

    • Introduzca cero para restaurar todas las funciones de la lista (SELinux, Kdump y Ksplice).
    • Introduzca un número único, entre uno y tres, para restaurar una de las funciones de la lista.
    • Introduzca dos números, entre uno y tres, para restaurar dos de las funciones de la lista.

    Por ejemplo, para restaurar la funcionalidad SELinux y Ksplice en la instancia mínima de Oracle Linux:

    $ /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

    Si cambia de opinión sobre una función que ha seleccionado, vuelva a escribir el número antes de pulsar Intro para anular la selección de la función. Si ya ha pulsado Intro, pulse Ctrl+C para cancelar la operación.

  3. En el indicador, escriba y para reiniciar la instancia.
    A reboot is required to enable and activate all restored services. 
    Do you wish to reboot now? (y/n)y

Para obtener información sobre la opción de la utilidad oci-image-expand, consulte Opciones comunes de la utilidad OCI.

oci-instanceid

Utilice la utilidad oci-instanceid para mostrar el identificador de Oracle Cloud (OCID) de la instancia.

Sintaxis

oci-instanceid [-h | --help]

Para ver el OCID de la instancia informática:

sudo oci-instanceid

Por ejemplo:

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

Para obtener información sobre la opción de la utilidad oci-instanceid, consulte Opciones comunes de la utilidad OCI.

oci-iscsi-config

Utilice la utilidad oci-iscsi-config para mostrar y configurar dispositivos iSCSI asociados a una instancia basada en Linux de Oracle Cloud Infrastructure (OCI). Cuando se ejecuta sin opciones de línea de comandos, oci-iscsi-config muestra los dispositivos que requieren atención.

Atención

Evite introducir información confidencial al asignar descripciones, etiquetas o nombres fáciles de explicar a las instancias de nube mediante la consola, la API o CLI.

Sintaxis

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

Subcomandos

La utilidad oci-iscsi-config tiene los siguientes subcomandos.

Subcomandos de la utilidad oci-iscsi-config

Subcomando

Para obtener más información, consulte...

show

Visualización de configuraciones de iSCSI

sync

Sincronización de un volumen

create

Creación y Asociación de un Nuevo Volumen

attach

Asociación de un volumen existente

detach

Desasociación de un volumen

destroy

Supresión de un volumen

Para obtener un video de formación que muestra cómo usar la utilidad oci-iscsi-config, consulte Uso de herramientas de OCI para administrar el almacenamiento iSCSI para instancias de la instancia de Oracle Cloud Infrastructure en Oracle Linux Training Station.

Para obtener información sobre la opción de la utilidad oci-iscsi-config, consulte Opciones comunes de la utilidad OCI.

Visualización de configuraciones de iSCSI

El subcomando oci-iscsi-config show muestra los dispositivos iSCSI y la información de iSCSI para la instancia. Este subcomando funciona con el daemon ocid para supervisar la creación y supresión de dispositivos mediante la consola, la CLI o la API, y detecta automáticamente esos cambios.

Si el daemon ocid no se está ejecutando, el subcomando necesita privilegios de usuario root.

Uso

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

Para mostrar una lista de todos los dispositivos asociados a la instancia:

  1. Ejecute el subcomando oci-iscsi-config show.

    sudo oci-iscsi-config show

    Por ejemplo:

    $ 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. Opcionalmente, utilice las opciones --details y --no-truncate con el subcomando oci-iscsi-config show para mostrar información más detallada que no se acorta en la salida:

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

    Por ejemplo:

    $ 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. Opcionalmente, cambie la presentación de salida para que sea más legible mediante la opción --output-mode con el subcomando oci-iscsi-config show:

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

    Por ejemplo, para mostrar la presentación de salida en modo de texto:

    $ 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

Detalles de opción

En la siguiente tabla, se proporciona información detallada sobre las opciones específicas de esta utilidad o subcomando. Para obtener información sobre las opciones comunes utilizadas en las utilidades de OCI, consulte Opciones comunes de la utilidad de OCI.

oci-iscsi-config show Detalles de la opción

Opción

Descripción

-A | --all

Muestra todos los dispositivos iSCSI. Por defecto, solo aparecen los dispositivos que No están asociados a una instancia.

-C | --compartments name

Muestra dispositivos iSCSI en el compartimento o todos los compartimentos especificados (si se ha especificado all para name).

Creación y Asociación de un Nuevo Volumen

Utilice el subcomando oci-iscsi-config create para crear y asociar un volumen en bloque a una instancia. Este subcomando necesita que se instale y configure el SDK de OCI para Python. Para obtener más información sobre el SDK de OCI, consulte Software development kits e interfaz de línea de comandos.

Este subcomando requiere privilegios de usuario root.

Uso

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

Para crear y asociar un volumen, utilice la utilidad oci-iscsi-config create con las opciones -S, --volume-name y --attach-volume:

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

Por ejemplo, para crear y asociar un volumen de 70 GB de tamaño a la instancia, con el nombre de volumen 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

Detalles de opción

En la siguiente tabla, se proporciona información detallada sobre las opciones específicas de esta utilidad o subcomando. Para obtener información sobre las opciones comunes utilizadas en las utilidades de OCI, consulte Opciones comunes de la utilidad de OCI.

oci-iscsi-config create Detalles de la opción

Opción

Descripción

-v | --volume-name name

Define el nombre mostrado para el volumen. Evite introducir información confidencial para el nombre mostrado.

-c | --chap

Aplica el dispositivo al indicador Requerir credenciales de CHAP.

Asociación de un volumen existente

Utilice el subcomando oci-iscsi-config attach para asociar un volumen en bloque existente a la instancia y hacer que el volumen esté disponible para el sistema. El SDK de OCI para Python es necesario para seleccionar volúmenes mediante su OCID. Para obtener más información sobre el SDK de OCI, consulte Software development kits e interfaz de línea de comandos.

Este subcomando requiere privilegios de usuario root.

Nota

Al utilizar un IQN, el volumen ya debe estar asociado (asignado) a la instancia en la consola. Esta opción se puede utilizar para asociar varios dispositivos al mismo tiempo proporcionando una lista separada por comas de los IQN.

Uso

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

Para asociar un volumen en bloque específico a la instancia:

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

Detalles de opción

En la siguiente tabla, se proporciona información detallada sobre las opciones específicas de esta utilidad o subcomando. Para obtener información sobre las opciones comunes utilizadas en las utilidades de OCI, consulte Opciones comunes de la utilidad de OCI.

oci-iscsi-config attach Detalles de la opción

Opción

Descripción

-I | --iqns IQN

Una lista separada por comas de los nombres cualificados iSCSI (iqns) del dispositivo iSCSI, o dispositivos, que se deben conectar a la instancia.

-O | --ocids OCID

Lista separada por comas de los OCID del dispositivo iSCSI, o dispositivos, que se van a asociar a la instancia.

-u | --username name

Utilice el nombre de usuario especificado como nombre de usuario de CHAP cuando sea necesaria la autenticación para asociar un dispositivo. Esta opción no es necesaria cuando el SDK de OCI para Python está disponible.

-p | --password password

Utilice la contraseña proporcionada como contraseña de CHAP cuando sea necesaria la autenticación para asociar un dispositivo. Este argumento no es necesario cuando el SDK de OCI para Python está disponible.

-c | --chap

Asocie el dispositivo al indicador Requerir credenciales de CHAP.

Sincronización de un volumen

Utilice el subcomando oci-iscsi-config sync para asociar los dispositivos de bloque disponibles a la instancia y realizar operaciones de sincronización. El subcomando requiere privilegios de usuario root.

Uso

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

Para asociar dispositivos de bloque disponibles a la instancia y sincronizar los cambios con OCI, utilice el subcomando oci-iscsi-config sync con la opción --apply:

sudo oci-iscsi-config sync --apply

Por ejemplo:

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

Detalles de opción

En la siguiente tabla, se proporciona información detallada sobre las opciones específicas de esta utilidad o subcomando. Para obtener información sobre las opciones comunes utilizadas en las utilidades de OCI, consulte Opciones comunes de la utilidad de OCI.

oci-iscsi-config sync Detalles de opción

Opción

Descripción

-a | --apply

Realice operaciones de sincronización.

Desasociación de un volumen

Utilice el subcomando oci-iscsi-config detach para desasociar un dispositivo con el IQN determinado (un ID único asignado a un dispositivo). Si el volumen (o cualquier partición del volumen) está montado, esta opción intenta desmontarlo primero.

Este subcomando requiere privilegios de usuario root.

Nota

Puede desasociar varios dispositivos al mismo tiempo proporcionando una lista separada por comas de IQN.

Uso

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

Para desasociar un dispositivo específico de la instancia, utilice el subcomando oci-iscsi-config detach con la opción -I:

sudo oci-iscsi-config detach -I IQN

Por ejemplo:

$ 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']

Para ver el IQN u OCID del volumen que desea desasociar, utilice el subcomando oci-iscsi-config show. Para obtener información, consulte Displaying iSCSI Configurations.

Detalles de opción

En la siguiente tabla, se proporciona información detallada sobre las opciones específicas de esta utilidad o subcomando. Para obtener información sobre las opciones comunes utilizadas en las utilidades de OCI, consulte Opciones comunes de la utilidad de OCI.

Detalles de opción de desasociación de oci-iscsi-config

Opción

Descripción

-f | --force

Continúe con la desconexión aunque el dispositivo no se pueda desmontar.

-I | --iqns IQN

Una lista separada por comas de los nombres cualificados iSCSI (iqns) del dispositivo iSCSI, o dispositivos, que se desasociarán de la instancia.

Supresión de un volumen

Para suprimir un volumen de almacenamiento de bloques con el OCID proporcionado, utilice el subcomando oci-iscsi-config destroy.

Nota

Puede suprimir varios dispositivos al mismo tiempo proporcionando una lista de OCID separados por comas.

Uso

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

Para suprimir un volumen en bloque específico de la instancia, utilice el subcomando oci-iscsi-config-destroy con la opción -O:

sudo oci-iscsi-config destroy -O OCID

Por ejemplo:

$ 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

Puede ver el OCID del volumen mediante el subcomando de la utilidad oci-iscsi-config show. Para obtener información, consulte Displaying iSCSI Configurations.

Detalles de opción

En la siguiente tabla, se proporciona información detallada sobre las opciones específicas de esta utilidad o subcomando. Para obtener información sobre las opciones comunes utilizadas en las utilidades de OCI, consulte Opciones comunes de la utilidad de OCI.

oci-iscsi-config destroy Detalles de la opción

Opción

Descripción

-O | --ocids OCID

Lista separada por comas de los OCID de volumen en bloque que se van a suprimir.

oci-metadata

Utilice la utilidad oci-metadata para mostrar o definir metadatos para una instancia informática basada en Oracle Linux. Cuando se ejecuta sin opciones de línea de comandos, oci-metadata muestra todos los metadatos disponibles.

Para obtener más información sobre los metadatos de la instancia, consulte Obtención de metadatos de instancia.

Sintaxis

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

Obtención de todos los metadatos de la instancia

Para ver todos los metadatos de la instancia, ejecute la utilidad oci-metadata sin opciones:

sudo oci-metadata

Por ejemplo:

$ 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

Obtención de metadatos específicos para la instancia

Para ver los metadatos de instancia para una clave especificada, utilice la opción --get con la utilidad oci-metadata:

sudo oci-metadata --get key

Por ejemplo, para ver solo el estado de la instancia informática:

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

Detalles de opción

En la siguiente tabla, se proporciona información detallada sobre las opciones específicas de esta utilidad o subcomando. Para obtener información sobre las opciones comunes utilizadas en las utilidades de OCI, consulte Opciones comunes de la utilidad de OCI.

Detalles de opción de oci-metadata

Opción

Descripción

-g key | --get key

Recupere los datos solo para la clave especificada. Las claves de metadatos de una instancia las puede definir Compute o puede crear claves personalizadas. Para obtener más información, consulte Claves de Metadatos.

--export

Si se utiliza con la opción -g o --get, muestre un comando de shell para exportar la clave como una variable de entorno.

--trim

Se utiliza con la opción -g o --get, ajuste la ruta de la clave al último componente, para que la salida sea más corta. Por ejemplo: de instance/metadata/ssh_authorized_keys a ssh_authorized_keys. Si la clave coincide con varias claves, solo se muestra la primera clave coincidente.

--value-only

Si se utiliza con la opción -g o --get, muestre solo los valores que coinciden con la clave get.

-u key_value

Actualice el valor de la clave (o claves) específica. Para key_value, especifique una cadena, un valor JSON o un puntero a un archivo con contenido JSON con el siguiente formato: key=file:/path/to/file

-i | --instance-id OCID

Obtiene o actualiza los metadatos de la instancia con el OCID específico. Por defecto, oci-metadata funciona con los metadatos de la instancia a la que se ha conectado.

oci-network-config

La utilidad oci-network-config permite configurar interfaces de red para la instancia. Esta utilidad se debe ejecutar como raíz.

La utilidad oci-network-config muestra las Tarjetas de interfaz de red virtuales (VNIC) actuales aprovisionadas en Oracle Cloud Infrastructure (OCI) y configuradas para esta instancia. Cuando se aprovisiona una VNIC secundaria en OCI, se debe configurar explícitamente en la instancia mediante la utilidad oci-network-config.

Las interfaces de red que se están configurando se pueden colocar dentro de espacios de nombre de red separados. Esta separación es necesaria cuando las VNIC están en subredes (VCNs diferentes) con bloques de direcciones superpuestos y las aplicaciones de red no están enlazadas directamente a las interfaces. Los espacios de nombres de red requieren que las aplicaciones se inicien en los espacios de nombres explícitamente (con el comando ip netns exec ns) para establecer una asociación con la interfaz. Si no se utilizan espacios del nombre, el enrutamiento basado en políticas se configura para proporcionar una ruta por defecto al enrutador virtual de la VNIC secundaria (gateway por defecto) cuando la dirección de la VNIC es de origen.

Las VNIC secundarias con hardware dedicado se configuran mediante las VLAN (cuando no hay una interfaz física correspondiente). Estas VNIC aparecen como dos interfaces adicionales al mostrar enlaces IP, con nombres en MACVLAN_FORMAT para la VLAN MAC y VLAN_FORMAT para la VLAN IP.

Sintaxis

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

Subcomandos

La utilidad oci-network-config tiene los siguientes subcomandos.

Para un video de formación que muestra cómo usar la utilidad oci-network-config, consulte Gestión de la interfaz del red mediante utilidades Oracle Linux en instancias en Oracle Linux Training Station.

Para obtener información sobre las opciones de la utilidad oci-network-config, consulte Opciones comunes de la utilidad OCI.

Visualización de la configuración actual de la red

El subcomando oci-network-config show muestra información sobre las VNIC configuradas en la instancia. Puede ver la configuración de red actual, como las VNIC aprovisionadas y las configuraciones de IP actuales de la instancia. Las VNIC que todavía no se han configurado se marcan con ADD y los valores de IP que ya no tienen una VNIC asociada se marcan con DELETE.

La salida de este comando es la acción por defecto si la utilidad oci-network-config se introduce sin ninguna opción.

Uso

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

Para mostrar la configuración de red actual:

sudo oci-network-config show

Por ejemplo:

$ 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  

Para configurar VNIC que aún no se han configurado (con la etiqueta ADD) y suprimir direcciones IP que no tengan ninguna VNIC asociada, utilice el subcomando oci-network-config config. Para obtener más información, consulte Configuración de VNIC.

Detalles de opción

En la siguiente tabla, se proporciona información detallada sobre las opciones específicas de esta utilidad o subcomando. Para obtener información sobre las opciones comunes utilizadas en las utilidades de OCI, consulte Opciones comunes de la utilidad de OCI.

oci-network-config show Detalles de la opción

Opción

Descripción

-I | --include item

Incluya una dirección IP o una interfaz de VLAN que se haya excluido previamente mediante la opción --exclude en la configuración/anulación de configuración automática. Para item, puede especificar un OCID de VNIC, una dirección IP o un nombre de interfaz de VLAN.

-X | --exclude item

Excluya de forma persistente una dirección IP o una interfaz de VLAN de la configuración/anulación de configuración automática. Para item, puede especificar un OCID de VNIC, una dirección IP o un nombre de interfaz de VLAN. Utilice la opción --include para volver a incluir la dirección IP o la interfaz de VLAN.

Creación y asociación de una VNIC

Utilice el subcomando oci-network-config attach-vnic para crear y conectar una VNIC a una instancia. Puede asignar una dirección IP pública o privada a la nueva VNIC con este subcomando.

Importante

La asociación de una VNIC con una dirección IPv6 principal no está soportada por 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]

Para crear una VNIC y conectar la VNIC a una instancia, utilice el subcomando oci-network-config attach-vnic con la opción -n:

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

Por ejemplo, para crear una VNIC denominada ex-demo-inst-10 y conectar la VNIC a la instancia:

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

Detalles de opción

En la siguiente tabla, se proporciona información detallada sobre las opciones específicas de esta utilidad o subcomando. Para obtener información sobre las opciones comunes utilizadas en las utilidades de OCI, consulte Opciones comunes de la utilidad de OCI.

Detalles de la opción attach-vnic de oci-network-config

Opción

Descripción

-I | --ip-address ip_address

Asigne la dirección IP privada proporcionada a la VNIC. Si esta opción no se utiliza, se asigna automáticamente una dirección IP que no se utiliza de la subred a la VNIC.

-ipv4 | --ipv4

Asigne una dirección IPv4 a la VNIC. Si se utiliza la opción --ipv4, se asigna una dirección IPv4 no utilizada de la subred a la VNIC. Si se especifica la opción --ip-address con esta opción, se ignoran las opciones --ipv4 y --ipv6.

-ipv6 | --ipv6

Asigne una dirección IPv6 a la VNIC. Si se utiliza la opción --ipv6, se asigna una dirección IPv6 no utilizada de la subred a la VNIC. Si utiliza la opción --ip-address en su lugar, se ignoran las opciones --ipv4 y --ipv6.

Importante: OCI no soporta la asociación de una VNIC con una dirección IPv6 principal.

El siguiente mensaje se muestra al ejecutar oci-network-config attach-vnic con la opción --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

Asigne la VNIC a la tarjeta NIC física especificada. Para index, especifique el número de índice asignado a la tarjeta NIC física. El valor por defecto es 0. Esta opción solo se utiliza para instancias con hardware dedicado.

--subnet subnet

Conecte la VNIC a la subred proporcionada. Para subnet, especifique un OCID o una expresión normal que coincida con el nombre mostrado de todas las subredes disponibles. Cuando se utiliza --ip-address, la subred se infiere de la dirección IP o se define por defecto en la subred de la VNIC principal.

-n | --name name

Defina el nombre mostrado de la VNIC. Evite introducir información confidencial.

--assign-public-ip

Asigne una dirección IP pública a la VNIC. Por defecto, solo se asigna una dirección IP privada.

Configuración de VNIC

El subcomando oci-network-config configure agrega la configuración IP para VNIC que no se han configurado y suprime la configuración IP de las VNIC que ya no están aprovisionadas. Este comando sincroniza la configuración de IP de la instancia con el aprovisionamiento de OCI actual.

Uso

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

Para configurar todas las VNIC de la instancia:

sudo oci-network-config configure

Por ejemplo:

$ sudo oci-network-config configure
Configured 

Para configurar las VNIC en la instancia, excepto para una VNIC específica, utilice el subcomando oci-network-config configure con la opción -X:

sudo oci-network-config configure -X VNIC_OCID

Por ejemplo:

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

Puede confirmar que las VNIC están configuradas ejecutando el subcomando oci-network-config show. Después de la configuración, no se mostrará ninguna etiqueta ADD ni DELETE en la salida, a menos que haya decidido excluir una VNIC de la configuración. Para obtener más información, consulte Displaying the Current Network Configuration.

Detalles de opción

En la siguiente tabla, se proporciona información detallada sobre las opciones específicas de esta utilidad o subcomando. Para obtener información sobre las opciones comunes utilizadas en las utilidades de OCI, consulte Opciones comunes de la utilidad de OCI.

oci-network-config configure Detalles de opción

Opción

Descripción

-n | --namespace format

Al realizar la configuración, coloque la interfaz en los espacios de nombres identificados por el formato proporcionado. El formato puede incluir las variables $nic y $vltag. El nombre se define por defecto en DEF_NS_FORMAT_BM para las BM y en DEF_NS_FORMAT_VM para las VM. Al configurar varias VNIC, asegúrese de que los espacios de nombres sean únicos.

-r | --start-sshd

Iniciar sshd en el espacio de nombres (si -n está presente).

-I | --include item

Incluya una dirección IP o una interfaz de VLAN que se haya excluido previamente mediante la opción --exclude en la configuración/anulación de configuración automática. Para item, puede especificar un OCID de VNIC, una dirección IP o un nombre de interfaz de VLAN.

-X | --exclude item

Excluya de forma persistente una dirección IP o una interfaz de VLAN de la configuración/anulación de configuración automática. Para item, puede especificar un OCID de VNIC, una dirección IP o un nombre de interfaz de VLAN. Utilice la opción --include para volver a incluir la dirección IP o la interfaz de VLAN.

Visualización de VNIC configuradas

El subcomando oci-network-config show-vnics muestra información sobre las VNIC configuradas en la instancia.

Uso

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

Para mostrar información acerca de las VNIC configuradas en la instancia:

sudo oci-network-config show-vnics

Por ejemplo:

$ 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|

Detalles de opción

En la siguiente tabla, se proporciona información detallada sobre las opciones específicas de esta utilidad o subcomando. Para obtener información sobre las opciones comunes utilizadas en las utilidades de OCI, consulte Opciones comunes de la utilidad de OCI.

Detalles de opción de oci-network-config show-vnics

Opción

Descripción

--ocid OCID

Muestra información sobre la VNIC que coincide con el identificador de Oracle Cloud (OCID) proporcionado.

--name name

Muestra información sobre la VNIC asociada al nombre proporcionado.

--ip-address primary_IP

Muestra información sobre la VNIC asociada a la dirección IP principal proporcionada.

Visualización de todas las VNIC configuradas

Utilice el subcomando oci-network-config show-vnics-all para ver información detallada sobre todas las VNIC configuradas en esta instancia.

Uso

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

Para mostrar todas las VNIC configuradas en la instancia:

sudo oci-network-config show-vnics-all

Por ejemplo:

# 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    |      

Para obtener información sobre las opciones oci-network-config show-vnics-all, consulte Opciones comunes de la utilidad OCI.

Adición de una dirección secundaria

La utilidad oci-network-config add-secondary-addr se utiliza para agregar una dirección IP privada secundaria con la dirección IPv4 o IPv6 especificada a una VNIC existente.

Uso

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

Para agregar una dirección IP secundaria privada, en este caso una dirección IPv6, a una VNIC existente, utilice el subcomando oci-network-config add-secondary-addr con las opciones --ipv6 y --ocid:

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

Por ejemplo:

$ 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

Detalles de opción

En la siguiente tabla, se proporciona información detallada sobre las opciones específicas de esta utilidad o subcomando. Para obtener información sobre las opciones comunes utilizadas en las utilidades de OCI, consulte Opciones comunes de la utilidad de OCI.

Detalles de opción de add-secondary-addr de oci-network-config

Opción

Descripción

-ipv4 | --ipv4

Especifique que se agregue una dirección secundaria privada IPv4 a una VNIC existente. Esta opción es la opción por defecto si se introduce el comando sin ninguna opción.

-ipv6 | --ipv6

Especifique que se agregue una dirección secundaria privada IPv6 a una VNIC existente.

-I ip_address | --ip-address ip_address

Especifique la dirección IP privada secundaria que desea agregar a la VNIC.

-O | --ocid OCID

Asigna la dirección secundaria a la VNIC asociada al OCID específico.

Supresión de la configuración IP de la VNIC secundaria aprovisionada

Utilice el subcomando oci-network-config unconfigure para suprimir toda la configuración de IP para las VNIC secundarias aprovisionadas (excepto las explícitamente excluidas). No se puede suprimir la VNIC principal.

Uso

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

Para suprimir toda la configuración de IP para las VNIC secundarias aprovisionadas, utilice el subcomando oci-network-config unconfigure:

sudo oci-network-config unconfigure

Por ejemplo:

$ sudo oci-network-config unconfigure
Unconfigured 

Detalles de opción

En la siguiente tabla, se proporciona información detallada sobre las opciones específicas de esta utilidad o subcomando. Para obtener información sobre las opciones comunes utilizadas en las utilidades de OCI, consulte Opciones comunes de la utilidad de OCI.

Detalles de opción de desconfiguración de configuración de red de oci

Opción

Descripción

-I | --include item

Incluya una dirección IP o una interfaz de VLAN que se haya excluido previamente mediante la opción --exclude en la configuración/anulación de configuración automática. Para item, puede especificar un OCID de VNIC, una dirección IP o un nombre de interfaz de VLAN.

-X | --exclude item

Excluya de forma persistente item (dirección IP o interfaz de VLAN) de la configuración/anulación de configuración automática. Para item, puede especificar un OCID de VNIC, una dirección IP o un nombre de interfaz de VLAN. Utilice la opción --include para volver a incluir la dirección IP o la interfaz de VLAN.

Eliminación de una dirección IPv6 secundaria

Utilice el subcomando oci-network-config remove-secondary-addr para eliminar una dirección IP privada secundaria con la dirección IPv4 o IPv6 especificada de una VNIC existente.

Uso

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

Para eliminar una dirección IPv6 secundaria privada de una VNIC existente, utilice el subcomando oci-network-config remove-secondary-addr con la opción -I:

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

Por ejemplo, para eliminar la dirección IPv6 secundaria, 2603:c020:c003:3a10:b64c:8f35:7f9e:7e87, de una VNIC existente:

$ 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

Detalles de opción

En la siguiente tabla, se proporciona información detallada sobre las opciones específicas de esta utilidad o subcomando. Para obtener información sobre las opciones comunes utilizadas en las utilidades de OCI, consulte Opciones comunes de la utilidad de OCI.

Detalles de la opción oci-network-config remove-secondary-addr

Opción

Descripción

-I | --ip-address ip_address

Especifique la dirección IP privada secundaria que desea eliminar de la VNIC.

Desasociación de una VNIC

Utilice el subcomando oci-network-config detach-vnic para desasociar y suprimir la VNIC con el OCID o la dirección IP específicos de la instancia. Este subcomando se puede utilizar para eliminar la dirección IP asignada de un VNIC existente. Sin embargo, la VNIC primaria no se puede desconectar. También se suprimen todas las direcciones IP privadas secundarias asociadas a la VNIC.

Uso

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

Para desasociar una VNIC de la instancia, utilice el subcomando oci-network-config detach-vnic con la opción --ocid:

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

Por ejemplo, para desasociar una VNIC con un OCID de VNIC específico de la instancia:

$ 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.

Detalles de opción

En la siguiente tabla, se proporciona información detallada sobre las opciones específicas de esta utilidad o subcomando. Para obtener información sobre las opciones comunes utilizadas en las utilidades de OCI, consulte Opciones comunes de la utilidad de OCI.

Detalles de opción de oci-network-config detach-vnic

Opción

Descripción

-I | --ip-address ip_address

Desasocie la VNIC con la dirección IP proporcionada.

--ocid OCID

Desasocie la VNIC con el OCID proporcionado.

Visualización de la información de la VCN

El subcomando oci-network-config show-vcns muestra información de la red virtual en la nube (VCN) en el compartimento donde reside la instancia.

Uso

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

Para mostrar información detallada de VCN con el formato de salida de texto, utilice el subcomando oci-network-config show-vcns con las opciones --details y --output-mode text:

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

Por ejemplo:

$ 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

Detalles de opción

En la siguiente tabla, se proporciona información detallada sobre las opciones específicas de esta utilidad o subcomando. Para obtener información sobre las opciones comunes utilizadas en las utilidades de OCI, consulte Opciones comunes de la utilidad de OCI.

Detalles de opción de oci-network-config show-vcns

Opción

Descripción

--ocid OCID

Muestre la VCN con el OCID proporcionado.

--name name

Muestre la VCN con el nombre proporcionado.

Visualización de la información de la subred

El subcomando oci-network-config show-subnets muestra información de subred en el compartimento en el que reside esta instancia.

Uso

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

Para ver información detallada de la subred en formato de salida JSON, utilice el subcomando oci-network-config show-subnets con las opciones --details y --output-mode json:

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

Por ejemplo:

$ 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"
  },
]

Detalles de opción

En la siguiente tabla, se proporciona información detallada sobre las opciones específicas de esta utilidad o subcomando. Para obtener información sobre las opciones comunes utilizadas en las utilidades de OCI, consulte Opciones comunes de la utilidad de OCI.

oci-network-config show-subnets Detalles de la opción

Opción

Descripción

--ocid OCID

Muestre la información sobre la subred que coincide con el identificador de Oracle Cloud (OCID) proporcionado.

--name name

Muestre la información sobre la subred asociada al nombre proporcionado.

oci-network-inspector

La utilidad oci-network inspector muestra un informe de red detallado para un compartimento o red específicos configurados para la instancia.

Sintaxis

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

Visualización de un informe detallado de una VCN específica

Para mostrar un informe detallado para una VCN específica, ejecute la utilidad oci-network-inspector y utilice la opción -N para especificar el OCID de la VCN:

sudo oci-network-inspector -N OCID

Por ejemplo:

$ 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

      ...

Visualización de un informe detallado para un compartimento específico

Para ver un informe de red detallado para un compartimento específico, ejecute la utilidad oci-network-inspector y utilice la opción -C para especificar un OCID de compartimento:

sudo oci-network-inspector -C OCID

Por ejemplo:

$ 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:-

     ...

Para obtener información sobre la opción de la utilidad oci-network-inspector, consulte Opciones comunes de la utilidad OCI.

oci-notify

La utilidad oci-notify envía un mensaje a un tema de servicio Notifications. Esta utilidad se debe ejecutar como raíz.

Un mensaje está compuesto por una cabecera de mensaje (título) y un archivo. La configuración del servicio Notifications para el tema determina dónde y cómo se entregan los mensajes. Los temas se configuran mediante la consola, la API o CLI de la aplicación Oracle Cloud Infrastructure (OCI).

Para obtener más información sobre el servicio Notifications, y sobre cómo crear temas, consulte Visión general de Notifications.

Sintaxis

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

Subcomandos

La utilidad oci-notify tiene los siguientes subcomandos.

Subcomandos de utilidad oci-notify

Subcomando

Para obtener más información, consulte...

config

Configuración de un tema del servicio Notifications en una instancia

message

Publicación de un Mensaje en un Tema

Para obtener información sobre la opción de la utilidad oci-notify, consulte Opciones comunes de la utilidad OCI.

Configuración de un tema del servicio Notifications en una instancia

Utilice el subcomando oci-notify config para escribir el OCID del tema del servicio Notifications en el archivo oci.conf. Después de configurarlo, puede publicar mensajes para este tema configurado.

Por defecto, la ruta al archivo de configuración es /etc/oci-utils/oci.conf. Puede sustituir la ruta del archivo de configuración mediante la variable de entorno OCI_CONFIG_DIR.

Uso

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

Para escribir el OCID de un tema de servicio de notificaciones configurado en el archivo oci.conf, utilice el subcomando oci-notify config y especifique el OCID del tema de servicio de notificaciones.

Por ejemplo:

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

Para obtener información sobre la opción de la utilidad oci-notify-config, consulte Opciones comunes de la utilidad OCI.

Publicación de un Mensaje en un Tema

Con el subcomando oci-notify message, puede publicar el contenido de un archivo o una cadena de texto con el título especificado en el tema configurado.

Nota: Cuando se publica el mensaje, la utilidad oci-notify antepone el nombre de la instancia al asunto del mensaje. Por ejemplo: instance_name:log messages

Uso

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

Para enviar el contenido del archivo /var/log/messages con el título 'logging messages' al tema configurado, utilice las opciones --title y --file con el subcomando oci-notify-message.

Por ejemplo:

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

Para enviar una cadena de texto al tema configurado, introduzca una línea de texto entre comillas simples para el valor de la opción --file.

Por ejemplo:

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

Detalles de opción

En la siguiente tabla, se proporciona información detallada sobre las opciones específicas de esta utilidad o subcomando. Para obtener información sobre las opciones comunes utilizadas en las utilidades de OCI, consulte Opciones comunes de la utilidad de OCI.

Detalles de opción de oci-notify-message

Opción

Descripción

-t | --title message_title

Especifique el título que se utilizará en la cabecera del mensaje (por ejemplo, 'log messages' si envía archivos log). message_title debe estar entre comillas simples o dobles. Las cabeceras de mensaje se truncan en 128 caracteres.

-f | --file message_file

Especifique la ruta de directorio completa o relativa, el HTTP o el URL de FTP del archivo de mensaje o la cadena de texto que se va a enviar. Los archivos más grandes se dividen en fragmentos de 64 KB y se envían como mensajes independientes. El número de fragmentos está limitado a 10.

Si no se reconoce como una URL o la ruta del directorio la message_file especificada, el texto introducido para message_file se envía como una cadena de texto. Las cadenas de texto están limitadas a 128 caracteres.

oci-public-ip

Utilice la utilidad oci-public-ip para mostrar la dirección IP pública de la instancia informática actual, en formato legible por el usuario o JSON.

La utilidad oci-public-ip utiliza el SDK de Oracle Cloud Infrastructure (OCI) para detectar la dirección IP (consulte Software Development Kits e interfaz de línea de comandos). Si esto no permite obtener la dirección IP, la utilidad oci-public-ip prueba el protocolo Session Traversal Utilities for NAT (STUN) como último recurso para detectar la dirección IP. Para obtener más información acerca de STUN, consulte el artículo de STUN Wikepedia.

Sintaxis

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]

Visualización de la dirección IP de la instancia actual

Ejecute el comando oci-public-ip sin opciones para devolver la dirección IP de la instancia actual:

sudo oci-public-ip

Por ejemplo:

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

Visualización de la Dirección IP de Otra Instancia

Para ver la dirección IP pública de otra instancia que no sea la actual, utilice la utilidad oci-public-ip con la opción --instance-id.

Nota

Esta opción requiere que el SDK para Python de OCI esté instalado y configurado. Para obtener más información, consulte Software development kits e interfaz de línea de comandos.
sudo oci-public-ip --instance-id OCID

Por ejemplo:

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

Visualización de una lista de servidores STUN

Para mostrar una lista de servidores STUN, utilice la utilidad oci-public-ip con la opción --list-servers:

sudo oci-public-ip --list-servers

Por ejemplo:

$ 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

Detalles de opción

En la siguiente tabla, se proporciona información detallada sobre las opciones específicas de esta utilidad o subcomando. Para obtener información sobre las opciones comunes utilizadas en las utilidades de OCI, consulte Opciones comunes de la utilidad de OCI.

Opciones de la utilidad oci-public-ip

Opción

Descripción

-g | get

Imprima solo la dirección IP.

--instance-id OCID

Muestra la dirección IP pública de la instancia proporcionada en lugar de la actual. Necesita que el SDK para Python de OCI esté instalado y configurado.

-L | --list-servers

Imprima una lista de servidores STUN conocidos y salidas.

-s | --sourceip source_IP

Especifica la dirección IP de origen que se va a utilizar.

-S | --stun-server STUN_server

Especifica el servidor STUN que se debe utilizar.

oci-volume-data

Utilice la utilidad oci-volume-data para ver datos sobre un volumen iSCSI específico asociado a una instancia informática basada en Oracle Linux.

La utilidad oci-volume-data requiere la opción -k (clave) para mostrar los datos de un volumen iSCSI específico. Los valores de opción clave pueden ser el nombre mostrado, el OCID o el iqn (nombre cualificado de iSCSI) del volumen.

Sintaxis

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]

Visualización de todos los datos de un volumen iSCSI asociado

Para ver todos los datos sobre un volumen iSCSI asociado a la instancia informática:

sudo oci-volume-data -k OCID

Por ejemplo:

$ 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

Visualización de datos específicos sobre un volumen iSCSI asociado

Opcionalmente, utilice las opciones -k, -p y -v (solo valor) con la utilidad oci-volume-data para reducir lo que desea que se muestre para el volumen iSCSI:

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

Por ejemplo, para mostrar solo el tamaño de un volumen iSCSI, en este caso, 70 GB:

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

Para obtener más información sobre los valores de opción soportados (como tamaño, estado, compartimento, etc.), consulte la página del comando man para oci-volume-data. Para obtener información sobre cómo acceder a las páginas del comando man de la utilidad OCI, consulte Opciones comunes de la utilidad OCI.

Detalles de opción

En la siguiente tabla, se proporciona información detallada sobre las opciones específicas de esta utilidad o subcomando. Para obtener información sobre las opciones comunes utilizadas en las utilidades de OCI, consulte Opciones comunes de la utilidad de OCI.

Opciones de la utilidad oci-volume-data

Opción

Descripción

-k KEY | --key KEY

Necesario. La clave para identificar el volumen. El valor KEY puede ser el OCID, el IQN o el nombre mostrado del volumen.

-p | --par

Especifica la dirección IP de origen que se va a utilizar.

-v | --value-only

Mostrar solo los valores de la salida.