デプロイメントの管理

Oracle Cloudコンソールでデプロイメントを編集、スケーリング、停止、起動および削除する方法について学習します。

ノート

GoldenGate REST APIを使用して、OCI GoldenGateデプロイメントを管理できます。Oracle GoldenGateに精通しているユーザーは、サービス・マネージャがOCI GoldenGateに公開されておらず、サービス・マネージャに対して行われたコールは戻らないことに注意してください。

デプロイメントの詳細の表示

「デプロイメント」ページからデプロイメントを選択して、詳細を表示します。「デプロイメントの詳細」ページでは:

  • デプロイメントのステータスの表示。ステータスは次のいずれかになります:
    • 作成中
    • 更新中
    • アクティブ
    • 非アクティブ
    • 削除中
    • 削除済
    • 失敗
    • 注意が必要
      ノート

      デプロイメントのステータスが「注意が必要」の場合、デプロイメント・ヘルスは100%未満です。OCPUの管理および請求について学習します。
  • 次のようなアクションをデプロイメントで実行します。
  • デプロイメント・コンソールを起動します。
  • データ・レプリケーション・デプロイメントの管理クライアントを起動します。
  • デプロイメントの作成日時および最終更新日時などのデプロイメント情報を表示します。
  • コンテキスト依存の通知を設定し、デプロイメント・イベントを常に把握できます
  • データ・レプリケーション・デプロイメントのストレージ使用量の表示。ストレージの使用量制限は、デプロイメントが現在使用しているファイル・システム領域の容量を示します。
    ノート

    ベースOCPU当たり500 GBのハード制限を開始しています。たとえば、4つのベースOCPUの場合、ハード制限は2TBです。このハード制限を超えると、サービスの機能およびパフォーマンスが制限される場合があります。

    アラームを作成してこのイベントを通知します。トレイル・ファイルを管理して領域を解放します。

  • デプロイメントのメンテナンス・ウィンドウを表示およびスケジュールします。
  • 次のようなGoldenGateインスタンス情報を表示します。
  • 次のようなネットワーク情報を表示します。
    • デプロイメントのサブネットの表示/編集
      ノート

      サブネットを変更すると、デプロイメントのイングレスIPおよびプライベートIPも変更されます。
    • パブリックIPアドレス
    • プライベートIPアドレス
    • イングレスIP(割り当てられた接続のトラフィック・ルーティング方法が共有の場合)。
    • ロード・バランサ情報(GoldenGateコンソールのパブリック・アクセスを有効にした場合)。

      警告:

      このリソースは管理できますが、デプロイメントがまだ使用中でもロード・バランサを削除しないでください。
  • デプロイメント・メトリックの表示
  • ネットワーク・セキュリティ・グループの追加および表示
    ノート

    ネットワーク・セキュリティ・グループ(NSG)を追加すると、サブネット内からデプロイメントにアクセスできる場所を詳細に制御できます。さらに学ぶ
  • データ・レプリケーション・デプロイメントの場合は、スケジュール済バックアップを作成または編集します。
  • デプロイメント・バックアップの作成および表示
  • アップグレード履歴を表示します。
  • 接続の表示、割当て、割当て解除および接続のテスト
  • サイズ、順序、プロデューサ、コンシューマなどのトレイル・ファイルの詳細の表示。
    ノート

    データ・レプリケーション・デプロイメントでは、トレイル・ファイルは長期間にわたって増加し、「デプロイメント情報」に表示される「ストレージの使用状況」の数値に大きく影響します。この情報を使用して、トレイル・ファイルを管理します
  • データ・レプリケーション・デプロイメント用のマスター暗号化キー・ウォレットをインポートおよびエクスポートします。
  • 作業リクエストのステータスと、作業リクエストに関連付けられたログ・メッセージ、エラー・メッセージおよびリソースの表示。作業リクエストを作成するデプロイメント操作には、次のものがあります:
    • 作成
    • 更新
    • 削除
    • 移動
    • リストア
    • 停止
    • 起動
    • パッチ適用
  • データ・レプリケーション・デプロイメントのプロセスおよびエラー・ログを有効または無効にします。
    ノート

    Oracle CloudコンソールのOCIロギング・サービスからログを有効化、無効化および表示することもできます。

