‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

התחברות ל-Cloud SQL ל-PostgreSQL מ-Compute Engine

‫MySQL | PostgreSQL | SQL Server

איך פורסים אפליקציה לדוגמה במכונה וירטואלית של Compute Engine שמבוססת על Linux או על Windows, שמחוברת למכונה של 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 the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

Verify that billing is enabled for your Google Cloud project.

מוודאים שיש את ההרשאות הנדרשות כדי להשלים את ההדרכה.
מפעילים את ממשקי ה-Cloud API שנדרשים כדי להריץ אפליקציה לדוגמה של Cloud SQL במכונה וירטואלית של Compute Engine.
המסוף

לוחצים על הכפתור Enable APIs כדי להפעיל את ה-API שנדרש למדריך למתחילים.

הפעלת ממשקי API

הפעולה הזו מפעילה את ה-API הבא:
- Cloud SQL Admin API
gcloud

מתקינים את ה-CLI של gcloud, שמאפשר גישה למשאבים של Google Cloud באמצעות שורת הפקודה. ה-CLI של gcloud משמש להרצת פקודות gcloud CLI שמוצגות במדריך למתחילים. כל הפקודות מעוצבות כך שניתן להריץ אותן בטרמינל או בחלון Powershell.

מריצים את הפקודה הבאה ב-gcloud:
```
gcloud services enable sqladmin.googleapis.com
```
הפקודה הזו מפעילה את ה-API הבא:
- Cloud SQL Admin API
אם המכונה הווירטואלית ב-Compute Engine או רשת ה-VPC מגבילות את תעבורת הנתונים היוצאת, צריך לוודא שהכללים של חומת האש מאפשרים חיבורי TCP יוצאים ביציאות היעד הנדרשות:
- חיבורים ישירים דרך כתובת IP ציבורית, כתובת IP פרטית או Private Service Connect: יציאה 5432, יציאת ברירת המחדל של PostgreSQL, בכתובת ה-IP של המכונה של Cloud SQL. בחיבורים ישירים לשרת Managed Connection Pooling, מאפשרים חיבורי TCP יוצאים ליציאה 6432.
- ‫Cloud SQL Auth Proxy או Cloud SQL Language Connectors: יציאה 3307 בכתובת ה-IP של מכונת Cloud SQL, ויציאה 443 לבקשות API של sqladmin.googleapis.com.

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

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

Billing Account Viewer (roles/billing.viewer) בארגון
אדמין ב-Cloud SQL (roles/cloudsql.admin) בפרויקט
אדמין מכונות של Compute ‏ (v1) (roles/compute.instanceAdmin.v1) בפרויקט
‫Dev Ops (roles/iam.devOps) בפרויקט
אדמין IAM של פרויקט (roles/resourcemanager.projectIamAdmin) בפרויקט
משתמש בחשבון שירות (roles/iam.serviceAccountUser) בפרויקט
Service Usage Consumer ‏ (roles/serviceusage.serviceUsageConsumer) בפרויקט
אדמין באחסון (roles/storage.admin) בפרויקט

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

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

הגדרת Cloud SQL

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

כתובת IP ציבורית

המסוף

יצירת מכונה עם כתובת IP ציבורית

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

כניסה לדף Cloud SQL Instances
לוחצים על Create instance.
לוחצים על PostgreSQL.
בשדה Instance ID, מזינים את הערך quickstart-instance.
בשדה Password, מזינים סיסמה למשתמש postgres. שמרו את הסיסמה הזו לשימוש עתידי.
בקטע Choose region and zonal availability, בוחרים באפשרות Single zone.
מרחיבים את הקטע Show Configurations.
ברשימה הנפתחת Machine Type, בוחרים באפשרות Lightweight.
לוחצים על Create Instance וממתינים עד שהמכונה תופעל.

gcloud

יצירת מכונה עם כתובת IP ציבורית

לפני שמריצים את הפקודה gcloud sql instances create, מחליפים את DB_ROOT_PASSWORD בסיסמה של המשתמש במסד הנתונים.

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

‫--database_version: הסוג והגרסה של המנוע של מסד הנתונים. אם לא מציינים ערך, המערכת משתמשת בערך ברירת המחדל של ה-API. כדי לראות את הגרסאות שזמינות כרגע, אפשר לעיין במאמרי העזרה בנושא גרסאות של מסדי נתונים ב-gcloud.
‫‎--cpu: מספר הליבות הרצוי במכונה.
‫‎--memory: ערך של מספר שלם שמציין את נפח הזיכרון הרצוי במכונה. צריך לציין יחידת מידה (לדוגמה, 3072MB או 9GB). אם לא מציינים יחידות, המערכת מניחה שמדובר ב-GB.
‫‎--region: המיקום האזורי של המכונה (לדוגמה, asia-east1,‏ us-east1). אם לא מציינים ערך, המערכת משתמשת בערך ברירת המחדל us-central. רשימת כל האזורים

מריצים את הפקודה gcloud sql instances create כדי ליצור מכונה של Cloud SQL.

gcloud sql instances create quickstart-instance --database-version=POSTGRES_13 --cpu=1 --memory=4GB --region=us-central --root-password=DB_ROOT_PASSWORD

כתובת IP פרטית

המסוף

הקצאת טווח של כתובות IP ויצירת חיבור פרטי כדי להגדיר גישה לשירותים פרטיים ב-Cloud SQL

במסוף Google Cloud , נכנסים לדף רשתות VPC.

כניסה לדף VPC networks
בוחרים את רשת ה-VPC‏ default.
לוחצים על הכרטיסייה Private service connection.
בוחרים בכרטיסייה Allocated IP ranges for services.
לוחצים על Allocate IP range.
בשדה Name של הטווח שהוקצה, מציינים את הערך google-managed-services-default.
בוחרים באפשרות Automatic לטווח כתובות ה-IP ומציינים את אורך הקידומת 16.
לוחצים על Allocate כדי ליצור את הטווח שהוקצה.
בוחרים בכרטיסייה Private connections to services של רשת ה-VPC‏ default.
לוחצים על Create connection כדי ליצור חיבור פרטי בין הרשת שלכם לבין הבעלים של השירות המנוהל.
בקטע הקצאה, בוחרים באפשרות google-managed-services-default.
לוחצים על קישור כדי ליצור את הקישור.

יצירת מכונה עם כתובת IP פרטית ו-SSL מופעל

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

כניסה לדף Cloud SQL Instances
לוחצים על Create instance.
לוחצים על PostgreSQL.
מזינים quickstart-instance בשדה Instance ID.
מזינים סיסמה למשתמש postgres. שמרו את הסיסמה הזו לשימוש עתידי.
לוחצים על האפשרות Single zone בשדה Choose region and zonal availability.
לוחצים על הצגת אפשרויות ההגדרה ומרחיבים את הקטע.
בשדה Machine Type, בוחרים באפשרות Lightweight.
בקטע Connections, בוחרים באפשרות Private IP.
בתפריט הנפתח Network, בוחרים באפשרות default.
מבטלים את הסימון בתיבה Public IP כדי ליצור מכונה רק עם כתובת IP פרטית.
לוחצים על Create instance ומחכים שהמכונה תופעל.
לוחצים על חיבורים.
בקטע אבטחה, בוחרים באפשרות לאפשר רק חיבורי SSL כדי להפעיל חיבורי SSL.
בתיבת הדו-שיח Allow only SSL connections, לוחצים על Save ומחכים שהמכונה תופעל מחדש.

gcloud

הקצאת טווח של כתובות IP ויצירת חיבור פרטי כדי להגדיר גישה לשירותים פרטיים ב-Cloud SQL

מריצים את הפקודה gcloud compute addresses create כדי להקצות טווח של כתובות IP.

gcloud compute addresses create google-managed-services-default --global --purpose=VPC_PEERING --prefix-length=16 --description="peering range for Google" --network=default

