יצירת אשכול והמופע הראשי שלו

בדף הזה מוסבר איך להגדיר אשכול מלא של AlloyDB ל-PostgreSQL. במאמר הזה נסביר איך ליצור אשכול AlloyDB חדש ואת המכונה הראשית שלו באמצעות מסוף Google Cloud , Google Cloud CLI,‏ API בארכיטקטורת REST או Terraform.

לפני שמתחילים

Google Cloud הפרויקט שבו אתם משתמשים צריך להיות מופעל כדי לגשת ל-AlloyDB.
רשת VPC בפרויקט שבו אתם משתמשים צריכה להיות מוגדרת כבר לגישה לשירותים פרטיים ל-AlloyDB. Google Cloud
כשמפתחים עומסי עבודה ומשתמשים בארגז חול, חשוב להתחשב באזור ובסוג המכונה. כדי להשתמש בצורה של vCPU אחד, צריך לבחור אזור שתומך בצורה הזו. מידע נוסף זמין במאמר שיקולים לשימוש ב-vCPU אחד.

התפקידים הנדרשים

לפני שיוצרים את אשכול Postgres הראשון, צריך לוודא שיש לכם את התפקידים הנכונים בניהול הזהויות והרשאות הגישה (IAM).

צריך להיות לכם אחד מתפקידי ה-IAM האלה ב Google Cloud פרויקט שבו אתם משתמשים:
- ‫roles/alloydb.admin (תפקיד IAM מוגדר מראש מסוג AlloyDB Admin)
- ‫roles/owner (תפקיד בסיסי ב-IAM מסוג בעלים)
- ‫roles/editor (תפקיד בסיסי ב-IAM עם הרשאת עריכה)
אם לא הוקצו לכם התפקידים האלה, פנו לאדמין הארגוני כדי לבקש גישה.
צריכה להיות לכם גם ההרשאה compute.networks.list בפרויקט Google Cloud שבו אתם משתמשים. כדי לקבל את ההרשאה הזו תוך הקפדה על העקרון של הרשאות מינימליות, צריך לבקש מהאדמין להקצות לכם את התפקיד 'משתמש ברשת Compute' (roles/compute.networkUser).

יצירת אשכול חדש ומופע ראשי

המסוף

עוברים לדף Clusters.

כניסה לדף Clusters
לוחצים על יצירת אשכול.
בוחרים הגדרה של אשכול. מידע נוסף על ההבדל בין הגדרות בסיסיות לבין הגדרות עם זמינות גבוהה זמין במאמר צמתים ומופעים.

אם אתם לא בטוחים אם צריך מופעים של מאגר קריאה באשכול החדש, בחרו באחת מההגדרות ללא מאגרי קריאה. אפשר להוסיף ל-cluster מופעים של מאגר קריאה מאוחר יותר, כשצריך.
לוחצים על Continue.
בקטע Configure your cluster (הגדרת האשכול), בשדה Cluster ID (מזהה האשכול), מזינים מזהה לאשכול.
בשדה Password, מזינים סיסמה ראשונית עבור האשכול החדש. ‫AlloyDB מקצה את הסיסמה שצוינה למשתמש במסד הנתונים postgres בזמן יצירת האשכול.
אופציונלי: כדי להגדיר את הדגל alloydb.iam_authentication באופן ידני, מבטלים את הסימון של Create an IAM database user (יצירת משתמש מסד נתונים של IAM). מידע נוסף מופיע במאמר עריכת מופע.

