ステップ 1: コンソールを使用したプロビジョン

1. IBM Cloud コンソールにログインします。

2. カタログで Databases for PostgreSQL サービス をクリックします。

3. サービスの詳細で、以下を設定する：

   • サービス名- 任意の文字列を指定できます。これは、Web および CLI 上で新しいデプロイメントを識別するために使用される名前です。
   • リソースグループ- サービスを リソースグループ ごとに整理している場合は、このフィールドにリソースグループを指定してください。 それ以外の場合は、この値をデフォルトのままにしておくことができます。 詳しくは、リソース・グループの管理を参照してください。
   • 場所- 展開するパブリッククラウドのリージョン。

4. リソース割り振り-データベースの初期 RAM、ディスク、およびコアを指定します。 デフォルトでは、メモリーおよびディスクの最小サイズが選択されています。 専用コアを使用する場合、リソース・グループには、CPU 共有の最小予約数を持つシングル・テナント・ホストが付与されます。 その後、デプロイメントには、指定したコア数が割り当てられます。 いったんプロビジョンされると、ディスクをスケールダウンすることはできません。

5. サービス・コンフィギュレーションで、以下を設定する：

   • データベースのバージョン Set only at deployment- データベースのデプロイメントバージョン。 最適なパフォーマンスを確保するには、優先バージョンを実行します。 最新のマイナー・バージョンが自動的に使用されます。 詳細については、「 データベースのバージョン管理ポリシー 」を参照してください。
   • 暗号化- Key Protect を使用する場合は、デプロイメントのディスクを暗号化するためにインスタンスと鍵を選択できます。 独自の鍵を使用しない場合、デプロイメントは自動的に自身のディスク暗号鍵を作成して管理します。
   • エンドポイント Set only at deployment- デプロイメント上のサービスエンドポイントを 構成します。

   適切な設定を行った後、「 作成 」をクリックしてプロビジョニング処理を開始してください。 Databases for PostgreSQL 「リソース・リスト」 ページが開きます。

6. 「作成」 をクリックします。 Cloud Databases 「リソース・リスト」 ページが開きます。

7. インスタンスのプロビジョニングが完了したら、インスタンス名をクリックして詳細情報を表示します。

ステップ 1: CLI を使用したプロビジョン

CLI を使用して Databases for PostgreSQL インスタンスをプロビジョンできます。 まだインストールしていない場合は、 IBM Cloud CLIをインストールする必要があります。

1. 次のコマンドを使用して、IBM Cloud にログインします。

   ibmcloud login
   

   フェデレーテッドユーザーIDを使用する場合は、ワンタイムパスコード（ibmcloud login --sso ）に切り替えるか、APIキー（ibmcloud --apikey key または @key_file ）を使用して認証を行うことが重要です。 CLI を使用したログイン方法の詳細については、 ibmcloud login の「 一般的な CLI(ibmcloud)コマンド」を 参照してください。

2. Databases for PostgreSQL インスタンスを作成する。

   以下のいずれかの方法を選択します。

   • エンタープライズ・プランで CLI からインスタンスを作成するには、以下のコマンドを実行します。

       ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE_NAME> <SERVICE_PLAN_NAME> <LOCATION> <SERVICE_ENDPOINTS_TYPE> <RESOURCE_GROUP>
       ```
   コマンド内のフィールドについては、以下の表で説明されています。
   
   | フィールド | 説明 | フラグ |
   |-------|------------|------------|
   | `NAME` [Required]{: tag-red} | インスタンス名は任意の文字列に設定でき、Web や CLI で新しいデプロイメントを識別するために使用される名前です。 |  |
   | `SERVICE_NAME` [Required]{: tag-red} | サービスの名前または ID。 Databases for PostgreSQL には `databases-for-postgresql` を使用する。 |  |
   | `SERVICE_PLAN_NAME` [Required]{: tag-red} | スタンダード・プラン (`standard`) |  |
   | `LOCATION` [Required]{: tag-red} | デプロイしたい場所。 地域のリストを取得するには、 `ibmcloud regions` コマンドを使う。 |  |
   | `SERVICE_ENDPOINTS_TYPE` | `public` または `private` のいずれかで、デプロイの [サービスエンドポイントを](/docs/cloud-databases?topic=cloud-databases-service-endpoints) 設定します。 |  |
   | `RESOURCE_GROUP` | リソースグループ名。 デフォルト値は `default`です。 | -g |
   | `--parameters` | サービス・インスタンスを作成するパラメーターの JSON ファイルまたは JSON 文字列 | -p |
   {: caption="基本的なコマンド形式のフィールド" caption-side="top"}
   
   次のような応答が表示されます：
   
   ```text {: codeblock}
   Creating service instance INSTANCE_NAME in resource group default of account    USER...
   OK
   Service instance INSTANCE_NAME was created.
   Name:                INSTANCE_NAME
   ID:                  crn:v1:bluemix:public:databases-for-postgresql:us-east:a/   40ddc34a846383BGB5b60e:dd13152c-fe15-4bb6-af94-fde0af5303f4::
   GUID:                dd13152c-fe15-4bb6-af94-fde0af56897
   Location:            LOCATION
   State:               provisioning
   Type:                service_instance
   Sub Type:            Public
   Service Endpoints:   private
   Allow Cleanup:       false
   Locked:              false
   Created at:          2023-06-26T19:42:07Z
   Updated at:          2023-06-26T19:42:07Z
   Last Operation:
                       Status    create in progress
                       Message   Started create instance operation
   

