OCI-Utilitys

Instanzen, die Oracle Linux-Plattformimages verwenden, umfassen ein Set von Utilitys (oci-utils), mit denen die Instanz auf Informationen zu Infrastrukturressourcen zugreifen können. Diese Utilitys bestehen aus einer Servicekomponente und Befehlszeilentools, mit denen Ressourcen automatisch erkannt oder bereitgestellt werden können.

OCI-Utilitys installieren

Instances launched with Oracle Linux 7 or later automatically include the Oracle Cloud Infrastructure (OCI) utilities (oci-utils) package installed. Die Utilitys sind in anderen Distributionen nicht verfügbar.

Um die OCI-Utilitys verwenden zu können, müssen Sie die folgenden Voraussetzungen erfüllen:

Stellen Sie sicher, dass das Repository oci_included aktiviert ist. Dieses Repository ist in Oracle Linux-Plattformimages standardmäßig aktiviert. Dieses Repository enthält alle Packageabhängigkeiten, einschließlich der erforderlichen OCI-SDK- und Python-Packages. Alle erforderlichen Packages werden mit dem Package oci-utils installiert.
Stellen Sie sicher, dass die OCI-Utilitys über ausreichende Berechtigungen für den Zugriff auf Oracle Cloud Infrastructure verfügen, indem Sie einen der folgenden Schritte ausführen:
- Erstellen Sie die SDK-Konfigurationsdatei für den Host. Weitere Informationen finden Sie unter SDK- und CLI-Konfigurationsdatei.
  Hinweis
  
  Möglicherweise müssen Sie die CLI für Ihre Umgebung installieren, bevor Sie den Befehl oci setup config ausführen, um die SDK-Konfigurationsdatei zu erstellen. Weitere Informationen finden Sie unter CLI installieren.
- Verwenden Sie Instanz-Principals, indem Sie die Instanz einer dynamischen Gruppe hinzufügen, der Zugriff auf Oracle Cloud Infrastructure-Services erteilt wurde. Weitere Informationen finden Sie unter Dynamische Gruppen verwalten.
- Konfigurieren Sie oci-utils so, dass "root" die Oracle Cloud Infrastructure-Konfigurationsdateien eines nicht privilegierten Benutzers verwenden kann. Weitere Informationen finden Sie in der Konfigurationsdatei im Verzeichnis /etc/oci-utils.conf.d der Instanz.
Wählen Sie die Methode für den Zugriff auf die Utilitys, und führen Sie gegebenenfalls Setup-Prozeduren für diese Methode aus:
- OCI-CLI von einer Instanz oder einem Remotehost: Ein CLI-Terminal, das mit einer Instanz oder einem Remotehost verbunden ist, auf dem Sie die OCI-Utilitys ausführen können. Weitere Informationen zur CLI und zu den ersten Schritten mit ihr finden Sie unter Befehlszeilenschnittstelle (CLI) und CLI-Schnellstart.
- OCI Software Development Kit (SDK) - Eine Reihe von Entwicklertools, mit denen Sie Code schreiben und OCI-Ressourcen verwalten können. Weitere Informationen finden Sie unter Software Development Kits und Befehlszeilenschnittstelle.

Ein Video zur Installation und Einrichtung der OCI-Utilitys finden Sie unter OCI-Utilitys in Oracle Linux auf Oracle Cloud Infrastructure-Instanzen aktivieren in der Oracle Linux-Schulungsstation.

OCI-Utilitys aktualisieren

So aktualisieren Sie auf die neueste Version von oci-utils:

sudo yum update oci-utils

ocid-Daemon verwenden

Der ocid-Daemon ist die Servicekomponente von oci-utils. Er überwacht die VNIC- und iSCSI-Konfiguration der Instanz und sucht, neue und entfernte Geräte automatisch anzuhängen oder zu trennen. Beispiel: Wenn Sie mit der Oracle Cloud Infrastructure-Konsole, der CLI oder der API erstellt oder gelöscht wurden.

So können Sie den ocid-Daemon mit systemd starten und festlegen, dass der ocid-Service beim Systemstart automatisch gestartet wird:

sudo systemctl enable --now ocid.service

So bestätigen Sie, dass der Service aktiv ist (ausgeführt wird):

sudo service ocid status

Beispiel:

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

Übersicht über OCI-Utilitys

Eine Übersicht über die Komponenten der OCI-Utilitys.