אפשרות ברירת המחדל היא Create an IAM database user (יצירת משתמש מסד נתונים של IAM), שפועלת באופן הבא:
- הפעלת הדגל alloydb.iam_authentication במופע הראשי.
- המערכת יוצרת בשבילכם משתמש במסד נתונים של IAM.
בשדה גרסת מסד הנתונים, בוחרים את הגרסה הראשית של PostgreSQL לאשכול AlloyDB החדש.
בחירת אזור. לעומסי עבודה של פיתוח וארגז חול, כדאי להשתמש בצורה של vCPU אחד, שזמינה באזורים נבחרים. מידע נוסף זמין במאמר שיקולים לשימוש ב-vCPU אחד.
בוחרים נתיב ברשת.
אופציונלי: כדי להחיל על האשכול הזה טווח כתובות IP ספציפי במקום לאפשר ל-AlloyDB לבחור טווח כתובות IP, פועלים לפי השלבים הבאים:
1. לוחצים על הצגת האפשרות 'טווח כתובות IP שהוקצו'.
2. ברשימה Allocated IP range, בוחרים טווח כתובות IP.
מידע נוסף על האפשרות הזו זמין במאמר יצירת אשכול עם טווח כתובות IP ספציפי.
אופציונלי: כדי להצפין את האשכול הזה באמצעות מפתח הצפנה בניהול הלקוח (CMEK) במקום הצפנה בניהול Google, פועלים לפי השלבים הנוספים הבאים:
1. לוחצים על אפשרויות מתקדמות להצפנה.
2. בוחרים באפשרות מפתח הצפנה בניהול הלקוח (CMEK).
3. בתפריט שמופיע, בוחרים מפתח בניהול הלקוח.
  
  Google Cloud המסוף מגביל את הרשימה הזו למפתחות שנמצאים באותו פרויקט ואזור כמו האשכול החדש. Google Cloud כדי להשתמש במפתח שלא מופיע ברשימה, לוחצים על לא רואים את המפתח? מזינים את שם משאב המפתח, ואז מקלידים את שם המשאב של המפתח בתיבת הדו-שיח שמופיעה.
  
  שימו לב: כדי להשתמש ב-CMEK עם AlloyDB, צריך לבצע הגדרה נוספת. מידע נוסף זמין במאמר שימוש ב-CMEK עם AlloyDB.
4. לוחצים על Continue.
מגדירים את המופע הראשי:
1. בשדה Instance ID (מזהה המכונה), מזינים מזהה למכונה הראשית.
2. בוחרים אחת מסדרות המכונות הבאות:
  - ‫C4A (סדרת מכונות שמבוססת על Google Axion).
  - ‫N2 (סדרת מכונות מבוססת x86). זו סדרת המכונות שמוגדרת כברירת מחדל.
  - ‫C4 (סדרת מכונות מבוססת x86).
  - ‫Z3 (סדרת מכונות מבוססת Intel Xeon).
3. בוחרים סוג מכונה. מידע נוסף זמין במאמר בחירת סוג מכונה.
  - ‫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 מעבדים וירטואליים.
  - ‫Z3 תומך ב-8,‏ 14,‏ 16,‏ 22,‏ 32,‏ 44 ו-88 vCPU.
  מידע נוסף על השימוש בסדרת המכונות C4A מבוססת Axion, כולל סוג המכונה עם vCPU אחד, זמין במאמר שיקולים לשימוש בסדרת המכונות C4A מבוססת Axion.
4. אופציונלי: מגדירים דגלים בהתאמה אישית למופע. לכל סימון, פועלים לפי השלבים הבאים:
  1. לוחצים על הוספת דגל.
  2. ברשימה New database flag, בוחרים דגל.
  3. צריך לספק ערך לדגל.
  4. לוחצים על סיום.
לוחצים על יצירת אשכול.

הערה: אחרי שיוצרים את האשכול, אפשר לעקוב אחרי תקינות האשכול והמופע באמצעות בעיות תקינות לפי סדר עדיפות במסוף Google Cloud . למידע נוסף, ראו מעקב אחרי התקינות של אשכולות ומופעים של AlloyDB.

gcloud

כדי להשתמש ב-CLI של gcloud, אפשר להתקין ולהפעיל את 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=NETWORK
```
התחברות לשירות פרטי
```
gcloud alloydb clusters create CLUSTER_ID \
    --database-version=POSTGRES_VERSION \
    --password=PASSWORD \
    --region=REGION_ID \
    --project=PROJECT_ID \
    --enable-private-service-connect
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫CLUSTER_ID: המזהה של האשכול שאתם יוצרים. הוא צריך להתחיל באות קטנה באנגלית ויכול לכלול אותיות קטנות, ספרות ומקפים.
- ‫VERSION: הגרסה הראשית של PostgreSQL שאתם רוצים ששרתי מסד הנתונים של האשכול יהיו תואמים לה. צריך לבחור אחת מהאפשרויות:
  - ‫14, לתאימות ל-PostgreSQL 14
  - ‫15, לתאימות ל-PostgreSQL 15
  - ‫16, לתאימות ל-PostgreSQL 16
  - ‫17, כדי שתהיה תאימות ל-PostgreSQL 17, שהיא גרסת ברירת המחדל של PostgreSQL הנתמכת
  - ‫18, לתאימות ל-PostgreSQL 18 (תצוגה מקדימה)
    
    מידע נוסף על ההגבלות שחלות על השימוש ב-PostgreSQL 18 בגרסת Preview זמין במאמר תאימות ל-PostgreSQL 18 בגרסת Preview.
