Utilitaires OCI

Pour les instances lancées avec Oracle Linux 7 ou une versions ultérieure, le package d'utilitaires Oracle Cloud Infrastructure (OCI) (oci-utils) est automatiquement installé. Les utilitaires ne sont pas disponibles sur d'autres distributions.

Pour utiliser les utilitaires OCI, vous devez satisfaire aux prérequis suivants :

• Assurez-vous que 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. Il contient toutes les dépendances d'un package, y compris les packages OCI SDK et Python requis. Tous les packages requis sont installés avec le package oci-utils.
• Assurez-vous que les utilitaires OCI disposent de droits d'accès suffisants pour accéder à Oracle Cloud Infrastructure en effectuant l'une des opérations suivantes :
  • Créez le fichier de configuration du kit SDK pour l'hôte. Pour plus d'informations, reportez-vous à Fichier de configuration du kit SDK et de l'interface de ligne de commande.
    Remarque
    
    Vous devrez peut-être installer l'interface de ligne de commande pour votre environnement avant d'exécuter la commande oci setup config pour créer le fichier de configuration du kit SDK. Pour plus d'informations, reportez-vous à Installation de la CLI.
  • Utilisez des principaux d'instance en ajoutant l'instance à un groupe dynamique disposant d'un accès aux services Oracle Cloud Infrastructure. Pour plus d'informations, reportez-vous à Gestion des groupes dynamiques.
  • Configurez oci-utils de sorte à permettre à l'utilisateur root de se servir des fichiers de configuration Oracle Cloud Infrastructure d'un utilisateur sans privilège. Pour plus d'informations, consultez le fichier de configuration situé dans le répertoire /etc/oci-utils.conf.d de l'instance.
• Choisissez la méthode d'accès aux utilitaires et effectuez les procédures de configuration nécessaires 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 sur lequel vous pouvez exécuter les utilitaires OCI. Pour plus d'informations sur l'interface de ligne de commande et sur la prise en main, reportez-vous aux sections Command Line Interface (CLI) et CLI Quickstart.
  • Kit de développement logiciel OCI : ensemble d'outils de développement qui vous permettent d'écrire du code et de gérer les ressources OCI. Pour plus d'informations, reportez-vous à Kits SDK et interface de ligne de commande.

Pour voir une vidéo portant sur l'installation et la configuration des utilitaires OCI, reportez-vous à Activation des utilitaires OCI dans Oracle Linux sur les instances Oracle Cloud Infrastructure dans le centre de formation Oracle Linux.

Pour effectuer la mise à jour vers la dernière version de oci-utils, utilisez la commande suivante :

sudo yum update oci-utils

Le démon ocid est le composant de service de oci-utils. Il surveille les modifications apportées à la configuration iSCSI et d'interface réseau virtuelle de l'instance, et essaye d'attacher ou de détacher automatiquement les périphériques lorsqu'ils apparaissent ou disparaissent. Par exemple, lorsqu'ils sont créés ou supprimés à l'aide de la console Oracle Cloud Infrastructure, de la CLI ou de l'API.

Pour démarrer le démon ocid à l'aide de systemd et définir le service ocid de sorte qu'il démarre automatiquement lors de l'initialisation du système, utilisez la commande suivante :

sudo systemctl enable --now ocid.service

Pour vérifier que le service est actif (en cours d'exécution), utilisez la commande suivante :

sudo service ocid status

Par exemple :

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

Récapitulatif des composants des utilitaires 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 permettent de définir plus précisément le type d'informations produites par l'utilitaire ou la façon dont une tâche de l'utilitaire est exécutée.

Le tableau suivant répertorie les options et leurs valeurs prises en charge communes aux utilitaires OCI.

$ 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

man oci-metadata