מריצים את הפקודה gcloud services vpc-peerings connect כדי ליצור חיבור פרטי לטווח כתובות ה-IP שהוקצה. מחליפים את YOUR_PROJECT_ID במזהה הפרויקט.
```
gcloud services vpc-peerings connect --service=servicenetworking.googleapis.com --ranges=google-managed-services-default --network=default --project=YOUR_PROJECT_ID
```

יצירת מכונה עם כתובת IP פרטית ו-SSL מופעל

לפני שמריצים את הפקודה הבאה, מחליפים את DB_ROOT_PASSWORD בסיסמה של המשתמש במסד הנתונים.

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

‫--database_version: הסוג והגרסה של המנוע של מסד הנתונים. אם לא מציינים ערך, המערכת משתמשת בערך ברירת המחדל של ה-API. כדי לראות את הגרסאות שזמינות כרגע, אפשר לעיין במאמרי העזרה בנושא גרסאות של מסדי נתונים ב-gcloud.
‫‎--cpu: מספר הליבות במכונה.
‫‎--memory: ערך של מספר שלם שמציין את כמות הזיכרון שצריך לכלול במכונה. אפשר לציין יחידת גודל (לדוגמה, 3072MB או 9GB). אם לא מציינים יחידות, המערכת מניחה שמדובר ב-GB.
‫‎--region: המיקום האזורי של המכונה (לדוגמה, asia-east1,‏ us-east1). אם לא מציינים ערך, המערכת משתמשת בערך ברירת המחדל us-central1. רשימת כל האזורים

מריצים את הפקודה gcloud sql instances create כדי ליצור מכונה של Cloud SQL עם כתובת IP פרטית.

gcloud beta sql instances create quickstart-instance --database-version=POSTGRES_13 --cpu=1 --memory=4GB --region=us-central --root-password=DB_ROOT_PASSWORD --no-assign-ip --network=default

מריצים את הפקודה gcloud sql instances patch כדי להפעיל את האפשרות רק חיבורי SSL מותרים במכונה.

gcloud sql instances patch quickstart-instance --require-ssl

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

המסוף

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

כניסה לדף Cloud SQL Instances
בוחרים באפשרות quickstart-instance.
פותחים את הכרטיסייה Databases.
לוחצים על Create database.

בתיבת הדו-שיח New database, מזינים quickstart_db בתור שם מסד הנתונים.
לוחצים על יצירה.

gcloud

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

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

יצירת משתמש

המסוף

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

כניסה לדף Cloud SQL Instances
כדי לפתוח את הדף Overview של מכונה, לוחצים על שם המכונה.
בתפריט הניווט של SQL, לוחצים על Users.
לוחצים על הוספת חשבון משתמש.
בדף הוספת חשבון משתמש למכונה instance_name, מוסיפים את הפרטים הבאים:
- בשדה שם משתמש, מזינים quickstart-user.
- בשדה Password, מציינים סיסמה למשתמש במסד הנתונים. חשוב לזכור את השם הזה כי תצטרכו אותו בשלב מאוחר יותר במדריך למתחילים.
לוחצים על הוספה.

gcloud

לפני שמריצים את הפקודה הבאה, מחליפים את הערכים הבאים:

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

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

gcloud sql users create quickstart-user --instance=quickstart-instance --password=PASSWORD

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

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

יוצרים ומגדירים Google Cloud חשבון שירות עם התפקיד לקוח Cloud SQL והרשאות להתחברות ל-Cloud SQL. אחרי שיוצרים חשבון שירות, יכול להיות שיהיה צריך להמתין 60 שניות לפחות לפני שאפשר להשתמש בו.

המסוף

יצירה של חשבון שירות

במסוף Google Cloud , נכנסים לדף Create service account.

כניסה לדף Create service account

בוחרים פרויקט ב- Google Cloud .
מזינים את הערך quickstart-service-account בתור השם של חשבון השירות.
אופציונלי: מזינים תיאור לחשבון השירות.
לוחצים על Create and continue וממשיכים לשלב הבא.
בוחרים את התפקיד לקוח Cloud SQL כדי להקצות אותו לחשבון השירות בפרויקט.
לוחצים על Add another role ובוחרים את התפקיד Storage Object Viewer כדי להקצות אותו לחשבון השירות בפרויקט.
לוחצים על Continue.
לוחצים על Done כדי לסיים ליצור את חשבון השירות.

gcloud

יצירה של חשבון שירות

כדי ליצור את חשבון השירות, מריצים את הפקודה gcloud iam service-accounts create:

gcloud iam service-accounts create quickstart-service-account --description="DESCRIPTION" --display-name="quickstart-service-account"

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

‫DESCRIPTION: תיאור אופציונלי של חשבון השירות

כדי להקצות לחשבון השירות את התפקיד לקוח Cloud SQL ואת התפקיד צפייה באובייקט אחסון בפרויקט, מריצים את הפקודה gcloud projects add-iam-policy-binding. מחליפים את PROJECT_ID במזהה הפרויקט ב-Google Cloud:
```
gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com" --role="roles/cloudsql.client" --role="roles/storage.objectViewer"
```

יצירת מכונה וירטואלית ב-Compute Engine

יצירת מכונה וירטואלית של Compute Engine לאירוח אפליקציית אינטרנט לדוגמה שמתחברת ל-Cloud SQL.

יצירת מכונה וירטואלית של Linux

המסוף

נכנסים לדף VM instances במסוף Google Cloud .

כניסה לדף VM instances
לוחצים על הכפתור Create instance.
בשדה Name של המכונה הווירטואלית, מזינים quickstart-vm-instance.
בקטע Service accounts, בוחרים באפשרות quickstart-service-account.
בקטע Firewall, בוחרים באפשרות Allow HTTP traffic.
לוחצים על Create כדי ליצור את המכונה הווירטואלית.

gcloud

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

מריצים את הפקודה הבאה של gcloud compute instances create.

gcloud compute instances create quickstart-vm-instance --image-family=debian-10 --image-project=debian-cloud  --machine-type=e2-medium --service-account=quickstart-service-account@YOUR_PROJECT_ID.iam.gserviceaccount.com --scopes=https://www.googleapis.com/auth/cloud-platform --tags=http-server --zone=us-central1-a

יצירת מכונה וירטואלית של Windows

המסוף

נכנסים לדף VM instances במסוף Google Cloud .

כניסה לדף VM instances
לוחצים על הכפתור Create instance.
בשדה Name של המכונה הווירטואלית, מזינים quickstart-vm-instance.
בקטע Boot disc לוחצים על הכפתור Change.

בשדה מערכת הפעלה בוחרים באפשרות Windows Server.
בשדה Version בוחרים באפשרות Windows Server 2022 Datacenter.
לוחצים על הכפתור בחירה.

בקטע Service accounts, בוחרים באפשרות quickstart-service-account.
בקטע Firewall, בוחרים באפשרות Allow HTTP traffic.
לוחצים על Create כדי ליצור את המכונה הווירטואלית.
אחרי 2-3 דקות, כשהמכונה הווירטואלית תתחיל לפעול, לוחצים על הכפתור Set Windows Password בדף הפרטים של המכונה הווירטואלית.
מעתיקים את הסיסמה ושומרים אותה במקום מאובטח, כי תצטרכו להשתמש בה כדי לגשת למכונה הווירטואלית בשלב הבא של המדריך למתחילים.

gcloud

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

מריצים את הפקודה הבאה של gcloud compute instances create בחלון הטרמינל.

gcloud compute instances create quickstart-vm-instance --image-project=windows-cloud --image-family=windows-2022 --machine-type=e2-medium --service-account=quickstart-service-account@YOUR_PROJECT_ID.iam.gserviceaccount.com --scopes=https://www.googleapis.com/auth/cloud-platform --tags=http-server --zone=us-central1-a

אחרי 2-3 דקות, כשהמכונה הווירטואלית תתחיל לפעול, מריצים את הפקודה הבאה כדי להגדיר את הסיסמה של Windows במכונה הווירטואלית.

