איך מתחברים ל-Cloud SQL ל-PostgreSQL מ-Google Kubernetes Engine

בדף הזה מוסבר איך לפרוס אפליקציה לדוגמה ב-Google Kubernetes Engine (GKE) שמחוברת למכונה של PostgreSQL באמצעות מסוף Google Cloud ואפליקציית לקוח. המשאבים שנוצרו במדריך למתחילים הזה בדרך כלל עולים פחות מדולר אחד (USD), בהנחה שאתם משלימים את השלבים, כולל הניקוי, בזמן.

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

  1. נכנסים לחשבון Google Cloud . אנחנו ממליצים למשתמשים חדשים ב- Google Cloudליצור חשבון כדי שיוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that you have the permissions required to complete this guide.

  4. Verify that billing is enabled for your Google Cloud project.

  5. Enable the Artifact Registry, Cloud Build, Cloud SQL Admin, Compute Engine, Kubernetes Engine, Service Networking APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

  6. Install the gcloud CLI.

  7. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  8. To initialize the gcloud CLI, run the following command:

    gcloud init
  9. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  10. Verify that you have the permissions required to complete this guide.

  11. Verify that billing is enabled for your Google Cloud project.

  12. Enable the Artifact Registry, Cloud Build, Cloud SQL Admin, Compute Engine, Kubernetes Engine, Service Networking APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

  13. Install the gcloud CLI.

  14. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  15. To initialize the gcloud CLI, run the following command:

    gcloud init

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

כדי לקבל את ההרשאות שדרושות לביצוע המשימות שמתוארות במדריך למתחילים, בקשו מהאדמין להקצות לכם את התפקידים הבאים ב-IAM בפרויקט של המדריך למתחילים:

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

יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.

הגדרת Cloud SQL

יצירת מכונה של Cloud SQL

יצירת מסד נתונים

כדי ליצור מסד נתונים:

המסוף

  1. נכנסים לדף Cloud SQL Instances במסוף Google Cloud .

    כניסה לדף Cloud SQL Instances

  2. לוחצים על quickstart-instance.
  3. בתפריט הניווט של SQL, לוחצים על Databases.
  4. לוחצים על  Create database.
    1. בשדה Database name בתיבת הדו-שיח New database, מזינים את הערך quickstart-db.
    2. לוחצים על יצירה.

gcloud

מריצים את הפקודה gcloud sql databases create כדי ליצור מסד נתונים.

gcloud sql databases create quickstart-db --instance=quickstart-instance

יצירת משתמש

המסוף

  1. נכנסים לדף Cloud SQL Instances במסוף Google Cloud .

    כניסה לדף Cloud SQL Instances

  2. כדי לפתוח את הדף Overview של מכונה, לוחצים על שם המכונה.
  3. בתפריט הניווט של SQL, לוחצים על Users.
  4. לוחצים על הוספת חשבון משתמש.
  5. בדף הוספת חשבון משתמש למופע instance_name, מוסיפים את הפרטים הבאים:
    • שם משתמש: מגדירים לערך quickstart-user
    • סיסמה: מציינים סיסמה למשתמש במסד הנתונים. חשוב לזכור את השם הזה, כי תצטרכו אותו בשלב מאוחר יותר במדריך למתחילים.
  6. לוחצים על הוספה.

gcloud

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

מריצים את הפקודה gcloud sql users create כדי ליצור את המשתמש.

gcloud sql users create quickstart-user \
--instance=quickstart-instance \
--password=DB_PASS

מגבלות האורך של שמות המשתמשים ב-Cloud SQL זהות לאלה של PostgreSQL מקומי.

יצירת אשכול GKE

המסוף

  1. במסוף Google Cloud , נכנסים לדף Google Kubernetes Engine.

    כניסה ל-Google Kubernetes Engine

  2. לוחצים על יצירה.
  3. לוחצים על Configure ב-GKE Autopilot.
  4. בשדה Name, מציינים את שם האשכול בתור gke-cloud-sql-quickstart.
  5. לוחצים על יצירה.

gcloud

מריצים את הפקודה gcloud container clusters create-auto כדי ליצור את האשכול.

