אחרי שמוסיפים את הפלאגין App Engine Gradle לפרויקט, אפשר להשתמש במשימות Gradle ספציפיות ל-App Engine:
| משימה | תיאור |
|---|---|
tasks |
הצגת מידע עזרה על משימות מותקנות. |
appengineStage |
יוצר ספריית אפליקציות לפריסה. |
appengineDeploy |
מבצעת staging ופריסה של אפליקציה ב-App Engine. |
appengineDeployCron |
פריסת קובץ הגדרה cron.yaml ב-App Engine. |
appengineDeployDispatch |
פריסת קובץ תצורה dispatch.yaml ב-App Engine. |
appengineDeployDos |
פריסת קובץ הגדרה dos.yaml ב-App Engine. |
appengineDeployIndex |
פריסת קובץ הגדרה index.yaml ב-App Engine. |
appengineDeployQueue |
פריסת קובץ הגדרה queue.yaml ב-App Engine. |
jettyRun |
מפעיל את שרת הפיתוח באמצעות הגדרות ברירת המחדל של Jetty. מידע נוסף על הפלאגין Gretty זמין במאמרים Gretty Configuration ו-Gretty Tasks. |
כדי לראות רשימה של כל המשימות:
gradle tasks
מידע נוסף על הגדרה ושימוש ב-Gradle זמין במאמר שימוש ב-App Engine Gradle ובמאגר app-gradle-plugin ב-GitHub.
מאפייני המשימה
התוכן של הקובץ gradle.build הוא קבוצה של כללים לתיאור הבנייה. הוא כתוב בשפה ספציפית לדומיין לתיאור של בנייה, על סמך שפת Groovy.
בהמשך מפורטים מאפיינים שמשויכים לכל משימה, שאפשר להשתמש בהם. אפשר לציין את המאפיינים האלה בקובץ gradle.build באמצעות סגירת הגדרות, משימה ומאפיינים.
בדוגמה הזו:
- התאריך שבו ההגדרה של הפלאגין תיסגר הוא
appengine. - המשימה היא
deploy. - המאפיינים
stopPreviousVersionו-promoteמוגדרים כ-true.
appengine.deploy.stopPreviousVersion = true
בקטעים הבאים מפורטת רשימה של הנכסים שזמינים לכל משימה.
appengineStage
task(stage)
יוצר ספריית אפליקציות לפריסה. בשימוש במשימה appengineDeploy ובמשימה jettyRun.
אפשר להשתמש במאפיינים הבאים:
| מאפיין (property) | תיאור |
|---|---|
artifact |
ארטיפקט בנוי שכולל את כל הכיתות, המשאבים והמניפסטים.
ברירת המחדל היא build/libs/[YOUR_SERVLET].war.
|
appEngineDirectory |
המיקום של הקובץ app.yaml. ברירת המחדל היא src/main/appengine.
|
dockerDirectory |
מיקום של Dockerfile. ברירת המחדל היא src/main/docker.
|
stagingDirectory |
חובה. הספרייה שאליה האפליקציה תועבר. ברירת המחדל היא build/staged-app.
|
appengineDeploy
task(deploy)
מבצעת staging ופריסה של אפליקציה ב-App Engine.
בהמשך מפורטים מאפיינים שמשויכים לכל משימה, שאפשר להשתמש בהם. אפשר לציין את המאפיינים האלה בקובץ gradle.build באמצעות סגירת הגדרות, משימה ומאפיינים.
בדוגמה הבאה:
- התאריך שבו ההגדרה של הפלאגין תיסגר הוא
appengine. - המשימה היא
run. - הנכס
portמוגדר כ-8080.
אם אתם צריכים לציין רק כמה מאפיינים, אתם יכולים להגדיר אותם בשורה אחת:
appengine.run.port = 8888
| מאפיין (property) | תיאור |
|---|---|
appEngineDirectory |
המיקום של קובצי ההגדרות .yaml (cron, index וכו') שממנו יתבצעו פריסות ספציפיות להגדרות (appengineDeployCron וכו'). באפליקציות גמישות, ברירת המחדל היא src/main/appengine.
|
bucket |
הקטגוריה של Cloud Storage שמשמשת לאחסון זמני של קבצים שמשויכים לפריסה. אם לא מציינים את הארגומנט הזה, המערכת משתמשת בדלי ברירת המחדל של האפליקציה. |
deployables |
קובצי ה-YAML של השירותים או ההגדרות שרוצים לפרוס.
ברירת המחדל היא הקובץ app.yaml בספריית ההעלאה. אם הוא לא נמצא, המערכת מנסה ליצור באופן אוטומטי קובצי הגדרה נחוצים (כמו app.yaml) בספריית הביניים.
|
imageUrl |
פריסה באמצעות קובץ אימג' של Docker ספציפי. כתובת ה-URL של Docker חייבת להיות אחת משמות המארחים התקפים של Artifact Registry. |
project |
שם הפרויקט ב-Google Cloud Platform שבו רוצים להשתמש עבור הקריאה הזו.
ברירת המחדל היא הפרויקט הנוכחי שנבחר כשמפעילים את כלי gcloud. כדי לאמת את העסק, אפשר להשתמש במספר gcloud config list project.
|
promote |
מקדמים את הגרסה שפרסתם כדי לקבל את כל תנועת הגולשים. ברירת המחדל היא True. |
server |
שרת App Engine שאליו מתחברים. בדרך כלל אין צורך לשנות את הערך הזה. |
stopPreviousVersion |
כשמפעילים גרסה חדשה שמקבלת את כל התנועה, צריך להפסיק את הגרסה הקודמת שהייתה פעילה. |
version |
הגרסה של האפליקציה שתיווצר או תוחלף על ידי הפריסה הזו. אם לא תציינו גרסה, המערכת תיצור גרסה בשבילכם. |
מאפיינים גלובליים
| מאפיין (property) | תיאור |
|---|---|
tools.cloudSdkHome |
מאפיין אופציונלי להגדרת המיקום של Google Cloud CLI.
בדרך כלל, הפלאגין מוצא את זה ב-CLI של gcloud כשהוא מותקן באמצעות gcloud components install app-engine-java.
|