Amazon S3への接続

OCI GoldenGateのターゲットとして使用するAmazon S3への接続の作成について学習します。

開始する前に

次を確認します:

接続の作成

Amazon S3接続を作成するには:

  1. OCI GoldenGateの「概要」ページで、「接続」を選択します。

    「はじめに」セクションの「接続の作成」を選択して、ステップ3にスキップすることも可能です。

  2. 「接続」ページで、「接続の作成」を選択します。

  3. 「接続の作成」ページで、次のようにフィールドに入力します:

    1. 「名前」に、接続の名前を入力します。

    2. (オプション)「説明」に、この接続を他の接続から区別するのに役立つ説明を入力します。

    3. (マルチクラウド上のGoldenGateの場合のみ)「サブスクリプション」を選択し、次のフィールドに入力します。

      1. 「コンパートメント」ドロップダウンで、リソース・アンカーが存在するコンパートメントを選択します。

      2. マルチクラウド・パートナ・リージョンを選択します。

      3. 「パートナ可用性ゾーン」を選択します。使用可能なオプションは、選択したマルチクラウド・パートナ・リージョンに基づいて移入されます。

    4. 「コンパートメント」で、接続を作成するコンパートメントを選択します。

    5. 「タイプ」で、「Amazon S3」を選択します。

    6. 「アクセス・キーID」に、Amazon S3アクセス・キーIDを入力します。

      ノート:アクセス・キーIDに使用できるのは、英数字とアンダースコアのみで、長さは16文字から128文字です。

    7. 「シークレット・アクセス・キー・シークレット」を選択します。別のコンパートメントにある場合は、ドロップダウンを使用してコンパートメントを変更します。

      ノート:

      • シークレットとは、パスワード、証明書、SSHキー、OCIサービスで使用する認証トークンなどの資格証明です。シークレットを作成するには、シークレットの作成を参照してください。次を確認します:

        • 「手動シークレット生成」を選択します。

        • 資格証明をシークレット・コンテンツに貼り付けます。

      • パスワード・シークレットを使用しない場合は、このフォームの下部にある「拡張オプション」の下の「セキュリティ」セクションで「ボールトでシークレットを使用」の選択を解除してください。

      • シークレット・コンテンツを更新する必要がある場合は、次のことを確認してください:

        • プレーン・テキスト・テンプレートを使用して新しいシークレット・バージョンを作成し、更新されたコンテンツを指定します。詳細は、シークレットのコンテンツの更新を参照してください。

        • キャッシュされたシークレット・コンテンツをクリアするには、接続をリフレッシュします。

    8. 「リージョン」に、バケットが存在するリージョンの名前を入力します。

    9. 「エンドポイント」に、S3のAmazon VPCエンドポイントを入力します。

    10. 拡張オプションの表示を展開します。次のオプションを構成できます。

      • セキュリティ

        • この接続にパスワード・シークレットを使用しない「ボールト・シークレットの使用」の選択を解除します。選択されていない場合:

          • すべての暗号化キー管理をOracleに任せるには、「Oracle管理暗号化キーの使用」を選択します。

          • 「顧客管理暗号化キーの使用」を選択して、OCI Vaultに格納されている特定の暗号化キーを選択し、接続資格証明を暗号化します。

      • ネットワーク接続性

        • 共有エンドポイント: 割り当てられたデプロイメントとエンドポイントを共有します。デプロイメントのイングレスIPからの接続を許可する必要があります。

        • 専用エンドポイント: VCN内の割り当てられたサブネット内の専用エンドポイントを介したネットワーク・トラフィック用。この接続のイングレスIPからの接続を許可する必要があります。

          ノート:

          • 専用接続が7日間未割当てのままの場合、サービスはそれを共有接続に変換します。
          • Oracle GoldenGate接続についてさらに学習します。

      • セキュリティ属性: Zero Trust Packet Routing (ZPR)を使用して、この接続へのアクセスを制御するセキュリティ属性を追加します。

      • タグ: タグを追加すると、リソースを編成できます。

  4. 「作成」を選択します。

接続が作成されると、「接続」リストに表示されます。接続をデプロイメントに割り当てて、レプリケーションのターゲットとして使用するようにしてください。

次の手順

既知問題

OCI GoldenGateでのAmazon S3接続の問題

Amazon S3接続の使用時に次のエラーが発生した場合は、サポート・チケットを開き、詳細およびエラー・メッセージを共有します。

ERROR 2024-03-04 11:42:31.000505 [TaskEngine_2(FileFinalizeTask)] - Verify S3 bucket
      [ggstest] failed.com.amazonaws.SdkClientException: Unable to execute HTTP request: s3.us-east-2.amazonaws.com

回避方法:

  1. Cloud Shellに接続します。

  2. 次のCLIサンプルを使用して、新しいAmazon S3接続を作成します:

    oci goldengate connection create-amazon-s3-connection --routing-method SHARED_SERVICE_ENDPOINT --display-name <connection_name> --compartment-id <compartment_ocid> --technology-type AMAZON_S3 --access-key-id <aws_access_key> --secret-access-key <aws_secret> --connection-region <amazon_s3_bucket_region>

  3. 接続をデプロイに割り当てます。

  4. Amazon S3のReplicatを追加して実行します。

または、パブリックアクセスを使用しない場合は、AWS VPCエンドポイントを使用するように Amazon S3接続のバケットを構成します。OCI GoldenGateがVPCエンドポイントを使用してS3バケットにアクセスするには、VCNとAWS VPCの間にIPsec VPNも構成する必要があります。

Amazon S3のエンドポイントを設定するには、Replicatプロパティ・ファイルにgg.eventhandler.s3.urlプロパティを追加し、プライベート接続のエンドポイントを指定します。