התחברות מ-Cloud Run

התחברות מ-Cloud Run

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

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

קוד האפליקציה לדוגמה של המדריך למתחילים הזה נמצא בספרייה examples/go במאגר GoogleCloudPlatform/alloydb-auth-proxy ב-GitHub.

האפליקציה כתובה בשפת התכנות Go ומשמשת ככלי לאיסוף הצבעות. הלוגיקה העיקרית נמצאת בקובץ main.go, שמפעיל שרת אינטרנט ומטפל בבקשות של משתמשים.

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

מאגר המקורות של הקוד

המאגר alloydb-auth-proxy מכיל את AlloyDB Auth Proxy, כלי שעוזר להתחבר בצורה מאובטחת למכונות של AlloyDB. המאגר כולל גם ספריות ודוגמאות קשורות, כמו אפליקציית Go שמשמשת במדריך למתחילים הזה.

לא צריך את כל הפרויקט ב-alloydb-auth-proxy כדי להתחבר ל-AlloyDB מ-Cloud Run. הפקודה cloudshell_open משכפלת את כל המאגר לנוחיותכם, אבל הקבצים היחידים שמשמשים לבניית הקונטיינר למדריך למתחילים הזה נמצאים בספרייה examples/go.

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

נכנסים לחשבון 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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine, Cloud Run, AlloyDB, Cloud Resource Manager, Service Networking, Cloud Build, and Container Registry 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

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine, Cloud Run, AlloyDB, Cloud Resource Manager, Service Networking, Cloud Build, and Container Registry 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

1. מוודאים שיש לכם אשכול AlloyDB ומכונה ראשית. מידע נוסף זמין במאמר יצירת אשכול והמכונה הראשית שלו.

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

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

• אדמין של רשת Compute ‏ (roles/compute.networkAdmin)
• אדמין ב-AlloyDB (roles/alloydb.admin)
• אדמין של Artifact Registry ‏ (roles/artifactregistry.admin)
• אדמין ב-Cloud Run (roles/run.admin)
• אדמין באחסון (roles/storage.admin)
• עריכה ב-Cloud Build ‏ (roles/cloudbuild.builds.editor)
• אדמין של Container Analysis ‏ (roles/containeranalysis.admin)
• יצירת אסימונים בחשבון שירות (roles/iam.serviceAccountTokenCreator)
• כתיבת מדדי מעקב (roles/monitoring.metricWriter)
• משתמש בחשבון שירות (roles/iam.serviceAccountUser)

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

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

התחברות למכונה ויצירת מסד נתונים

1. אם אתם לא נמצאים בדף Overview של האשכול החדש שיצרתם, במסוף Google Cloud נכנסים לדף Clusters.

   כניסה לדף Clusters

2. כדי להציג את הדף Overview של האשכול, לוחצים על שם האשכול my-cluster.

3. בתפריט הניווט, לוחצים על AlloyDB Studio.

4. ברשימה Database בקטע Log in to your database, בוחרים באפשרות postgres.

5. ברשימה הנפתחת User, בוחרים באפשרות postgres.

6. בשדה Password, מזינים את הסיסמה שיצרתם בקטע יצירת אשכול והמכונה הראשית שלו.

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

8. בכרטיסייה Untitled query, יוצרים מסד נתונים:

   CREATE DATABASE quickstart_db;
   

9. לוחצים על Run. מחכים עד שההודעה Statement executed successfully תופיע בחלונית Results.

איך מוצאים את מזהה הפרויקט

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

   כניסה לדף Dashboard

2. מזהה הפרויקט מופיע בכרטיס Project info.

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

אכלוס Artifact Registry בתמונה של האפליקציה לדוגמה

1. במסוף Google Cloud , פותחים את Cloud Shell.

   פתיחת Cloud Shell

2. ב-Cloud Shell Editor, משתמשים בפקודה הבאה כדי לשכפל את המאגר עם קוד האפליקציה לדוגמה מ-GitHub:

   cloudshell_open --repo_url \
   "https://github.com/GoogleCloudPlatform/alloydb-auth-proxy" \
   --dir \
   "examples/go" \
   --force_new_clone

3. יוצרים מאגר ב-Artifact Registry לקובצי אימג' של Docker:

   gcloud artifacts repositories create cloud-run-source-deploy --location us-central1 --repository-format=docker --project PROJECT_ID

   מחליפים את PROJECT_ID במזהה הפרויקט.

4. בתיבת הדו-שיח Authorize Cloud Shell, לוחצים על Authorize. ההודעה הזו לא תופיע אם כבר ביצעתם את השלב הזה בעבר.

5. כדי ליצור קונטיינר של Docker ולפרסם אותו ב-Artifact Registry, משתמשים בפקודה הבאה:

    gcloud builds submit --tag  us-central1-docker.pkg.dev/PROJECT_ID/cloud-run-source-deploy/run-sql --project PROJECT_ID

   מחליפים את PROJECT_ID במזהה הפרויקט.

   קוד האפליקציה לדוגמה של המדריך למתחילים הזה נמצא בספרייה examples/go במאגר GoogleCloudPlatform/alloydb-auth-proxy ב-GitHub. הפקודה cloudshell_open בשלב הקודם משכפלת באופן אוטומטי את המאגר הזה ופותחת את הספרייה הנכונה.