gcloud compute reset-windows-password quickstart-vm-instance

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

גישה למכונה וירטואלית של Compute Engine

גישה למכונה וירטואלית של Linux

המסוף

נכנסים לדף VM instances במסוף Google Cloud .

כניסה לדף VM instances

ברשימת המכונות הווירטואליות, לוחצים על SSH בשורה של המכונה שרוצים להתחבר אליה.

הלחצן SSH ליד שם המכונה.

הערה: כשמתחברים למכונות וירטואליות באמצעות מסוף Google Cloud , מערכת Compute Engine יוצרת מפתח SSH זמני. מידע נוסף על מפתחות SSH זמין במאמר חיבורי SSH למכונות וירטואליות של Linux.

gcloud

משתמשים בפקודה gcloud compute ssh כדי להתחבר למכונה וירטואלית של Linux. מחליפים את YOUR_PROJECT_ID במזהה הפרויקט:

gcloud compute ssh --project=YOUR_PROJECT_ID --zone=us-central1-a quickstart-vm-instance

גישה למכונה וירטואלית של Windows

לקוח RDP

אתם יכולים להשתמש בלקוח של פרוטוקול Remote Desktop ‏ (RDP), כמו האפליקציה Microsoft Remote Desktop Connection, כדי להתחבר למכונה הווירטואלית של Windows. לשם כך, צריך להוריד את קובץ התצורה של ה-RDP של המכונה ממסוףGoogle Cloud .

כדי להתחבר באמצעות לקוח RDP:

אם עדיין לא מותקן לקוח RDP במחשב המקומי, מתקינים אחד. במאמר לקוחות של Microsoft Remote Desktop תוכלו למצוא רשימה של הלקוחות שנתמכים.
נכנסים לדף VM instances במסוף Google Cloud ומוצאים את המכונה של Windows שאליה רוצים להתחבר.
לדף VM instances
לוחצים על התפריט RDP של המכונה שאליה רוצים להתחבר, ואז על Download the RDP file כדי להוריד את קובץ ה-RDP של המכונה.
פותחים את קובץ ה-RDP שהורדתם בלקוח ה-RDP.
כשתתבקשו, הזינו את שם המשתמש והסיסמה שיצרתם למכונה הווירטואלית. למכונה הווירטואלית אין דומיין מוגדר, לכן אם מופיעה בקשה, משאירים את השדה Domain ריק.
אם מוצגת בקשה, מאשרים את האישור כדי להשלים את החיבור.

אחר

במאמר התחברות למכונות וירטואליות של Windows באמצעות RDP מפורטות אפשרויות נוספות לגישה למכונה וירטואלית של Windows ב-Compute Engine.

הגדרת סביבת פיתוח לשפת תכנות

מגדירים את סביבת הפיתוח של המכונה הווירטואלית ב-Compute Engine לשפת התכנות המועדפת.

הגדרת סביבת פיתוח של מכונה וירטואלית של Linux

המשך

כדי להגדיר את סביבת הפיתוח של מכונת ה-VM ב-Compute Engine להרצת האפליקציה לדוגמה ב-Go, צריך לבצע את השלבים הבאים.

עוברים אל מדריך ההגדרה של סביבת פיתוח ב-Go.
מבצעים את ההוראות שבקטע התקנת Go.

Java

כדי להגדיר את סביבת הפיתוח של המכונה הווירטואלית ב-Compute Engine להרצת האפליקציה לדוגמה ב-Java, צריך לבצע את השלבים הבאים.

עוברים אל המדריך להגדרת סביבת פיתוח ב-Java.
מבצעים את ההוראות שבקטע התקנת JDK (ערכת פיתוח ל-Java).
כדי להגדיר את Apache Maven, פועלים לפי ההוראות בקטע התקנה של כלי אוטומציה של גרסאות build.

Node.js

כדי להגדיר את סביבת הפיתוח של מכונת ה-VM ב-Compute Engine להרצת האפליקציה לדוגמה ב-Node.js, צריך לבצע את השלבים הבאים.

עוברים אל המדריך להגדרת סביבת פיתוח ב-Node.js.
מבצעים את ההוראות שבקטע התקנת Node.js ו-npm.

Python

כדי להגדיר את סביבת הפיתוח של מכונת ה-VM ב-Compute Engine להרצת האפליקציה לדוגמה ב-Python, פועלים לפי השלבים הבאים.

מדריך להגדרת סביבת פיתוח ב-Python
מבצעים את ההוראות שבקטע התקנת Python.

הגדרת סביבת פיתוח של מכונה וירטואלית של Windows

המשך

כדי להגדיר את סביבת הפיתוח של מכונת ה-VM ב-Compute Engine להרצת האפליקציה לדוגמה ב-Go, צריך לבצע את השלבים הבאים.

עוברים אל מדריך ההגדרה של סביבת פיתוח ב-Go.
מבצעים את ההוראות שבקטע התקנת Go.

Java

עוברים אל המדריך להגדרת סביבת פיתוח ב-Java.
מבצעים את ההוראות שבקטע התקנת JDK (ערכת פיתוח ל-Java).
כדי להגדיר את Apache Maven, מבצעים את ההוראות בקטע התקנה של כלי אוטומציה של גרסאות build.

Node.js

כדי להגדיר את סביבת הפיתוח של מכונת ה-VM ב-Compute Engine להרצת האפליקציה לדוגמה ב-Node.js, צריך לבצע את השלבים הבאים.

עוברים אל המדריך להגדרת סביבת פיתוח ב-Node.js.
מבצעים את ההוראות שבקטע התקנת Node.js ו-npm.

Python

כדי להגדיר את סביבת הפיתוח של מכונת ה-VM ב-Compute Engine להרצת האפליקציה לדוגמה ב-Python, פועלים לפי השלבים הבאים.

מתקינים את Python ואת מנהל החבילות PIP ל-Python.

מדריך להגדרת סביבת פיתוח ב-Python
מבצעים את ההוראות שבקטע התקנת Python.

לפי ההוראות שלמעלה, צריך להיכנס לדף ההורדה Python Releases for Windows. בדף הזה, לוחצים על הקישור Latest Python 3 Release.
בדף Python 3.X.X, לוחצים על הקישור Windows Installer 64-bit כדי להוריד את קובץ ההתקנה למכונה הווירטואלית של Windows Compute Engine.
אחרי שמורידים את קובץ ההתקנה של Python למכונה הווירטואלית, פותחים את התיקייה שמכילה את הקובץ שהורדתם. לאחר מכן לוחצים לחיצה ימנית על קובץ ההתקנה ובוחרים באפשרות הפעלה כמנהל מערכת.
בתיבת הדו-שיח Install Python שמופיעה, בוחרים באפשרות Add Python 3.X.X to PATH ולוחצים על ‎→ Install Now.

משתמשים ב-PIP כדי להתקין את virtualenv.

פותחים את Powershell במכונה הווירטואלית של Windows ב-Compute Engine ומריצים את הפקודה הבאה של pip install.

pip install virtualenv

התקנת Git

מתקינים את Git, מערכת לניהול גרסאות בקוד פתוח, במכונה הווירטואלית של Compute Engine.

מכונה וירטואלית של Linux ב-Compute Engine

במכונה הווירטואלית של Linux ב-Compute Engine, פועלים לפי הוראות ההתקנה הרשמיות של Git ל-Linux.

מריצים את הפקודה המוצעת של Debian/Ubuntu install git באמצעות הקידומת sudo כדי להריץ את הפקודה כאדמין. הפקודה המלאה להתקנה שצריך להריץ בטרמינל צריכה להיות בפורמט הבא:

sudo apt-get install git

מכונה וירטואלית של Windows ב-Compute Engine

במכונה הווירטואלית של Windows ב-Compute Engine, פועלים לפי הוראות ההתקנה הרשמיות של Git ל-Windows כדי להוריד את 64-bit Standalone Installer ולהריץ אותו כדי להתקין את Git.