3. プロビジョニングの状態を確認するには、次のコマンドを実行してください：

   ibmcloud resource service-instance <INSTANCE_NAME>
   

   完了すると、次のような応答が表示されます。

   Retrieving service instance INSTANCE_NAME in resource group default under account USER's Account as USER...
   OK
   Name:                  INSTANCE_NAME
   ID:                    crn:v1:bluemix:public:databases-for-postgresql:us-east:a/40ddc34a953a8c02f109835656860e:dd13152c-fe15-4bb6-af94-fde0af5303f4::
   GUID:                  dd13152c-fe15-4bb6-af94-fde5654765
   Location:              <LOCATION>
   Service Name:          databases-for-postgresql
   Service Plan Name:     standard
   Resource Group Name:   default
   State:                 active
   Type:                  service_instance
   Sub Type:              Public
   Locked:                false
   Service Endpoints:     private
   Created at:            2023-06-26T19:42:07Z
   Created by:            USER
   Updated at:            2023-06-26T19:53:25Z
   Last Operation:
                          Status    create succeeded
                          Message   Provisioning PostgreSQL with version 12 (100%)
   

4. (オプション) サービス・インスタンスの削除 次のようなコマンドを実行して、インスタンスを削除します

   ibmcloud resource service-instance-delete <INSTANCE_NAME>
   

ibmcloud cdb deployment-connections example-postgres --start

ibmcloud resource service-instance-create databases-for-postgresql <SERVICE_NAME> standard us-south \
-p \ '{
  "backup_id": "crn:v1:blue:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
  "members_memory_allocation_mb": "3072"
}'

ステップ 1: リソース・コントローラー API を使用したプロビジョン

リソース・コントローラー APIを使用してプロビジョンするには、以下の手順を実行します。

1. APIトークンからIAMトークンを取得します。

2. デプロイ先とするリソース・グループの ID を知っている必要があります。 この情報は IBM Cloud CLI により入手できます。

   次のようなコマンドを使用します。

   ibmcloud resource groups
   

3. デプロイ先のリージョンを把握しておく必要があります。

   現在のリージョンからデプロイメントをプロビジョンできるすべてのリージョンをリストするには、 Cloud Databases CLI プラグインを使用します。

   コマンドは次のようになります。

   ibmcloud cdb regions --json
   

   すべての情報を取得したら、 IBM Cloud リソース・コントローラーを使用して 新規リソース・インスタンスをプロビジョン します。

   curl -X POST \
     https://resource-controller.cloud.ibm.com/v2/resource_instances \
     -H 'Authorization: Bearer <>' \
     -H 'Content-Type: application/json' \
       -d '{
       "name": "my-instance",
       "target": "blue-us-south",
       "resource_group": "5g9f447903254bb58972a2f3f5a4c711",
       "resource_plan_id": "databases-for-postgresql-standard"
     }'
   

   パラメーターの name、target、resource_group、resource_plan_id はすべて必須です。

追加パラメーターのリスト

• backup_id- リストア元となるバックアップ・リソースの CRN。 バックアップは、同じサービス ID を持つデータベースのデプロイによって作成される必要があります。 バックアップはプロビジョニングの後にロードされ、その後にそのデータを使用する新規デプロイメントが開始されます。 バックアップ CRN の形式は crn:v1:<...>:backup:<uuid> です。 これを省略した場合、データベースは空のままプロビジョンされます。

• version - プロビジョンするデータベースのバージョン。 省略した場合、データベースは最新のメジャー・バージョンとマイナー・バージョンを使用して作成されます。

• disk_encryption_key_crn- KMS キーの CRN（ Key Protect ）、これはその後、ディスクの暗号化に使用されます。 KMS キーの CRN は、 crn:v1:<...>:key:<id> という形式です。

• backup_encryption_key_crn- KMSキーのCRN（例えば、[Key Protect )のCRNで、バックアップの暗号化に使用される。 KMS キーの CRN は、 crn:v1:<...>:key:<id> という形式です。

  バックアップに鍵を使用するには、まず サービス間委任を有効にする 必要があります。

