> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Private Cloud Connector

> Connect AI のPrivate Cloud Connector 機能は、オンプレミスのネットワークにインストールするソフトウェアです。コネクタは、オンプレミスのデータ（クラウド上にないデータ）とConnect AI の橋渡し役として機能します。

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

<Frame>
  <img src="https://mintcdn.com/cdata/R0wVTubipq1c_yb5/ja/images/private_cloud_connector_architecture.svg?fit=max&auto=format&n=R0wVTubipq1c_yb5&q=85&s=be20afb4c705116f4b6e32c4055f67b5" alt="Private Cloud Connector Architecture" width="960" height="340" data-path="ja/images/private_cloud_connector_architecture.svg" />
</Frame>

各コネクタは、個々の接続設定の中でConnect AI のユーザーインターフェースに登録します。複数の場所にコネクタを配置することが可能です。場所ごとにConnect AI にコネクタを登録する必要があります。

Private Cloud Connector は、同一の場所とアカウントId を指す複数のコネクタインスタンス（複数のDocker コンテナ、またはKubernetes デプロイメントのレプリカ）をサポートすることで、高可用性を実現します。1 つのインスタンスが停止した場合、リクエストは残りのコネクタインスタンスに自動的にルーティングされます。

次の図は、Private Cloud Connector が複数の場所と複数のデータソースをどのようにサポートするかを示しています。

<Frame>
  <img src="https://mintcdn.com/cdata/R0wVTubipq1c_yb5/ja/images/private_cloud_connector_architecture_advanced.svg?fit=max&auto=format&n=R0wVTubipq1c_yb5&q=85&s=f0eeaeec699d198d51852595235f796b" alt="Private Cloud Connector Architecture Advanced" width="1000" height="680" data-path="ja/images/private_cloud_connector_architecture_advanced.svg" />
</Frame>

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

* [API](/ja/Data-Sources/APIConnector)
* [Confluence](/ja/Data-Sources/Confluence)
* [Databricks](/ja/Data-Sources/Databricks)
* [GitHub](/ja/Data-Sources/GitHub)
* [Jira](/ja/Data-Sources/JIRA)
* [MySQL](/ja/Data-Sources/MySQL)
* [PostgreSQL](/ja/Data-Sources/PostgreSQL)
* [QuickBooks](/ja/Data-Sources/QuickBooks)
* [SAP Business One](/ja/Data-Sources/SAPBusinessOne)
* [SAP Gateway](/ja/Data-Sources/SAPGateway)
* [Snowflake](/ja/Data-Sources/Snowflake)
* [Splunk](/ja/Data-Sources/Splunk)
* [SQL Server](/ja/Data-Sources/SQL)