שכפול של האפליקציה לדוגמה

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

המשך

במכונה הווירטואלית של Compute Engine, פותחים חלון חדש של טרמינל או של Powershell. מריצים את הפקודות הבאות כדי לשכפל את האפליקציה לדוגמה ב-Go ולשנות את הספרייה לספרייה שמכילה את האפליקציה לדוגמה.

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

git clone https://github.com/GoogleCloudPlatform/golang-samples

עוברים לספרייה שמכילה את האפליקציה לדוגמה.
```
cd golang-samples/cloudsql/postgres/database-sql
```

Java

במכונה הווירטואלית של Compute Engine, פותחים חלון חדש של טרמינל או של Powershell. מריצים את הפקודות הבאות כדי לשכפל את האפליקציה לדוגמה ב-Java ולשנות את הספרייה לספרייה שמכילה את האפליקציה לדוגמה.

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

git clone https://github.com/GoogleCloudPlatform/java-docs-samples

עוברים לספרייה שמכילה את האפליקציה לדוגמה.
```
cd java-docs-samples/cloud-sql/postgres/servlet
```

Node.js

במכונה הווירטואלית של Compute Engine, פותחים חלון חדש של טרמינל או של Powershell. מריצים את הפקודות הבאות כדי לשכפל את האפליקציה לדוגמה ב-Node.js ולשנות את הספרייה לספרייה שמכילה את האפליקציה לדוגמה.

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

git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples

עוברים לספרייה שמכילה את האפליקציה לדוגמה.
```
cd nodejs-docs-samples/cloud-sql/postgres/knex
```

Python

במכונה הווירטואלית של Compute Engine, פותחים חלון חדש של טרמינל או של Powershell. מריצים את הפקודות הבאות כדי לשכפל את האפליקציה לדוגמה ב-Python ולשנות את הספרייה לספרייה שמכילה את האפליקציה לדוגמה.

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

git clone https://github.com/GoogleCloudPlatform/python-docs-samples

עוברים לספרייה שמכילה את האפליקציה לדוגמה.
```
cd python-docs-samples/cloud-sql/postgres/sqlalchemy
```

הגדרה והפעלה של אפליקציה לדוגמה ב-Cloud SQL

אחרי שיצרתם מכונה ב-Cloud SQL, מסד נתונים וחשבון שירות עם הרשאות לקוח, אתם יכולים להגדיר אפליקציה לדוגמה שפועלת במכונה הווירטואלית של Compute Engine כדי להתחבר למכונה ב-Cloud SQL.

מכונה של Cloud SQL עם כתובת IP ציבורית ומכונה וירטואלית של Compute Engine שמבוססת על Linux

המשך

במכונה הווירטואלית של Compute Engine, בטרמינל הפתוח, מריצים את הפקודות הבאות כדי לאתחל את משתני הסביבה שנדרשים להרצת האפליקציה לדוגמה. לפני שמריצים את הפקודות, מבצעים את ההחלפות הבאות:

‫INSTANCE_CONNECTION_NAME בשם החיבור של המכונה, שמופיע בדף Cloud SQL instances במסוף Google Cloud .
‫YOUR_DB_PASSWORD בסיסמה של quickstart-user שיצרתם בשלב הקודם, יצירת משתמש, במדריך למתחילים.

export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'

במכונת ה-VM של Compute Engine, בטרמינל הפתוח, מריצים את הפקודות הבאות כדי לקבל את יחסי התלות של האפליקציה לדוגמה ב-Go במכונת ה-VM של Compute Engine, ומריצים את האפליקציה לדוגמה.

מורידים את יחסי התלות שנדרשים כדי להפעיל את האפליקציה לדוגמה.
```
go get ./...
```
מפעילים את האפליקציה לדוגמה.
```
go run cmd/app/main.go
```

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

הערה: כדי לבצע את השלב הזה במדריך למתחילים, צריך להשתמש ב-ה-CLI של gcloud, שמאפשר גישה למשאבים של Google Cloud באמצעות פקודות gcloud CLI. אם ה-CLI של gcloud לא מותקן במחשב המקומי, מתקינים את ה-CLI של gcloud כדי להמשיך.

בטרמינל או ב-Powershell במחשב המקומי, מריצים את הפקודה הבאה של gcloud compute instances describe כדי לקבל את כתובת ה-IP החיצונית של המכונה הווירטואלית ב-Compute Engine:

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

כדי לראות את האפליקציה לדוגמה שפועלת, פותחים דפדפן במחשב המקומי ונכנסים לכתובת ה-IP החיצונית של המכונה הווירטואלית ב-Compute Engine וליציאה ‎ :8080.
```
http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
```

כדי לעצור את האפליקציה לדוגמה, לוחצים על Control+C בטרמינל של המכונה הווירטואלית של Compute Engine שבו הפעלתם את האפליקציה לדוגמה.

Java

‫INSTANCE_CONNECTION_NAME בשם החיבור של המכונה, שמופיע בדף Cloud SQL instances במסוף Google Cloud .
‫YOUR_DB_PASSWORD בסיסמה של quickstart-user שיצרתם בשלב הקודם, יצירת משתמש, במדריך למתחילים.

export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'

במכונה הווירטואלית של Compute Engine, בטרמינל הפתוח, מריצים את הפקודה הבאה כדי להוריד את יחסי התלות של האפליקציה לדוגמה ב-Java למכונה הווירטואלית של Compute Engine, ומריצים את האפליקציה לדוגמה.

mvn jetty:run

בטרמינל או ב-Powershell במחשב המקומי, מריצים את הפקודה הבאה של gcloud compute instances describe כדי לקבל את כתובת ה-IP החיצונית של המכונה הווירטואלית ב-Compute Engine:

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

כדי לראות את האפליקציה לדוגמה שפועלת, פותחים דפדפן במחשב המקומי ונכנסים לכתובת ה-IP החיצונית של המכונה הווירטואלית ב-Compute Engine וליציאה ‎ :8080.
```
http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
```

Node.js

במכונה הווירטואלית של Compute Engine, בטרמינל הפתוח, מריצים את הפקודות הבאות כדי לאתחל את משתני הסביבה שנדרשים להרצת האפליקציה לדוגמה. לפני שמריצים את הפקודות, מחליפים את הערכים הבאים:
- ‫YOUR_DB_PASSWORD בסיסמה של quickstart-user שיצרתם בשלב הקודם של המדריך למתחילים יצירת משתמש.
```
export INSTANCE_HOST='127.0.0.1'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'
```

מורידים את Cloud SQL Auth Proxy.

curl -o cloud-sql-proxy \
https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.0.0/cloud-sql-proxy.linux.amd64

מגדירים הרשאות כדי להפוך את קובץ ה-Cloud SQL Auth Proxy לקובץ שניתן להפעלה.
```
chmod +x cloud-sql-proxy
```
מריצים את Cloud SQL Auth Proxy כתהליך ברקע. מחליפים את INSTANCE_CONNECTION_NAME ב-Connection name של המכונה, שמופיע בדף Cloud SQL instances במסוף Google Cloud .
```
./cloud-sql-proxy INSTANCE_CONNECTION_NAME &
```

הערה: אפשר לעצור את התהליך שמפעיל את Cloud SQL Auth Proxy ברקע באמצעות הפקודה fg בחלון הטרמינל שבו הפעלתם את האפליקציה לדוגמה. הפעולה הזו אמורה להעביר את המשימה של Cloud SQL Auth Proxy שפועלת לחזית הטרמינל. לאחר מכן מקישים על המקשים Ctrl + C כדי לעצור את משימת ה-proxy.

במכונת ה-VM של Compute Engine, בטרמינל הפתוח, מריצים את הפקודות הבאות כדי לקבל את חבילות Node.js הנדרשות למכונת ה-VM של Compute Engine ולהריץ את האפליקציה לדוגמה.

מתקינים את חבילות Node.js שנדרשות כדי להריץ את האפליקציה באופן מקומי.
```
npm install
```
מפעילים את האפליקציה לדוגמה.
```
npm start
```