- ‫PASSWORD: הסיסמה שבה יש להשתמש עבור משתמש ברירת המחדל postgres.
- ‫NETWORK (אופציונלי): השם של רשת ה-VPC שהגדרתם לגישה פרטית לשירותים אל AlloyDB. אם לא מציינים את הדגל --network,‏ AlloyDB משתמש ברשת default.
  
  במקרה של רשת VPC משותפת, צריך להגדיר את הנתיב המוגדר במלואו של רשת ה-VPC – לדוגמה, projects/cymbal-project/global/networks/shared-vpc-network.
- ‫--enable-private-service-connect (אופציונלי): מגדירים את האפשרות enable Private Service Connect כשיטת הקישוריות לאשכול ולמופעים שלו.
- ‫REGION_ID: האזור שבו רוצים למקם את האשכול.
הערה: לעומסי עבודה של פיתוח וארגז חול, כדאי לשקול את הצורה של 1 vCPU, שזמינה באזורים נבחרים. מידע נוסף זמין במאמר שיקולים לשימוש ב-vCPU אחד.
- ‫PROJECT_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 שרוצים להשתמש בו.
- ‫KEYRING_ID: המזהה של אוסף המפתחות של המפתח.
- ‫LOCATION_ID: המזהה של האזור של מחזיק המפתחות, שחייב להיות זהה לאזור של האשכול.
- ‫PROJECT_ID: המזהה של הפרויקט של מחזיק המפתחות.
הערה: כדי להשתמש ב-CMEK, צריך לבצע הגדרה נוספת. מידע נוסף מופיע במאמר בנושא שימוש ב-CMEK עם AlloyDB.
מוודאים שהפעולה בוצעה בהצלחה.
```
gcloud alloydb operations describe OPERATION_ID \
    --region=REGION_ID \
    --project=PROJECT_ID
```
מחליפים את OPERATION_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: המזהה של המכונה שאתם יוצרים. הוא חייב להתחיל באות קטנה באנגלית, ויכול לכלול אותיות קטנות, מספרים ומקפים.
‫REGION_ID: האזור שבו רוצים למקם את המכונה.
‫CLUSTER_ID: המזהה של האשכול שיצרתם קודם.
‫PROJECT_ID: מזהה הפרויקט שבו נוצר האשכול.
‫CPU_COUNT: מספר ליבות ה-CPU הווירטואליות שרוצים להקצות למכונה.
- חובה לציין cpu_count או machine_type.
- אם מספקים רק את cpu_count, נוצר מופע N2 עם המפרט הבא:
  - ‫2: 2 vCPUs, ‏ 16 GB RAM
  - ‫4: 4 מעבדי vCPU, ‏ 32GB RAM
  - ‫8: 8 מעבדי vCPU, ‏ 64GB RAM
  - ‫16: 16 vCPUs, ‏ 128 GB RAM
  - ‫32: ‏ 32 מעבדי vCPU, ‏ 256GB RAM
  - ‫64: ‏ 64 מעבדי vCPU, ‏ 512GB RAM
  - ‫96: ‏ 96 vCPUs, ‏ 768 GB RAM
  - ‫128: ‏ 128 vCPUs, ‏ 864 GB RAM
- אם מציינים גם את machine_type וגם את cpu_count, הערך של cpu_count חייב להיות זהה למספר המעבדים הווירטואליים שצוין ב-machine_type. לדוגמה, אם הערך של 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 היא רשימה מופרדת בפסיקים של מזהי פרויקטים או מספר הפרויקט שרוצים לאפשר לו גישה למופע.

Terraform

יצירת אשכול ומופע ראשי

כדי ליצור אשכול ואת המופע הראשי שלו, משתמשים במשאב של Terraform.

קטע הקוד הבא מציג איך ליצור אשכול ומכונה ראשית על סמך הדוגמה AlloyDB instance full:

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

כדי להחיל את ההגדרות של Terraform בפרויקט, מכינים את Cloud Shell באופן הבא: Google Cloud

