コンピュート・インスタンス上の管理エージェントの管理タスク

管理エージェントがコンピュート・インスタンスにデプロイされているときは、様々な管理タスクを実行できます。

コンピュート・インスタンス上の管理エージェントの無効化

コンピュート・インスタンスを使用する場合は、Oracle Cloud Agent機能を使用して管理エージェント・プラグインを無効にできます。

管理エージェントを無効にするには、OCIコンソールまたはコンピュートAPIを使用します。

進める前に、コンピュート・インスタンスへの管理エージェントのデプロイの前提条件の実行の説明に従って、必要な前提条件タスクを実行したことを確認します。

管理エージェントを無効にするには、OCIコンソールまたはコンピュートAPIを使用します。

ノート

コンピュート・インスタンスで管理エージェント・プラグインを正常に無効化すると、管理エージェント・プロセスがただちに停止されます。この操作により、Javaランタイム(JRE)はディスクに残ります。これは、そのバージョンのJavaランタイムに対して新しい脆弱性が検出された場合、将来、潜在的なセキュリティ・リスクとしてフラグが付けられる可能性があります。これに対処するには、ソフトウェアおよび状態ディレクトリを手動でクリーンアップする必要があります。詳細は、次を参照してください。

昇格された権限を持つユーザーとして、ディスク上の次のディレクトリを削除します。
```
/var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris
/var/lib/oracle-cloud-agent/plugins/oci-managementagent/download
```
上記は、管理エージェントの使用を停止し、今後エージェントを再帰する計画がない場合にのみ実行する必要があります。将来、管理エージェントを使用する予定の場合は、自動アップグレードを有効にするか、エージェントを手動で定期的にアップグレードする必要があります。

コンソールを使用した管理エージェントの無効化

管理エージェント・プラグインがインスタンスに対して無効になっているかどうかを確認するには:

ナビゲーション・メニューを開き、「コンピュート」をクリックします。「コンピュート」で、「インスタンス」をクリックします。
目的のインスタンスをクリックします。
「Oracle Cloud Agent」タブをクリックします。
管理エージェント・プラグインの「無効」スイッチを切り替えます。

コンピュートAPIを使用した管理エージェントの無効化

APIの使用の詳細は、REST APIを参照してください。

SDKについては、ソフトウェア開発キットとコマンドライン・インタフェースを参照してください。

次のAPI操作を使用して、管理エージェントをOracle Cloud Agentプラグインとして管理します:

LaunchInstance - インスタンスの作成時に、プラグインを有効または無効にしたり、すべてのプラグインを停止したりします。
UpdateInstance - 既存のインスタンスで、個々のプラグインを有効または無効にしたり、すべてのプラグインを停止または起動したりします。

次に示すのは、LaunchInstanceまたはUpdateInstance API操作に含まれるJavaサンプルからの抽出です。ユーザーはこれを使用して、コンピュート・インスタンスの起動時または更新時に管理エージェントを有効化できます:

... 
    .agentConfig(LaunchInstanceAgentConfigDetails.builder()
			.isMonitoringDisabled(false)
			.isManagementDisabled(true)
			.areAllPluginsDisabled(false)
			.pluginsConfig(new ArrayList<>(Arrays.asList(InstanceAgentPluginConfigDetails.builder()
					.name("Management Agent")   
					.desiredState(InstanceAgentPluginConfigDetails.DesiredState.esiredState.Disabled).build()))).build())
...

ここで、.name("Management Agent")はこれが管理エージェント・プラグイン用であることを示し、.desiredState(InstanceAgentPluginConfigDetails.DesiredState.Disabled).build()))).build())は管理エージェント・プラグインを無効化することを示します。

コンピュート・インスタンス上の管理エージェントのアップグレード

管理エージェントのアップグレードには、次の2つの方法を使用できます。

手動アップグレード

