איך מתחברים ל-Cloud SQL ל-PostgreSQL מ-Google Kubernetes Engine
בדף הזה מוסבר איך לפרוס אפליקציה לדוגמה ב-Google Kubernetes Engine (GKE) שמחוברת למכונה של PostgreSQL באמצעות מסוף Google Cloud ואפליקציית לקוח. המשאבים שנוצרו במדריך למתחילים הזה בדרך כלל עולים פחות מדולר אחד (USD), בהנחה שאתם משלימים את השלבים, כולל הניקוי, בזמן.
לפני שמתחילים
- נכנסים לחשבון Google Cloud . אנחנו ממליצים למשתמשים חדשים ב- Google Cloudליצור חשבון כדי שיוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that you have the permissions required to complete this guide.
-
Verify that billing is enabled for your Google Cloud project.
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.enablepermission. 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.-
Install the gcloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init -
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that you have the permissions required to complete this guide.
-
Verify that billing is enabled for your Google Cloud project.
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.enablepermission. 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.-
Install the gcloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
התפקידים הנדרשים
כדי לקבל את ההרשאות שדרושות לביצוע המשימות שמתוארות במדריך למתחילים, בקשו מהאדמין להקצות לכם את התפקידים הבאים ב-IAM בפרויקט של המדריך למתחילים:
-
ליצור, לעדכן או למחוק את כל המכונות, מסדי הנתונים והמשתמשים של Cloud SQL:
- Cloud SQL Admin (
roles/cloudsql.admin) - צפייה ב-Compute (
roles/compute.viewer)
- Cloud SQL Admin (
-
יצירת מכונה של Cloud SQL עם כתובת IP פרטית (חיבור לגישה לשירותים פרטיים): אדמין של רשת Compute (
roles/compute.networkadmin) -
יצירה וניהול של אשכול Google Kubernetes Engine:
אדמין של Kubernetes Engine (
roles/container.admin) -
יוצרים ומנהלים חשבונות שירות לפרויקט:
- אדמין IAM בפרויקט (
roles/resourcemanager.projectIamAdmin) - אדמין בחשבון שירות (
roles/serviceAccountAdmin)
- אדמין IAM בפרויקט (
-
יצירת מאגר ב-Artifact Registry לפרויקט: אדמין של Artifact Registry (
roles/artifactregistry.admin) -
שליחה ובנייה של אפליקציות ב-Cloud Build:
- עריכה ב-Cloud Build (
roles/cloudbuilds.builds.editor) - יצירת אובייקטים באחסון (
roles/storage.objectCreator) - צפייה בקטגוריות אחסון (
roles/storage.bucketViewer) - משתמש בחשבון שירות (
roles/iam.serviceAccountUser) - צפייה ביומנים (
roles/logging.viewer)
- עריכה ב-Cloud Build (
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.
הגדרת Cloud SQL
יצירת מכונה של Cloud SQL
יצירת מסד נתונים
כדי ליצור מסד נתונים:
המסוף
-
נכנסים לדף Cloud SQL Instances במסוף Google Cloud .
- לוחצים על
quickstart-instance. - בתפריט הניווט של SQL, לוחצים על Databases.
- לוחצים על Create database.
- בשדה Database name בתיבת הדו-שיח New database, מזינים את הערך
quickstart-db. - לוחצים על יצירה.
gcloud
מריצים את הפקודה gcloud
sql databases create כדי ליצור מסד נתונים.
gcloud sql databases create quickstart-db --instance=quickstart-instance
יצירת משתמש
המסוף
-
נכנסים לדף Cloud SQL Instances במסוף Google Cloud .
- כדי לפתוח את הדף Overview של מכונה, לוחצים על שם המכונה.
- בתפריט הניווט של SQL, לוחצים על Users.
- לוחצים על הוספת חשבון משתמש.
- בדף הוספת חשבון משתמש למופע instance_name, מוסיפים את הפרטים הבאים:
- שם משתמש: מגדירים לערך
quickstart-user - סיסמה: מציינים סיסמה למשתמש במסד הנתונים. חשוב לזכור את השם הזה, כי תצטרכו אותו בשלב מאוחר יותר במדריך למתחילים.
- שם משתמש: מגדירים לערך
- לוחצים על הוספה.
gcloud
לפני שמריצים את הפקודה הבאה, מחליפים את DB_PASS בסיסמה למשתמש של מסד הנתונים. שימו לב לזה, כי תצטרכו להשתמש בזה בשלב מאוחר יותר במדריך למתחילים.
מריצים את הפקודה gcloud sql users create כדי ליצור את המשתמש.
gcloud sql users create quickstart-user \ --instance=quickstart-instance \ --password=DB_PASS
מגבלות האורך של שמות המשתמשים ב-Cloud SQL זהות לאלה של PostgreSQL מקומי.
יצירת אשכול GKE
המסוף
-
במסוף Google Cloud , נכנסים לדף Google Kubernetes Engine.
- לוחצים על יצירה.
- לוחצים על Configure ב-GKE Autopilot.
- בשדה Name, מציינים את שם האשכול בתור
gke-cloud-sql-quickstart. - לוחצים על יצירה.
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.
המשך
-
ב-Cloud Shell Editor, פותחים את קוד המקור של האפליקציה לדוגמה.
פתיחת Cloud Shell Editor -
בתיבת הדו-שיח
Open in Cloud Shell, לוחצים על Confirm כדי להוריד את קוד האפליקציה לדוגמה ולפתוח את ספריית האפליקציה לדוגמה ב-Cloud Shell Editor.
Java
-
ב-Cloud Shell Editor, פותחים את קוד המקור של האפליקציה לדוגמה.
פתיחת Cloud Shell Editor -
בתיבת הדו-שיח
Open in Cloud Shell, לוחצים על Confirm כדי להוריד את קוד האפליקציה לדוגמה ולפתוח את ספריית האפליקציה לדוגמה ב-Cloud Shell Editor.
Node.js
-
ב-Cloud Shell Editor, פותחים את קוד המקור של האפליקציה לדוגמה.
פתיחת Cloud Shell Editor -
בתיבת הדו-שיח
Open in Cloud Shell, לוחצים על Confirm כדי להוריד את קוד האפליקציה לדוגמה ולפתוח את ספריית האפליקציה לדוגמה ב-Cloud Shell Editor.
Python
-
ב-Cloud Shell Editor, פותחים את קוד המקור של האפליקציה לדוגמה.
פתיחת Cloud Shell Editor -
בתיבת הדו-שיח
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
הגדרה של חשבון שירות
-
מריצים את הפקודה
gcloud iam service-accounts createכדי ליצור חשבון שירות חדש:gcloud iam service-accounts create gke-quickstart-service-account \ --display-name="GKE Quickstart Service Account"
- מריצים את הפקודה
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"
- האפליקציה לדוגמה משתמשת ברישום ביומן, לכן צריך להריץ את הפקודה
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"
- חשבון השירות צריך להיות מסוגל לשלוף קובצי אימג' ממאגר 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.
- מעדכנים את הקובץ
service-account.yamlב-Cloud Shell Editor. מחליפים את<YOUR-KSA-NAME>ב-ksa-cloud-sql. - מריצים את הפקודה
kubectl applyב-Cloud Shell:kubectl apply -f service-account.yaml
- מעדכנים את הקובץ
- מריצים את הפקודה
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
- מריצים את הפקודה
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
- YOUR_KSA_NAME עם
הגדרת סודות
מריצים את הפקודה 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
פיתוח האפליקציה לדוגמה
המשך
- חוזרים ל-Cloud Shell Editor ולוחצים על Open Terminal כדי לפתוח את Cloud Shell.
-
בשורת הפקודה של 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"
- משנים את הספרייה למיקום שבו שכפלתם בעבר את האפליקציה לדוגמה של Cloud SQL מ-GitHub.
הספרייה של האפליקציה לדוגמה מכילה
Dockerfileלאפליקציה לדוגמה. לדוגמה, כדי לשנות את הספריות לספרייה של האפליקציה לדוגמה, אפשר להריץ פקודה כמו זו:cd ~/cloudshell_open/golang-samples/cloudsql/postgres/database-sql
- מריצים את הפקודה
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
- חוזרים ל-Cloud Shell Editor ולוחצים על Open Terminal כדי לפתוח את Cloud Shell.
-
בשורת הפקודה של 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"
- משנים את הספרייה למיקום שבו שכפלתם בעבר את האפליקציה לדוגמה של Cloud SQL מ-GitHub.
הספרייה של האפליקציה לדוגמה מכילה
pom.xmlלאפליקציה לדוגמה. לדוגמה, כדי לשנות את הספריות לספרייה של האפליקציה לדוגמה, אפשר להריץ פקודה כמו זו:cd ~/cloudshell_open/java-docs-samples/cloud-sql/postgres/servlet
- מריצים את הפקודה
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
- חוזרים ל-Cloud Shell Editor ולוחצים על Open Terminal כדי לפתוח את Cloud Shell.
-
בשורת הפקודה של 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"
- משנים את הספרייה למיקום שבו שכפלתם בעבר את האפליקציה לדוגמה של Cloud SQL מ-GitHub.
הספרייה של האפליקציה לדוגמה מכילה
Dockerfileלאפליקציה לדוגמה. לדוגמה, כדי לשנות את הספריות לספרייה של האפליקציה לדוגמה, אפשר להריץ פקודה כמו זו:cd ~/cloudshell_open/nodejs-docs-samples/cloud-sql/postgres/knex
- מריצים את הפקודה
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
- חוזרים ל-Cloud Shell Editor ולוחצים על Open Terminal כדי לפתוח את Cloud Shell.
-
בשורת הפקודה של 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"
- משנים את הספרייה למיקום שבו שכפלתם בעבר את האפליקציה לדוגמה של Cloud SQL מ-GitHub.
הספרייה של האפליקציה לדוגמה מכילה
Dockerfileלאפליקציה לדוגמה. לדוגמה, כדי לשנות את הספריות לספרייה של האפליקציה לדוגמה, אפשר להריץ פקודה כמו זו:cd ~/cloudshell_open/python-docs-samples/cloud-sql/postgres/sqlalchemy
- מריצים את הפקודה
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 על המשאבים שבהם השתמשתם בדף הזה:
-
נכנסים לדף Cloud SQL Instances במסוף Google Cloud .
- בוחרים את המכונה
quickstart-instanceכדי לפתוח את הדף Instance details. - בסרגל הסמלים שבחלק העליון של הדף, לוחצים על מחיקה.
- בתיבת הדו-שיח Delete instance, מקלידים
quickstart-instanceולוחצים על Delete כדי למחוק את המכונה. -
במסוף Google Cloud , נכנסים לדף Google Kubernetes Engine.
- לוחצים על תיבת הסימון לצד שם השירות
gke-cloud-sql-quickstart. - לוחצים על הלחצן Delete בחלק העליון של הדף Google Kubernetes Engine.
שלבי ניקוי אופציונליים
אם אתם לא משתמשים בחשבון השירות Google Cloud שיצרתם במדריך למתחילים, אתם יכולים להסיר אותו.
-
נכנסים לדף Service accounts במסוף Google Cloud .
- מסמנים את התיבה של חשבון ה-IAM שנקרא
gke-quickstart-service-account. - לוחצים על הסרה ומאשרים את ההסרה.
אם אתם לא משתמשים בממשקי ה-API שהופעלו כחלק מהמדריך למתחילים, אתם יכולים להשבית אותם.
- ממשקי ה-API שהופעלו במדריך למתחילים הזה:
- Compute Engine API
- Cloud SQL Admin API
- Kubernetes Engine API
- Artifact Registry API
- Cloud Build API
נכנסים לדף APIs במסוף Google Cloud .
בוחרים את ה-API שרוצים להשבית ולוחצים על הכפתור Disable API.
המאמרים הבאים
בהתאם לצרכים שלכם, תוכלו לקרוא מידע נוסף על יצירת מכונות של Cloud SQL.אתם יכולים גם לקרוא מידע נוסף על יצירת משתמשי PostgreSQL ומסדי נתונים למכונה של Cloud SQL.
למידע נוסף על:
- כל אפשרויות הקישוריות ב-Cloud SQL.
- הגדרת מכונת Cloud SQL עם כתובת IP ציבורית.
- הגדרת המכונה של Cloud SQL עם כתובת IP פרטית.
בנוסף, אתם יכולים לקרוא איך מתחברים למכונה של Cloud SQL מאפליקציות אחרות של Google Cloud:
