OCIチュートリアル
タグ検索 トップページへ戻る

101: キューを作成する

タグ: #Queue

OCI Queueの基本単位となるキューを作成します。本章ではOracle管理キーとデフォルト構成を使用します。

所要時間 : 約20分

前提条件 :

  1. OCIコンソールへサインインできること
  2. <対象コンパートメント>でQueueを管理できること
  3. Queueを利用できるリージョンとサービス制限の空きが確認済みであること

注意 : リージョン、コンパートメント名、OCIDなどの環境固有値を共有ファイルや共有画面へ記録しないでください。

目次:

1. 全章で必要なポリシーを準備する

本チュートリアル全体では、Queueの作成・送受信・削除、コンシューマ・グループ、メトリック確認、Cloud Shell、201章の検証用ポリシー操作を行います。学習期間中だけ使用する専用コンパートメントとグループを用意し、少数の文で全操作をカバーします。

次は、具体的なチュートリアル用名称を使った例です。

  • ポリシー名: OCIQueueTutorialAuthoringPolicy
  • グループ名: OCIQueueTutorialAuthors
  • コンパートメント名: OCIQueueTutorial
Allow group OCIQueueTutorialAuthors to manage all-resources in compartment OCIQueueTutorial
Allow group OCIQueueTutorialAuthors to use cloud-shell in tenancy

1文目は専用コンパートメント内だけを対象とします。テナンシ全体へmanage all-resourcesを付与しないでください。2文目はCloud Shellの起動に使用します。既存ポリシーで同等以上の権限がある場合は、重複して作成する必要はありません。

自分の環境へコピーする場合は、山括弧の3か所を置き換えます。

Allow group <チュートリアル制作者グループ名> to manage all-resources in compartment <チュートリアル専用コンパートメント名>
Allow group <チュートリアル制作者グループ名> to use cloud-shell in tenancy
  1. テナンシ管理者へ、対象グループ、専用コンパートメント、既存権限との差分と上記2文を提示します。
  2. 管理者がポリシーを作成するか、既存権限で充足することを確認します。
  3. 対象ユーザーがグループへ所属していることと、Cloud Shellを起動できることを確認します。
    • 期待結果: Queueとコンシューマ・グループを専用コンパートメント内で管理でき、Cloud Shellを起動できます。
    • 失敗時確認: グループ名、アイデンティティ・ドメイン、コンパートメント階層、ポリシー配置先、反映待ちを確認します。
Cloud Shellの起動確認

組織方針でall-resourcesを使用できない場合は、1文目を次の2文へ置き換えます。

Allow group <チュートリアル制作者グループ名> to manage queues in compartment <チュートリアル専用コンパートメント名>
Allow group <チュートリアル制作者グループ名> to manage queue-consumer-group in compartment <チュートリアル専用コンパートメント名>

参考: キュー・ポリシー(日本語)クラウド・シェル(日本語)ポリシー構文(日本語)

2. Queue画面を開く

  1. OCIコンソールのナビゲーション・メニューから開発者サービスアプリケーション統合キューを選択します。
    • 期待結果: キューの一覧が表示されます。
    • 失敗時確認: リージョンがQueue対応リージョンか、Queue画面を表示する権限があるかを確認します。
  2. 画面上部のリージョンと一覧のコンパートメントを、事前に決めた値へ合わせます。
    • 期待結果: <対象コンパートメント>のキュー一覧が表示されます。
    • 失敗時確認: コンパートメントの参照権限と、選択したリージョンを確認します。
Queueの一覧画面

3. キューを作成する

  1. キューの作成をクリックします。
  2. 名前queue-tutorial-basicを入力し、コンパートメントを確認します。リソース名に個人名や案件名を含めないでください。
Queueの基本情報の入力

  1. デフォルト構成を選択し、暗号化がOracle管理キーであることを確認します。
Queueの構成と暗号化設定

  1. コンシューマ・グループは無効のまま、キューの作成をクリックします。
    • 期待結果: 詳細ページへ移動し、状態が作成中からアクティブになります。
    • 失敗時確認: manage queues相当の権限、サービス制限、表示名の重複や入力規則を確認します。
作成したQueueの詳細

4. 確認

詳細ページで表示タイムアウト、最大保持期間、最大配信試行回数、暗号化、メッセージ・エンドポイントを確認します。環境固有値はコピーして本文へ貼り付けず、必要な操作時だけOCIコンソールまたはCloud Shellで参照します。

期待結果は、キューの状態がアクティブであることです。

Queueの設定値の確認

5. トラブルシュート

  • 一覧へ表示されない場合はリージョンとコンパートメントを再確認します。
  • 認可エラーの場合はIAMを変更せず、必要なポリシー案を管理者へ提示します。
  • 作成が長時間完了しない場合は作業リクエストとサービス状態を確認します。

6. 作成したリソースの削除

後続章で使用するため、本章では削除しません。queue-tutorial-basicは105章の手順で削除します。

参考: キューの作成