בטרמינל או ב-Powershell במחשב המקומי, מריצים את הפקודה הבאה של gcloud compute instances describe כדי לקבל את כתובת ה-IP החיצונית של המכונה הווירטואלית ב-Compute Engine:

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

כדי לראות את האפליקציה לדוגמה שפועלת, פותחים דפדפן במחשב המקומי ונכנסים לכתובת ה-IP החיצונית של המכונה הווירטואלית ב-Compute Engine וליציאה ‎ :8080.
```
http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
```

Python

‫INSTANCE_CONNECTION_NAME בשם החיבור של המכונה, שמופיע בדף Cloud SQL instances במסוף Google Cloud .
‫YOUR_DB_PASSWORD בסיסמה של quickstart-user שיצרתם בשלב הקודם, יצירת משתמש, במדריך למתחילים.

export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'

במכונת ה-VM של Compute Engine, בטרמינל הפתוח, מריצים את הפקודות הבאות כדי לקבל את הדרישות של האפליקציה לדוגמה ב-Python במכונת ה-VM של Compute Engine, ומריצים את האפליקציה לדוגמה.

מאתחלים סביבה וירטואלית ומתקינים את הדרישות להפעלת האפליקציה לדוגמה.
```
python3 -m venv env
source env/bin/activate
pip install -r requirements.txt
```
מפעילים את האפליקציה לדוגמה.
```
python app.py
```

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

הערה: בשלב הזה במדריך למתחילים צריך להשתמש ב-ה-CLI של gcloud, שמאפשר גישה למשאבים של Google Cloudבאמצעות פקודות gcloud CLI. אם ה-CLI של gcloud לא מותקן במחשב המקומי, מתקינים את ה-CLI של gcloud כדי להמשיך.

בטרמינל או ב-Powershell במחשב המקומי, מריצים את הפקודה הבאה של gcloud compute ssh כדי להגדיר העברה ליציאה אחרת באמצעות SSH. לפני שמריצים את הפקודה, מחליפים את YOUR_PROJECT_ID במזהה הפרויקט.

gcloud compute ssh quickstart-vm-instance --project=YOUR_PROJECT_ID --zone=us-central1-a --ssh-flag='-L 8000:127.0.0.1:8080'

צופים באפליקציה לדוגמה שפועלת. כשהעברה ליציאה אחרת פועלת, פותחים דפדפן במחשב המקומי ומזינים http://127.0.0.1:8000 בסרגל הכתובות של הדפדפן.

מכונה של Cloud SQL עם כתובת IP ציבורית ומכונה וירטואלית של Compute Engine שמבוססת על Windows

המשך

במכונה הווירטואלית של Compute Engine, בחלון הפתוח של PowerShell, מריצים את הפקודות הבאות כדי לאתחל את משתני הסביבה שנדרשים להפעלת האפליקציה לדוגמה. לפני שמריצים את הפקודות, מחליפים את הערכים הבאים:

‫INSTANCE_CONNECTION_NAME בשם החיבור של המכונה, שמופיע בדף Cloud SQL instances במסוף Google Cloud .
‫YOUR_DB_PASSWORD בסיסמה של quickstart-user שיצרתם בשלב הקודם, יצירת משתמש, במדריך למתחילים.

$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"

במכונה הווירטואלית של Compute Engine, בחלון הפתוח של PowerShell, מריצים את הפקודות הבאות כדי להוריד את יחסי התלות של האפליקציה לדוגמה ב-Go למכונה הווירטואלית של Compute Engine, ומריצים את האפליקציה לדוגמה.

מורידים את יחסי התלות שנדרשים כדי להפעיל את האפליקציה לדוגמה.
```
go get ./...
```
מפעילים את האפליקציה לדוגמה.
```
go run cmd\app\main.go
```
כדי לראות את האפליקציה לדוגמה שפועלת, פותחים דפדפן במכונה הווירטואלית של Compute Engine ונכנסים לכתובת http://127.0.0.1:8080.

כדי לעצור את האפליקציה לדוגמה, לוחצים על Control+C בחלון Powershell של המכונה הווירטואלית של Compute Engine שבו הפעלתם את האפליקציה לדוגמה.

Java

‫INSTANCE_CONNECTION_NAME בשם החיבור של המכונה, שמופיע בדף Cloud SQL instances במסוף Google Cloud .
‫YOUR_DB_PASSWORD בסיסמה של quickstart-user שיצרתם בשלב הקודם, יצירת משתמש, במדריך למתחילים.

$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"

במכונה הווירטואלית של Compute Engine, בחלון הפתוח של Powershell, מריצים את הפקודה הבאה כדי לקבל את יחסי התלות של האפליקציה לדוגמה ב-Java במכונה הווירטואלית של Compute Engine, ומריצים את האפליקציה לדוגמה.
```
mvn jetty:run
```
כדי לראות את האפליקציה לדוגמה שפועלת, פותחים דפדפן במכונה הווירטואלית של Compute Engine ונכנסים לכתובת http://127.0.0.1:8080.

Node.js

במכונה הווירטואלית של Compute Engine, בחלון הפתוח של PowerShell, מריצים את הפקודות הבאות כדי לאתחל את משתני הסביבה שנדרשים להפעלת האפליקציה לדוגמה. לפני שמריצים את הפקודות, מחליפים את הערכים הבאים:
- ‫YOUR_DB_PASSWORD בסיסמה של quickstart-user שיצרתם בשלב הקודם של המדריך למתחילים יצירת משתמש.
```
$env:INSTANCE_HOST="127.0.0.1"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"
```

מורידים את Cloud SQL Auth Proxy.

wget https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.0.0/cloud-sql-proxy.x64.exe `
-O cloud-sql-proxy.exe

מריצים את Cloud SQL Auth Proxy כתהליך ברקע. מחליפים את INSTANCE_CONNECTION_NAME ב-Connection name של המכונה, שמופיע בדף Cloud SQL instances במסוף Google Cloud .
```
Start-Process -filepath  ".\cloud-sql-proxy.exe" -ArgumentList `
"INSTANCE_CONNECTION_NAME"
```

הערה: כדי לעצור את התהליך שמפעיל את Cloud SQL Auth Proxy ברקע, בוחרים את החלון cmd.exe שנוצר על ידי הפקודה Start-Process. אחר כך סוגרים את החלון כדי להפסיק את פעולת השרת.

במכונה הווירטואלית של Compute Engine, בחלון הפתוח של PowerShell, מריצים את הפקודות הבאות כדי לקבל את חבילות Node.js הנדרשות במכונה הווירטואלית של Compute Engine ולהריץ את האפליקציה לדוגמה.

מתקינים את חבילות Node.js שנדרשות כדי להריץ את האפליקציה באופן מקומי.
```
npm install
```
מפעילים את האפליקציה לדוגמה.
```
npm start
```
כדי לראות את האפליקציה לדוגמה שפועלת, פותחים דפדפן במכונה הווירטואלית של Compute Engine ונכנסים לכתובת http://127.0.0.1:8080.

Python

‫INSTANCE_CONNECTION_NAME בשם החיבור של המכונה, שמופיע בדף Cloud SQL instances במסוף Google Cloud .
‫YOUR_DB_PASSWORD בסיסמה של quickstart-user שיצרתם בשלב הקודם, יצירת משתמש, במדריך למתחילים.

$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"

במכונה הווירטואלית של Compute Engine, בחלון הפתוח של Powershell, מריצים את הפקודות הבאות כדי להוריד את הדרישות של האפליקציה לדוגמה ב-Python למכונה הווירטואלית של Compute Engine, ומריצים את האפליקציה לדוגמה.

מאתחלים סביבה וירטואלית ומתקינים את הדרישות להפעלת האפליקציה לדוגמה.
```
virtualenv --python python3 env
.\env\Scripts\activate
pip install -r requirements.txt
```
מפעילים את האפליקציה לדוגמה.
```
python app.py
```
כדי לראות את האפליקציה לדוגמה שפועלת, פותחים דפדפן במכונה הווירטואלית של Compute Engine ונכנסים לכתובת http://127.0.0.1:8080.