איך מוצאים את כתובת ה-IP של המכונה החדשה

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

   כניסה לדף Clusters

2. בטבלה, מוצאים את השורה שבה שם המשאב הוא my-primary.

3. שימו לב לערך של Private IP address בשורה הזו. הוא נדרש לשלב הבא במדריך למתחילים.

   דוגמה לפורמט של כתובת IP: 172.19.209.2:5432.

   הערה: אם אתם משתמשים באשכול של תקופת ניסיון בחינם, יכול להיות שכתובת ה-IP הפרטית לא תוצג בדף Clusters. כדי למצוא את כתובת ה-IP הפרטית של המכונה הראשית, אפשר להריץ את הפקודה הבאה ב-Cloud Shell:

   gcloud alloydb instances describe INSTANCE_ID \
   --cluster=CLUSTER_ID \
   --region=LOCATION \
   --format="value(ipAddress)"

יצירת שירות ל-Cloud Run

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

   כניסה ל-Cloud Run

2. בכרטיסייה Services (שירותים), לוחצים על Deploy Container (פריסת מאגר תגים).

3. בדף Create service, בוחרים באפשרות Deploy one revision from an existing container image.

4. בשדה Container image URL, לוחצים על Select.

5. בחלונית Select container image, מבצעים את הפעולות הבאות:

   1. לוחצים על הכרטיסייה Artifact Registry.
   2. מרחיבים את us-central1-docker.pkg.dev/PROJECT_ID/cloud-run-source-deploy.
   3. מרחיבים את run-sql.
   4. בוחרים את התמונה האחרונה.
   5. לוחצים על בחירה.

6. בשדה Service name, מזינים quickstart-service.

7. מוודאים שהאפשרות us-central1 (Iowa) נבחרה כברירת מחדל ברשימה Region.

8. בקטע Authentication, בוחרים באפשרות Allow public access.

9. מוודאים שהאפשרות CPU is only allocated during request processing מסומנת בקטע CPU allocation and pricing.

10. מרחיבים את הקטע Container(s), Volumes, Networking, Security.

11. בכרטיסייה Container(s) (מאגרי תגים), בוחרים בכרטיסייה Variables & secrets (משתנים וסודות) ומבצעים את השלבים הבאים:

    1. בקטע Environment variables, לוחצים על Add variable.

    2. מזינים את הפרטים הבאים בשדות Name ו-Value:

       • DB_NAME: quickstart_db
       • DB_USER: postgres
       • ‫DB_PASS: הסיסמה שהזנתם כשיצרתם את האשכול.
       • DB_PORT: 5432
       • ‫INSTANCE_HOST: כתובת ה-IP של המכונה הראשית של האשכול, שמצאתם בקטע איתור כתובת ה-IP של המכונה החדשה. אל תכללו את מספר היציאה – לדוגמה, הגדירו את 172.19.209.2 ולא את 172.19.209.2:5432.

12. עוברים מהכרטיסייה Container(s) לכרטיסייה Networking ומבצעים את הפעולות הבאות:

    1. מסמנים את התיבה Connect to a VPC for outbound traffic.

    2. בוחרים באפשרות שליחת תנועה ישירות ל-VPC.

    3. ברשימה הנפתחת רשת, בוחרים את הערך default.

    4. ברשימה הנפתחת Subnet, מוודאים שהערך default נבחר.

13. לוחצים על Create כדי ליצור את שירות Cloud Run.

    אחרי שפורסים את שירות Cloud Run, כתובת ה-URL של האפליקציה לדוגמה מופיעה בשדה URL בדף quickstart-service.

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

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

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

   כניסה ל-Cloud Run

2. בדף quickstart-service, לוחצים על Copy to clipboard כדי להעתיק את כתובת ה-URL של האפליקציה.

3. בכרטיסייה חדשה בדפדפן, מדביקים את כתובת ה-URL של האפליקציה שהועתקה ולוחצים על Enter.

הסרת המשאבים

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

ניקוי האשכול

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

   כניסה לדף Clusters

2. ליד האשכול ב-my-cluster שרוצים למחוק, לוחצים על Actions ואז על Delete.

3. בתיבת הדו-שיח Delete cluster שמופיעה, מקלידים my-cluster בשדה my-cluster כדי לאשר שרוצים למחוק אותו.

4. לוחצים על Delete.

ניקוי השירות

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

   כניסה ל-Cloud Run

2. מסמנים את התיבה לצד שם השירות quickstart-service.

3. לוחצים על Delete בחלק העליון של הדף Cloud Run.

4. בתיבת הדו-שיח Delete quickstart-service שמופיעה, לוחצים על Delete כדי לאשר.

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

• הפעלת הגישה לפרויקט ב-AlloyDB

• מתן גישה ל-AlloyDB למשתמשים אחרים

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

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