プライベート・エンドポイントの使用

IBM Cloud Schematics プライベート・サービス・エンドポイントをターゲットとすることによって、Schematics ワークスペースをプライベート・ネットワーク上に作成して管理します。

まず IBM Cloud®で仮想ルーティングおよび転送（VRF）とサービスエンドポイントを有効にしてください。アカウントで VRF を有効にすると、IBM Cloud Schematics Private ネットワークでしかアクセスできないプライベート IP を使用して IBM Cloud に接続できます。 IBM Cloud でのプライベート接続について詳しくは、プライベート接続のためのサービス・エンドポイントを参照してください。

プライベート・ネットワーク接続を使用して IBM Cloud Schematics に接続するには、Schematics API またはコマンド・ライン・プラグインを使用する必要があります。この機能は、IBM Cloud コンソールからは使用できません。

Schematics のプライベート・サービス・エンドポイント

プライベート・サービス・エンドポイントは、Schematics で使用できます。IBM Cloud Schematics CLI ユーザーは、IBM Cloud Schematics CLI の API エンドポイントとして private-us-south.schematics.cloud.ibm.com を指定することで、プライベート・ネットワークにアクセスできます。詳しくは、プライベート Schematics エンドポイントの使用を参照してください。

プライベート・ネットワークにアクセスするには、まず ibmcloud login -a private.cloud.ibm.com を使用してプライベート・ネットワークにログインする必要があります。 Schematics コマンドにアクセスして、プライベート Schematics エンドポイントと対話し、エンドポイントに自動的にアクセスします。

アカウントの VRF とサービス・エンドポイントを有効にする

プライベート・サービス・エンドポイントで作業できるように IBM Cloud アカウントを有効にします。

IBM Cloud アカウントで Virtual Routing and Forwarding(VRF) を有効にします。

VRF を有効にすると、ご使用のアカウント用に別個のルーティング・テーブルが作成され、アカウントのリソースとの間の接続は IBM Cloud ネットワーク上で別個にルーティングされます。 VRF テクノロジーの詳細については、「仮想ルーティングと転送 IBM Cloud をご覧ください。

VRF を有効にすると、アカウントのネットワーキングは永続的に変更されます。アカウントおよびリソースへの影響を理解しておく必要があります。 VRF を有効にした後、VRF を再び無効にすることはできません。
サービス・エンドポイントの IBM Cloud アカウントを有効にします。

アカウントで VRF とサービス・エンドポイントを有効にすると、すべての Schematics ワークスペース (既存のものと、今後作成するものを含む) は、パブリックとプライベートの両方のサービス・エンドポイントから利用できるようになります。
アカウントで VRF とサービス・エンドポイントが有効になっていることを確認します。
1. IBM Cloud にログインします。
```
ibmcloud login
```
  ログインに失敗した場合は、ibmcloud login --ssoコマンドを実行して再試行してください。フェデレーテッドIDを使用してログインする場合は、--ssoパラメーターが必要です。このオプションを使用する場合、コマンド・ライン出力にリストされたリンクにアクセスして、ワンタイム・パスコードを生成します。
2. アカウントの詳細を表示します。
```
ibmcloud account show
```
  出力例
```
Retrieving account User's Account of user@email.com...
OK

Account ID:                   a111aaaa1aa1aaaaaaaaaaaa1a1aa111   
Currently Targeted Account:   true   
Linked Softlayer Account:     000000
VRF Enabled:                  true  
Service Endpoint Enabled:     true
```

Schematics プライベート・サービス・エンドポイントに接続する

IBM Cloud Private ネットワーク用のルーティング・テーブルを構成して、VSI またはテスト・マシンを準備します。

プライベート・サービス・エンドポイントに接続するには、最初に仮想サーバー・インスタンス (VSI) を作成する必要があります。この VSI を使用して、IBM Cloud Private ネットワークに接続します。 Classic VSI または VPC VSI を作成できます。
VSI に対して接続後、API 要求を Schematics API サーバーに送信する際にプライベート・サービス・エンドポイントをターゲットとします。以下の例は、Schematics エンジンのサポート対象の Terraform と Helm バージョンを示します。
```
curl -X GET https://private-us-south.schematics.cloud.ibm.com/v1/version
```

Schematics の仮想プライベート・エンドポイント・ゲートウェイ

サービス・インスタンスは、プライベート・ネットワーク・エンドポイントまたはパブリック・ネットワーク・エンドポイント、あるいはその両方を持つことができます。アカウントで VPC を有効にし、仮想プライベート・エンドポイント・ゲートウェイからプライベート・ネットワーク上の Schematics サービスに接続した後。

- **Public:** A service endpoint on the IBM Cloud public network.
- **Private:** A service endpoint that is accessible only on the IBM Cloud private network with no access from the public internet.
- **Both public and private:** Service endpoints that allow access over both networks.

仮想プライベート・エンドポイント・ゲートウェイは、VPC 第 2 世代でのみサポートされます。

開始前に

始める前に、仮想プライベート・エンドポイント・ゲートウェイを介して Schematics サービスにアクセスするために、以下の基準が満たされるようにします。

VPC の作成、エンドポイント・ゲートウェイの作成、サブネットからの予約済み IP の作成またはバインドに必要な許可と、並行インスタンスの VSI 作成のアカウント制限があることを確認します。
VPC 第 2 世代インスタンスと、エンドポイント・ゲートウェイのプロビジョンと同時に IP アドレスをバインドするサブネット・ゾーン。詳しくは、VPC の概要を参照してください。
VSI が作成されていること。詳しくは、creating a VSI を参照してください。

Schematics の仮想プライベート・エンドポイント・ゲートウェイの追加

これで、仮想プライベート・エンドポイント・ゲートウェイを安全に接続して、新規インスタンスの workspace、action、job、plan、apply、および destroy などの Schematics サービスおよび機能にアクセスできます。詳しくは、「Schematics のプライベート・サービス・エンドポイントの概要」を参照してください。

同じ Schematics インスタンスに対して複数の仮想プライベート・エンドポイント・ゲートウェイを作成することはできません。

Schematics のプライベート・ネットワーク・エンドポイントを追加するステップは、以下のとおりです。

Schematics ワークスペースを作成します。詳しくは、ワークスペースの作成を参照してください。
オプションで、リソース・インスタンスを Schematics ワークスペースにデプロイできます。詳しくは、リソースのデプロイを参照してください。
仮想プライベート・エンドポイント・ゲートウェイを作成します。詳しくは、エンドポイント・ゲートウェイの作成を参照してください。また、リストされた Schematics サービス・エンドポイントを仮想プライベート・エンドポイント・ゲートウェイに割り当てることができます。
Schematics サービスに関連付けられた作成済み仮想プライベート・エンドポイント・ゲートウェイを表示します。詳細については、エンドポイント・ゲートウェイの詳細の表示を参照してください。