מכונה של Cloud SQL עם כתובת IP פרטית ומכונה וירטואלית של Compute Engine שמבוססת על Linux

יוצרים ומורידים אישורי SSL לשרת וללקוח במחשב המקומי.

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

כניסה לדף Cloud SQL Instances
לוחצים על quickstart-instance כדי לראות את דף הסקירה הכללית שלו.
לוחצים על הכרטיסייה חיבורים.
בקטע אבטחה, לוחצים על יצירת אישור לקוח.
בתיבת הדו-שיח Create a client certificate, מזינים את השם quickstart-key ולוחצים על Create.
בתיבת הדו-שיח New SSL certificate created, לוחצים על כל קישור להורדה כדי להוריד את אישורי ה-SSL. אחר כך לוחצים על סגירה.

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

העלאת אישורי SSL לקטגוריה של Cloud Storage

המסוף

בדפדפן במחשב המקומי, יוצרים קטגוריה של Cloud Storage ומעלים אליה אישורי SSL, כדי שאפשר יהיה לגשת אליהם ממכונת ה-VM של Compute Engine.

יצירת קטגוריה של Cloud Storage

בשדה Name of your bucket, מזינים את השם הבא. מחליפים את YOUR_PROJECT_ID במזהה הפרויקט:
```
YOUR_PROJECT_ID-quickstart-certs
```
לוחצים על הכפתור Create כדי ליצור את הקטגוריה.

לוחצים על הכפתור Upload Files כדי להעלות קבצים לקטגוריה החדשה של Cloud Storage.
בוחרים את הקבצים הבאים להעלאה מהמחשב המקומי ל-Cloud Storage:

server-ca.pem
client-cert.pem
client-key.pem

gcloud

במחשב המקומי, פותחים את הטרמינל או את חלון Powershell בספרייה שאליה הורדתם את אישורי ה-SSL. עכשיו אפשר ליצור קטגוריה של Cloud Storage ולהעלות אליה את אישורי ה-SSL, כדי שתוכלו לגשת אליהם ממכונת ה-VM של Compute Engine. העלאת הקבצים תתבצע באמצעות ה-CLI של gcloud.

מריצים את הפקודה הבאה של gcloud storage buckets create כדי ליצור קטגוריה חדשה של Cloud Storage:

gcloud storage buckets create gs://YOUR_PROJECT_ID-quickstart-certs --location=us-central1

מהספרייה שבה הורדתם את האישורים במחשב המקומי, מריצים את הפקודות הבאות של gcloud storage cp כדי להעתיק את אישורי ה-SSL לקטגוריה החדשה של Cloud Storage:

gcloud storage cp server-ca.pem gs://YOUR_PROJECT_ID-quickstart-certs/
gcloud storage cp client-cert.pem gs://YOUR_PROJECT_ID-quickstart-certs/
gcloud storage cp client-key.pem gs://YOUR_PROJECT_ID-quickstart-certs/

המשך

הורדת אישורי SSL באמצעות ה-CLI של gcloud במכונת ה-VM של Compute Engine

במכונה הווירטואלית של Compute Engine, בטרמינל שפתוח לספרייה golang-samples/cloudsql/postgres/database-sql, מריצים את הפקודות הבאות של gcloud storage cp כדי להוריד את אישורי ה-SSL מ-Cloud Storage לספרייה certs.

gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem certs/.
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-cert.pem certs/.
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-key.pem certs/.

הגדרת משתני סביבה במכונה הווירטואלית של Compute Engine

INSTANCE_HOST מוגדר לכתובת ה-IP הפרטית של המכונה שמוצגת בדף Cloud SQL instances במסוף Google Cloud .

‫YOUR_DB_PASSWORD בסיסמה של quickstart-user שיצרתם בשלב הקודם של המדריך למתחילים יצירת משתמש.

export INSTANCE_HOST='INSTANCE_HOST'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'
export DB_ROOT_CERT='certs/server-ca.pem'
export DB_CERT='certs/client-cert.pem'
export DB_KEY='certs/client-key.pem'
export PRIVATE_IP='TRUE'

מורידים את יחסי התלות שנדרשים כדי להפעיל את האפליקציה לדוגמה.
```
go get ./...
```
מפעילים את האפליקציה לדוגמה.
```
go run cmd/app/main.go
```

הערה: שלב זה במדריך למתחילים דורש את ה-CLI של gcloud, שמאפשר גישה למשאבים של Google Cloudבאמצעות פקודות gcloud CLI. אם ה-CLI של gcloud לא מותקן במחשב המקומי, מתקינים את ה-CLI של gcloud כדי להמשיך.

בטרמינל או ב-Powershell במחשב המקומי, מריצים את הפקודה הבאה של gcloud compute instances describe כדי לקבל את כתובת ה-IP החיצונית של המכונה הווירטואלית ב-Compute Engine:

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

כדי לראות את האפליקציה לדוגמה שפועלת, פותחים דפדפן במחשב המקומי ונכנסים לכתובת ה-IP החיצונית של המכונה הווירטואלית ב-Compute Engine וליציאה ‎ :8080.
```
http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
```

Java

הורדת אישורי SSL באמצעות ה-CLI של gcloud במכונת ה-VM של Compute Engine

במכונה הווירטואלית של Compute Engine, בטרמינל שפתוח לספרייה java-docs-samples/cloud-sql/postgres/servlet, מריצים את הפקודות הבאות של gcloud storage cp כדי להוריד את אישורי ה-SSL מ-Cloud Storage לספרייה הנוכחית.

gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem .
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-cert.pem .
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-key.pem .

הגדרת אישורי ה-SSL לשימוש ב-Java במכונה הווירטואלית של Compute Engine

בטרמינל של המכונה הווירטואלית של Compute Engine, מריצים את הפקודה הבאה כדי להמיר את המפתח והאישור בפורמט PEM שהורדתם לארכיון PKCS12 באמצעות openssl. לפני שמריצים את הפקודה הבאה, מחליפים את SSL_CLIENT_KEY_PASSWD בסיסמה של מאגר המפתחות בהתאמה אישית, שמשמשת ליצירת מאגר המפתחות של לקוח Java.

openssl pkcs12 -export -in client-cert.pem -inkey client-key.pem \
-name "postgresclient" -passout pass:SSL_CLIENT_KEY_PASSWD \
-out client-keystore.p12

הגדרת משתני סביבה במכונה הווירטואלית של Compute Engine

INSTANCE_HOST מוגדר לכתובת ה-IP הפרטית של המכונה שמוצגת בדף Cloud SQL instances במסוף Google Cloud .

‫SSL_CLIENT_KEY_PASSWD בסיסמה שציינתם ליצירת מאגר המפתחות של לקוח Java באמצעות openssl בשלב הקודם במדריך למתחילים.
‫YOUR_DB_PASSWORD בסיסמה של quickstart-user שיצרתם בשלב הקודם של המדריך למתחילים יצירת משתמש.

export INSTANCE_HOST='INSTANCE_HOST'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'
export SSL_CLIENT_KEY_PATH='client-keystore.p12'
export SSL_CLIENT_KEY_PASSWD='SSL_CLIENT_KEY_PASSWD'
export SSL_SERVER_CA_PATH='server-ca.pem'
export PRIVATE_IP='TRUE'

mvn jetty:run

בטרמינל או ב-Powershell במחשב המקומי, מריצים את הפקודה הבאה של gcloud compute instances describe כדי לקבל את כתובת ה-IP החיצונית של המכונה הווירטואלית ב-Compute Engine:

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

כדי לראות את האפליקציה לדוגמה שפועלת, פותחים דפדפן במחשב המקומי ונכנסים לכתובת ה-IP החיצונית של המכונה הווירטואלית ב-Compute Engine וליציאה ‎ :8080.
```
http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
```

