Utilidades de OCI

Las instancias que utilizan imágenes de la plataforma 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 de Oracle Linux vienen con el paquete de utilidades de Oracle Cloud Infrastructure (OCI) (oci-utils) instalado. Estas utilidades no están disponibles en otras distribuciones.

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

El repositorio oci_included está activado. Este repositorio está activado por defecto en las imágenes de plataforma de Oracle Linux. El repositorio contiene todos los paquetes necesarios, incluidos los paquetes de Python y SDK de OCI necesarios. El paquete oci-utils proporciona todas las dependencias.
Las utilidades de OCI tienen los permisos necesarios para acceder a Oracle Cloud Infrastructure. Esto se puede lograr haciendo 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 antes de ejecutar el comando oci setup config para crear el archivo de configuración del SDK. Para obtener más información, consulte Installing the CLI.
- Utilice principales de instancia agregando la instancia a un grupo dinámico que tenga 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 permitir que la cuenta raíz utilice los archivos de configuración de OCI de un usuario sin privilegios. Para obtener más información, consulte el archivo de configuración en el directorio /etc/oci-utils.conf.d de la instancia.
Después de asegurarse de que las utilidades de OCI tengan los permisos necesarios, seleccione cuál de los siguientes métodos utilizar para acceder a las utilidades y realice la configuración necesaria para ese método:
- CLI de OCI desde una instancia o un host remoto: terminal de CLI conectado a una instancia o un host remoto donde puede ejecutar las utilidades de OCI. Para obtener más información sobre la CLI y cómo comenzar a utilizarla, consulte Interfaz de línea de comandos (CLI) e Inicio rápido de la CLI.
- OCI Software Development Kit (SDK): juego de herramientas para desarrolladores que le 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 obtener un vídeo en el que se muestra cómo instalar y configurar las utilidades de OCI, consulte Activación del servicio público de OCI en Oracle Linux en instancias de Oracle Cloud Infrastructure.

Actualización de utilidades de OCI

Para actualizar a la última versión de oci-utils, ejecute el siguiente comando:

sudo dnf update oci-utils

Uso del daemon ocid

El daemon ocid es el componente de servicio oci-utils. Supervisa las modificaciones en la configuración de VNIC e iSCSI de la instancia e trata de asociar o desasociar automáticamente dispositivos a medida que aparecen o desaparecen. Por ejemplo, cuando se crean o suprimen mediante la consola, la CLI o la API de Oracle Cloud Infrastructure.

Para iniciar el daemon ocid inmediatamente mediante systemd e iniciar automáticamente cuando se inicie el sistema, ejecute el siguiente comando:

sudo systemctl enable --now ocid.service

Para confirmar que el servicio está activo (en ejecución), ejecute el siguiente comando:

sudo service ocid status

La salida es similar a la siguiente:

$ sudo service ocid status
Redirecting to /bin/systemctl status ocid.service
● ocid.service - Oracle Cloud Infrastructure utilities daemon
     Loaded: loaded (/etc/systemd/system/ocid.service; enabled; preset: disabled)
     Active: active (running) since date and time; 9s ago
 Invocation: edd65c2c534949f3a3fb1a77d0aecccf
   Main PID: 361841 (python3)
      Tasks: 4 (limit: 72765)
     Memory: 127.3M (peak: 127.8M)
        CPU: 1.424s
     CGroup: /system.slice/ocid.service
             └─361841 /usr/bin/python3 /usr/lib/python3.12/site-packages/oci_utils/impl/ocid_main.py --no-daemon
date and time hostname systemd[1]: Starting ocid.service - Oracle Cloud Infrastructure utilities daemon...
date and time hostname systemd[1]: Started ocid.service - Oracle Cloud Infrastructure utilities daemon.

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`	Amplía 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 estándar de Oracle Linux.
`oci-instanceid`	Muestra el OCID de la base de datos.
`oci-iscsi-config`	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 de las opciones de las líneas de comandos, se muestran 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 específicos.
`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 definen con más detalle qué tipo de información produce la utilidad o cómo se realiza una tarea.

En la siguiente tabla, se muestran las opciones y sus posibles valores 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 posibles valores para cada opción. Por ejemplo, para ver la ayuda para 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. Están disponibles las siguientes opciones: `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`	Responda "sí" a todas las peticiones de datos.
`-n \| --no`	Respuestas "no" en todas las peticiones.
`-q \| --quiet`	Suprime los mensajes de información.

Nota

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