לפני שפורסים שירות ב-Cloud Run, אפשר לפתח אותו באופן מקומי באמצעות אמולטור של Cloud Run.
הגדרת השירות לפיתוח
אם לא מוגדר קובץ .vscode/launch.json, בתיבת הדו-שיח Run/Debug on Cloud Run Emulator אפשר להגדיר את ההפעלה ואז לשמור את ההגדרות בקובץ .vscode/launch.json. אם הגדרתם קובץ .vscode/launch.json, אתם יכולים לערוך אותו ישירות.
כדי להריץ את השירות באופן מקומי, מציינים את ההגדרה:
- פותחים את לוח הפקודות (מקישים על
Ctrl/Cmd+Shift+Pאו לוחצים על View (תצוגה) > Command Palette (לוח הפקודות)) ומריצים את הפקודה Run on Cloud Run Emulator (הרצה ב-Cloud Run Emulator). בתיבת הדו-שיח Run/Debug on Cloud Run Emulator, מגדירים את המפרטים של ההגדרה:
- רק כלי בנייה שהותקנו באופן מקומי זמינים ל-Cloud Run Emulator
- בוחרים באפשרות Docker או Buildpacks ככלי הבנייה ומציינים את המקור.
- (אופציונלי) כדי לציין משתני סביבה להעברה למאגרי הנתונים הפעילים, מרחיבים את הגדרות מתקדמות של גרסת ה-build ואז לוחצים כדי לציין זוגות של מפתח-ערך.
שם תיאור דוגמה PORT היציאה שבה שרת ה-HTTP מאזין. 8080 K_SERVICE השם של שירות Cloud Run שמופעל. hello-world K_REVISION השם של גרסת Cloud Run שמופעלת. hello-world.1 K_CONFIGURATION השם של הגדרת Cloud Run שיצרה את הגרסה. hello-world - (אופציונלי) כדי לציין חיבורים ל-Cloud SQL, מרחיבים את הגדרות שירות מתקדמות, לוחצים על חיבורים ומציינים חיבור אחד ל-Cloud SQL בכל שורה.
- (אופציונלי) מסמנים את האפשרות השירות יהיה נגיש ממכשירים אחרים ברשת המקומית.
- (אופציונלי) אם רוצים לבנות מחדש את השירות ולהפעיל אותו באופן ידני בלבד, ולא באופן אוטומטי כשמבצעים שינוי, מבטלים את הסימון של האפשרות בנייה מחדש והפעלה מחדש אוטומטיות בעקבות שינויים.
הפעלת השירות באופן מקומי
אחרי שמגדירים את ההגדרות הרצויות, מפעילים את השירות על ידי לחיצה על הפעלה.
אם מוצגת בקשה, מאמתים את פרטי הכניסה כדי להריץ ולנפות באגים באפליקציה באופן מקומי.
עוקבים אחרי סטטוס הפריסה בחלון הפלט.
אחרי שהפריסה תושלם, תוכלו לראות את השירות הפועל על ידי פתיחת כתובת ה-URL שמוצגת בחלון הפלט.
כדי לראות רישומים מפורטים, עוברים לתצוגה המפורטת של Cloud Run בחלון הפלט.
אחרי שהסשן מסתיים, לוחצים לחיצה ימנית כדי להשתמש בפקודות הבאות:
- צפייה ביומנים: פותחים את יומני האפליקציה של פריסה ספציפית באמצעות הכלי Cloud Code logs explorer.
- פתיחת כתובת URL: פתיחה של כתובת ה-URL של שירות האפליקציה של שירות ספציפי בדפדפן אינטרנט.
אם השבתתם את מצב הצפייה בהגדרות ההפעלה ואתם רוצים לבצע שינויים באפליקציה, לבנות אותה מחדש ולפרוס אותה מחדש, לוחצים על סרגל הסטטוס של Cloud Code ואז על הפעלת מצב צפייה.
כדי להפסיק את הפריסה, אפשר ללחוץ על הלחצן הפסקה בסרגל הפעולות של הפריסה הנוכחית.
אחסון סודות
אם הקוד שלכם כולל נתונים רגישים פוטנציאליים כמו מפתחות API, סיסמאות ואישורים, אחסון שלהם כסודות יכול לעזור לאבטח אותם. האינטגרציה של Cloud Code עם Secret Manager מאפשרת לכם לאחסן את הסודות האלה בצורה מאובטחת ולאחזר אותם באופן פרוגרמטי. במדריך Secret Manager מוסבר בפירוט איך ליצור סודות ולנהל אותם באמצעות Cloud Code.
התאמה אישית של הגדרת launch.json קיימת
התוסף Cloud Code מעדכן את קובץ ההגדרות launch.json באופן אוטומטי כשבוחרים פעולת הפעלה. כדי להתאים אישית את אופן ההפעלה של השירות, אפשר לציין את השדות הבאים בקובץ .vscode/launch.json:
watch: עוקב אחרי שינויים בסביבת העבודה ומפעיל מחדש את השירות. ברירת המחדל היא True.
בדוגמה הבאה, השעון מוגדר ל-
true:"watch": true,build: מציינים את ה-builder (Docker, jibMaven, jibGradle או buildpacks) שבאמצעותו ייבנו קובצי האימג'.
בדוגמה הבאה מוצג Docker builder:
"build": { "docker": { "path": "Dockerfile" } },בדוגמה הבאה מוצג כלי ליצירת buildpack:
"build": { "buildpacks": { "path": "src/requirements.txt", "builder": "gcr.io/buildpacks/builder:v1" } },image: מציינים את שם התמונה שרוצים להשתמש בה.
בדוגמה הבאה אפשר לראות איך מציינים שם של תמונה:
"image": "hello-world",service: מציינים את שירות Cloud Run שבו רוצים להשתמש.
בדוגמה הבאה אפשר לראות איך מציינים שם שירות, יציאה ומגבלות משאבים:
"service": { "name": "hello-world", "containerPort": 8080, "resources": { "limits": { "memory": "256Mi" } } },debug: מציינים הגדרות ניפוי באגים, כמו מיפוי נתיבים מרוחקים, כדי למפות נתיב מקומי לנתיב בקונטיינר המרוחק.
בדוגמה הבאה מוצג קטע של ניפוי באגים שמציין את המיקום של קובצי המקור:
"debug": { "sourceFileMap": { "${workspaceFolder}": "/app" } }