Node.js

הורדת אישורי SSL באמצעות ה-CLI של gcloud במכונת ה-VM של Compute Engine

במכונה הווירטואלית של Compute Engine, בטרמינל שפתוח לספרייה nodejs-docs-samples/cloud-sql/postgres/knex, מריצים את הפקודות הבאות של gcloud storage cp כדי להוריד את אישורי ה-SSL מ-Cloud Storage לספרייה certs.

gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem certs/.
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-cert.pem certs/.
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-key.pem certs/.

הגדרת משתני סביבה במכונה הווירטואלית של Compute Engine

INSTANCE_HOST מוגדר לכתובת ה-IP הפרטית של המכונה שמוצגת בדף Cloud SQL instances במסוף Google Cloud .

‫YOUR_DB_PASSWORD בסיסמה של quickstart-user שיצרתם בשלב הקודם של המדריך למתחילים יצירת משתמש.

export INSTANCE_HOST='INSTANCE_HOST'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'
export DB_ROOT_CERT='certs/server-ca.pem'
export DB_CERT='certs/client-cert.pem'
export DB_KEY='certs/client-key.pem'
export PRIVATE_IP='TRUE'

מתקינים את חבילות Node.js שנדרשות כדי להריץ את האפליקציה באופן מקומי.
```
npm install
```
מפעילים את האפליקציה לדוגמה.
```
npm start
```

בטרמינל או ב-Powershell במחשב המקומי, מריצים את הפקודה הבאה של gcloud compute instances describe כדי לקבל את כתובת ה-IP החיצונית של המכונה הווירטואלית ב-Compute Engine:

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

כדי לראות את האפליקציה לדוגמה שפועלת, פותחים דפדפן במחשב המקומי ונכנסים לכתובת ה-IP החיצונית של המכונה הווירטואלית ב-Compute Engine וליציאה ‎ :8080.
```
http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
```

Python

הורדת אישורי SSL באמצעות ה-CLI של gcloud במכונת ה-VM של Compute Engine

במכונה הווירטואלית של Compute Engine, בטרמינל שפתוח לספרייה python-docs-samples/cloud-sql/postgres/sqlalchemy, מריצים את הפקודות הבאות של gcloud storage cp כדי להוריד את אישורי ה-SSL מ-Cloud Storage לספרייה certs.

gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem certs/.
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-cert.pem certs/.
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-key.pem certs/.

הגדרת משתני סביבה במכונה הווירטואלית של Compute Engine

INSTANCE_HOST מוגדר לכתובת ה-IP הפרטית של המכונה שמוצגת בדף Cloud SQL instances במסוף Google Cloud .

‫YOUR_DB_PASSWORD בסיסמה של quickstart-user שיצרתם בשלב הקודם של המדריך למתחילים יצירת משתמש.

export INSTANCE_HOST='INSTANCE_HOST'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'
export DB_ROOT_CERT='certs/server-ca.pem'
export DB_CERT='certs/client-cert.pem'
export DB_KEY='certs/client-key.pem'
export PRIVATE_IP='TRUE'

מאתחלים סביבה וירטואלית ומתקינים את הדרישות להפעלת האפליקציה לדוגמה.
```
python3 -m venv env
source env/bin/activate
pip install -r requirements.txt
```
מפעילים את האפליקציה לדוגמה.
```
python app.py
```

בטרמינל או ב-Powershell במחשב המקומי, מריצים את הפקודה הבאה של gcloud compute ssh כדי להגדיר העברה ליציאה אחרת באמצעות SSH. לפני שמריצים את הפקודה, מחליפים את YOUR_PROJECT_ID במזהה הפרויקט.

gcloud compute ssh quickstart-vm-instance --project=YOUR_PROJECT_ID --zone=us-central1-a --ssh-flag='-L 8000:127.0.0.1:8080'

צופים באפליקציה לדוגמה שפועלת. כשהעברה ליציאה אחרת פועלת, פותחים דפדפן במחשב המקומי ומזינים http://127.0.0.1:8000 בסרגל הכתובות של הדפדפן.

מכונה של Cloud SQL עם כתובת IP פרטית ומכונה וירטואלית של Compute Engine שמבוססת על Windows

יוצרים ומורידים אישורי SSL לשרת וללקוח במחשב המקומי.

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

כניסה לדף Cloud SQL Instances
לוחצים על quickstart-instance כדי לראות את דף הסקירה הכללית שלו.
לוחצים על הכרטיסייה חיבורים.
בקטע אבטחה, לוחצים על יצירת אישור לקוח.
בתיבת הדו-שיח Create a client certificate, מזינים את השם quickstart-key ולוחצים על Create.
בתיבת הדו-שיח New SSL certificate created, לוחצים על כל קישור להורדה כדי להוריד את אישורי ה-SSL. אחר כך לוחצים על סגירה.

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

העלאת אישורי SSL לקטגוריה של Cloud Storage

המסוף

יצירת קטגוריה של Cloud Storage

בשדה Name of your bucket, מזינים את השם הבא. מחליפים את YOUR_PROJECT_ID במזהה הפרויקט:
```
YOUR_PROJECT_ID-quickstart-certs
```
לוחצים על הכפתור Create כדי ליצור את הקטגוריה.

לוחצים על הכפתור Upload Files כדי להעלות קבצים לקטגוריה החדשה של Cloud Storage.
בוחרים את הקבצים הבאים להעלאה מהמחשב המקומי ל-Cloud Storage:

server-ca.pem
client-cert.pem
client-key.pem

gcloud

מריצים את הפקודה הבאה של gcloud storage buckets create כדי ליצור קטגוריה חדשה של Cloud Storage:

gcloud storage buckets create gs://YOUR_PROJECT_ID-quickstart-certs --location=us-central1

מהספרייה שבה הורדתם את האישורים במחשב המקומי, מריצים את הפקודות הבאות של gcloud storage cp כדי להעתיק את אישורי ה-SSL לקטגוריה החדשה של Cloud Storage:

gcloud storage cp server-ca.pem gs://YOUR_PROJECT_ID-quickstart-certs/
gcloud storage cp client-cert.pem gs://YOUR_PROJECT_ID-quickstart-certs/
gcloud storage cp client-key.pem gs://YOUR_PROJECT_ID-quickstart-certs/

המשך

הורדת אישורי SSL באמצעות ה-CLI של gcloud במכונת ה-VM של Compute Engine

במכונה הווירטואלית של Compute Engine, בחלון Powershell שפתוח לספרייה golang-samples/cloudsql/postgres/database-sql, מריצים את הפקודות הבאות של gcloud storage cp כדי להוריד את אישורי ה-SSL מ-Cloud Storage לספרייה certs.

gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem certs/.
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-cert.pem certs/.
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-key.pem certs/.

הגדרת משתני סביבה במכונה הווירטואלית של Compute Engine

במכונה הווירטואלית של Compute Engine, בחלון של Powershell, מריצים את הפקודות הבאות כדי לאתחל את משתני הסביבה שנדרשים להפעלת האפליקציה לדוגמה. לפני שמריצים את הפקודות, מבצעים את ההחלפות הבאות:

INSTANCE_HOST מוגדר לכתובת ה-IP הפרטית של המכונה שמוצגת בדף Cloud SQL instances במסוף Google Cloud .

‫YOUR_DB_PASSWORD בסיסמה של quickstart-user שיצרתם בשלב הקודם של המדריך למתחילים יצירת משתמש.

$env:INSTANCE_HOST="INSTANCE_HOST"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"
$env:DB_ROOT_CERT="certs/server-ca.pem"
$env:DB_CERT="certs/client-cert.pem"
$env:DB_KEY="certs/client-key.pem"
$env:PRIVATE_IP="TRUE"