gcloud container clusters create-auto gke-cloud-sql-quickstart \
    --region us-central1

שכפול אפליקציה לדוגמה של Cloud SQL מ-GitHub באמצעות Cloud Shell

אחרי שיצרתם מכונה של Cloud SQL, מסד נתונים ואשכול GKE, אתם יכולים לשכפל ולהגדיר אפליקציה לדוגמה שמתחברת למכונה של Cloud SQL. האפליקציה לדוגמה מאוחסנת ב-GitHub. כדי להשלים את השלבים הבאים במדריך למתחילים, צריך להשתמש ב-Cloud Shell, ב-gcloud וב-kubectl. הכלים gcloud ו-kubectl מותקנים מראש ב-Cloud Shell.

המשך

  1. ב-Cloud Shell Editor, פותחים את קוד המקור של האפליקציה לדוגמה.
    פתיחת Cloud Shell Editor
  2. בתיבת הדו-שיח Open in Cloud Shell, לוחצים על Confirm כדי להוריד את קוד האפליקציה לדוגמה ולפתוח את ספריית האפליקציה לדוגמה ב-Cloud Shell Editor.

Java

  1. ב-Cloud Shell Editor, פותחים את קוד המקור של האפליקציה לדוגמה.
    פתיחת Cloud Shell Editor
  2. בתיבת הדו-שיח Open in Cloud Shell, לוחצים על Confirm כדי להוריד את קוד האפליקציה לדוגמה ולפתוח את ספריית האפליקציה לדוגמה ב-Cloud Shell Editor.

Node.js

  1. ב-Cloud Shell Editor, פותחים את קוד המקור של האפליקציה לדוגמה.
    פתיחת Cloud Shell Editor
  2. בתיבת הדו-שיח Open in Cloud Shell, לוחצים על Confirm כדי להוריד את קוד האפליקציה לדוגמה ולפתוח את ספריית האפליקציה לדוגמה ב-Cloud Shell Editor.

Python

  1. ב-Cloud Shell Editor, פותחים את קוד המקור של האפליקציה לדוגמה.
    פתיחת Cloud Shell Editor
  2. בתיבת הדו-שיח Open in Cloud Shell, לוחצים על Confirm כדי להוריד את קוד האפליקציה לדוגמה ולפתוח את ספריית האפליקציה לדוגמה ב-Cloud Shell Editor.

הפעלת אשכול GKE

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

מריצים את הפקודה gcloud container clusters get-credentials כדי להפעיל את אשכול GKE.
gcloud container clusters get-credentials gke-cloud-sql-quickstart \
  --region us-central1

הגדרה של חשבון שירות

יוצרים ומגדירים Google Cloud חשבון שירות שישמש את GKE, כך שיהיה לו את התפקיד לקוח Cloud SQL עם הרשאות להתחבר ל-Cloud SQL.
  1. מריצים את הפקודה gcloud iam service-accounts create כדי ליצור חשבון שירות חדש:
    gcloud iam service-accounts create gke-quickstart-service-account \
      --display-name="GKE Quickstart Service Account"
  2. מריצים את הפקודה gcloud projects add-iam-policy-binding כדי להוסיף את התפקיד לקוח Cloud SQL לחשבון השירות Google Cloud שיצרתם. מחליפים את YOUR_PROJECT_ID במזהה הפרויקט.
    gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
      --member="serviceAccount:gke-quickstart-service-account@YOUR_PROJECT_ID.iam.gserviceaccount.com" \
      --role="roles/cloudsql.client"
  3. האפליקציה לדוגמה משתמשת ברישום ביומן, לכן צריך להריץ את הפקודה gcloud projects add-iam-policy-binding כדי להוסיף את התפקיד כותב ביומן לחשבון השירות Google Cloud שיצרתם. מחליפים את YOUR_PROJECT_ID במזהה הפרויקט.
    gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
      --member="serviceAccount:gke-quickstart-service-account@YOUR_PROJECT_ID.iam.gserviceaccount.com" \
      --role="roles/logging.logWriter"
  4. חשבון השירות צריך להיות מסוגל לשלוף קובצי אימג' ממאגר Artifactory, לכן צריך להריץ את הפקודה
    gcloud projects add-iam-policy-binding כדי להוסיף את התפקיד קורא של Artifact Registry לחשבון השירות. מחליפים את YOUR_PROJECT_ID במזהה הפרויקט.
    gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
      --member="serviceAccount:gke-quickstart-service-account@YOUR_PROJECT_ID.iam.gserviceaccount.com" \
      --role="roles/artifactregistry.reader"
