Utilidades de OCI

Las instancias que utilizan imágenes de plataforma de Oracle Linux incluyen un juego de utilidades (oci-utils) que permiten a la instancia acceder a información sobre los recursos de infraestructura. Estas utilidades constan de un componente de servicio y herramientas de línea de comandos que ayudan a detectar o aprovisionar recursos automáticamente.

Instalación de utilidades de OCI

Las instancias iniciadas con Oracle Linux 7 o posterior incluyen automáticamente el paquete de utilidades de Oracle Cloud Infrastructure (OCI) (oci-utils) instalado. Las utilidades no están disponibles en otras distribuciones.

Para utilizar las utilidades de OCI, debe cumplir los siguientes requisitos:

Asegúrese de que el repositorio oci_included esté activado. Este repositorio está activado por defecto en las imágenes de plataforma de Oracle Linux. Este repositorio contiene todas las dependencias de paquetes, incluidos los paquetes necesarios del SDK de OCI y Python. Todos los paquetes necesarios se instalan con el paquete oci-utils.
Asegúrese de que las utilidades de OCI tienen permisos suficientes para acceder a Oracle Cloud Infrastructure mediante una de las siguientes acciones:
- Cree el archivo de configuración de SDK para el host. Para obtener más información, consulte Archivo de configuración de SDK y CLI.
  Nota
  
  Puede que necesite instalar la CLI para su entorno antes de ejecutar el comando oci setup config para crear el archivo de configuración de SDK. Para obtener más información, consulte Instalación de la CLI.
- Utilice principales de instancia agregando la instancia a un grupo dinámico al que se le haya otorgado acceso a los servicios de Oracle Cloud Infrastructure. Para obtener más información, consulte Gestión de grupos dinámicos.
- Configure oci-utils para que root pueda utilizar los archivos de configuración de Oracle Cloud Infrastructure de un usuario sin privilegios. Para obtener más información, consulte el archivo de configuración ubicado en el directorio /etc/oci-utils.conf.d de la instancia.
Elija el método para acceder a las utilidades y realice los procedimientos de configuración para ese método, según sea necesario:
- CLI de OCI desde una instancia o host remoto: terminal de CLI conectado a una instancia o host remoto donde puede ejecutar las utilidades de OCI. Para obtener más información sobre la CLI y cómo empezar a utilizarla, consulte Interfaz de línea de comandos (CLI) e Inicio rápido de la CLI.
- OCI Software Development Kit (SDK): conjunto de herramientas de desarrollador que permiten escribir código y gestionar recursos de OCI. Para obtener más información, consulte Software development kits e interfaz de línea de comandos.

Para ver un vídeo sobre cómo instalar y configurar las utilidades de OCI, consulte Activación de las herramientas de OCI en Oracle Linux en instancias de Oracle Cloud Infrastructure en Oracle Linux Training Station.

Actualización de utilidades de OCI

Para actualizar a la última versión de oci-utils:

sudo yum update oci-utils

Uso del daemon ocid

El daemon ocid es el componente de servicio de oci-utils. Supervisa los cambios en la configuración de VNIC e iSCSI de la instancia e intenta asociar o desconectar automáticamente los dispositivos a medida que aparecen o desaparecen, por ejemplo, cuando se crean o suprimen con la consola, la CLI o la API de Oracle Cloud Infrastructure.

Para iniciar el daemon ocid mediante systemd y definir que el servicio ocid se inicie automáticamente durante el inicio del sistema:

sudo systemctl enable --now ocid.service

Para confirmar que el servicio está activo (en ejecución):

sudo service ocid status

Por ejemplo:

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

Referencia de utilidades de OCI

Para obtener más información, consulte la descripción, los ejemplos de uso y las opciones de cada utilidad.

Gestión de Volúmenes

Gestión de redes

Ver información de configuración

Configuración de notificaciones

oci-notify

Conversión de la imagen mínima de Oracle Linux

oci-image-expand

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.

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 de 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 completamente el volumen de inicio recién ampliado.

Nota

Solo están soportados los sistemas de archivos XFS y ext4.

Por defecto, una instancia basada en Linux no utiliza automáticamente el volumen de inicio completo si el volumen de inicio es mayor o igual que 50 GB. Si el volumen de inicio asociado a la instancia tiene menos de 50 GB, no se realiza ningún cambio en el sistema al utilizar la utilidad oci-growfs.

Sintaxis

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

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

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

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 Rescanning the Disk for Volumes Attached to Linux-Based Instances.

Ejecute la utilidad oci-growfs con la opción y para responder "sí" 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-image-expand

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 de Oracle Linux estándar. 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 utilidades de OCI.

Tipos de Conversión

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

Por defecto: restaura los servicios por defecto de la plataforma Oracle Linux systemd, los paquetes de diagnóstico, los valores de configuración en 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. La utilidad oci-image-expand siempre aplica este tipo de conversión.
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 seleccionables por 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 sobre el uso de Ksplice, consulte Oracle Ksplice for Zero-Downtime Updates y la Guía del usuario de Oracle Linux Ksplice.
La selecció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 los valores configurados por el usuario en la instancia. Por ejemplo, la utilidad restaura cloud-init config a la configuración por defecto de la imagen de la plataforma Oracle Linux y, por lo tanto, sobrescribe 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 a 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:

Ejecute la utilidad oci-image-expand.
```
/usr/libexec/oci-image-expand
```
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 único número, 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 pulsó Intro, pulse Ctrl+C para cancelar la operación.

En el indicador, introduzca 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.

ID de instancia de oci

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 Oracle Cloud Infrastructure (OCI) Linux. 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 recordar a los recursos en la nube mediante la consola, la API o la 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 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 ver un vídeo de formación que muestre cómo usar la utilidad oci-iscsi-config, consulte Uso de utilidades de OCI para gestionar el almacenamiento iSCSI para instancias 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 requiere privilegios de raíz.

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:

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|