コンピュート・インスタンスでOracle Cloud Agentを使用している場合、管理エージェントをアップグレードする前に、次を確認する必要があります:

管理エージェントがOracle Cloud Agentインタフェースで有効化されています。
管理エージェントが完全に機能するために必要なポリシーがすでに適切に設定されています。

管理エージェントをアップグレードするには、次のコマンドを実行します:

sudo -u oracle-cloud-agent /usr/libexec/oracle-cloud-agent/plugins/oci-managementagent/oci-managementagent -cli -upgrade-native-agent

自動アップグレード

管理エージェント・サービスは自動アップグレードをサポートします。

自動アップグレードの有効化機能はテナンシ・レベルで設定されます。ユーザーは、現在のテナンシに存在するすべての管理エージェントに対して自動アップグレードを有効にできます。

デフォルトの自動アップグレード・ステータス:無効にします。

要件:

権限:自動アップグレード機能を有効にするには、テナンシ・ルート・コンパートメントのMGMT_AGENT_UPDATE権限が必要です。次のポリシー構文を使用します。
```
ALLOW GROUP <group_name> TO USE management-agents IN TENANCY
```
管理エージェント・ポリシーの詳細は、管理エージェントの詳細を参照してください。
最小管理エージェント・バージョン: 211116.xxxx以上。

自動アップグレードの有効化

管理エージェント・コンソールを使用して自動アップグレードを有効にできます。

「管理エージェント」ホームページで、左側のメニューから「ダウンロードとキー」をクリックします。

ページの上部に「エージェントの自動アップグレード」ペインが表示されます。
「エージェントの自動アップグレード」ペインで、「自動アップグレードの有効化」をクリックします。

「自動アップグレードの有効化」ウィンドウが表示されます。
「自動アップグレードの有効化」ウィンドウで、「OK」をクリックして、現在のテナンシ内のすべての管理エージェントの自動アップグレードを有効にします

自動アップグレードの無効化

管理エージェント・コンソールを使用して、自動アップグレードを無効にできます。

「管理エージェント」ホームページで、左側のメニューから「ダウンロードとキー」をクリックします。

ページの上部に「エージェントの自動アップグレード」ペインが表示されます。
「エージェントの自動アップグレード」ペインで、「自動アップグレードの無効化」をクリックします。

「自動アップグレードの無効化」ウィンドウが表示されます。
「自動アップグレードの無効化」ウィンドウで、「OK」をクリックして、現在のテナンシ内のすべての管理エージェントの自動アップグレードを無効にします。

自動アップグレードを有効化および無効化するための使用可能なCLIコマンドのリストについては、Oracle Cloud Infrastructure CLIコマンド・リファレンスを参照してください。

コンピュート・インスタンス上の管理エージェントのソース資格証明

管理エージェントがコンピュート・インスタンス上で実行している際には、様々なソースからデータを収集する必要があります。場合によっては、ソース資格証明が必要になることがあります。

ソース資格証明の管理方法の詳細は、管理エージェントでの資格証明の作成および管理を参照してください。

コンピュート・インスタンスの管理エージェント・ログおよび構成ファイルの確認

管理エージェントは、有効になるとoracle-cloud-agent OSユーザーとして実行されています。

次のディレクトリには、環境のログおよび構成に関する情報を含むファイルが含まれています。

エージェント・ログ・ディレクトリ:

/var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/log

エージェント構成ディレクトリ:

/var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/config

エージェント・ユーティリティ・ディレクトリ:

/var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/bin

コンピュート・インスタンス上の管理エージェントの監査ログ

管理エージェント・サービスでは、監査サービスによるロギングをサポートしています。これによって、サポートされるすべてのOracle Cloud Infrastructureパブリック・アプリケーション・プログラミング・インタフェース(API)エンドポイントへのコールがログ・イベントとして自動的に記録されます。詳細は、管理エージェントの監査ログを参照してください。

Oracle Cloud Infrastructureドキュメント