יוצרים חשבון שירות של Kubernetes שמוגדר עם גישה ל-Cloud SQL, על ידי קישור שלו לחשבון השירות של Google Cloud באמצעות איחוד זהויות של עומסי עבודה ל-GKE.
  1. יוצרים חשבון שירות ב-Kubernetes.
    1. מעדכנים את הקובץ service-account.yaml ב-Cloud Shell Editor. מחליפים את <YOUR-KSA-NAME> ב-ksa-cloud-sql.
    2. מריצים את הפקודה kubectl apply ב-Cloud Shell:
      kubectl apply -f service-account.yaml
  2. מריצים את הפקודה gcloud iam service-accounts add-iam-policy-binding כדי להפעיל קישור IAM של חשבון השירות ב- Google Cloud ושל חשבון השירות ב-Kubernetes. מחליפים את הפרטים הבאים:
    • ‫YOUR_PROJECT_ID במזהה הפרויקט.
    • YOUR_K8S_NAMESPACE ב-default, שהוא מרחב השמות שמוגדר כברירת מחדל לאשכולות שנוצרו ב-GKE.
    • ‫YOUR_KSA_NAME עם ksa-cloud-sql.
    gcloud iam service-accounts add-iam-policy-binding \
      --role="roles/iam.workloadIdentityUser" \
      --member="serviceAccount:YOUR_PROJECT_ID.svc.id.goog[YOUR_K8S_NAMESPACE/YOUR_KSA_NAME]" \
      gke-quickstart-service-account@YOUR_PROJECT_ID.iam.gserviceaccount.com
  3. מריצים את הפקודה kubectl annotate כדי להוסיף הערה לחשבון השירות של Kubernetes עם קישור ל-IAM. מחליפים את הפרטים הבאים:
    • ‫YOUR_KSA_NAME עם ksa-cloud-sql.
    • ‫YOUR_PROJECT_ID במזהה הפרויקט.
    kubectl annotate serviceaccount \
      YOUR_KSA_NAME  \
      iam.gke.io/gcp-service-account=gke-quickstart-service-account@YOUR_PROJECT_ID.iam.gserviceaccount.com

הגדרת סודות

מריצים את הפקודה kubectl create secret generic כדי ליצור סודות של Kubernetes למסד הנתונים, למשתמש ולסיסמת המשתמש, שבהם תשתמש האפליקציה לדוגמה. הערכים של כל סוד מבוססים על הערכים שצוינו בשלבים הקודמים של המדריך למתחילים. מחליפים את DB_PASS בסיסמה של quickstart-user שיצרתם בשלב הקודם, יצירת משתמש, במדריך למתחילים.

kubectl create secret generic gke-cloud-sql-secrets \
  --from-literal=database=quickstart-db \
  --from-literal=username=quickstart-user \
  --from-literal=password=DB_PASS

פיתוח האפליקציה לדוגמה