También puede utilizar las opciones --details y --no-truncate con el subcomando oci-iscsi-config show para mostrar información más detallada que no se acorte 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|

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 la 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 las utilidades 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 se muestran los dispositivos que no están asociados a una instancia.
`-C \| --compartments name`	Muestra los dispositivos iSCSI en el compartimento especificado o en todos los compartimentos (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 and Command Line Interface.

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 que tenga un tamaño de 70 GB 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 la opción

Detalles de opción de creación de oci-iscsi-config
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`	Permite asociar 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 and Command Line Interface.

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

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

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

Detalles de la opción

Detalles de opción de conexión de oci-iscsi-config
Opción	Descripción
`-I \| --iqns IQN`	Una lista separada por comas de los nombres completos (iqns) de iSCSI del dispositivo o dispositivos iSCSI que se van a asociar a la instancia.
`-O \| --ocids` `OCID`	Lista separada por comas de los OCID del dispositivo iSCSI o los 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 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 bloques 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 la opción

Detalles de opción de sincronización de oci-iscsi-config
Opción	Descripción
`-a \| --apply`	Realice operaciones de sincronización.

Desasociación de un volumen

Utilice el subcomando oci-iscsi-config detach para desconectar 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.

Sintaxis

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 la opción

Detalles de la opción de desconexión de oci-iscsi-config
Opción	Descripción
`-f \| --force`	Continúe con la desasociación incluso si el dispositivo no se puede desmontar.
`-I \| --iqns IQN`	Una lista separada por comas de los nombres completos (iqns) de iSCSI del dispositivo o dispositivos iSCSI para desasociar 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 separada por comas de OCID.

Sintaxis

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 la opción

Detalles de opción de destrucción de oci-iscsi-config
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 para 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 de 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 la Opción

Detalles de opción de oci-metadata
Opción	Descripción
`-g key \| --get key`	Recupere los datos solo para la clave especificada. Compute puede definir las claves de metadatos de una instancia, o bien 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`	Si 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`	Actualiza el valor de la clave (o claves específicas). 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`	Obtenga o actualice 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 root.

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 nombres de red independientes. Esta separación es necesaria cuando las VNIC están en subredes (diferentes VCN) 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 la asociación con la interfaz. Cuando no se utilizan espacios de nombres, se configura el enrutamiento basado en políticas para proporcionar una ruta por defecto al enrutador virtual de la VNIC secundaria (gateway por defecto) cuando la dirección de la VNIC es la dirección 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.

Subcomandos de la utilidad oci-network-config
Subcomando	Para obtener más información, consulte...
`show`	Visualización de la configuración de red actual
`show-vnics`	Visualización de VNIC configuradas
`show-vnics-all`	Visualización de todas las VNIC configuradas
`show-vcns`	Visualización de información de VCN
`show-subnets`	Visualización de información de subred
`configure`	Configuración de las VNIC
`unconfigure`	Supresión de la configuración de IP de las VNIC secundarias aprovisionadas
`attach-vnic`	Creación y asociación de una VNIC
`detach-vnic`	Desasociación de una VNIC
`add-secondary-addr`	Adición de una dirección secundaria
`remove-secondary-addr`	Eliminación de una dirección IPv6 secundaria

Para ver un vídeo de formación que muestre cómo usar la utilidad oci-network-config, consulte Gestión de la interfaz de red mediante utilidades de OCI en instancias de Oracle Linux 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 de red actual

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 aún no están configuradas se marcan con ADD y las configuraciones 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.

Sintaxis

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 están configuradas (con la etiqueta ADD) y suprimir direcciones IP que no tienen ninguna VNIC asociada, utilice el subcomando oci-network-config config. Para obtener más información, consulte Configuración de VNIC.

Detalles de la opción

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 asociar una VNIC a una instancia. Puede asignar una dirección IP pública o privada a la nueva VNIC con este subcomando.

Importante

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

Uso

Para crear una VNIC y asociar 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 asociar la VNIC a la instancia:

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

Detalles de la opción

Detalles de la opción oci-network-config attach-vnic
Opción	Descripción
`-I \| --ip-address ip_address`	Asigne la dirección IP privada proporcionada a la VNIC. Si no se utiliza esta opción, se asigna automáticamente una dirección IP no utilizada 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 regular 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 las VNIC

El subcomando oci-network-config configure agrega la configuración IP para las VNIC que no están configuradas 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

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 se configuran ejecutando el subcomando oci-network-config show. Después de la configuración, no se mostrará ninguna etiqueta ADD o DELETE en la salida, a menos que elija excluir una VNIC de la configuración. Para obtener más información, consulte Displaying the Current Network Configuration.

Detalles de la opción

Detalles de opción de configuración de oci-network-config
Opción	Descripción
`-n \| --namespace format`	Al configurar, coloque las interfaces en el espacio de nombres identificado 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 los bloques y `DEF_NS_FORMAT_VM` para las máquinas virtuales. 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 sobre 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 la opción

Detalles de la opción de vnics de oci-network-config
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

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

Uso

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 la opción

Detalles de la opción 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 de IP de las VNIC secundarias aprovisionadas

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

Sintaxis

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 la opción

Detalles de la opción de desconfiguración de oci-network-config
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.

Sintaxis

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 la opción

Detalles de la opción remove-secondary-addr de oci-network-config
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 una VNIC existente. Sin embargo, la VNIC principal no se puede desconectar. También se suprimen todas las direcciones IP privadas secundarias asociadas a la VNIC.

Sintaxis

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

Para separar 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 la opción

Detalles de la opción 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 información de VCN

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

Sintaxis

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

Para mostrar información detallada de la VCN en 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 la opción

Detalles de la opción 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 información de subred

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

Sintaxis

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 la opción

Detalles de la opción de oci-network-config show-subnets
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 de un compartimento o una 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 de 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 de un compartimento específico

Para ver un informe de red detallado de 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 del servicio Notifications. Esta utilidad se debe ejecutar como root.

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 la CLI de 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 la utilidad oci-notify
Subcomando	Para obtener más información, consulte...
`config`	Configuración de un tema del servicio de notificaciones 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 de notificaciones en una instancia

Utilice el subcomando oci-notify config para escribir el OCID del tema del servicio Notifications en el archivo oci.conf. Una vez configurado, puede publicar mensajes en 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.

Sintaxis

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

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

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 asocia el nombre de la instancia al tema del mensaje. Por ejemplo: instance_name:log messages

Sintaxis

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 la opción

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 está enviando 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 el `message_file` especificado no se reconoce como una URL o la ruta del directorio no existe, 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 Kits de desarrollo de software e interfaz de línea de comandos). Si no se puede obtener la dirección IP con este método, 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 sobre STUN, consulte el artículo de la Wikipedia sobre STA.

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 instancia actual, utilice la utilidad oci-public-ip con la opción --instance-id.

Nota

Esta opción necesita que se instale y configure el SDK de OCI para Python. 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 la Opción

