本頁說明如何完成 AlloyDB for PostgreSQL 叢集設定。 瞭解如何使用 Google Cloud 控制台、Google Cloud CLI、REST API 或 Terraform，建立新的 AlloyDB 叢集及其主要執行個體。
事前準備
- 您使用的 Google Cloud 專案必須啟用 AlloyDB 存取權。
- 您使用的 Google Cloud 專案中的虛擬私有雲網路，必須已設定 AlloyDB 的私人服務存取權。
- 開發和沙箱工作負載的區域和機型。如要使用 1 個 vCPU 的形狀，請務必選取支援該形狀的區域。詳情請參閱使用 1 個 vCPU 時的考量事項。
必要的角色
建立第一個 Postgres 叢集前，您必須具備正確的 Identity and Access Management (IAM) 角色。
- 您必須在 Google Cloud 使用的專案中具備下列任一 IAM 角色：
roles/alloydb.admin(AlloyDB 管理員預先定義的 IAM 角色)roles/owner(擁有者基本 IAM 角色)roles/editor(編輯者基本 IAM 角色)
- 如果您不具備上述任一角色，請與機構管理員聯絡，並要求存取權。
- 此外，您還必須在使用的 Google Cloud 專案中具備
compute.networks.list權限。如要遵循最低權限原則並取得這項權限，請管理員授予您 Compute 網路使用者 (roles/compute.networkUser) 角色。
建立新叢集和主要執行個體
控制台
前往「Clusters」(叢集) 頁面。
按一下 [Create cluster] (建立叢集)。
選擇叢集設定。如要進一步瞭解高可用性和基本設定之間的差異，請參閱「節點和執行個體」。
如果不確定新叢集是否需要讀取集區執行個體，請選擇沒有讀取集區的設定。之後可以視需要為叢集新增讀取集區執行個體。
按一下「繼續」。
在「設定叢集」部分的「叢集 ID」欄位中，輸入叢集的 ID。
在「Password」(密碼) 欄位中，輸入新叢集的初始密碼。AlloyDB 會在建立叢集時，將提供的密碼指派給
postgres資料庫使用者。選用：如要手動設定
alloydb.iam_authentication旗標，請取消選取「建立身分與存取權管理資料庫使用者」。 詳情請參閱「編輯執行個體」。系統會預設選取「建立 IAM 資料庫使用者」，並執行下列操作：
在主要執行個體上啟用
alloydb.iam_authentication旗標。為您建立 IAM 資料庫使用者。
在「資料庫版本」欄位中，選取新 AlloyDB 叢集的 PostgreSQL 主要版本。
選取所需區域。對於開發和沙箱工作負載，請考慮使用 1 個 vCPU 的形狀，這項功能適用於特定區域。詳情請參閱使用 1 個 vCPU 時的考量事項。
選取網路路徑。
選用：如要將特定 IP 位址範圍套用至這個叢集，而不是允許 AlloyDB 選擇 IP 位址範圍，請按照下列步驟操作：
按一下「顯示分配的 IP 範圍選項」。
從「已分配的 IP 範圍」清單中選取 IP 位址範圍。
如要進一步瞭解這個選項，請參閱「使用特定 IP 位址範圍建立叢集」。
選用步驟：如要使用客戶自行管理的加密金鑰 (CMEK) 加密這個叢集，而非 Google 管理的加密金鑰，請按照下列額外步驟操作：
按一下「進階加密選項」。
選取「Customer-managed encryption key (CMEK)」(客戶自行管理的加密金鑰 (CMEK))。
在隨即顯示的選單中，選取客戶管理的金鑰。
Google Cloud 控制台會將這份清單限制為與新叢集位於 Google Cloud 相同專案和區域的金鑰。如要使用不在清單中的金鑰，請按一下「找不到金鑰嗎？輸入金鑰資源名稱，然後在隨即顯示的對話方塊中輸入金鑰的資源名稱。
請注意，在 AlloyDB 中使用 CMEK 需要進行一些額外設定。詳情請參閱「搭配使用 CMEK 與 AlloyDB」。
按一下「繼續」。
設定主要執行個體：
- 在「Instance ID」(執行個體 ID) 欄位中，輸入主要執行個體的 ID。
選取下列其中一個機器系列：
- C4A (Google Axion 型機器系列)。
- N2 (x86 型機器系列)。這是預設機器系列。
- C4 (x86 型機器系列)。
- Z3 (以 Intel Xeon 為基礎的機器系列)。
選取機型。詳情請參閱「選擇機器類型」。
- C4A 支援 1、4、8、16、32、48、64 和 72 個 vCPU。
- N2 支援 2、4、8、16、32、64、96 和 128 個 vCPU。
- C4 支援 4、8、16、24、32、48、96、144、192 和 288 個 vCPU。
- Z3 支援 8、14、16、22、32、44 和 88 個 vCPU。
如要進一步瞭解如何使用 C4A Axion 型機型系列 (包括 1 個 vCPU 的機型)，請參閱「使用 C4A Axion 型機型系列時的注意事項」。
選用：為執行個體設定自訂旗標。請針對每個標記執行下列步驟：
- 按一下「新增旗標」。
- 在「New database flag」(新增資料庫標記) 清單中，選取一個標記。
- 提供旗標的值。
- 按一下 [完成]。
如果您選擇的叢集類型沒有讀取集區，請按一下「建立叢集」。
gcloud
如要使用 gcloud CLI，可以安裝並初始化 Google Cloud CLI，也可以使用 Cloud Shell。
您必須先建立 AlloyDB 叢集和主要執行個體，才能開始使用 AlloyDB。
建立叢集
如要建立啟用私人服務存取權或 Private Service Connect 的叢集，請使用
gcloud alloydb clusters create指令。私人服務存取權
gcloud alloydb clusters create CLUSTER_ID \ --database-version=POSTGRES_VERSION \ --password=PASSWORD \ --region=REGION_ID \ --project=PROJECT_ID \ --network=NETWORKPrivate Service Connect
gcloud alloydb clusters create CLUSTER_ID \ --database-version=POSTGRES_VERSION \ --password=PASSWORD \ --region=REGION_ID \ --project=PROJECT_ID \ --enable-private-service-connect更改下列內容：
CLUSTER_ID：您要建立的叢集 ID。開頭須為小寫英文字母，且只能由小寫英文字母、數字和連字號組成。VERSION：叢集資料庫伺服器要相容的 PostgreSQL 主要版本。請選擇下列其中一項：14，確保與 PostgreSQL 14 相容15，以便與 PostgreSQL 15 相容 (這是支援的預設 PostgreSQL 版本)17，以便與 PostgreSQL 17 (預先發布版) 相容如要進一步瞭解使用 PostgreSQL 17 預先發布版時的限制，請參閱「PostgreSQL 17 預先發布版相容性」。
PASSWORD：預設postgres使用者的密碼。NETWORK(選用)：您為 AlloyDB 設定私人服務存取權的虛擬私有雲網路名稱。如果省略--network旗標，AlloyDB 會使用default網路。如果是共用虛擬私有雲網路，請設為虛擬私有雲網路的完整路徑，例如
projects/cymbal-project/global/networks/shared-vpc-network。--enable-private-service-connect(選用)：設為啟用 Private Service Connect，做為叢集及其執行個體的連線方法。REGION_ID：要放置叢集的區域。
PROJECT_ID：您要放置叢集的專案 ID。
這個指令會啟動長時間執行的作業，並傳回作業 ID。
選用：如要將特定 IP 位址範圍套用至這個叢集，請提供下列引數，而非允許 AlloyDB 選擇 IP 位址範圍：
--allocated-ip-range-name=RANGE將
RANGE替換為您要讓這個叢集用於私人服務存取權的 IP 位址範圍名稱。如要進一步瞭解這個選項，請參閱「建立具有特定 IP 位址範圍的叢集」。
選用：如要使用客戶自行管理的加密金鑰 (CMEK) 加密這個叢集，而非預設的 Google 代管加密，請提供下列引數：
--kms-key=KEY_ID \ --kms-keyring=KEYRING_ID \ --kms-location=LOCATION_ID \ --kms-project=PROJECT_ID請替換下列項目：
KEY_ID：要使用的 CMEK 金鑰 ID。KEYRING_ID：金鑰的金鑰環 ID。LOCATION_ID：金鑰環所在區域的 ID，必須與叢集所在的區域相同。PROJECT_ID：金鑰環專案的 ID。
確認作業是否成功。
gcloud alloydb operations describe OPERATION_ID \ --region=REGION_ID \ --project=PROJECT_ID將
OPERATION_ID替換為先前步驟傳回的作業 ID。
建立主要叢集後，您必須建立主要執行個體。
建立主要執行個體
如要建立主要執行個體，請使用 gcloud alloydb instances create 指令。
gcloud alloydb instances create INSTANCE_ID \
--instance-type=PRIMARY \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--project=PROJECT_ID \
--cpu-count=CPU_COUNT \
--machine-type=MACHINE_TYPE \
--allowed-psc-projects=ALLOWED_PROJECT_LIST更改下列內容：
INSTANCE_ID：要建立的執行個體 ID。只能使用小寫英文字母、數字和連字號，而且開頭須為小寫英文字母。REGION_ID：執行個體所在的區域。CLUSTER_ID：先前建立的叢集 ID。PROJECT_ID：叢集建立所在專案的 ID。CPU_COUNT：執行個體所需的 vCPU 數量。- 您必須指定
cpu_count或machine_type。 如果只提供
cpu_count，系統會建立 N2 執行個體，並採用下列規格：- 2：2 個 vCPU，16 GB RAM
- 4：4 個 vCPU，32 GB RAM
- 8：8 個 vCPU，64 GB RAM
- 16：16 個 vCPU，128 GB RAM
- 32：32 個 vCPU，256 GB RAM
- 64：64 個 vCPU，512 GB RAM
- 96：96 個 vCPU，768 GB RAM
- 128：128 個 vCPU，864 GB RAM
如果同時提供
machine_type和cpu_count，則cpu_count值必須與machine_type中指定的 vCPU 數量一致。舉例來說，如果machine_type為n2-highmem-4，則必須將cpu_count設為4。
- 您必須指定
MACHINE_TYPE：從支援的機型清單中選取，例如n2-highmem-4、c4-highmem-4-lssd或c4a-highmem-4-lssd。詳情請參閱「選擇 AlloyDB 機器類型」。如果同時使用
machine_type和cpu_count，cpu_count和machine_type中的值必須相符。舉例來說，如果machine_type為n2-highmem-4，則必須將cpu_count設為4。ALLOWED_PROJECT_LIST：(選用) 如果您使用 Private Service Connect，ALLOWED_PROJECT_LIST是以半形逗號分隔的專案 ID 清單，或您要允許存取執行個體的專案編號。
Terraform
建立叢集和主要執行個體
如要建立叢集及其主要執行個體，請使用 Terraform 資源。
以下程式碼片段會根據 AlloyDB 執行個體完整範例，建立叢集和主要執行個體：
resource "google_alloydb_instance" "default" {
cluster = google_alloydb_cluster.default.name
instance_id = "alloydb-instance"
instance_type = "PRIMARY"
machine_config {
cpu_count = 2
}
depends_on = [google_service_networking_connection.vpc_connection]
}
resource "google_alloydb_cluster" "cluster_abc" {
cluster_id = "alloydb-cluster"
location = "us-central1"
network_config {
network = google_compute_network.default.id
}
database_version = "POSTGRES_16"
initial_user {
password = "alloydb-cluster"
}
}
data "google_project" "project" {}
resource "google_compute_network" "default" {
name = "alloydb-network"
}
resource "google_compute_global_address" "private_ip_alloc" {
name = "alloydb-cluster"
address_type = "INTERNAL"
purpose = "VPC_PEERING"
prefix_length = 16
network = google_compute_network.default.id
}
resource "google_service_networking_connection" "vpc_connection" {
network = google_compute_network.default.id
service = "servicenetworking.googleapis.com"
reserved_peering_ranges = [google_compute_global_address.private_ip_alloc.name]
}
這個範例會建立 N2 執行個體。如需其他支援的機器類型 (例如 n2-highmem-4、c4-highmem-4-lssd 或 c4a-highmem-4-lssd) 清單，請參閱「選擇 AlloyDB 機器類型」。
準備 Cloud Shell
如要在 Google Cloud 專案中套用 Terraform 設定，請準備 Cloud Shell，步驟如下：
- 啟動 Cloud Shell。
設定要套用 Terraform 設定的預設 Google Cloud 專案。
每個專案只需要執行一次這個指令，而且可以在任何目錄中執行。
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
如果您在 Terraform 設定檔中設定明確值，系統會覆寫環境變數。
準備目錄
每個 Terraform 設定檔都必須有自己的目錄，也稱為「根模組」。
- 在 Cloud Shell 中建立目錄，並在該目錄中建立新檔案。檔案名稱必須是 TF 檔案，例如
main.tf。在本文件中，這個檔案稱為main.tf。mkdir DIRECTORY && cd DIRECTORY && touch main.tf
- 將範例程式碼複製到新建立的
main.tf。 視需要從 GitHub 複製程式碼。如果 Terraform 程式碼片段是端對端解決方案的一部分，建議使用這個方法。 - 查看
main.tf檔案，並修改範例參數，套用至您的環境。 - 儲存變更。
- 初始化 Terraform。每個目錄只需執行一次這項操作。
terraform init
-upgrade選項：terraform init -upgrade
套用變更
- 檢查設定，確認 Terraform 更新符合預期：
terraform plan
- 執行下列指令，並在提示中輸入
yes，即可套用 Terraform 設定：terraform apply
Apply complete!訊息。 - 開啟 Google Cloud 專案即可查看結果。在 Google Cloud 控制台中，前往 UI 中的資源，確認 Terraform 已建立或更新這些資源。
REST v1
建立叢集
這個範例會建立叢集。 如需這項呼叫的完整參數清單，請參閱「方法：projects.locations.clusters.create」。如要瞭解叢集設定，請參閱「查看叢集和執行個體設定」。
請勿在叢集 ID 中加入敏感資訊或個人識別資訊，因為外部使用者可以看見此 ID。 叢集名稱不需要包含專案 ID。系統會在適當地方 (例如在記錄檔中) 自動加入。
如要傳送要求，請將要求主體儲存在名為 cluster_request.json 的檔案中：
{
"databaseVersion": "<var>DATABASE_VERSION</var>",
"initialUser": {
"user": "<var>INITIAL_USERNAME</var>",
"password": "<var>INITIAL_USER_PASSWORD</var>"
},
"labels": {
"test": "alloydb-cluster-full"
}
}
請替換下列項目：
DATABASE_VERSION：資料庫版本的列舉字串，例如POSTGRES_17。INITIAL_USERNAME：您用於預設 postgres 使用者的使用者名稱。INITIAL_USER_PASSWORD：您用於預設 postgres 使用者的密碼。
請使用下列 HTTP 方法和網址：
POST https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID
請替換下列項目：
PROJECT_ID：您要叢集所在的專案 ID。LOCATION_ID：叢集所在區域的 ID。CLUSTER_ID：您建立的叢集 ID。 叢集 ID 開頭須為小寫英文字母，且只能包含小寫英文字母、數字和連字號。
您可以使用下列 curl 執行上述要求：
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://alloydb.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID -d @cluster_request.json
建立主要執行個體
這個範例會建立主要執行個體。如需此呼叫的完整參數清單，請參閱「方法：projects.locations.clusters.instances.create」。如要瞭解叢集設定，請參閱「查看叢集和執行個體設定」。
請勿在叢集 ID 中加入敏感資訊或個人識別資訊，因為外部使用者可以看見此 ID。您不需要在叢集名稱中加入專案 ID，因為系統會在適當地方自動加入，例如記錄檔。
如要傳送要求，請將下列要求主體儲存在名為 instance_request.json 的檔案中。
{
"instance_type": "PRIMARY",
"machine_config": {
"cpu_count": "vCPU_COUNT"
}
}
請替換下列項目：
VCPU_COUNT：要建立的執行個體上可見的 CPU 核心數量。
上述範例會建立 N2 執行個體，規格如下：
- 2：2 個 vCPU，16 GB RAM
- 4：4 個 vCPU，32 GB RAM
- 8：8 個 vCPU，64 GB RAM
- 16：16 個 vCPU，128 GB RAM
- 32：32 個 vCPU，256 GB RAM
- 64：64 個 vCPU，512 GB RAM
- 96：96 個 vCPU，768 GB RAM
- 128：128 個 vCPU，864 GB RAM
以下範例說明如何為機器類型建立執行個體：
machine_config: {
machine_type : MACHINE_TYPE,
},
將 MACHINE_TYPE 替換為支援的機器類型，例如 n2-highmem-4、c4-highmem-4-lssd 或 c4a-highmem-4-lssd。如要進一步瞭解支援的機器類型，請參閱「選擇 AlloyDB 機器類型」。
請使用下列 HTTP 方法和網址：
POST https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances?instance_id=INSTANCE_ID
請替換下列項目：
PROJECT_ID：您要叢集所在的專案 ID。LOCATION_ID：叢集所在區域的 ID。CLUSTER_ID：您建立的叢集 ID。ID 開頭須為小寫英文字母，且只能包含小寫英文字母、數字和連字號。INSTANCE_ID：要建立的主要執行個體名稱。
您可以使用 curl 執行要求，如下列範例所示：
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://alloydb.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances?instance_id=INSTANCE_ID -d @instance_request.json
複製運作中的叢集
如要建立現有叢集的副本，其中包含來源叢集的所有資料副本，並在相同區域中執行，請對該叢集執行時間點復原作業。您可以指定非常近的時間點，例如目前這一分鐘的第一秒。
這個程序只會將來源叢集的資料複製到副本，不會複製來源叢集的任何設定。如要使用 CMEK 加密複製項的資料，即使來源叢集的資料已以 CMEK 加密，您仍須在時間點還原指令中指定 CMEK 詳細資料。建立新叢集後，您需要新增執行個體、資料庫標記、備份排程，以及任何其他符合需求的必要設定。
以這種方式建立的叢集會獨立於來源存在，且初始複製完成後，其資料與來源叢集的資料沒有任何關係。如要建立次要叢集，自動追蹤及複製來源叢集中的資料變更，請參閱「關於跨區域複寫」。
建立特定 IP 位址範圍的叢集
AlloyDB 會使用私人服務連線，允許叢集的內部資源彼此通訊。建立叢集前，虛擬私有雲 (VPC) 網路必須包含至少一個已設定私人服務存取連線的 IP 位址範圍。
如果虛擬私有雲網路包含多個具有
使用 C4A Axion 型機器系列的注意事項
AlloyDB 提供以 Google Axion 為基礎的 C4A 機器系列，這是 Google 的自訂 Arm 架構處理器。C4A 虛擬機器 (VM) 提供預先定義的設定，可選擇 1、4、8、16、32、48、64 和 72 個 vCPU，以及高達 576 GB 的雙倍資料速率 5 (DDR5) 記憶體。
選擇 C4A 時，請注意下列事項：
- 如要將現有的 N2 執行個體切換為 C4A 執行個體，請使用 Google Cloud 控制台、gcloud CLI、Terraform 或 API，修改目前執行個體的
machine_type。 - 請勿刪除 N2 執行個體，並在同一個叢集中建立新的 C4A 執行個體。
C4A 支援下列地區：
asia-east1asia-southeast1europe-west1europe-west2europe-west3europe-west4us-central1us-east1us-east4
使用 1 個 vCPU 機器類型時的注意事項
AlloyDB 提供 1 個 vCPU 的 C4A 規格，僅供開發及測試。如為實際工作環境工作負載，請選擇兩個以上的 vCPU。
選擇 1 個 vCPU 時，請注意下列限制：
- 1 個 vCPU 搭配 8 GB 記憶體，但不支援超快速快取。
- 如果資料庫大小為數十 GB，建議在開發和沙箱環境中使用 1 個 vCPU 的設定。如果是較大的資料庫和實際工作環境工作負載，建議使用 2 個以上的 vCPU。
- 您可以設定高可用性 (HA)，但我們不提供運作時間服務水準協議。
- 如要瞭解可在何處部署 1 個 vCPU，請參閱 C4A 支援的區域。