המשך

  1. חוזרים ל-Cloud Shell Editor ולוחצים על Open Terminal כדי לפתוח את Cloud Shell.
  2. בשורת הפקודה של Cloud Shell, מריצים את הפקודה הבאה של gcloud artifacts repositories create כדי ליצור מאגר ב-Artifact Registry בשם gke-cloud-sql-repo באותו אזור של האשכול. מחליפים את YOUR_PROJECT_ID במזהה הפרויקט.
    gcloud artifacts repositories create gke-cloud-sql-repo \
      --project=YOUR_PROJECT_ID \
      --repository-format=docker \
      --location=us-central1 \
      --description="GKE Quickstart sample app"
  3. משנים את הספרייה למיקום שבו שכפלתם בעבר את האפליקציה לדוגמה של Cloud SQL מ-GitHub. הספרייה של האפליקציה לדוגמה מכילה Dockerfile לאפליקציה לדוגמה. לדוגמה, כדי לשנות את הספריות לספרייה של האפליקציה לדוגמה, אפשר להריץ פקודה כמו זו:
    cd ~/cloudshell_open/golang-samples/cloudsql/postgres/database-sql
      
  4. מריצים את הפקודה gcloud builds submit כדי ליצור קונטיינר של Docker ולפרסם אותו ב-Artifact Registry. מחליפים את YOUR_PROJECT_ID במזהה הפרויקט.
    gcloud builds submit \
      --tag us-central1-docker.pkg.dev/YOUR_PROJECT_ID/gke-cloud-sql-repo/gke-sql .

Java

  1. חוזרים ל-Cloud Shell Editor ולוחצים על Open Terminal כדי לפתוח את Cloud Shell.
  2. בשורת הפקודה של Cloud Shell, מריצים את הפקודה הבאה של gcloud artifacts repositories create כדי ליצור מאגר ב-Artifact Registry בשם gke-cloud-sql-repo באותו אזור של האשכול. מחליפים את YOUR_PROJECT_ID במזהה הפרויקט.
    gcloud artifacts repositories create gke-cloud-sql-repo \
      --project=YOUR_PROJECT_ID \
      --repository-format=docker \
      --location=us-central1 \
      --description="GKE Quickstart sample app"
  3. משנים את הספרייה למיקום שבו שכפלתם בעבר את האפליקציה לדוגמה של Cloud SQL מ-GitHub. הספרייה של האפליקציה לדוגמה מכילה pom.xml לאפליקציה לדוגמה. לדוגמה, כדי לשנות את הספריות לספרייה של האפליקציה לדוגמה, אפשר להריץ פקודה כמו זו:
    cd ~/cloudshell_open/java-docs-samples/cloud-sql/postgres/servlet
      
  4. מריצים את הפקודה mvn באופן הבא כדי ליצור קונטיינר של Docker ולפרסם אותו ב-Artifact Registry. מחליפים את YOUR_PROJECT_ID במזהה הפרויקט.
    mvn clean package com.google.cloud.tools:jib-maven-plugin:2.8.0:build \
      -Dimage=us-central1-docker.pkg.dev/YOUR_PROJECT_ID/gke-cloud-sql-repo/gke-sql \
      -DskipTests -Djib.to.credHelper=gcloud

Node.js

  1. חוזרים ל-Cloud Shell Editor ולוחצים על Open Terminal כדי לפתוח את Cloud Shell.
  2. בשורת הפקודה של Cloud Shell, מריצים את הפקודה הבאה של gcloud artifacts repositories create כדי ליצור מאגר ב-Artifact Registry בשם gke-cloud-sql-repo באותו אזור של האשכול. מחליפים את YOUR_PROJECT_ID במזהה הפרויקט.
    gcloud artifacts repositories create gke-cloud-sql-repo \
      --project=YOUR_PROJECT_ID \
      --repository-format=docker \
      --location=us-central1 \
      --description="GKE Quickstart sample app"
  3. משנים את הספרייה למיקום שבו שכפלתם בעבר את האפליקציה לדוגמה של Cloud SQL מ-GitHub. הספרייה של האפליקציה לדוגמה מכילה Dockerfile לאפליקציה לדוגמה. לדוגמה, כדי לשנות את הספריות לספרייה של האפליקציה לדוגמה, אפשר להריץ פקודה כמו זו:
    cd ~/cloudshell_open/nodejs-docs-samples/cloud-sql/postgres/knex
      
  4. מריצים את הפקודה gcloud builds submit כדי ליצור קונטיינר של Docker ולפרסם אותו ב-Artifact Registry. מחליפים את YOUR_PROJECT_ID במזהה הפרויקט.
    gcloud builds submit \
      --tag us-central1-docker.pkg.dev/YOUR_PROJECT_ID/gke-cloud-sql-repo/gke-sql .

