Utilitaires OCI

Les instances utilisant des images de plate-forme Oracle Linux comprennent un jeu d'utilitaires (oci-utils) qui permettent à l'instance d'accéder aux informations sur les ressources d'infrastructure. Ces utilitaires comportent un composant de service et des outils de ligne de commande qui permettent de détecter ou de provisionner automatiquement des ressources.

Installation des utilitaires OCI

Les instances Oracle Linux sont fournies avec l'ensemble des utilitaires Oracle Cloud Infrastructure (OCI) (oci-utils) installé. Ces utilitaires ne sont pas disponibles sur d'autres distributions.

Pour utiliser les utilitaires OCI, vous devez respecter les préalables suivants :

Le référentiel oci_included est activé. Ce référentiel est activé par défaut dans les images de plate-forme Oracle Linux. Le référentiel contient tous les ensembles requis, y compris la trousse SDK OCI et les ensembles Python requis. L'ensemble oci-utils fournit toutes les dépendances.
Les utilitaires OCI disposent des autorisations requises pour accéder à Oracle Cloud Infrastructure. Pour ce faire, vous pouvez effectuer l'une des opérations suivantes :
- Créez le fichier de configuration de la trousse SDK pour l'hôte. Pour plus d'informations, voir Fichier de configuration des trousses SDK et de l'interface de ligne de commande.
  Note
  
  Vous devrez peut-être installer l'interface de ligne de commande avant d'exécuter la commande oci setup config pour créer le fichier de configuration de la trousse SDK. Pour plus d'informations, voir Installation de l'interface de ligne de commande.
- Utilisez les principaux d'instance en ajoutant l'instance à un groupe dynamique ayant accès aux services Oracle Cloud Infrastructure. Pour plus d'informations, voir Gestion des groupes dynamiques.
- Configurez oci-utils pour permettre au compte racine d'utiliser les fichiers de configuration OCI d'un utilisateur sans privilèges. Pour plus d'informations, consultez le fichier de configuration dans le répertoire /etc/oci-utils.conf.d de l'instance.
Après vous être assuré que les utilitaires OCI disposent des autorisations nécessaires, sélectionnez l'une des méthodes suivantes à utiliser pour accéder aux utilitaires et effectuer toute configuration requise pour cette méthode :
- Interface de ligne de commande OCI à partir d'une instance ou d'un hôte distant : Terminal d'interface de ligne de commande connecté à une instance ou à un hôte distant où vous pouvez exécuter les utilitaires OCI. Pour plus d'informations sur l'interface de ligne de commande et pour commencer à l'utiliser, voir Interface de ligne de commande et Démarrage rapide de l'interface de ligne de commande.
- Trousse SDK pour OCI : Jeu d'outils pour développeurs qui vous permettent d'écrire du code et de gérer les ressources OCI. Pour plus d'informations, voir Trousses SDK et interface de ligne de commande.

Pour une vidéo montrant comment installer et configurer les outils OCI, voir Activation des outils OCI dans Oracle Linux sur des instances Oracle Cloud Infrastructure.

Mise à jour des utilitaires OCI

Pour effectuer une mise à jour à la dernière version d'oci-utils, exécutez la commande suivante :

sudo dnf update oci-utils

Utilisation du démon ocid

Le démon ocid est le composant de service d'oci-utils. Il surveille les modifications apportées à la carte VNIC et à la configuration iSCSI de l'instance et tente automatiquement d'attacher ou de détacher les appareils lorsqu'ils apparaissent ou disparaissent. Par exemple, lorsqu'elles sont créées ou supprimées à l'aide de la console Oracle Cloud Infrastructure, de l'interface de ligne de commande ou de l'API.

Pour démarrer le démon ocid immédiatement à l'aide de systemd et démarrer automatiquement lorsque le système démarre, exécutez la commande suivante :

sudo systemctl enable --now ocid.service

Pour vérifier que le service est actif (exécution), exécutez la commande suivante :

sudo service ocid status

La sortie est similaire à la suivante :

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

Sommaire des utilitaires OCI

Sommaire des composants des utilitaires OCI.


Nom	Description
`ocid`	Composant de service de `oci-utils`, exécuté en tant que démon démarré par `systemd`. Ce service effectue un balayage pour rechercher les modifications apportées aux configurations des périphériques iSCSI et vNIC et met en mémoire cache les métadonnées OCI et l'adresse IP publique de l'instance.
`oci-compartmentid`	Affiche l'identificateur Oracle Cloud (OCID) du compartiment dans lequel l'instance est exécutée.
`oci-growfs`	Développe le système de fichiers racine de l'instance à sa taille configurée.
`oci-image-expand`	Convertit l'instance Oracle Linux Minimal en services et ensembles d'une image de plate-forme Oracle Linux standard.
`oci-instanceid`	Affiche l'OCID de l'instance.
`oci-iscsi-config`	Configure les appareils iSCSI attachés à une instance de calcul. Si aucune option de ligne de commande n'est spécifiée, elle liste tous les appareils qui nécessitent votre attention.
`oci-metadata`	Affiche les métadonnées pour l'instance de calcul. Si aucune option de ligne de commande n'est spécifiée, cela indique toutes les métadonnées disponibles. Les métadonnées incluent l'OCID de l'instance, le nom d'affichage, le compartiment, la forme, la région, le domaine de disponibilité, la date de création, l'état, l'image et toutes les métadonnées personnalisées que vous fournissez, par exemple une clé publique SSH.
`oci-network-config`	Liste ou configure les cartes d'interface réseau virtuelles (vNIC) attachées à l'instance de calcul. Lorsqu'une carte vNIC secondaire est provisionnée dans le nuage, elle doit être configurée explicitement dans l'instance à l'aide de ce script ou de commandes similaires.
`oci-network-inspector`	Affiche un rapport détaillé sur un compartiment ou un réseau spécifique.
`oci-notify`	Envoie un message à un sujet du service d'avis.
`oci-public-ip`	Affiche l'adresse IP publique du système courant dans un format lisible par l'utilisateur ou au format JSON.
`oci-volume-data`	Affiche les données sur un volume iSCSI spécifique attaché à l'instance.

Options communes de l'utilitaire OCI

De nombreux utilitaires Oracle Cloud Infrastructure (OCI) ont les mêmes options ou arguments disponibles lorsque les utilitaires sont exécutés à partir de la ligne de commande. Ces options et arguments définissent davantage le type d'informations produites par l'utilitaire ou la façon dont une tâche est exécutée.

Le tableau suivant répertorie les options, ainsi que leurs valeurs possibles, qui sont communes aux utilitaires OCI.


Option	Description
`--help`	Affiche des informations d'aide sur l'utilitaire, telles que l'utilisation de l'utilitaire, les options disponibles et les valeurs possibles pour chaque option. Par exemple, pour voir l'aide de l'utilitaire `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`	Affiche tous les éléments, ou valeurs, dans la sortie.
`--details`	Affiche des informations détaillées dans la sortie.
`--output-mode`	Permet de définir comment la sortie est affichée. Les options suivantes sont disponibles : `json` : Affiche la sortie au format JSON. `human-readable` : Affiche la sortie dans un format lisible par l'utilisateur. `parsable` : Affiche la sortie dans un format analysable. `table` : Affiche la sortie dans une table. `text` : Affiche la sortie textuelle.
`--no-truncate`	Ne raccourcit pas les valeurs dans la sortie affichée.
`--truncate`	Raccourcit les valeurs dans la sortie affichée.
`-y\| --yes`	Réponses "Oui" à toutes les invites.
`-n \| --no`	Réponses "non" à toutes les invites.
`-q \| --quiet`	Supprime les messages d'information.

Note

Vous pouvez voir les pages de manuel de chaque utilitaire OCI en entrant man oci-utility à la ligne de commande. Par exemple, pour afficher les pages manuelles intégrées pour l'utilitaire oci-metadata :

man oci-metadata