חבילה כוללת של אפליקציית אתחול קוטין באביב ופריסתה ב-Cloud Run

חבילה כוללת של אפליקציית אתחול קוטין באביב ופריסתה ב-Cloud Run

מידע על Codelab זה

subjectהעדכון האחרון: אפר׳ 22, 2020
account_circleנכתב על ידי גוגלר

1.‏ לפני שמתחילים

Google מספקת כלי מתקדם ליצירת תמונות, שבאמצעותו תוכל לבנות ולפרסם בקלות תמונה של מאגר אביזר עגינה עבור אפליקציות Java בכל זמן בלי Docker או Dockerfile. ב-Google Cloud תקבלו גם שרתים ללא שרת (CPC) עם קונטיינרים באמצעות Cloud Run – פלטפורמת מחשוב מנוהלת שמתאימה את גודל המאגרים באופן אוטומטי ללא מצב. במעבדה הזו, תוכלו לראות כמה קל לאחסן את אפליקציית Spring Botlin Kotlin, לפרסם אותה ב-Container Registry, ולהפעיל את התמונה ב-Google Cloud בצורה חלקה!

בשיעור הקוד הזה תלמדו איך להגדיר אפליקציה פשוטה ב-Cotlin, שממחישה איך משתמשים בשירותים ובכלים של Google Cloud, כולל Jib, Container Registry ו-Cloud Run.

דרישות מוקדמות

  • היכרות עם השפה והתכנות של Java
  • ידע בעורכי טקסט רגילים של Linux, כמו Vim , Emacs ו-nano

הפעולות שתבצעו:

  • הגדרת אפליקציה של Spring Botlin ב-Spring.
  • אפשר ליצור תמונת Docker אופטימלית.
  • מפרסמים את התמונה ברישום מאגר התגים.
  • מריצים את האפליקציה במאגר ב-Cloud Run.

מה תצטרך להכין

  • פרויקט ב-Google Cloud
  • דפדפן כמו Google Chrome

2.‏ תהליך ההגדרה

הגדרת סביבה בקצב עצמי

  1. נכנסים ל-Cloud Console ויוצרים פרויקט חדש או משתמשים שוב בפרויקט קיים. (אם עדיין אין לכם חשבון Gmail או G Suite, עליכם ליצור חשבון).

חשוב לזכור את מזהה הפרויקט הוא שם ייחודי בכל הפרויקטים ב-Google Cloud (השם הקודם כבר תפוס, והוא לא יעבוד בשבילך.) נתייחס אליו מאוחר יותר ב-codelab הזה בתור PROJECT_ID.

  1. לאחר מכן, עליך להפעיל חיוב ב-Cloud Console כדי להשתמש במשאבים של Google Cloud.

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

משתמשים חדשים ב-Google Cloud זכאים לתקופת ניסיון בחינם ב-1200 ש"ח.

Cloud Shell

Google Cloud יכול לפעול מרחוק מהמחשב הנייד שלכם, אבל במעבדה זו תשתמשו ב-Cloud Shell, סביבת שורת פקודה שפועלת ב-Google Cloud.

הפעלת Cloud Shell

  1. ב-Cloud Console, לוחצים על Activate Cloud Shell .

אם אף פעם לא התחלת להשתמש ב-Cloud Shell, יוצג לך מסך ביניים (בחלק הנגלל) שמתאר את הבעיה. אם זה קורה, יש ללחוץ על המשך (ולא יוצג לך שוב). כך נראה המסך החד-פעמי הזה:

הוא ייקח רק כמה רגעים עד שההקצאה והחיבור ל-Cloud Shell.

המכונה הווירטואלית הזו נטענת באמצעות כל כלי הפיתוח הדרושים לך. יש בה ספריית בית בנפח עקבי של 5GB והיא פועלת ב-Google Cloud, וכך משפרת באופן משמעותי את הביצועים ואת האימות של הרשת. את רוב העבודה במעבדה זו אפשר לבצע, אם לא את כולם, באמצעות דפדפן או ה-Chromebook בלבד.

לאחר החיבור ל-Cloud Shell, אתם אמורים לראות שכבר בוצע אימות, ושהפרויקט כבר מוגדר כמזהה הפרויקט.

  1. מריצים את הפקודה הבאה ב-Cloud Shell כדי לוודא שאתם מאומתים:
gcloud auth list

פלט הפקודה

 Credentialed Accounts
ACTIVE  ACCOUNT
*       <my_account>@<my_domain.com>

To set the active account, run:
    $ gcloud config set account `ACCOUNT`
 
gcloud config list project

פלט הפקודה

[core]
project = <PROJECT_ID>

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

gcloud config set project <PROJECT_ID>

פלט הפקודה

Updated property [core/project].

3.‏ אתחול של אפליקציית Spring אתחול

  1. יצירה של אפליקציית Spring Boot חדשה באמצעות Spring אתחול.
$ curl https://start.spring.io/starter.tgz \
    -d language=kotlin \
    -d dependencies=web \
    -d baseDir=kotlin-jib-cloud-run | tar -xzvf -

לתשומת ליבך, ה-Initializr יוסיף באופן אוטומטי את spring-boot-starter-web לתלויות שלך ב-pom.xml של אפליקציית התבנית.

  1. משנים את הספרייה של אפליקציית התבנית.
$ cd kotlin-jib-cloud-run
  1. בונים ומפעילים את האפליקציה באמצעות Maven.
