Private Cloud Connector

Private Cloud Connector はオンプレミスのコネクタであり、Docker コンテナとして実行するか、Helm を介してKubernetes にデプロイできます。コネクタは、会社のファイアウォール、プライベートネットワーク、またはVirtual Private Cloud (VPC) の内側にあるデータと、Connect AI のクラウドベースのサービスとの間を安全なリバーストンネルで接続します。これにより、データをインターネットに直接公開することなく、Connect AI がデータにアクセスできます。

各コネクタは、個々の接続設定の中でConnect AI のユーザーインターフェースに登録します。複数の場所にコネクタを配置することが可能です。場所ごとにConnect AI にコネクタを登録する必要があります。 Private Cloud Connector は、同一の場所とアカウントId を指す複数のコネクタインスタンス（複数のDocker コンテナ、またはKubernetes デプロイメントのレプリカ）をサポートすることで、高可用性を実現します。1 つのインスタンスが停止した場合、リクエストは残りのコネクタインスタンスに自動的にルーティングされます。次の図は、Private Cloud Connector が複数の場所と複数のデータソースをどのようにサポートするかを示しています。

Private Cloud Connector Architecture Advanced

以下は、Connect AI がPrivate Cloud Connector でサポートするコネクタの一部です：

Private Cloud Connector で別のコネクタが必要な場合は、CData サポートにお問い合わせください。 Private Cloud Connector のセットアップには、次の 3 つの主要なステップがあります：

Connect AI にPrivate Cloud Connector を登録する。

オンプレミスデータが存在する各場所でコネクタをインストールして実行します。Docker でPrivate Cloud Connector をデプロイするか、Kubernetes でPrivate Cloud Connector をデプロイするかのいずれかを選択できます。

Connect AI でPrivate Cloud Connector セットアップを完了し、コネクタをテストしてコネクションを完成させます。

Connect AI にPrivate Cloud Connector を登録する

Connect AI にPrivate Cloud Connector を登録するには、次の手順に従います：

Sources に移動し、新しいコネクションの場合は Add Connection をクリックするか、既存のコネクションを編集します。

Add/Edit Connection ページでPrivate Cloud Connector タブをクリックします。

Connectors でAdd をクリックします。Add Connector ダイアログが表示されます。

コネクタがインストールされている場所を識別するための説明的な場所名を入力し、Confirm をクリックします。Connectors リストに場所が表示され、キーとPending ステータスが示されます。目のアイコンをクリックしてキーを確認できます。

コネクタに必要な次の値をコピーしてください（コピーアイコンをクリックします）：

Account Id–コネクタのACCOUNT_ID 環境変数です。
Location Id–コネクタのGATEWAY_LOCATION_ID 環境変数です。
Key–コネクタのGATEWAY_API_KEY 環境変数です。

Docker でPrivate Cloud Connector をデプロイする

Private Cloud Connector は、ネットワーク内で動作する軽量なサービスで、Connect AI とローカルデータソースの間を安全なリバーストンネルで接続します。コネクタは起動時にConnect AI に自己登録します。その後、Azure Relay テクノロジーを使用して受信接続を待機しますが、パブリックインターネットに公開されることはありません。コネクタはプロトコルに依存しません。データベースプロトコル（MySQL、PostgreSQL、SQL Server など）を認識せずに生のバイトをそのまま転送するため、TCP ベースのデータソースと互換性があります。

前提条件

Private Cloud Connector をDocker コンテナとして実行するには、次のものが必要です：

ホストマシンに Docker がインストールされていること。
cloud.cdata.com へのネットワークアクセスがあること。
Connect AI でコネクタが作成されていること。
ホストの IP フォワーディング（net.ipv4.ip_forward=1）が有効になっていること。Docker がコンテナのアウトバウンド接続にこれを必要とします。OS のパッチ適用やセキュリティハードニングのベースライン（CIS/STIG）によって 0 にリセットされる場合があるので注意してください。
*.servicebus.windows.net、*.azurecr.io、および *.cdata.com に対して、エグレスTLS インスペクションをバイパスする必要があること。これらのエンドポイントでSSL インスペクションを行うと、コネクタのリレートンネルを確立できなくなります。

