このページでは、Database Service を使用して、Google Distributed Cloud（GDC）エアギャップでデータベースを作成、管理する方法について説明します。
承認とロール
ユーザーは、Database Service にアクセスする権限が必要です。GDC コンソールと Distributed Cloud CLI の両方で Database Service にアクセスするには、承認が必要です。
次のロールは、ユーザーに権限を付与します。
- プロジェクト閲覧者（
project-viewer） - このロールを持つユーザーは、GDC コンソールと Distributed Cloud CLI にアクセスできます。
- プロジェクト DB 閲覧者（
project-db-viewer） - このロールを持つユーザーは、データベース クラスタを表示できます。
- プロジェクト DB 編集者（
project-db-editor） - このロールを持つユーザーは、
project-db-viewerによって付与された機能を使用でき、データベース クラスタを編集することもできます。 - プロジェクト DB 管理者（
project-db-admin） - このロールを持つユーザーは、
project-db-editorによって付与された機能を使用でき、データベース クラスタの作成と削除も行うことができます。 - プロジェクト バケット オブジェクト閲覧者（
project-bucket-object-viewer） - このロールを持つユーザーは、GDC コンソールの Database Service インターフェースでストレージ ブラウザを使用できます。このインターフェースは、データベースのインポートに使用するファイルと、データベースのエクスポートによって生成されたファイルの宛先を指定するために使用されます。
- プロジェクト モニタリング閲覧者（
project-monitoring-viewer） - このロールを持つユーザーは、モニタリング インスタンスにアクセスできます。Database Service の指標をモニタリングする方法については、指標をモニタリングするを ご覧ください。このロールは、モニタリング インスタンスにアクセスする必要があるユーザーにのみ付与してください。
- プロジェクト メンテナンス ポリシー管理者（
project-mp-admin） - このロールを持つユーザーは、
project_mp_editorロールとproject_mpb_editorロールの両方によって付与された機能を使用できるため、メンテナンス ポリシーとメンテナンス ポリシー バインディングの両方を作成、編集、削除できます。 - プロジェクト メンテナンス ポリシー閲覧者（
project-mp-viewer） - このロールを持つユーザーは、メンテナンス ポリシーを表示できます。
- プロジェクト メンテナンス ポリシー編集者（
project-mp-editor） - このロールを持つユーザーは、
project_mp_viewerロールによって付与された機能を使用でき、メンテナンス ポリシーの作成、編集、削除も行うことができます。 - プロジェクト メンテナンス ポリシー バインディング閲覧者（
project-mpb-viewer） - このロールを持つユーザーは、メンテナンス ポリシー バインディングを表示できます。
- プロジェクト メンテナンス ポリシー バインディング編集者（
project-mpb-editor） - このロールを持つユーザーは、
project_mpb_viewerロールによって付与された機能を使用でき、メンテナンス ポリシー バインディングの作成、編集、削除も行うことができます。
使用可能なデータベース エンジン
GDC 環境で使用できるデータベース エンジンは次のとおりです。
| データベース | バージョン | |-----------------------------|----------| | PostgreSQL | 13、14、15 |
データベース クラスタを作成する
プロジェクト DB 管理者ロールを持つユーザーは、次の手順を行う必要があります。データベース クラスタを作成するには、GDC コンソールまたは Distributed Cloud CLI を使用します。
コンソール
- メインメニューから [Database Service] を選択します。
- [データベース クラスタを作成] をクリックします。
In the [データベース エンジンを選択] ダイアログで、 データベース エンジンを選択します。
[クラスタを構成する] ダイアログで、クラスタ ID、パスワード、データベースのバージョンを指定します。バックアップを有効にして、バックアップの保持期間を構成できます。
データベース クラスタの高可用性を有効にできます。有効にすると、障害から保護するために、Database Service はプライマリ インスタンスと同じゾーンにスタンバイ インスタンスをプロビジョニングします。詳細については、高可用性 をご覧ください。
[プライマリ インスタンスの構成] ダイアログで、データベース クラスタのプライマリ インスタンスの CPU、メモリ、ストレージ容量を指定します。最大のテーブルを保持するのに十分なメモリを選択することをおすすめします。
[作成] をクリックします。データベース クラスタの作成には数分かかることがあります。 [クラスタの概要] ページでクラスタのステータスを確認します。クラスタの準備が完了すると、ステータスが [作成中 ] から [準備完了 ] に変わります。
gdcloud
Distributed Cloud CLI を使用する前に、 インストールして初期化します。 次に、組織で認証します。
次のコマンドを実行して、データベース クラスタを作成します。
gdcloud database clusters create CLUSTER_NAME \ --database-version DB_VERSION \ --admin-password ADMIN_PASSWORD次の変数を置き換えます。
CLUSTER_NAMEは、新しいクラスタの名前に置き換えます。DB_VERSIONは、新しいクラスタのバージョン文字列に置き換えます。例:POSTGRESQL_13、POSTGRESQL_14、POSTGRESQL_15ADMIN_PASSWORDは、新しいクラスタの管理者パスワードに置き換えます。
データベース クラスタの CPU、メモリ、ストレージ リソースの構成、バックアップの構成、高可用性の有効化、その他の使用可能なオプションの詳細については、次を実行します。
gdcloud database clusters create --help
API
apiVersion: v1
kind: Secret
metadata:
name: db-pw-DBCLUSTER_NAME
namespace: USER_PROJECT
type: Opaque
data:
DBCLUSTER_NAME: "BASE64_PASSWORD"
---
apiVersion: postgresql.dbadmin.gdc.goog/v1
kind: DBCluster
metadata:
name: DBCLUSTER_NAME
namespace: USER_PROJECT
spec:
primarySpec:
adminUser:
passwordRef:
name: db-pw-DBCLUSTER_NAME
version: "DB_VERSION"
resources:
memory: DB_MEMORY
cpu: DB_CPU
disks:
- name: DataDisk
size: DB_DATA_DISK
次の変数を置き換えます。
DBCLUSTER_NAME: データベース クラスタの名前。USER_PROJECT: データベース クラスタが作成されるユーザー プロジェクトの名前。BASE64_PASSWORD: データベースの管理者パスワード（base64 エンコード）。DB_VERSION: データベース エンジンのバージョン。DB_MEMORY: DB クラスタに割り当てられるメモリ量。例:5Gi。DB_CPU: DB クラスタに割り当てられる CPU の量。例:2。DB_DATA_DISK: DB クラスタに割り当てられるスペースの量。例:10 Gi。