Utilidades de OCI

Las instancias en las que se utilizan imágenes de plataforma de Oracle Linux incluyen un juego de utilidades (oci-utils) que permiten que la instancia acceda a información sobre 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 del 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 del paquete, 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 tengan 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 Installing the 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 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 de desarrollador que permite 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 del oci-utils. Supervisa los cambios en la configuración de VNIC e iSCSI de la instancia e intentará asociar o desasociar automáticamente dispositivos a medida que aparecen o desaparecen, por ejemplo, cuando Se crean o desaparecen mediante 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.

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`	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 con más detalle qué tipo de información produce la utilidad o cómo se realiza una tarea de 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 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 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`	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

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