• members_memory_allocation_mb - データベース内のデータベース・メンバー間で共有されるメモリーの合計量。 例えば、値が「6144」で 3 つのデータベース・メンバーが存在する場合、デプロイメントには合計 6 GB の RAM が与えられます (メンバーごとに 2 GB の RAM)。 この指定を省略すると、データベース・タイプのデフォルト値が使用されます。

• members_disk_allocation_mb - データベース・メンバー間で共有されるデータベース内のディスクの合計量。 例えば、値が「30720」で 3 つのメンバーが存在する場合、デプロイメントには合計 30 GB のディスクが与えられます (メンバーごとに 10 GB のディスク)。 この指定を省略すると、データベース・タイプのデフォルト値が使用されます。

• members_cpu_allocation_count - コアの割り振りを有効にし、指定した専用コア数をデプロイメントに割り振ります。 例えば、メンバーごとに 2 つの専用コアを使用するには、"members_cpu_allocation_count":"2" を使用します。 この指定を省略した場合、デフォルト値の「共有 CPU」が共有ホストのコンピュート・リソースを使用します。

• service_endpoints- デプロイメントでサポートされている サービスエンドポイント、 public または private。 これは必須パラメーターです。

ステップ 1: Terraform を使用したプロビジョン

Terraform を使用して、 ibm_database Resource for Terraformを介してインフラストラクチャーを管理します。 あるいは、Terraform IBM Modules を使って Terraform IBM 用モジュール Databases for PostgreSQL でインフラを管理することもできます。

ステップ 5: コンソールを使用して IBM Cloud Monitoring を接続する

IBM Cloud Monitoring を使用して、アプリケーション、サービス、およびプラットフォームのパフォーマンスと正常性に関する運用上の可視性を得ることができます。 IBM Cloud Monitoring は、管理者、 DevOps チーム、および開発者向けのフルスタック・テレメトリーに、モニターとトラブルシューティング、アラートの定義、およびカスタム・ダッシュボードの設計を行うための拡張機能を提供します。

Monitoringと Databases for PostgreSQLの使用方法の詳細については、監視統合 を参照してください。

ステップ 5: CLI を使用して IBM Cloud Monitoring を接続する

IBM Cloud Monitoring を使用して、アプリケーション、サービス、およびプラットフォームのパフォーマンスと正常性に関する運用上の可視性を得ることができます。 IBM Cloud Monitoring は、管理者、 DevOps チーム、および開発者向けのフルスタック・テレメトリーに、モニターとトラブルシューティング、アラートの定義、およびカスタム・ダッシュボードの設計を行うための拡張機能を提供します。

Monitoringと Databases for PostgreSQLの使用方法の詳細については、監視統合 を参照してください。

CLIを使用して IBM Cloud Monitoring。 このタスクを実行するには、コンソールを使用します。 詳細については、統合の監視 を参照。

ステップ 5: API を使用した IBM Cloud Monitoring の接続

IBM Cloud Monitoring を使用して、アプリケーション、サービス、およびプラットフォームのパフォーマンスと正常性に関する運用上の可視性を得ることができます。 IBM Cloud Monitoring は、管理者、 DevOps チーム、および開発者向けのフルスタック・テレメトリーに、モニターとトラブルシューティング、アラートの定義、およびカスタム・ダッシュボードの設計を行うための拡張機能を提供します。

Monitoringと Databases for PostgreSQLの使用方法の詳細については、監視統合 を参照してください。

CLIを使用して IBM Cloud Monitoring。 このタスクを実行するには、コンソールを使用します。 詳細については、統合の監視 を参照。

ステップ 5: Terraform を使用した IBM Cloud Monitoring の接続

IBM Cloud Monitoring を使用して、アプリケーション、サービス、およびプラットフォームのパフォーマンスと正常性に関する運用上の可視性を得ることができます。 IBM Cloud Monitoring は、管理者、 DevOps チーム、および開発者向けのフルスタック・テレメトリーに、モニターとトラブルシューティング、アラートの定義、およびカスタム・ダッシュボードの設計を行うための拡張機能を提供します。

Monitoringと Databases for PostgreSQLの使用方法の詳細については、監視統合 を参照してください。

CLIを使用して IBM Cloud Monitoring。 このタスクを実行するには、コンソールを使用します。 詳細については、統合の監視 を参照。

ステップ6：接続 IBM Cloud Activity Tracker Event Routing

IBM Cloud® Activity Tracker Event Routing Activity Tracker Event Routing は、 のサービスの状態を変更するユーザー主導のアクティビティを記録します。 IBM Cloud Activity Tracker Event Routing を使用して、ユーザーやアプリケーションが Databases for PostgreSQL サービスとどのようにやり取りしているかを追跡します。

