本記事では、Amazon Web Services (AWS) PrivateLinkを使用してOceanBase Cloudに接続する方法について説明します。
前提条件
- AWSアカウントが登録済みであること。
- OceanBase Cloudアカウントが登録済みで、クラスタインスタンスとテナントが作成されていること。詳細については、インスタンスの作成およびテナントの作成をご参照ください。本記事では、MySQL互換テナントを例に説明します。
- クライアントIPアドレスがテナントの許可リストに追加されていることを確認してください。具体的な操作については、IPアドレスの許可リストの設定をご参照ください。
初回のプライベートネットワーク接続
インスタンスに利用可能なプライベートネットワークアドレスがない場合は、まずプライベートネットワークアドレスを作成し、その後接続文字列を取得する必要があります。
OB Cloudクラウドデータベースコンソールにログインし、左側のナビゲーションペインで、**ネットワーキング**をクリックします。
ネットワーク設定ページで、**プライベート接続を作成**をクリックします。
ポップアップダイアログで、以下の情報に従って**ステップ1：エンドポイントサービスの作成の設定を完了し、作成**をクリックします。
パラメータ説明クラウドプロバイダの選択 **AWS**を選択します。 インスタンスまたはテナントの選択 接続するインスタンスとテナントを選択します。 対端アカウントIDの入力 AWSアカウントIDです。AWSクラウドコンソールに移動し、右上のユーザー名をクリックして、ドロップダウンメニューからアカウントIDをコピーします。 AWSエンドポイントを作成します。
AWSコンソールでの作成
**ステップ2: エンドポイントを作成で、サービスID**をコピーして保存します。
AWSクラウドコンソールに移動し、検索バーでエンドポイントを検索して、**機能 > エンドポイント**を選択します。
エンドポイントページで、**エンドポイントの作成**をクリックし、以下の設定情報を入力して、エンドポイントの作成をクリックします。
パラメータ説明名前 カスタム名を入力します。 タイプ NLBとGWLBを使用するエンドポイントサービスを選択します。 サービス名 **ステップ2: エンドポイントを作成**でコピーしたサービスIDを入力し、サービスの検証をクリックします。 VPC エンドポイントを作成するVPCを選択し、対象のサブネットを選択します。 AWSエンドポイントが正常に作成されたら、VPCエンドポイントIDをコピーします。その後、エンドポイントページで、作成したエンドポイントを選択し、操作 > プライベートDNS名の変更を選択します。表示された画面で、プライベートDNS名の有効化の下のこのエンドポイントで有効化にチェックを入れて保存します。
コマンドラインによる作成
AWSコンソールにアクセスし、VPC IDとサブネットIDを取得して入力します。
ステップ2: エンドポイントを作成 > AWS CLIによる作成タブで、エンドポイント作成コマンドをコピーします。
AWSコンソールのコマンドラインページで、コピーしたコマンドを実行します。
作成が完了したら、エンドポイントページにアクセスし、VPCエンドポイントIDをコピーします。エンドポイントページで、作成したエンドポイントを選択し、操作 > プライベートDNS名の変更を選択します。表示された画面で、プライベートDNS名の有効化の下のこのエンドポイントで有効化にチェックを入れて保存します。
OceanBase Cloudコンソールに戻り、ステップ2: エンドポイントを作成に、コピーしたVPCエンドポイントIDを入力し、**エンドポイントの作成**をクリックします。
エンドポイントの作成が完了したら、専用DNSが有効になっていることを確認し、**ステップ3：プライベートDNSを有効化でOK**をクリックします。
**ステップ4：データベースにアクセス**で、既存のデータベースとアカウントを選択するか、新しいデータベースとアカウントを作成します。
注意
アカウント作成時には、生成されたパスワードを安全な場所に保管してください。
必要に応じて、OBClientなどの接続方式を選択し、生成された接続文字列をクライアントにコピーして接続します。接続に成功すれば、データベースへのアクセスと利用が可能になります。
既存の利用可能なプライベートネットワークアドレス
既に利用可能なプライベートネットワークアドレスがある場合は、既に作成済みのプライベートネットワーク接続を選択して直接接続できます。以下では、既に作成済みのプライベートネットワーク接続を使用して接続する方法について説明します。新しいプライベートネットワーク接続を作成する必要がある場合は、上記の初めてプライベートネットワーク接続を使用する場合の章を参照して作成してください。
OB Cloudデータベースコンソールにログインします。インスタンスリストページで、対象インスタンスの情報を展開し、対象テナントで、接続 > **接続文字列を取得**を選択します。
ポップアップウィンドウで、**プライベートネットワークアドレスの使用**を選択します。
**ステップ4：データベースにアクセス**で、データベースとアカウントを選択するか、新しいデータベースとアカウントを作成します。
注意
新しいアカウントの作成を選択した場合は、アカウント作成時に生成されたパスワードを適切に記録してください。
必要に応じて、OBClientなどの接続方式を選択し、生成された接続文字列をクライアントにコピーして接続します。接続に成功すれば、データベースへのアクセスと利用が可能になります。
次のステップ
エンドポイントの作成が完了すると、テナントワークスペースのトポロジーマップで作成したエンドポイント情報を確認できます。VPCの変更などの理由で既に作成したエンドポイントを変更する必要がある場合、現在OB Cloudは既存のエンドポイントを削除して再度作成することをサポートしています。エンドポイントの削除手順は以下のとおりです：
OB Cloudコンソールのインスタンスリストページで、対象テナント名をクリックしてテナントワークスペースに入ります。
テナントのダッシュボードにある トポロジー の下で、削除ボタンをクリックして作成したエンドポイントを削除します。