環境変数

コネクタを実行するには、次の環境変数が必要です：

変数	説明
GATEWAY_LOCATION_ID	このコネクタインスタンスの一意の識別子です。Connect AI のConnectors リストで、ユーザーが定義したLocation Name の下に表示される値をコピーします。
GATEWAY_API_KEY	このコネクタをConnect AI で認証するためのシークレットAPI キーです。Connect AI のConnectors リストのKey の下に表示される値をコピーします。
ACCOUNT_ID	CData Connect AI のアカウント識別子です。組織固有の値です。Connect AI のConnectors リストのAccount Id をコピーします。

Docker でコネクタを実行する

次のようにコネクタを実行します：

docker run \
    --name my-onprem-gateway \
    -e GATEWAY_LOCATION_ID=<gateway_location_id> \
    -e GATEWAY_API_KEY=<gateway_api_key> \
    -e ACCOUNT_ID=<account_id> \
    connectaipublic.azurecr.io/connectgateway:latest

docker run は、Docker イメージがホストにまだ存在しない場合、レジストリからイメージをプルします。

Docker ログを確認する

docker logs -f my-onprem-gateway

コネクタを停止する

docker stop my-onprem-gateway
docker rm my-onprem-gateway

Docker Compose

次の内容をコピーして docker-compose.yml として保存します：

version: "3.8"

services:
  onprem-gateway:
    image: connectaipublic.azurecr.io/connectgateway:latest
    container_name: my-onprem-gateway
    restart: unless-stopped
    environment:
      GATEWAY_LOCATION_ID: <gateway_location_id>
      GATEWAY_API_KEY: <gateway_api_key>
      ACCOUNT_ID: <account_id>

Private Cloud Connector を起動する

docker compose up

docker compose up は、Docker イメージがホストにまだ存在しない場合、レジストリからイメージをプルします。

ログを確認する

docker compose logs -f

Private Cloud Connector を停止する

docker compose down

Kubernetes でPrivate Cloud Connector をデプロイする

Private Cloud Connector のKubernetes Helm チャートは GitHub リポジトリで公開されています。

前提条件

Kubernetes にPrivate Cloud Connector をデプロイするには、次のものが必要です：

Kubernetes 1.25 以降
Helm 3.10 以降
クラスタに Metrics Server がインストールされていること（メモリベースのオートスケーリングに必要）
クラスタから cloud.cdata.com へのネットワーク送信
*.servicebus.windows.net、*.azurecr.io、および *.cdata.com に対して、エグレスTLS インスペクションをバイパスする必要があること。これらのエンドポイントでSSL インスペクションを行うと、コネクタのリレートンネルを確立できなくなります。
Connect AI のAccount Id、Location Id、およびKey。これらの値の場所についてはConnect AI にPrivate Cloud Connector を登録するを参照してください。

クイックスタート

Helm リポジトリを追加します：

helm repo add cdata https://cdatasoftware.github.io/connect-gateway-helm
helm repo update

チャートをインストールします：

helm install connect-gateway cdata/connect-gateway \
  --set gateway.locationId=<location-id> \
  --set gateway.accountId=<account-id> \
  --set gateway.apiKey=<api-key> \
  -n connect-gateway --create-namespace

GitHub リリースから直接インストールすることもできます。これは、エアギャップ環境や Helm リポジトリを追加したくない場合に便利です。以下の URL のバージョンは、最新のリリースに置き換えてください。

helm install connect-gateway \
  https://github.com/CDataSoftware/connect-gateway-helm/releases/download/v1.0.0/connect-gateway-1.0.0.tgz \
  --set gateway.locationId=<location-id> \
  --set gateway.accountId=<account-id> \
  --set gateway.apiKey=<api-key> \
  -n connect-gateway --create-namespace