$ ./mvnw -DskipTests spring-boot:run
  1. לאחר ההפעלה, האפליקציה תתחיל להאזין ליציאה 8080. לוחצים על תצוגה מקדימה באינטרנט בסרגל הכלים של Cloud Shell ובוחרים באפשרות תצוגה מקדימה ביציאה 8080 כדי לגשת לאפליקציה.

  1. אתם אמורים לקבל תשובה מסוג 404 כי האפליקציה עדיין לא עוזרת. הפסקת האפליקציה עם Control+C.

4.‏ הוספת בקר אינטרנט

  1. צריך ליצור את המחלקה הבאה (Controller) בחבילת ההדגמה:
$ vi src/main/kotlin/com/example/demo/Controller.kt
    or
$ nano src/main/kotlin/com/example/demo/Controller.kt

src/main/kotlin/com/example/demo/Controller.kt

package com.example.demo

import org.springframework.web.bind.annotation.GetMapping
import org.springframework.web.bind.annotation.RestController

@RestController
class Controller {
  
  @GetMapping("/")
  fun saySomething(): String {
    return "Kotlin app on Cloud Run, containerized by Jib!"
  }
}
  1. בונים מחדש את האפליקציה ומפעילים אותה.
$ ./mvnw spring-boot:run
  1. בודקים שוב את האפליקציה באמצעות התצוגה המקדימה באינטרנט . הפעם אמורה להופיע ההודעה " Kotlin app on Cloud Run, containerized by Jib!". יש להפסיק את השימוש באפליקציה עם Control+C.

5.‏ יש לכלול את האפליקציה שלך במאגר ולפרסם אותה במאגר התגים

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

  1. לפני שממשיכים, צריך להפעיל את ה-Container Registry API. יש לעשות זאת רק פעם אחת לכל פרויקט כדי לאפשר גישה ל-API.
$ gcloud services enable containerregistry.googleapis.com
  1. מריצים את Jib כדי ליצור תמונת Docker ולפרסם אותה במאגר התגים.
$ ./mvnw com.google.cloud.tools:jib-maven-plugin:1.8.0:build \
    -Dimage=gcr.io/$GOOGLE_CLOUD_PROJECT/kotlin-jib-cloud-run

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

[INFO] Built and pushed image as gcr.io/PROJECT_ID/kotlin-jib-cloud-run
...
[INFO] BUILD SUCCESS

אם מופיעה הודעת שגיאה, צריך לבדוק שוב אם ההגדרה של $GOOGLE_CLOUD_PROJECT נכונה למזהה הפרויקט שלך ב-Google Cloud (PROJECT_ID).

  1. לפני שממשיכים, כדאי לבדוק אם התמונה פורסמה בהצלחה. חוזרים אל Cloud Console, לוחצים על Navigation menu ובוחרים באפשרות Container Registry.

לאחר מכן תראו שהתמונה פורסמה בהצלחה.

6.‏ הפעלת האפליקציה המוכלת ב-Cloud Run

ב-Cloud Run, אתם יכולים לבצע אוטומציה של שרת הקונטיינרים ללא הגבלה ואז להגדיר התאמה אוטומטית של מאגרי התגים שלכם ללא מצב.

  1. לוחצים שוב על תפריט הניווט ובוחרים באפשרות Cloud Run.

אם זו הפעם הראשונה שאתם ניגשים אל Cloud Run, תופיע תיבת הדו-שיח הבאה להגדרה חד-פעמית. לוחצים על התחלת השימוש ב-Cloud Run אם היא מופיעה.

  1. בדף Cloud Run, לוחצים על Create Service (יצירת שירות).

  1. במסך הבא, לוחצים על בחירה בקטע מקור. המקור הוא התמונה שרוצים להריץ ב-Cloud Run.

  1. בתיבת הדו-שיח תוצג התמונה שיצרתם בעבר. בוחרים את התמונה ולוחצים על המשך.

  1. נותרו עוד מספר קליקים להגדרת האפליקציה. בקטע פלטפורמת פריסה, בוחרים באפשרות Cloud Run (מנוהל) כדי שהשירות יופעל ב-Google Cloud באופן מלא. בוחרים אזור שמתאים למיקום שלכם, בוחרים באפשרות הפעלת הפעלות לא מאומתות ולוחצים על יצירה. זהו!

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

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

Kotlin app on Cloud Run, containerized by Jib!

זהו! בעתיד, אם תרצו לפרוס גרסאות חדשות של אפליקציות, תוכלו לעשות זאת על ידי לחיצה על פריסת גרסה חדשה בדף.

7.‏ הסרת עותקים כפולים

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

  1. באופן דומה, עוברים אל דף הרישום של מאגר תגים ומוחקים את התמונה.

8.‏ מזל טוב

מעולה! יצרתם בהצלחה את האפליקציה Spring Bot Kotlin ופרסתם אותה ב-Cloud Run!

באמצעות Jib, בניתם תמונה של מאגר שעברה אופטימיזציה בלי להתקין את Dockerfile או כתבתם קובץ Dockerfile ופרסמתם אותו ב-Container Registry. Jib מבצעת אופטימיזציה של בניית תמונות, כך שכל מי שאינו ללא ידע מעמיק ב-Docker יוכל לחבר אפליקציות Java במהירות וביעילות. לאחר מכן, בכמה קליקים, פרסתם את האפליקציה ב-Cloud Run כדי להתחיל להציג מודעות תוך זמן קצר.

מידע נוסף

bug_report דיווח על טעות