デプロイメントの編集

デプロイメントを編集するには:

  1. 「デプロイメント」ページでデプロイメントを選択し、「デプロイメントの詳細」ページで「編集」をクリックします。

    編集するデプロイメントの「アクション」(3つのドット)メニューから「編集」を選択することもできます。

  2. 「デプロイメントの編集」ダイアログで、次のフィールドを更新できます:
    • 名前
    • 説明
    • GoldenGateコンソール・パブリック・アクセスの有効化
    • FQDN接頭辞
    • 証明書と秘密キーのペア(保持、削除または置換)
      ノート

      SSL証明書は、次の要件を満たす必要があります:
      • 共通名は、デプロイメントのFQDNと一致する必要があります。そうでない場合は、デプロイメント・コンソールにアクセスしたときに警告が表示されます。
      • 強力なハッシュ・アルゴリズムを使用して署名する必要があります。arcfour、arcfour128、arcfour256、アルゴリズム・タイプは許可されません。
      • 期限切れにしないでください。
      • 最大有効期間は13か月を超えないようにしてください。
      • 自己署名証明書であってはなりません。
      「無効な秘密キー」エラーが発生した場合は、次のOpenSSLコマンドを使用してキーの正確性をチェックできます。証明書に対して次のコマンドを実行します。
      openssl x509 --noout --modulus --in <cert>.pem |openssl md5

      次に、秘密キーに対して次のコマンドを実行します。

      openssl rsa --noout --modulus --in <key>.pem |openssl md5

      2つのコマンドの出力では、同じmd5値が返されます。そうでない場合は、証明書と秘密キーが一致しません。

  3. 「変更の保存」をクリックします。

デプロイメント・ユーザー名の編集

デプロイメント・コンソールへのログインに使用する資格証明ストアを編集できます。

資格証明ストアをOracle Cloud Infrastructure Identity and Access Management (OCI IAM)にまだ変更していない場合は、まずVaultを設定していることを確認してください。Vaultおよびシークレットの管理についてさらに学習します。
  1. デプロイメントの詳細ページの「デプロイメント情報カード」のGoldenGateセクションで、「ユーザー名」の横にある「編集」をクリックします。
    「ユーザー名の編集」パネルが開きます。
  2. 「ユーザー名の編集」パネルでは、次のことができます。
    • 資格証明ストアをGoldenGateからOracle Cloud Infrastructure Identity and Access Management (OCI IAM)に変更します。
    • 資格証明ストアがGoldenGateの場合は、ユーザー名を変更します。
    • 資格証明ストアがGoldenGateの場合は、別のパスワード・シークレットを選択します。
      ノート

      既存のパスワード・シークレットの内容を編集するには、パスワード・シークレットの編集を参照してください。
    • 新規パスワード・シークレットを作成します。新しいパスワード・シークレットを作成するには:
      1. 「パスワード・シークレットの作成」をクリックします。
      2. 「シークレットの作成」パネルで、シークレットの名前、およびオプションで説明を入力します。
      3. シークレットを保存するコンパートメントを「コンパートメント」ドロップダウンから選択します。
      4. 現在のコンパートメント内のボールトを選択するか、「コンパートメントの変更」をクリックして別のコンパートメント内のボールトを選択します。
      5. 暗号化キーの選択
        ノート

        サポートされるのは、AESキー、ソフトウェア保護キーおよびHSMキーのみです。RSAおよびECDSAキーは、GoldenGateパスワード秘密キーではサポートされていません。
      6. パスワードの長さを8から30文字とし、大文字、小文字、数字および特殊文字を少なくとも1つ含みます。特殊文字は、'$'、'^'または'?'にすることはできません。
      7. パスワードの確認
      8. 「作成」をクリックします
  3. 「変更の保存」をクリックします。