Opciones de utilidad oci-public-ip
Opción	Descripción
`-g \| get`	Imprime solo la dirección IP.
`--instance-id OCID`	Muestra la dirección IP pública de la instancia proporcionada en lugar de la actual. Requiere que se instale y configure el SDK de OCI para Python.
`-L \| --list-servers`	Imprime una lista de servidores STUN conocidos y se cierra.
`-s \| --sourceip source_IP`	Especifica la dirección IP de origen que se debe utilizar.
`-S \| --stun-server STUN_server`	Especifica el servidor STUN que se debe utilizar.

datos de volumen de oci

Use 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 datos para un volumen iSCSI específico. Los valores de opción de clave pueden ser el nombre mostrado, el OCID o iqn (nombre completo 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 sobre 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

También puede utilizar las opciones -k, -p y -v (solo valor) con la utilidad oci-volume-data para acotar 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 el acceso a las páginas del comando man de la utilidad OCI, consulte Opciones comunes de la utilidad OCI.

Detalles de la Opción

Opciones de la utilidad oci-volume-data
Opción	Descripción
`-k KEY \| --key KEY`	Es necesario. Clave para identificar el volumen. El valor `KEY` puede ser el OCID, IQN o el nombre mostrado del volumen.
`-p \| --par`	Especifica la dirección IP de origen que se debe utilizar.
`-v \| --value-only`	Solo se muestran los valores de la salida.

Resumen de utilidades de OCI

Resumen de los componentes de las utilidades de OCI.


Nombre	Descripción
`ocid`	Componente de servicio de `oci-utils`, que se ejecuta como un daemon iniciado por `systemd`. Este servicio busca cambios en las configuraciones de dispositivos iSCSI y VNIC, y almacena en caché los metadatos de OCI y la dirección IP pública de la instancia.
`oci-compartmentid`	Muestra el identificador de Oracle Cloud (OCID) del compartimento en el que se ejecuta la instancia.
`oci-growfs`	Expande el sistema de archivos raíz de la instancia a su tamaño configurado.
`oci-image-expand`	Convierte la instancia mínima de Oracle Linux para agregar servicios y paquetes de una imagen de plataforma de Oracle Linux estándar.
`oci-instanceid`	Muestra el OCID de la instancia.
`oci-iscsi-config`	Muestra o configura dispositivos iSCSI asociados a una instancia informática. Si no se especifica ninguna opción de línea de comandos, se muestran los dispositivos que requieren atención.
`oci-metadata`	Muestra los metadatos de la instancia informática. Si no se especifica ninguna opción de la línea de comandos, muestra todos los metadatos disponibles. Los metadatos incluyen el OCID de instancia, el nombre mostrado, el compartimento, la unidad, la región, el dominio de disponibilidad, la fecha de creación, el estado, la imagen y los metadatos personalizados que proporcione, por ejemplo, una clave pública SSH.
`oci-network-config`	Muestra o configura las tarjetas de interfaz de red virtual (VNIC) asociadas a la instancia informática. Cuando se aprovisiona una VNIC secundaria en la nube, se debe configurar de forma explícita en la instancia utilizando este script o comandos similares.
`oci-network-inspector`	Muestra un informe detallado de un compartimento o una red proporcionados.
`oci-notify`	Envía un mensaje a un tema del servicio Notification.
`oci-public-ip`	Muestra la dirección IP pública del sistema actual en formato legible por el usuario o JSON.
`oci-volume-data`	Muestra datos sobre un volumen iSCSI específico asociado a la instancia.

Opciones comunes de la utilidad OCI

Muchas de las utilidades de Oracle Cloud Infrastructure (OCI) tienen las mismas opciones o argumentos disponibles cuando las utilidades se ejecutan desde la línea de comandos. Estas opciones y argumentos ayudan a definir más a fondo qué tipo de información produce la utilidad o cómo se realiza una tarea de la utilidad.

En la siguiente tabla se muestran las opciones y sus valores soportados que son comunes en las utilidades de OCI.


Opción	Descripción
`--help`	Muestra información de ayuda sobre la utilidad, como el uso de la utilidad, las opciones disponibles y los valores admitidos para cada opción. Por ejemplo, para ver la ayuda de la utilidad `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`	Muestra todos los elementos, o valores, en la salida.
`--details`	Muestra información detallada en la salida.
`--output-mode`	Permite definir cómo se muestra la salida de la utilidad. A continuación, se muestran los modos de utilidad de OCI disponibles: `json`: muestra la salida en formato JSON. `human-readable`: muestra la salida en formato legible por el usuario. `parsable`: muestra la salida en formato analizable. `table`: muestra la salida en una tabla. `text`: muestra la salida textual.
`--no-truncate`	No acorta los valores de la salida mostrada.
`--truncate`	Acorta los valores de la salida mostrada.
`-y\| --yes`	Responde "yes" en todas las peticiones de datos.
`-n \| --no`	Responde "no" en todas las peticiones de datos.
`-q \| --quiet`	Suprime los mensajes de información.

Nota

También puede ver las páginas del comando man de cada utilidad de OCI introduciendo man oci-utility en la línea de comandos. Por ejemplo, para mostrar las páginas manuales incorporadas para la utilidad oci-metadata:

man oci-metadata

Documentación de Oracle Cloud Infrastructure Probar cuenta gratuita

Utilidades de OCI

Instalación de utilidades de OCI 🔗

Actualización de utilidades de OCI 🔗

Uso del daemon ocid 🔗

Referencia de utilidades de OCI 🔗

Gestión de Volúmenes 🔗

Gestión de redes

Ver información de configuración

Configuración de notificaciones

Conversión de la imagen mínima de Oracle Linux

oci-compartmentid 🔗

Sintaxis

oci-growfs 🔗

Sintaxis

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

oci-image-expand 🔗

Requisito

Tipos de Conversión

Sintaxis

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

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

ID de instancia de oci 🔗

Sintaxis

oci-iscsi-config 🔗

Sintaxis

Subcomandos

Visualización de configuraciones de iSCSI 🔗

Creación y asociación de un nuevo volumen 🔗

Asociación de un volumen existente 🔗

Sincronización de un volumen 🔗

Desasociación de un volumen 🔗

Supresión de un volumen 🔗

oci-metadata 🔗

Sintaxis

Obtención de todos los metadatos para la instancia

Obtención de metadatos específicos para la instancia

Detalles de la Opción

oci-network-config 🔗

Sintaxis

Subcomandos

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

Creación y asociación de una VNIC 🔗

Configuración de las VNIC 🔗

Visualización de VNIC configuradas 🔗

Visualización de todas las VNIC configuradas 🔗

Adición de una dirección secundaria 🔗

Supresión de la configuración de IP de las VNIC secundarias aprovisionadas 🔗

Eliminación de una dirección IPv6 secundaria 🔗

Desasociación de una VNIC 🔗

Visualización de información de VCN 🔗

Visualización de información de subred 🔗

oci-network-inspector 🔗

Sintaxis

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

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

oci-notify 🔗

Sintaxis

Subcomandos

Configuración de un tema del servicio de notificaciones en una instancia 🔗

Publicación de un mensaje en un tema 🔗

oci-public-ip 🔗

Sintaxis

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

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

Visualización de una lista de servidores STUN

Detalles de la Opción

datos de volumen de oci 🔗

Sintaxis

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

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

Detalles de la Opción

Resumen de utilidades de OCI 🔗

Opciones comunes de la utilidad OCI 🔗

Documentación de Oracle Cloud Infrastructure
Probar cuenta gratuita

Instalación de utilidades de OCI

Actualización de utilidades de OCI

Uso del daemon ocid

Referencia de utilidades de OCI

Gestión de Volúmenes

oci-compartmentid

oci-growfs

oci-image-expand

ID de instancia de oci

oci-iscsi-config

Visualización de configuraciones de iSCSI

Creación y asociación de un nuevo volumen

Asociación de un volumen existente

Sincronización de un volumen

Desasociación de un volumen

Supresión de un volumen

oci-metadata

oci-network-config

Visualización de la configuración de red actual

Creación y asociación de una VNIC

Configuración de las VNIC

Visualización de VNIC configuradas

Visualización de todas las VNIC configuradas

Adición de una dirección secundaria

Supresión de la configuración de IP de las VNIC secundarias aprovisionadas

Eliminación de una dirección IPv6 secundaria

Desasociación de una VNIC

Visualización de información de VCN

Visualización de información de subred

oci-network-inspector

oci-notify

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

Publicación de un mensaje en un tema

oci-public-ip

datos de volumen de oci

Resumen de utilidades de OCI

Opciones comunes de la utilidad OCI