Name	Beschreibung
`ocid`	Die Servicekomponente von `oci-utils`, die als Daemon ausgeführt und mit `systemd` gestartet wird. Dieser Service scannt Änderungen in den iSCSI- und VNIC-Gerätekonfigurationen und cacht die OCI-Metadaten sowie die öffentliche IP-Adresse der Instanz.
`oci-compartmentid`	Zeigt die Oracle Cloud-ID (OCID) des Compartments an, in dem die Instanz ausgeführt wird.
`oci-growfs`	Erweitert das Root-Dateisystem der Instanz bis zur konfigurierten Größe.
`oci-image-expand`	Konvertiert die Oracle Linux Minimal-Instanz, um Services und Packages eines Standard-Oracle Linux-Plattformimages hinzuzufügen.
`oci-instanceid`	Zeigt die OCID der Instance an.
`oci-iscsi-config`	Listet iSCSI-Geräte auf, die an eine Compute-Instanz angehängt sind, oder konfiguriert diese. Wenn keine Befehlszeilenoptionen angegeben sind, werden die Geräte aufgelistet, die bearbeitet werden müssen.
`oci-metadata`	Zeigt Metadaten für die Compute-Instanz an. Wenn keine Befehlszeilenoptionen angegeben sind, werden alle verfügbaren Metadaten aufgelistet. Metadaten umfassen die Instanz-OCID, den Anzeigenamen, das Compartment, die Ausprägung, die Region, die Availability-Domain, das Erstellungsdatum, den Status, das Image und alle von Ihnen angegebenen benutzerdefinierten Metadaten, wie z.B. SSH-Public-Keys.
`oci-network-config`	Listet die VNICs (virtuellen Netzwerkkarten) auf, die an die Compute-Instanz angehängt sind, oder konfiguriert diese. Wenn eine sekundäre VNIC in der Cloud bereitgestellt wird, muss sie explizit mit diesem Skript oder ähnlichen Befehlen in der Instanz konfiguriert werden.
`oci-network-inspector`	Zeigt einen detaillierten Bericht für ein angegebenes Compartment oder Netzwerk an.
`oci-notify`	Sendet eine Nachricht an ein Notifications-Servicethema.
`oci-public-ip`	Zeigt die öffentliche IP-Adresse des aktuellen Systems im menschenlesbaren oder JSON-Format an.
`oci-volume-data`	Zeigt Daten zu einem bestimmten iSCSI-Volume an, das an die Instanz angehängt ist.

Allgemeine Optionen für OCI-Utility

Viele der Oracle Cloud Infrastructure-(OCI-)Utilitys haben dieselben Optionen oder Argumente, wenn die Utilitys über die Befehlszeile ausgeführt werden. Mit diesen Optionen und Argumenten können Sie weiter definieren, welche Art von Informationen vom Dienstprogramm erzeugt werden oder wie eine Dienstprogrammaufgabe ausgeführt wird.

In der folgenden Tabelle werden die Optionen und die unterstützten Werte aufgeführt, die in den OCI-Utilitys üblich sind.


Option	Beschreibung
`--help`	Zeigt Hilfeinformationen zum Utility an, wie die Verwendung des Utilitys, verfügbare Optionen und die unterstützten Werte für jede Option. Beispiel: So zeigen Sie die Hilfe für das Utility `oci-metadata` an: `$ 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`	Zeigt alle Elemente oder Werte in der Ausgabe an.
`--details`	Zeigt detaillierte Informationen in der Ausgabe an.
`--output-mode`	Hier können Sie definieren, wie die Ausgabe des Utilitys angezeigt wird. Die folgenden OCI-Utilitymodi sind verfügbar: `json`: Zeigt die Ausgabe im JSON-Format an. `human-readable`: Zeigt die Ausgabe im menschenlesbaren Format an. `parsable`: Zeigt die Ausgabe im Parsable-Format an. `table`: Zeigt die Ausgabe in einer Tabelle an. `text`: Zeigt die Textausgabe an.
`--no-truncate`	Die Werte in der angezeigten Ausgabe werden nicht gekürzt.
`--truncate`	Verkürzt die Werte in der angezeigten Ausgabe.
`-y\| --yes`	Antworten auf alle Prompts mit "ja".
`-n \| --no`	Antworten "Nein" auf alle Prompts.
`-q \| --quiet`	Unterdrückt Informationsmeldungen.

Hinweis

Sie können auch Manpages für jedes OCI-Utility anzeigen, indem Sie in der Befehlszeile man oci-utility eingeben. Beispiel: So zeigen Sie die integrierten manuellen Seiten für das Utility oci-metadata an:

man oci-metadata