パスワード・シークレットの編集

パスワード・シークレットを編集するには:
  1. デプロイメントの詳細ページの「デプロイメント情報」領域のGoldenGateで、パスワード・シークレットをクリックします。
  2. パスワード・シークレットの詳細ページの「バージョン」リストで、「シークレット・バージョンの作成」をクリックします。
  3. 「シークレット・バージョンの作成」ダイアログで:
    1. シークレット・タイプ・テンプレート(プレーン・テキストまたはBase64)を選択します。
    2. 「シークレット・コンテンツ」を入力します。
      ノート

      パスワード・シークレットの内容は8から30文字とし、大文字、小文字、数字および特殊文字を少なくとも1つ含める必要があります。特殊文字は、'$'、'^'または'?'にすることはできません。
    3. 「シークレット・バージョンの作成」をクリックします。
  4. 新しいシークレット・バージョンを選択するには、「編集」をクリックします。
  5. 「シークレットの編集」ダイアログで:
    1. 説明を入力します
    2. 新しいシークレット・バージョンを選択します。
    3. 「変更の保存」をクリックします。シークレットの更新およびアクティブ化には1分かかる場合があります。
  6. OCI GoldenGateが新しいパスワード・シークレット・バージョンを確実に取得するには、デプロイメントの詳細ページに戻り、GoldenGateユーザー名の横にある「編集」をクリックします。
  7. 「編集」パネルで、「変更の保存」をクリックします。

デプロイメントのアップグレード

アップグレード方法、OCI GoldenGateバージョン、アップグレードのスケジュールなどについて学習するには、OCI GoldenGateデプロイメントのメンテナンスを参照してください。

通知の設定

デプロイメントで問題が発生したときにメッセージを受信します。Oracle Cloudコンソールでコンテキスト通知を使用して、デプロイメントのイベント・ルールおよびアラームを作成します。クイック・スタート・テンプレートを使用できます。これらの通知は、通知サービスでアラームを作成するための代替またはショートカットとして設定できます。