Activity Tracker Event Routing を使い始めるには、 IBM Cloud® Activity Tracker Event Routing をご覧ください。

Activity Tracker Event Routing のインスタンスは、ロケーションごとに 1 つだけ作成できます。 イベントを表示するには、ご使用のサービス・インスタンスが使用可能なロケーションと同じ場所にある IBM Cloud® Activity Tracker Event Routing サービスの Web UI にアクセスする必要があります。

Databases for PostgreSQL固有のイベントの詳細については、アクティビティ追跡イベント を参照してください。

イベントは、Cloud Auditing Data Federation（CADF）規格に従ってフォーマットされています。 含まれる情報の詳細については、 CADF 標準を参照してください。

ステップ6：CLIで IBM Cloud Activity Tracker Event Routing

IBM Cloud® Activity Tracker Event Routing Activity Tracker Event Routing は、 のサービスの状態を変更するユーザー主導のアクティビティを記録します。 IBM Cloud Activity Tracker Event Routing を使用して、ユーザーやアプリケーションが Databases for PostgreSQL サービスとどのようにやり取りしているかを追跡します。

Activity Tracker Event Routing を使い始めるには、 Activity Tracker Event Routing をご覧ください。

Activity Tracker Event Routing のインスタンスは、ロケーションごとに 1 つだけ作成できます。 イベントを表示するには、ご使用のサービス・インスタンスが使用可能なロケーションと同じ場所にある Activity Tracker Event Routing サービスの Web UI にアクセスする必要があります。 詳しくは、 Web UI の起動を参照してください。

Databases for PostgreSQL固有のイベントの詳細については、アクティビティ追跡イベント を参照してください。

イベントは、Cloud Auditing Data Federation（CADF）規格に従ってフォーマットされています。 含まれる情報の詳細については、 CADF 標準を参照してください。

CLIを使用して Activity Tracker Event Routing。 このタスクを実行するには、コンソールを使用します。 詳しくは、アクティビティ追跡 イベントをご覧ください。

ステップ 6: API を通して IBM Cloud® Activity Tracker Event Routing に接続する

IBM Cloud Activity Tracker Event Routingを使用すると、企業のポリシーや業界の規制に準拠するために、サービスのアクティビティを表示、管理、監査できます。Activity Tracker Event Routingは、IBM Cloud内のサービスの状態を変更するユーザ起動アクティビティを記録します。 Activity Tracker Event Routing を使用して、ユーザーやアプリケーションが Databases for PostgreSQL サービスとどのようにやり取りしているかを追跡します。

Activity Tracker Event Routing の使い方を始めるには、 [Getting Started with Activity Tracker Event Routing]/docs/atracker?topic=atracker-getting-started){: external} を参照してください。

Activity Tracker Event Routing のインスタンスは、ロケーションごとに 1 つだけ作成できます。 イベントを表示するには、ご使用のサービス・インスタンスが使用可能なロケーションと同じ場所にある Activity Tracker Event Routing サービスの Web UI にアクセスする必要があります。 詳しくは、 Web UI の起動を参照してください。

Databases for PostgreSQL固有のイベントの詳細については、アクティビティ追跡イベント を参照してください。

イベントは、Cloud Auditing Data Federation（CADF）規格に従ってフォーマットされています。 含まれる情報の詳細については、 CADF 標準を参照してください。

APIを使用して Activity Tracker Event Routing。 このタスクを実行するには、コンソールを使用します。 詳しくは、アクティビティ追跡 イベントをご覧ください。

ステップ6: Terraformで IBM Cloud Activity Tracker Event Routing

IBM Cloud® Activity Tracker Event Routing Activity Tracker Event Routing は、 のサービスの状態を変更するユーザー主導のアクティビティを記録します。 IBM Cloud Activity Tracker Event Routing を使用して、ユーザーやアプリケーションが Databases for PostgreSQL サービスとどのようにやり取りしているかを追跡します。

Activity Tracker Event Routing を使い始めるには、 Activity Tracker Event Routing をご覧ください。

Activity Tracker Event Routing のインスタンスは、ロケーションごとに 1 つだけ作成できます。 イベントを表示するには、ご使用のサービス・インスタンスが使用可能なロケーションと同じ場所にある Activity Tracker Event Routing サービスの Web UI にアクセスする必要があります。 詳しくは、 Web UI の起動を参照してください。

Databases for PostgreSQL固有のイベントの詳細については、アクティビティ追跡イベント を参照してください。

イベントは、Cloud Auditing Data Federation（CADF）規格に従ってフォーマットされています。 含まれる情報の詳細については、 CADF 標準を参照してください。

APIを使用して Activity Tracker Event Routing。 このタスクを実行するには、コンソールを使用します。 詳しくは、アクティビティ追跡 イベントをご覧ください。