Oracle Cloud Infrastructureドキュメント

「イベント」の概要

Oracle Cloud Infrastructure Eventsを使用すると、テナンシ全体でのリソースの状態変更に基づいて自動化を作成できます。 「イベント」を使用すると、リソースがその状態を変更したときに、開発チームが自動的に応答できるようになります。

イベントの使用例を示します: 

  • データベースのバックアップが完了したら、DevOpsチームに通知を送信します。
  • ファイルが「オブジェクト・ストレージ」バケットにアップロードされる場合、ある形式のファイルを別の形式に変換します。

ノート

「イベント」は、Oracle Cloud Infrastructure Government Cloudでは使用できません。

「イベント」のしくみ

Oracle Cloud Infrastructureサービス送信「イベント」は、リソースの変更を示す構造化メッセージです。 イベント(サービスではなく)は、「クラウド・ネイティブ・コンピューティング基金(CNCF)」がホストするCloudEventsの業界標準の形式に従います。 この標準により、様々なクラウド・プロバイダ間、オンプレミス・システム間およびクラウド・プロバイダ間の相互運用性が可能になります。 イベントは、作成、読取り、更新または削除(CRUD)操作、リソースのライフサイクル状態の変更、またはリソースに影響するシステム・イベントです。 たとえば、バックアップが完了または失敗したときにイベントが表示されるか、「オブジェクト・ストレージ」バケット内のファイルが追加、更新または削除されたときです。

リソースまたはデータのサービス発行イベント。 たとえば、「オブジェクト・ストレージ」では、バケットとオブジェクトのイベントが生成されます。 サービスはリソースに対して異なるタイプのイベントを発行し、リソースは「イベント型」と識別されます。 バケットおよびオブジェクトのイベント・タイプには、たとえば、作成、更新および削除があります。 イベント・タイプは、特定のリソースによってイベントを生成する変更です。 イベントを生成するサービスのリストおよびそれらのサービスが追跡するイベント・タイプについては、「イベントを生成するサービス」を参照してください。

イベントの操作には、「ルール」を作成します。 ルールには、テナンシのリソースによって生成されるイベントを指定するために定義するフィルタが含まれます。 フィルタは柔軟性があります:

  • 特定のイベントのみまたはすべてのイベントに一致するフィルタを定義できます。
  • リソースのタグ付け方法、またはイベント自体からの属性の特定値の存在に基づいてフィルタを定義できます。

ルールは、フィルタが一致するイベントを検出したときにトリガーするactionも指定する必要があります。 アクションとは、イベント照合に対して定義するレスポンスです。 「イベント」サービスでアクションとして確立されたOracle Cloud Infrastructureサービスを設定します(これらの選択サービスの設定が続きます)。 これらのサービスのリソースは、イベントを照合する宛先として機能します。 ルール内のフィルタが一致を検出すると、「イベント」サービスは、ルールで指定した1つ以上の宛先に一致イベントを配信します。 イベントを受信する宛先サービスによって、定義した方法でイベントが処理されます。 この配信により、環境の自動化が行われます。

イベントは、ルールを使用して特定のOracle Cloud Infrastructureサービスにのみ配信できます。 次のサービスを使用してアクションを作成します: 

このイメージは、イベント・サービスの図を示しています

「イベント」の概念

「イベント」を使って作業するには、次の概念が不可欠です。

イベント
イベント生成Oracle Cloud Infrastructureリソースによってレポートされる、状態変更の自動通知。 たとえば、データベース・リソースは、バックアップの開始時にbackup.beginイベントを生成します。
イベント・タイプ
各種のイベントを区別するものです。 詳細は、「イベントを生成するサービス」を参照してください。
ルール
イベント・タイプをサブスクライブし、そのイベントが発生した場合にアクションをトリガーするために作成するJSONオブジェクト。 たとえば、ルールでは、データベースからのbackup.endイベント・タイプによって「通知」サービスがトリガーされ、特定のDevOpsエンジニアに電子メールが送信されるように指定できます。 詳細は、「フィルタを使用したイベントの照合」を参照してください。
アクション
ルールは、フィルタが一致するイベントを検出したときにトリガーするactionも指定する必要があります。 アクションとは、イベント照合に対して定義するレスポンスです。 「イベント」サービスでアクションとして確立されたOracle Cloud Infrastructureサービスを設定します。 これらのサービスのリソースは、イベントを照合する宛先として機能します。 ルール内のフィルタが一致を検出すると、「イベント」サービスは、ルールで指定した1つ以上の宛先に一致イベントを配信します。 イベントを受信する宛先サービスによって、定義した方法でイベントが処理されます。 この配信により、環境の自動化が行われます。
イベントは、ルールを使用して特定のOracle Cloud Infrastructureサービスにのみ配信できます。 次のサービスを使用してアクションを作成します: 

リージョン可用性

「イベント」は、現在以下のリージョンで利用可能です:

リージョン名 リージョン識別子 リージョンのロケーション リージョン・キー
大韓民国中部(ソウル) ap-seoul-1 アジア太平洋: ソウル、韓国 ICN
日本東部(東京) ap-tokyo-1 アジア太平洋: 東京、日本 NRT
カナダ南東部(トロント) ca-toronto-1 カナダ: トロント YYZ
ドイツ中央部(フランクフルト) eu-frankfurt-1 ヨーロッパ: フランクフルト、ドイツ FRA
英国南部(ロンドン) uk-london-1 イギリス: ロンドン LHR
米国東部(アッシュバーン) us-ashburn-1 アメリカ合衆国: アッシュバーン、VA IAD
米国西部(フェニックス) us-phoenix-1 アメリカ合衆国: フェニックス、AZ PHX

Oracle Cloud Infrastructureにアクセスする方法

コンソール (ブラウザベースのインタフェース)またはREST APIを使用して、Oracle Cloud Infrastructureにアクセスできます。 コンソールおよびAPIの手順は、このガイドのトピックに含まれています。 使用可能なSDKのリストは、「ソフトウェア開発キットとコマンドライン・インタフェース」を参照してください。

コンソールにアクセスするには、「サポートされているブラウザ」を使用する必要があります。 このページの上部にあるコンソール・リンクを使用して、サインイン・ページにアクセスできます。 クラウド・テナント、ユーザー名、およびパスワードを入力するよう求められます。

認証と認可

Oracle Cloud Infrastructureの各サービスは、すべてのインタフェース(コンソール、SDKまたはCLI、およびREST API)の認証および認可のためにIAMと統合されています。

組織の管理者は、どのユーザーがどのサービス、どのリソースおよびアクセスのタイプにアクセスできるかを制御するグループ、コンパートメントおよびポリシーを設定する必要があります。 たとえば、ポリシーは、新しいユーザーの作成、クラウド・ネットワークの作成と管理、インスタンスの起動、バケットの作成、オブジェクトのダウンロードなどを実行できるユーザーを制御します。詳細は、「ポリシーの開始」を参照してください。 異なる各サービスに対するポリシーの記述の詳細は、「ポリシー・リファレンス」を参照してください。

会社が所有するOracle Cloud Infrastructureリソースを使用する必要がある通常のユーザー(管理者ではない)の場合は、管理者に連絡してユーザーIDを設定してください。 管理者は、使用する必要があるコンパートメントを確認できます。

管理者: ルールを使用するユーザーに許可するだけでなく、ルールにアクションとして指定されたリソースへの「イベント」サービス・アクセス権を付与するポリシーを記述する必要があります。 詳細は、「イベントおよびIAMポリシー」を参照してください。

「イベント」リソースの制限

「イベント」サービスでは、テナンシごとに50のルールに対する制限があります。

適用可能な制限の一覧と制限の増加をリクエストする手順については、「サービス制限」を参照してください。

サービス・ゲートウェイおよび「イベント」

「イベント」サービスは、サービス・ゲートウェイを介したVCNのOracle Cloud Infrastructureリソースからのプライベート・アクセスもサポートします。 サービス・ゲートウェイを使用すると、プライベート・サブネット内のプライベートIPアドレスから「イベント」パブリック・エンドポイントに接続できます。 たとえば、インターネットを介してではなく、Oracle Cloud Infrastructureバックスラッシュを使用してルールを管理できます。 オプションで、「イベント」にアクセスできるVCNまたはIPアドレス範囲を制御するために、IAMポリシーを使用できます。 詳細については、「Oracle Servicesへのアクセス: サービス・ゲートウェイ」を参照してください。