本番環境では、ゲートウェイ認証情報を含む Kubernetes Secret を作成し、--set gateway.apiKey=… の代わりに --set existingSecret=<secret-name> を渡してください。--set で API キーを渡すと、シェルの履歴と Helm リリースに保存される values に書き込まれます。シークレット管理のパターンについては Helm チャートの Readme ファイルを参照してください。

Private Cloud Connector が動作していることを確認する

コネクタのPod が準備完了になっていることを確認し、ログを表示します：

kubectl get pods -n connect-gateway
kubectl logs -n connect-gateway -l app.kubernetes.io/name=connect-gateway -f

Private Cloud Connector をアップグレードする

helm repo update
helm upgrade connect-gateway cdata/connect-gateway -n connect-gateway

Private Cloud Connector をアンインストールする

helm uninstall connect-gateway -n connect-gateway

インストールオプション、設定値、シークレット管理パターンの完全なリストについては、Helm チャートの Readme ファイルを参照してください。

Private Cloud Connector セットアップを完了する

Connect AI に戻り、Private Cloud Connector のセットアップを完了します。

Docker でPrivate Cloud Connector をデプロイするまたは Kubernetes でPrivate Cloud Connector をデプロイするのステップが完了したら、Connectors に追加したコネクタをテストできます。Add/Edit Connection ページのPrivate Cloud Connector タブをクリックします。Test Connectors をクリックします。すべてのコネクタのセットアップが完了すると、Status がSuccess に変わります。

コネクション全体をテストするには、引き続き Save & Test をクリックする必要があります。

コネクションのBasic Settings タブに戻ります。Connection Type でPrivate Cloud Connector を選択します。

ドロップダウンリストから使用するPrivate Cloud Connector の場所を選択します。

コネクタの Documentation ペインに従って、コネクタの Authentication の手順を入力します。

Save & Test をクリックしてコネクタを認証します。

はじめに

データソース

探索とモデリング

MCP/データインテグレーション

LLM インテグレーション

AI

セキュリティとガバナンス

仮想データベース

オペレーション

Private Cloud Connector

Connect AI にPrivate Cloud Connector を登録する

Docker でPrivate Cloud Connector をデプロイする

前提条件

環境変数

Docker でコネクタを実行する

Docker ログを確認する

コネクタを停止する

Docker Compose

Private Cloud Connector を起動する

ログを確認する

Private Cloud Connector を停止する

Kubernetes でPrivate Cloud Connector をデプロイする

前提条件

クイックスタート

Private Cloud Connector が動作していることを確認する

Private Cloud Connector をアップグレードする

Private Cloud Connector をアンインストールする

Private Cloud Connector セットアップを完了する

​Connect AI にPrivate Cloud Connector を登録する

​Docker でPrivate Cloud Connector をデプロイする

​前提条件

​環境変数

​Docker でコネクタを実行する

​Docker ログを確認する

​コネクタを停止する

​Docker Compose

​Private Cloud Connector を起動する

​ログを確認する

​Private Cloud Connector を停止する

​Kubernetes でPrivate Cloud Connector をデプロイする

​前提条件

​クイックスタート

​Private Cloud Connector が動作していることを確認する

​Private Cloud Connector をアップグレードする

​Private Cloud Connector をアンインストールする

​Private Cloud Connector セットアップを完了する

Connect AI にPrivate Cloud Connector を登録する

Docker でPrivate Cloud Connector をデプロイする

前提条件

環境変数

Docker でコネクタを実行する

Docker ログを確認する

コネクタを停止する

Docker Compose

Private Cloud Connector を起動する

ログを確認する

Private Cloud Connector を停止する

Kubernetes でPrivate Cloud Connector をデプロイする

前提条件

クイックスタート

Private Cloud Connector が動作していることを確認する

Private Cloud Connector をアップグレードする

Private Cloud Connector をアンインストールする

Private Cloud Connector セットアップを完了する