מורידים את יחסי התלות שנדרשים כדי להפעיל את האפליקציה לדוגמה.
```
go get ./...
```
מפעילים את האפליקציה לדוגמה.
```
go run cmd\app\main.go
```
כדי לראות את האפליקציה לדוגמה שפועלת, פותחים דפדפן במכונה הווירטואלית של Compute Engine ונכנסים לכתובת http://127.0.0.1:8080.

Java

הורדת אישורי SSL באמצעות ה-CLI של gcloud במכונת ה-VM של Compute Engine

במכונה הווירטואלית של Compute Engine, בחלון Powershell שפתוח לספרייה java-docs-samples/cloud-sql/postgres/servlet, מריצים את הפקודות הבאות של gcloud storage cp כדי להוריד את אישורי ה-SSL מ-Cloud Storage לספרייה הנוכחית.

gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem .
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-cert.pem .
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-key.pem .

הגדרת אישורי ה-SSL לשימוש ב-Java במכונה הווירטואלית של Compute Engine

בטרמינל של המכונה הווירטואלית של Compute Engine, מריצים את הפקודה הבאה כדי להמיר את המפתח והאישור בפורמט PEM שהורדתם לארכיון PKCS12 באמצעות openssl. לפני שמריצים את הפקודה הבאה, מחליפים את SSL_CLIENT_KEY_PASSWD בסיסמה של מאגר המפתחות בהתאמה אישית, שמשמשת ליצירת מאגר המפתחות של לקוח Java.

openssl pkcs12 -export -in client-cert.pem -inkey client-key.pem `
-name "postgresclient" -passout pass:SSL_CLIENT_KEY_PASSWD `
-out client-keystore.p12

הגדרת משתני סביבה במכונה הווירטואלית של Compute Engine

INSTANCE_HOST מוגדר לכתובת ה-IP הפרטית של המכונה שמוצגת בדף Cloud SQL instances במסוף Google Cloud .

‫YOUR_DB_PASSWORD בסיסמה של quickstart-user שיצרתם בשלב הקודם של המדריך למתחילים יצירת משתמש.
SSL_CLIENT_KEY_PASSWD עם הסיסמה שציינת עבור SSL_CLIENT_KEY_PASSWD.

$env:INSTANCE_HOST="INSTANCE_HOST"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"
$env:SSL_CLIENT_KEY_PATH="client-keystore.p12"
$env:SSL_CLIENT_KEY_PASSWD="SSL_CLIENT_KEY_PASSWD"
$env:SSL_SERVER_CA_PATH="server-ca.pem"
$env:PRIVATE_IP="TRUE"

במכונה הווירטואלית של Compute Engine, בחלון הפתוח של Powershell, מריצים את הפקודה הבאה כדי לקבל את יחסי התלות של האפליקציה לדוגמה ב-Java במכונה הווירטואלית של Compute Engine, ומריצים את האפליקציה לדוגמה.
```
mvn jetty:run
```
כדי לראות את האפליקציה לדוגמה שפועלת, פותחים דפדפן במכונה הווירטואלית של Compute Engine ונכנסים לכתובת http://127.0.0.1:8080.

Node.js

הורדת אישורי SSL באמצעות ה-CLI של gcloud במכונת ה-VM של Compute Engine

במכונה הווירטואלית של Compute Engine, בחלון Powershell שפתוח לספרייה nodejs-docs-samples/cloud-sql/postgres/knex, מריצים את הפקודות הבאות של gcloud storage cp כדי להוריד את אישורי ה-SSL מ-Cloud Storage לספרייה certs.

gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem certs/.
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-cert.pem certs/.
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-key.pem certs/.

הגדרת משתני סביבה במכונה הווירטואלית של Compute Engine

INSTANCE_HOST מוגדר לכתובת ה-IP הפרטית של המכונה שמוצגת בדף Cloud SQL instances במסוף Google Cloud .

‫YOUR_DB_PASSWORD בסיסמה של quickstart-user שיצרתם בשלב הקודם של המדריך למתחילים יצירת משתמש.

$env:INSTANCE_HOST="INSTANCE_HOST"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"
$env:DB_ROOT_CERT="certs/server-ca.pem"
$env:DB_CERT="certs/client-cert.pem"
$env:DB_KEY="certs/client-key.pem"
$env:PRIVATE_IP="TRUE"

מתקינים את חבילות Node.js שנדרשות כדי להריץ את האפליקציה באופן מקומי.
```
npm install
```
מפעילים את האפליקציה לדוגמה.
```
npm start
```
כדי לראות את האפליקציה לדוגמה שפועלת, פותחים דפדפן במכונה הווירטואלית של Compute Engine ונכנסים לכתובת http://127.0.0.1:8080.

Python

הורדת אישורי SSL באמצעות ה-CLI של gcloud במכונת ה-VM של Compute Engine

במכונה הווירטואלית של Compute Engine, בחלון Powershell שפתוח לספרייה python-docs-samples/cloud-sql/postgres/sqlalchemy, מריצים את הפקודות הבאות של gcloud storage cp כדי להוריד את אישורי ה-SSL מ-Cloud Storage לספרייה certs.

gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem certs/.
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-cert.pem certs/.
gcloud storage cp gs://YOUR_PROJECT_ID-quickstart-certs/client-key.pem certs/.

הגדרת משתני סביבה במכונה הווירטואלית של Compute Engine

INSTANCE_HOST מוגדר לכתובת ה-IP הפרטית של המכונה שמוצגת בדף Cloud SQL instances במסוף Google Cloud .

‫YOUR_DB_PASSWORD בסיסמה של quickstart-user שיצרתם בשלב הקודם של המדריך למתחילים יצירת משתמש.

$env:INSTANCE_HOST="INSTANCE_HOST"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"
$env:DB_ROOT_CERT="certs/server-ca.pem"
$env:DB_CERT="certs/client-cert.pem"
$env:DB_KEY="certs/client-key.pem"
$env:PRIVATE_IP="TRUE"

מאתחלים סביבה וירטואלית ומתקינים את הדרישות להפעלת האפליקציה לדוגמה.
```
virtualenv --python python3 env
.\env\Scripts\activate
pip install -r requirements.txt
```
מפעילים את האפליקציה לדוגמה.
```
python app.py
```
כדי לראות את האפליקציה לדוגמה שפועלת, פותחים דפדפן במכונה הווירטואלית של Compute Engine ונכנסים לכתובת http://127.0.0.1:8080.

הסרת המשאבים

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

מחיקת מכונה של Cloud SQL

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

כניסה לדף Cloud SQL Instances
בוחרים את המכונה quickstart-instance כדי לפתוח את הדף Instance details.
בסרגל הסמלים שבחלק העליון של הדף, לוחצים על מחיקה.
בתיבת הדו-שיח Delete instance, מקלידים quickstart-instance ולוחצים על Delete כדי למחוק את המכונה.

מחיקת מכונה וירטואלית של Compute Engine

נכנסים לדף VM instances במסוף Google Cloud .

כניסה לדף VM instances
בוחרים את המכונה quickstart-vm-instance כדי לפתוח את הדף Instance details.
בסרגל הסמלים שבחלק העליון של הדף, לוחצים על מחיקה.
לוחצים על Delete כדי למחוק את המכונה.

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

אם אתם לא משתמשים בתפקיד לקוח Cloud SQL שהקציתם לחשבון השירות Compute Engine default, אתם יכולים להסיר אותו.

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

כניסה לדף IAM
לוחצים על סמל העריכה (שנראה כמו עיפרון) של חשבון ה-IAM שנקרא Compute Engine default service account.
מוחקים את התפקיד לקוח Cloud SQL.
לוחצים על Save.

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

ה-API שהופעל במדריך למתחילים הזה:
- Cloud SQL Admin API

נכנסים לדף APIs במסוף Google Cloud .

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

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

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

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

למידע נוסף על התמחור, ראו התמחור של Cloud SQL ל-PostgreSQL.

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

הגדרת מכונת Cloud SQL עם כתובת IP ציבורית.
הגדרת המכונה של Cloud SQL עם כתובת IP פרטית.

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