מפעילים את 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
```
אופציונלי: כדי להשתמש בגרסה העדכנית ביותר של הספק של Google, כוללים את האפשרות -upgrade:
```
terraform init -upgrade
```

החלה של השינויים

בודקים את ההגדרות כדי לוודא שהעדכונים ב-Terraform תואמים לציפיות שלכם:
```
terraform plan
```
מתקנים את ההגדרות לפי הצורך.
מריצים את הפקודה הבאה ומזינים yes בהודעה שמופיעה, כדי להחיל את הגדרות Terraform:
```
terraform apply
```
ממתינים עד שב-Terraform תוצג ההודעה Apply complete!.
פותחים את Google Cloud הפרויקט כדי לראות את התוצאות. במסוף Google Cloud , נכנסים למשאבים בממשק המשתמש כדי לוודא שהם נוצרו או עודכנו ב-Terraform.

REST v1

יצירת אשכול

בדוגמה הזו נוצר אשכול. רשימה מלאה של הפרמטרים של הקריאה הזו זמינה במאמר Method: projects.locations.clusters.create. מידע על הגדרות האשכול זמין במאמר צפייה בהגדרות של אשכול ומופע.

אל תכללו מידע רגיש או פרטים אישיים מזהים במזהה האשכול, כי הוא גלוי חיצונית. אין צורך לכלול את מזהה הפרויקט בשם האשכול. הפעולה הזו מתבצעת אוטומטית במקרים המתאימים, למשל בקובצי היומן.

כדי לשלוח את הבקשה, שומרים את תוכן הבקשה בקובץ בשם 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: מחרוזת enum של גרסת מסד הנתונים, לדוגמה POSTGRES_17.
‫INITIAL_USERNAME: שם המשתמש שבו משתמשים עבור משתמש ברירת המחדל של postgres.
‫INITIAL_USER_PASSWORD: הסיסמה שבה משתמשים עבור משתמש ברירת המחדל של postgres.

משתמשים ב-method הבא ב-HTTP ובכתובת ה-URL:

POST https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID

מחליפים את הפרטים הבאים:

‫PROJECT_ID: מזהה הפרויקט שבו רוצים למקם את האשכול.
‫LOCATION_ID: המזהה של האזור של האשכול.
‫CLUSTER_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

יצירת מופע ראשי

בדוגמה הזו נוצרת מכונה ראשית. רשימה מלאה של הפרמטרים של הקריאה הזו זמינה במאמר בנושא Method: ‏ projects.locations.clusters.instances.create. מידע על הגדרות האשכול זמין במאמר צפייה בהגדרות של אשכול ושל מופע.

אל תכללו מידע רגיש או פרטים אישיים מזהים במזהה האשכול, כי הוא גלוי חיצונית. לא צריך לכלול את מזהה הפרויקט בשם האשכול, כי המערכת עושה את זה אוטומטית במקומות המתאימים – למשל, בקובצי היומן.

כדי לשלוח את הבקשה, שומרים את תוכן הבקשה הבא בקובץ בשם instance_request.json.

{
  "instance_type": "PRIMARY",
  "machine_config": {
    "cpu_count": "vCPU_COUNT"
  }
}

מחליפים את הפרטים הבאים:

‫VCPU_COUNT: מספר ליבות ה-CPU שגלויות במכונה שרוצים ליצור.

בדוגמה שלמעלה נוצרת מכונת N2 עם המפרט הבא:

‫2: 2 vCPUs, ‏ 16 GB RAM
‫4: 4 מעבדי vCPU, ‏ 32 GB RAM
‫8: 8 vCPUs, ‏ 64 GB RAM
‫16: 16 vCPUs, ‏ 128 GB RAM
‫32: ‏ 32 vCPUs, ‏ 256 GB RAM
‫64: ‏ 64 vCPU, ‏ 512 GB RAM
‫96: ‏ 96 vCPUs, ‏ 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.

משתמשים ב-method הבא ב-HTTP ובכתובת ה-URL:

POST https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances?instance_id=INSTANCE_ID

מחליפים את הפרטים הבאים:

‫PROJECT_ID: מזהה הפרויקט שבו רוצים למקם את האשכול.
‫LOCATION_ID: המזהה של האזור של האשכול.
‫CLUSTER_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

שכפול של אשכול פעיל

כדי ליצור שיבוט של אשכול פעיל, שמכיל עותק של כל הנתונים של אשכול המקור ופועל באותו אזור, מבצעים שחזור מערכת מנקודה מסוימת בזמן (PITR) באשכול הזה. כשמגדירים את השעה, אפשר לציין נקודת זמן עדכנית מאוד – למשל, השנייה הראשונה של הדקה הנוכחית.

במהלך התהליך הזה, רק הנתונים של אשכול המקור מועתקים לשיבוט – לא ההגדרות של אשכול המקור. כדי להצפין את הנתונים של השיבוט באמצעות CMEK, צריך לציין את פרטי ה-CMEK כחלק מהפקודה לשחזור מערכת מנקודה מסוימת בזמן (PITR), גם אם הנתונים של אשכול המקור כבר מוצפנים באמצעות CMEK. אחרי שיוצרים את האשכול החדש, צריך להוסיף מופעים, דגלים של מסד נתונים, תזמונים של גיבויים וכל הגדרה אחרת שנדרשת כדי להתאים את האשכול לצרכים שלכם.

אשכול שנוצר בדרך הזו קיים באופן עצמאי, בלי קשר למקור שלו. הנתונים שלו לא קשורים לנתונים של אשכול המקור אחרי שהשכפול הראשוני מסתיים. אם רוצים ליצור אשכולות משניים שעוקבים באופן אוטומטי אחרי שינויים בנתונים שבוצעו באשכולות המקור שלהם ומשכפלים אותם, אפשר לעיין במאמר מידע על שכפול בין אזורים.

יצירת אשכול עם טווח כתובות IP ספציפי

‫AlloyDB משתמש בגישה לשירותים פרטיים כדי לאפשר למשאבים פנימיים של אשכול לתקשר ביניהם. כדי ליצור אשכול, ברשת הענן הווירטואלי הפרטי (VPC) צריך להיות לפחות טווח כתובות IP אחד שמוגדר עם חיבור גישה לשירותים פרטיים.

אם רשת ה-VPC מכילה יותר מטווח כתובות IP אחד עם

שיקולים לשימוש בסדרת המכונות C4A שמבוססת על Axion

‫AlloyDB מציע סדרת מכונות C4A שמבוססת על Google Axion, מעבד מותאם אישית מבוסס-Arm של Google. מכונות וירטואליות (VM) מסוג C4A זמינות כתצורות מוגדרות מראש עם 1, 4, 8, 16, 32, 48, 64 ו-72 מעבדים וירטואליים, ועם זיכרון Double Data Rate 5 (DDR5) בנפח של עד 576 GB.

כשבוחרים ב-C4A, חשוב לזכור את הנקודות הבאות:

כדי להחליף מכונת N2 קיימת במכונת C4A, משנים את machine_typeשל המכונה הנוכחית באמצעות Google Cloud המסוף, ה-CLI של gcloud,‏ Terraform או ה-API.
אל תמחקו את מכונת N2 ותיצרו מכונת C4A חדשה באותו אשכול.

התכונה C4A נתמכת באזורים הבאים:

asia-east1
asia-southeast1
europe-west1
europe-west2
europe-west3
europe-west4
us-central1
us-east1
us-east4

הערה: ב-asia-southeast1, נתמך רק vCPU אחד.

שיקולים לשימוש בסוג מכונה עם vCPU אחד

‫AlloyDB מציע צורה של ליבת CPU וירטואלית אחת עם C4A, והוא מיועד למטרות פיתוח ובדיקה בלבד. לעומסי עבודה של ייצור, מומלץ לבחור שני מעבדי vCPU או יותר.

כשבוחרים 1 vCPU, חשוב לזכור את ההגבלות הבאות:

‫vCPU אחד מוצע עם זיכרון של 8GB ללא תמיכה במטמון מהיר במיוחד.
מומלצת הגדרה של 1 vCPU לסביבות פיתוח וארגז חול עם גדלים קטנים יותר של מסדי נתונים, בסדר גודל של עשרות גיגה-בייט. למסדי נתונים גדולים יותר ולעומסי עבודה של ייצור, מומלץ להשתמש ב-2 יחידות vCPU או יותר.
אפשר להגדיר זמינות גבוהה (HA), אבל לא מוצעים הסכמי רמת שירות (SLA) לגבי זמן פעולה.
כדי לדעת באילו אזורים אפשר לפרוס ליבות וירטואליות מסוג 1 vCPU, אפשר לעיין באזורים הנתמכים ב-C4A.

יצירת אשכול והמופע הראשי שלו קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

לפני שמתחילים

התפקידים הנדרשים

יצירת אשכול חדש ומופע ראשי

המסוף

gcloud

יצירת אשכול

גישה לשירותים פרטיים

התחברות לשירות פרטי

יצירת מופע ראשי

Terraform

יצירת אשכול ומופע ראשי

הכנת Cloud Shell

הכנת הספרייה

החלה של השינויים

REST v1

יצירת אשכול

יצירת מופע ראשי

שכפול של אשכול פעיל

יצירת אשכול עם טווח כתובות IP ספציפי

שיקולים לשימוש בסדרת המכונות C4A שמבוססת על Axion

התכונה C4A נתמכת באזורים הבאים:

שיקולים לשימוש בסוג מכונה עם vCPU אחד

המאמרים הבאים

יצירת אשכול והמופע הראשי שלו