Private Cloud Connector で別のコネクタが必要な場合は、[CData サポート](https://jp.cdata.com/support/submit.aspx)にお問い合わせください。

Private Cloud Connector のセットアップには、次の 3 つの主要なステップがあります：

<Steps>
  <Step>
    [Connect AI にPrivate Cloud Connector を登録する](#connect-ai-に-private-cloud-connector-を登録する)。
  </Step>

  <Step>
    オンプレミスデータが存在する各場所でコネクタをインストールして実行します。[Docker でPrivate Cloud Connector をデプロイする](#docker-で-private-cloud-connector-をデプロイする)か、[Kubernetes でPrivate Cloud Connector をデプロイする](#kubernetes-で-private-cloud-connector-をデプロイする)かのいずれかを選択できます。
  </Step>

  <Step>
    Connect AI で[Private Cloud Connector セットアップを完了](#private-cloud-connector-セットアップを完了する)し、コネクタをテストしてコネクションを完成させます。
  </Step>
</Steps>

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

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

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

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

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

    <Frame>
      <img src="https://mintcdn.com/cdata/R0wVTubipq1c_yb5/ja/images/private_cloud_connector_add_connector.png?fit=max&auto=format&n=R0wVTubipq1c_yb5&q=85&s=8eb5fd44cf6253f086903bb0651a9978" alt="Add Connector" width="600" height="317" data-path="ja/images/private_cloud_connector_add_connector.png" />
    </Frame>
  </Step>

  <Step>
    コネクタがインストールされている場所を識別するための説明的な場所名を入力し、**Confirm** をクリックします。

    **Connectors** リストに場所が表示され、キーと**Pending** ステータスが示されます。目のアイコンをクリックしてキーを確認できます。

    <Frame>
      <img src="https://mintcdn.com/cdata/R0wVTubipq1c_yb5/ja/images/private_cloud_connector_list.png?fit=max&auto=format&n=R0wVTubipq1c_yb5&q=85&s=7d63c1717dcd0fd822e23d5b90d42f96" alt="Connectors List" width="1147" height="287" data-path="ja/images/private_cloud_connector_list.png" />
    </Frame>

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

    * **Account Id**–コネクタのACCOUNT\_ID 環境変数です。
    * **Location Id**–コネクタのGATEWAY\_LOCATION\_ID 環境変数です。
    * **Key**–コネクタのGATEWAY\_API\_KEY 環境変数です。
  </Step>
</Steps>

## 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 でコネクタを実行する

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

```bash wrap theme={null}
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
```

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

#### Docker ログを確認する

```bash wrap theme={null}
docker logs -f my-onprem-gateway
```

#### コネクタを停止する

```bash wrap theme={null}
docker stop my-onprem-gateway
docker rm my-onprem-gateway
```

### Docker Compose

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

```yaml theme={null}
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 を起動する

```bash wrap theme={null}
docker compose up
```

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

#### ログを確認する

```bash wrap theme={null}
docker compose logs -f
```

#### Private Cloud Connector を停止する

```bash wrap theme={null}
docker compose down
```

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

Private Cloud Connector のKubernetes Helm チャートは [GitHub リポジトリ](https://github.com/CDataSoftware/connect-gateway-helm/)で公開されています。

### 前提条件

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 を登録する](#connect-ai-に-private-cloud-connector-を登録する)を参照してください。

### クイックスタート

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

```bash wrap theme={null}
helm repo add cdata https://cdatasoftware.github.io/connect-gateway-helm
helm repo update
```

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

```bash wrap theme={null}
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 リリース](https://github.com/CDataSoftware/connect-gateway-helm/releases)から直接インストールすることもできます。これは、エアギャップ環境や Helm リポジトリを追加したくない場合に便利です。以下の URL のバージョンは、最新のリリースに置き換えてください。

```bash wrap theme={null}
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
```

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

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

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

```bash wrap theme={null}
kubectl get pods -n connect-gateway
kubectl logs -n connect-gateway -l app.kubernetes.io/name=connect-gateway -f
```

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

```bash wrap theme={null}
helm repo update
helm upgrade connect-gateway cdata/connect-gateway -n connect-gateway
```

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

```bash wrap theme={null}
helm uninstall connect-gateway -n connect-gateway
```

インストールオプション、設定値、シークレット管理パターンの完全なリストについては、Helm チャートの [Readme ファイル](https://github.com/CDataSoftware/connect-gateway-helm/blob/main/charts/connect-gateway/README.md)を参照してください。

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

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

<Steps>
  <Step>
    [Docker でPrivate Cloud Connector をデプロイする](#docker-で-private-cloud-connector-をデプロイする)または [Kubernetes でPrivate Cloud Connector をデプロイする](#kubernetes-で-private-cloud-connector-をデプロイする)のステップが完了したら、**Connectors** に追加したコネクタをテストできます。**Add/Edit Connection** ページの**Private Cloud Connector** タブをクリックします。**Test Connectors** をクリックします。すべてのコネクタのセットアップが完了すると、**Status** が**Success** に変わります。
    <Note>コネクション全体をテストするには、引き続き **Save & Test** をクリックする必要があります。</Note>
  </Step>

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

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

    <Frame>
      <img src="https://mintcdn.com/cdata/R0wVTubipq1c_yb5/ja/images/private_cloud_connector_basic_settings.png?fit=max&auto=format&n=R0wVTubipq1c_yb5&q=85&s=9ccc8c9e79c077b42e32e5a147eba0dd" alt="Basic Settings" width="751" height="249" data-path="ja/images/private_cloud_connector_basic_settings.png" />
    </Frame>
  </Step>

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

  <Step>
    **Save & Test** をクリックしてコネクタを認証します。
  </Step>
</Steps>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.