OCIユーティリティ

Oracle Linux 7以降で起動されたインスタンスには、インストールされたOracle Cloud Infrastructure (OCI)ユーティリティ(oci-utils)パッケージが自動的に含まれます。ユーティリティは、他のディストリビューションでは使用できません。

OCIユーティリティを使用するには、次の前提条件を満たす必要があります。

• oci_includedリポジトリが有効になっていることを確認します。このリポジトリは、Oracle Linuxプラットフォーム・イメージではデフォルトで有効になっています。このリポジトリには、必要なOCI SDKおよびPythonパッケージを含む、すべてのパッケージ依存関係が含まれています。必要なすべてのパッケージは、oci-utilsパッケージとともにインストールされます。
• 次のいずれかを実行して、OCIユーティリティにOracle Cloud Infrastructureへのアクセスに十分な権限があることを確認します。
  • ホストのSDK構成ファイルを作成します。詳細は、SDKおよびCLIの構成ファイルを参照してください。
    ノート
    
    oci setup configコマンドを実行してSDK構成ファイルを作成する前に、ご使用の環境にCLIをインストールする必要がある場合があります。詳細は、Installing the CLIを参照してください。
  • Oracle Cloud Infrastructureサービスへのアクセスが許可された動的グループにインスタンスを追加して、インスタンス・プリンシパルを使用します。詳細は、動的グループの管理を参照してください。
  • rootが非特権ユーザーのOracle Cloud Infrastructure構成ファイルを使用できるように、oci-utilsを構成します。詳細は、インスタンスの/etc/oci-utils.conf.dディレクトリにある構成ファイルを参照してください。
• ユーティリティにアクセスする方法を選択し、必要に応じてその方法の設定手順を実行します。
  • インスタンスまたはリモート・ホストからのOCI CLI - OCIユーティリティを実行できるインスタンスまたはリモート・ホストに接続されたCLI端末。CLIとその使用開始方法の詳細は、コマンドライン・インタフェース(CLI)およびCLIクイックスタートを参照してください。
  • OCI Software Development Kit (SDK) - コードを記述し、OCIリソースを管理できる開発者ツールのセット。詳細は、ソフトウェア開発キットとコマンドライン・インタフェースを参照してください。

OCIユーティリティをインストールおよび設定する方法に関するビデオについては、Oracle Linuxトレーニング・ステーションのOracle Cloud InfrastructureインスタンスでのOracle LinuxのOCIユーティリティの有効化を参照してください。

最新バージョンのoci-utilsに更新するには:

sudo yum update oci-utils

ocidデーモンは、oci-utilsのサービス・コンポーネントです。これは、インスタンスのVNICおよびiSCSI構成内の変化をモニターし、デバイスの出現や消失(Oracle Cloud Infrastructure Console、CLIまたはAPIを使用したデバイスの作成または削除など)に合せてデバイスの自動アタッチまたはデタッチを試みます。

systemdを使用してocidデーモンを起動し、システム・ブート中にocidサービスが自動的に開始されるように設定するには:

sudo systemctl enable --now ocid.service

サービスがアクティブ(実行中)であることを確認するには:

sudo service ocid status

例:

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

OCIユーティリティ・コンポーネントのサマリー。

Oracle Cloud Infrastructure (OCI)ユーティリティの多くには、コマンドラインからユーティリティを実行するときに使用できる同じオプションまたは引数があります。これらのオプションおよび引数は、ユーティリティによって生成される情報のタイプ、またはユーティリティ・タスクの実行方法をさらに定義するのに役立ちます。

次の表に、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