Data Serviceのカスタムドメイン

TiDB Cloud Data Serviceは、各データアプリのエンドポイントにアクセスするためのデフォルトドメイン<region>.data.tidbcloud.comを提供します。パーソナライズと柔軟性を高めるために、デフォルトドメインの代わりにデータアプリにカスタムドメインを設定することもできます。

このドキュメントでは、データアプリでカスタムドメインを管理する方法について説明します。

始める前に

データアプリのカスタムドメインを設定する前に、以下の点にご注意ください。

• セキュリティ上の理由から、カスタムドメインのリクエストはHTTPSのみをサポートしています。カスタムドメインの設定が完了すると、「Let's Encrypt」証明書が自動的に適用されます。
• カスタムドメインは、 TiDB Cloud Data Service内で一意である必要があります。
• TiDB Cloud Starterインスタンスのリージョンによって決定されるデフォルトドメインごとに、設定できるカスタムドメインは1つだけです。

カスタムドメインの管理

以下のセクションでは、データアプリのカスタムドメインを作成、編集、削除する方法について説明します。

カスタムドメインを作成する

データアプリのカスタムドメインを作成するには、次の手順を実行します。

1. プロジェクトのData Serviceページに移動します。
2. 左側のペインで、対象のデータアプリの名前をクリックすると、その詳細が表示されます。
3. 「カスタムドメインの管理」エリアで、 「カスタムドメインの追加」をクリックします。
4. 「カスタムドメインの追加」ダイアログボックスで、以下の操作を行います。
   1. 置き換えたいデフォルトドメインを選択してください。
   2. 希望するカスタムドメイン名を入力してください。
   3. オプション：エンドポイントのプレフィックスとしてカスタムパスを設定できます。カスタムパスを空欄にした場合、デフォルトのパスが使用されます。
5. ベースURLをプレビューして、期待どおりになっているか確認してください。問題がなければ、 「保存」をクリックしてください。
6. DNS設定ダイアログの指示に従って、DNSプロバイダのデフォルトドメインにCNAMEレコードを追加してください。

カスタムドメインは、システムがDNS設定を検証している間、最初は「保留中」の状態になります。DNS検証が成功すると、カスタムドメインの状態は「成功」に更新されます。

カスタム ドメインのステータスがSuccessに設定されると、それを使用してエンドポイントにアクセスできるようになります。 TiDB Cloud Data Serviceによって提供されるコード サンプルは、カスタム ドメインとパスに自動的に更新されます。詳細については、 エンドポイントを呼び出すを参照してください。

カスタムドメインを編集する

データアプリのカスタムドメインを編集するには、次の手順を実行します。

1. プロジェクトのData Serviceページに移動します。
2. 左側のペインで、対象のデータアプリの名前をクリックすると、その詳細が表示されます。
3. カスタムドメインの管理領域で、アクション列を見つけてクリックします。 編集したいカスタムドメインの行を編集してください。
4. 表示されたダイアログボックスで、カスタムドメインまたはカスタムパスを更新してください。
5. ベースURLをプレビューして、期待どおりになっているか確認してください。問題がなければ、 「保存」をクリックしてください。
6. カスタムドメインを変更した場合は、 DNS設定ダイアログの指示に従って、DNSプロバイダのデフォルトドメインにCNAMEレコードを追加してください。

カスタムドメインを削除する

データアプリのカスタムドメインを削除するには、次の手順を実行します。

1. プロジェクトのData Serviceページに移動します。
2. 左側のペインで、対象のデータアプリの名前をクリックすると、その詳細が表示されます。
3. カスタムドメインの管理領域で、アクション列を見つけてクリックします。 削除したいカスタムドメインの行を削除してください。
4. 表示されたダイアログボックスで、削除を確認してください。