テナンシに次のポリシーが追加されていることを確認します:
allow group ContextualNotificationsUsers to manage alarms in tenancy
allow group ContextualNotificationsUsers to read metrics in tenancy
allow group ContextualNotificationsUsers to manage ons-topics in tenancy
allow group ContextualNotificationsUsers to manage cloudevents-rules in tenancy
デプロイメントのコンテキスト通知を設定するには:
  1. 「デプロイメント」ページで、通知を設定するデプロイメントを選択します。
  2. デプロイメントの詳細ページで、「モニタリング」を選択します。
  3. 「モニタリング」ページで、「通知」まで下にスクロールします。
  4. 「通知の作成」パネルでは、次の中から選択できます。
    • クイックスタート: 一連のテンプレートから通知を作成します。
    • 拡張イベント通知: 特定のイベントの通知を作成します。
    • 通知メトリックしきい値を作成するための拡張アラーム通知が超えています。
  5. 「トピックとサブスクリプション」セクションで、既存のトピックを作成または選択します。
  6. 少なくとも1つのサブスクリプション・プロトコルを選択してください:
    • 電子メール、および有効な電子メールアドレスを入力します。
    • Slackで、Slackエンドポイントを入力します。

      サブスクリプションの親トピックにメッセージを発行するときに、デフォルトで指定したSlackチャネルにメッセージを送信します。

      エンドポイント・フォーマット(URL:
      https://hooks.slack.com/services/<webhook-token>

      <webhook-token>には、2つのスラッシュ(/)を含める必要があります。問合せパラメータはURLでは許可されません。(SlackチャネルのWebフックを使用して) Slackサブスクリプションのエンドポイントを作成するには、Slackのドキュメントを参照してください。

    • SMSを選択し、国コードを選択して電話番号を入力します。
  7. (オプション)「トピックとサブスクリプション」の上にリストされているデフォルト設定(イベント・タイプまたはアラームの重大度)を変更します。
  8. 「通知の作成」をクリックします。
  9. 必要に応じて、新しいサブスクリプションを確認します。詳細は、サブスクリプションの確認を参照してください。
通知の条件が満たされるたびに、メッセージが連絡先情報エントリに送信されます。

デプロイメントのスケーリング

デプロイメントは、必要なOracle Compute Unit (OCPU)の量に応じてスケール・アップまたはスケール・ダウンできます。このプロセスを自動化するには、デプロイメントを作成または編集するときに自動スケールを有効にするか、デプロイメントの詳細ページでデプロイメントを手動でスケーリングします。

自動スケーリングを有効にすると、デプロイメントは、「スケール」ダイアログに現在表示されているOCPUの数の最大3倍のメモリーまでスケール・アップできます。1 OCPUは16GBのメモリーに相当します。ワークロードに追加のOCPUが必要な場合、自動スケーリングが有効になっていれば、デプロイメントは手動操作の必要なしに自動的にリソースを使用します。

OCPUの使用状況を確認するには、コンソールの「デプロイメントの詳細」ページの「メトリック」セクションでOCPU使用量グラフを表示できます。

自動スケールを有効にしない場合は、デプロイメントの詳細ページからデプロイメントを手動でスケーリングできます。デプロイメントを手動でスケーリングするには:

  1. 「デプロイメント」ページで、スケーリングするデプロイメントの「アクション」メニューから「スケール」を選択します。

    デプロイメントの「詳細」ページで「スケール」をクリックすることもできます。

  2. 「OCPU数」に、1から24までのOCPU数を入力します。
  3. (オプション)「自動スケーリング」を有効にします。
    自動スケーリングを有効にすると、指定したOCPU数の3倍(最大24 OCPU)までサービスをスケール・アップできます。
  4. 「変更の保存」をクリックします。
デプロイメントが再起動して、行った変更が反映されます。デプロイメントのスケーリングにかかる停止時間は、デプロイメントの停止および再起動にかかる時間と同じです。

診断の収集

診断を収集して、OCI GoldenGateデプロイメントに関する情報を分析または共有します。問題が発生した場合は、収集した情報をMy Oracle Supportと共有できます。

ノート

この機能は、データ・レプリケーション・デプロイメントにのみ適用されます。
診断を収集する前に、OCIオブジェクト・ストレージ・バケットを作成してください。
デプロイメント診断を収集するには:
  1. 「デプロイメント」ページで、診断を収集するデプロイメントを選択します。
  2. デプロイメントの「詳細」ページで、「アクション」メニューから「診断収集」を選択します。
  3. 「診断の収集」パネルで、次のフィールドに入力し、「診断の収集」をクリックします:
    1. 「バケット」ドロップダウンから、診断ファイルを保存するバケットを選択します。別のコンパートメントのバケットを選択する場合は、「コンパートメントの変更」をクリックします。
    2. 「診断名接頭辞」に、診断ファイル名の接頭辞となる短縮名または数個の文字を入力します。
    3. (オプション)システム・ログを収集する開始日を選択します。
    4. (オプション)システム・ログを収集する終了日を選択します。
      ノート

      OCI GoldenGateデプロイメント用に収集される診断には、デプロイメントの存続期間全体のGoldenGateログが含まれます。これは選択した開始日および終了日とは関係ありません。
「診断の収集」をクリックすると、「デプロイメント情報」カードの「GoldenGate」セクションの下に「診断」という名前の新しいフィールドが表示されます。診断zipファイルはダウンロード可能になるまで数分かかることがあります。使用可能になると、「ダウンロード」リンクが表示されます。

デプロイメントの停止

デプロイメントを停止すると、Oracle Cloud Infrastructure GoldenGateも停止します。デプロイメントが停止している間は、OCI GoldenGateデプロイメント・コンソールにアクセスできず、デプロイメントを再起動するまで請求されません。

デプロイメントを停止するには:

  1. 「デプロイメント」ページで、デプロイメントを選択します。
  2. デプロイメントの詳細ページで、「アクション」メニューから「停止」を選択します。

    「デプロイメント」ページで停止するデプロイメントの「アクション」メニューから「停止」を選択することもできます。

  3. 「デプロイメントの停止」ダイアログで「停止」をクリックします。

デプロイメントを停止すると、Oracle Cloud Infrastructure GoldenGateはすべてのアクティブなタスクを停止します。デプロイメントは、「デプロイメント」または「デプロイメントの詳細」ページから再起動できます。

デプロイメントの起動

デプロイメントが作成されると、Oracle Cloud Infrastructure GoldenGateが自動的に起動されます。デプロイメントを停止した場合、デプロイメントの「アクション」メニューの「起動」オプションを使用してデプロイメントを再起動できます。デプロイメントを起動すると、請求も再開されます。

デプロイメントを起動するには:

  1. 「デプロイメント」ページで、デプロイメントを選択します。
  2. デプロイメントの詳細スページで、「アクション」メニューから「開始」を選択します。

    「デプロイメント」ページで起動するデプロイメントの「アクション」メニューから「開始」を選択することもできます。

  3. 「デプロイメントの開始」ダイアログで、「開始」をクリックします。

デプロイメントが起動し、デプロイメント・コンソールを起動できるようになりました。Oracleにより、使用したOracle Compute Unit (OCPU)の量に対する請求が再開されます。

また、デプロイメントの起動時にExtractおよびReplicatが自動的に起動するように構成することもできます。詳細は、「管理対象プロセスの構成」を参照してください。

デプロイメントの移行

デプロイメントは、あるコンパートメントから別のコンパートメントに移動できます。

デプロイメントを移動するには:
  1. 「デプロイメント」ページでデプロイメントを選択し、「アクション」メニューで、「デプロイメントの詳細」ページから「リソースの移動」を選択します。

    「デプロイメント」ページで移動するデプロイメントの「アクション」メニューから「リソースの移動」を選択することもできます。

  2. 「別のパーティションへのリソースの移動」ダイアログで、デプロイメントの移動先となるコンパートメントをドロップダウンから選択します。
  3. 「リソースの移動」をクリックします。

デプロイメントを新しいコンパートメントに移動すると、固有のポリシーがただちに適用され、コンソールを介したデプロイメントへのアクセスに影響を与える可能性があります。詳細は、コンパートメントの管理に関する項を参照してください。

デプロイメントのタグの管理

タグは、テナンシ内のリソースを見つけるのに役立ちます。デプロイメントのタグは、「デプロイメント」ページと「デプロイメントの詳細」ページから追加および表示できます。

「デプロイメント」ページでは、デプロイメントの「アクション」(3つのドット)メニューから「タグの追加」または「タグの表示」を選択します

「デプロイメント詳細」ページでは、「アクション」メニューから「タグの追加」を選択するか、「タグ」タブをクリックしてタグを表示および編集できます。

タグ付けについてさらに学習します。

デプロイメントの削除

デプロイメントを削除すると、そのデプロイメント内のすべてのアクティブなOracle GoldenGateタスクが停止します。デプロイメントを削除しても、チェックポイント表やExtract情報などの参照は、デプロイメントが使用したデータベースから削除されません。一度削除したデプロイメントはリストアできません

デプロイメントを削除するには:

  1. 「デプロイメント」ページでデプロイメントを選択し、「アクション」メニューから「削除」を選択します。

    「デプロイメント」ページで削除するデプロイメントの「アクション」メニューから「削除」を選択することもできます。

  2. 「デプロイメントの削除」ダイアログで、「削除」をクリックします。

デプロイメントの削除後、ソース・データベースおよびターゲット・データベースに残っているファイルを手動で削除する必要がある場合があります。詳細は、「手動で削除するファイル」を参照してください。

デプロイメントへの接続の割当て

ソース・テクノロジとターゲット・テクノロジの接続が作成されていることを確認します。
ノート

パスワード・シークレットで接続を使用する場合、接続を割り当てるデプロイメントは、接続のパスワード・シークレットにアクセスできる必要があります。ポリシーallow dynamic-group <group-name> to read secret-bundles in <location>をコンパートメントまたはテナンシに追加していることを確認します。
デプロイメントに接続を割り当てるには:
  1. 「デプロイメントの詳細」ページの「リソース」で、「割当て済接続」をクリックします。
  2. 「割当て済接続」をクリックします。
  3. 「接続の割当て」ダイアログで、ドロップダウンから接続を選択します。別のコンパートメントから接続を選択する場合は、「コンパートメントの変更」をクリックします。
  4. 「割当て済接続」をクリックします。
選択した接続が「割当て済接続」リストに表示されます。この関係は、「割当て済デプロイメント」の「接続の詳細」ページから表示および管理することもできます。
ノート

専用エンドポイントとの接続が7日間未割当てのままである場合、サービスはそれを共有エンドポイントに変換します。

デプロイメントに接続を割り当てると、GoldenGateは、入力した名前から許可されていない文字を削除し、30文字の長さに切り捨てます。名前には英数字のみを使用し、別名パターン^[a-zA-Z][a-zA-Z0-9_#$]*$に従う必要があります。同じ別名の接続がすでに割り当てられている場合、新しい別名に番号が自動的に追加されます。

接続のテスト

デプロイメントに接続を割り当てた後、接続をテストして、デプロイメントが接続できることを確認します。

テスト接続では、ネットワーク・レベルとアプリケーション・レベルの2つのタイプのテストが実行されます。ネットワーク・レベルの接続テストでは、ホストとポートがデプロイメントから到達可能であることを確認し、アプリケーション・レベルのテストでは、エンドポイントにログインして資格証明が有効であることを確認します。

一部の接続では両方のテストが実行されますが、ビッグ・データ接続タイプなどの接続では、現在アプリケーション・レベルのテストがサポートされていません。接続がネットワーク・レベルの接続テストに合格しているかぎり、接続を使用し、ExtractおよびReplicatプロセスの作成を開始できます。

接続をテストする前に、最初に接続を作成してデプロイメントに割り当てたことを確認してください。

割り当てられた接続をテストするには:
  1. デプロイメントの詳細ページで、「割当て済接続」をクリックします。

    接続の詳細ページで、割当て済デプロイメントから接続をテストすることもできます。

  2. 割当済接続のリストで、テストする接続の「アクション」メニューから「接続のテスト」を選択します。

    「接続のテスト」ダイアログが開き、成功した場合は確認メッセージが表示され、失敗した場合はエラー・メッセージが表示されます。エラー・メッセージが表示された場合は、接続および設定に戻ります。

  3. 「閉じる」をクリックします

接続の割当て解除

デプロイメントから接続を削除(割当て解除)できます。まず、削除する接続に関連するアクティブなプロセスがデプロイメントで実行されていないことを確認します。
接続を割当て解除するには:
  1. デプロイメントの詳細ページで、「割当て済接続」をクリックします。
  2. 割当てを解除する接続の「アクション」メニューから、「割当てを解除」を選択します。
  3. 「接続の割当て解除」ダイアログで、このデプロイメントから接続を割当て解除することを確認し、「接続の割当て解除」をクリックします。
接続は、「割当て済接続」リストに表示されなくなります。接続を割当て解除しても、接続は削除されません。接続を削除する場合は、接続の削除を参照してください。
ノート

専用エンドポイントとの接続が7日を超えて未割当てのままである場合、サービスはそれを共有エンドポイントに変換します。