Python

  1. חוזרים ל-Cloud Shell Editor ולוחצים על Open Terminal כדי לפתוח את Cloud Shell.
  2. בשורת הפקודה של Cloud Shell, מריצים את הפקודה הבאה של gcloud artifacts repositories create כדי ליצור מאגר ב-Artifact Registry בשם gke-cloud-sql-repo באותו אזור של האשכול. מחליפים את YOUR_PROJECT_ID במזהה הפרויקט.
    gcloud artifacts repositories create gke-cloud-sql-repo \
      --project=YOUR_PROJECT_ID \
      --repository-format=docker \
      --location=us-central1 \
      --description="GKE Quickstart sample app"
  3. משנים את הספרייה למיקום שבו שכפלתם בעבר את האפליקציה לדוגמה של Cloud SQL מ-GitHub. הספרייה של האפליקציה לדוגמה מכילה Dockerfile לאפליקציה לדוגמה. לדוגמה, כדי לשנות את הספריות לספרייה של האפליקציה לדוגמה, אפשר להריץ פקודה כמו זו:
    cd ~/cloudshell_open/python-docs-samples/cloud-sql/postgres/sqlalchemy
      
  4. מריצים את הפקודה gcloud builds submit כדי ליצור קונטיינר של Docker ולפרסם אותו ב-Artifact Registry. מחליפים את YOUR_PROJECT_ID במזהה הפרויקט.
    gcloud builds submit \
      --tag us-central1-docker.pkg.dev/YOUR_PROJECT_ID/gke-cloud-sql-repo/gke-sql .

פריסת האפליקציה לדוגמה

הסרת המשאבים

כדי לא לצבור חיובים לחשבון Google Cloud על המשאבים שבהם השתמשתם בדף הזה:

  1. נכנסים לדף Cloud SQL Instances במסוף Google Cloud .

    כניסה לדף Cloud SQL Instances

  2. בוחרים את המכונה quickstart-instance כדי לפתוח את הדף Instance details.
  3. בסרגל הסמלים שבחלק העליון של הדף, לוחצים על מחיקה.
  4. בתיבת הדו-שיח Delete instance, מקלידים quickstart-instance ולוחצים על Delete כדי למחוק את המכונה.
  5. במסוף Google Cloud , נכנסים לדף Google Kubernetes Engine.

    כניסה ל-Google Kubernetes Engine

  6. לוחצים על תיבת הסימון לצד שם השירות gke-cloud-sql-quickstart.
  7. לוחצים על הלחצן Delete בחלק העליון של הדף Google Kubernetes Engine.

שלבי ניקוי אופציונליים

אם אתם לא משתמשים בחשבון השירות Google Cloud שיצרתם במדריך למתחילים, אתם יכולים להסיר אותו.

  1. נכנסים לדף Service accounts במסוף Google Cloud .

    כניסה לדף IAM

  2. מסמנים את התיבה של חשבון ה-IAM שנקרא gke-quickstart-service-account.
  3. לוחצים על הסרה ומאשרים את ההסרה.

אם אתם לא משתמשים בממשקי ה-API שהופעלו כחלק מהמדריך למתחילים, אתם יכולים להשבית אותם.

  • ממשקי ה-API שהופעלו במדריך למתחילים הזה:
    • Compute Engine API
    • Cloud SQL Admin API
    • Kubernetes Engine API
    • Artifact Registry API
    • Cloud Build API
  1. נכנסים לדף APIs במסוף Google Cloud .

    כניסה אל APIs

  2. בוחרים את ה-API שרוצים להשבית ולוחצים על הכפתור Disable API.

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

בהתאם לצרכים שלכם, תוכלו לקרוא מידע נוסף על יצירת מכונות של Cloud SQL.

אתם יכולים גם לקרוא מידע נוסף על יצירת משתמשי PostgreSQL ומסדי נתונים למכונה של Cloud SQL.

מידע על התמחור של Cloud SQL

למידע נוסף על:

בנוסף, אתם יכולים לקרוא איך מתחברים למכונה של Cloud SQL מאפליקציות אחרות של Google Cloud: