הערכת אפליקציות Java לצורך מודרניזציה

בדף הזה מוסבר איך משתמשים ב-Google Cloud Modernization Hub במסוףGoogle Cloud כדי להעריך אפליקציות Java ארגוניות לצורך הכלה בקונטיינרים של Linux ומודרניזציה לגרסאות Java Long-Term Support‏ (LTS) בפלטפורמות שונות (כמו Java 17 או Java 21) ב- Google Cloud.

הרבה אפליקציות Java ארגוניות תלויות בממשקי API מדור קודם של Java EE, בהגדרות קנייניות של שרתי אפליקציות (כמו WebLogic,‏ WebSphere או JBoss) או בספריות מיושנות של צד שלישי, שמונעות פריסה ישירה בקונטיינרים של Linux. הערכה אוטומטית ב-Modernization Hub מנתחת את קוד המקור, מזהה גורמים שחוסמים את ההעברה, בודקת את התאימות של יחסי התלות של Maven או Gradle וממליצה על נתיבים לשינוי מבנה הקוד (refactoring) ב-Cloud Run או ב-Google Kubernetes Engine.

כדי להריץ הערכות מהמחשב המקומי או להתאים אישית את חלקי הדוח באמצעות ה-CLI העצמאי של codmod, קראו את המאמר יצירת הערכה למודרניזציה של אפליקציות.

מתי כדאי להשתמש בהערכת אפליקציות ב-Java

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

  • העברת פלטפורמה לקונטיינרים של Linux: לפני שמעבירים את האפליקציות לקונטיינרים ב-Cloud Run או ב-GKE, צריך לזהות את יחסי התלות הספציפיים לסביבה (כמו גישה למערכת קבצים מקומית, ספריות JNI או ממשקי API של שרתי אפליקציות קנייניים).
  • שדרוג גרסאות של סביבת זמן ריצה של Java: הערכת המאמץ ופערי התאימות במעבר מ-Java 8 או Java 11 לגרסאות LTS מודרניות של Java (‏Java 17 או Java 21), או במעבר מ-Java EE (‏javax.*) ל-Jakarta EE (‏jakarta.*).
  • הפרדת ארכיטקטורות מונוליתיות: זיהוי רכיבי EJB בצימוד חזק, מתווכי הודעות JMS או פריסות WAR ו-EAR מונוליתיות שצריך לשנות את המבנה שלהן למיקרו-שירותים (microservices) מבוססי-ענן או לאפליקציות Spring Boot.

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

לפני שמתחילים משימת הערכה של Java במסוף, צריך להפעיל את ממשקי ה-API הנדרשים, לאמת את ההרשאות של הפרויקט בממשק לניהול הזהויות והרשאות הגישה (IAM), לרשום קטגוריה של הגדרות סביבת העבודה ולהעלות את ארכיון קוד המקור ל-Cloud Storage.

הפעלת ממשקי ה-API הנדרשים

כדי להשתמש ב-Modernization Hub, צריך להפעיל בפרויקט את ממשקי ה-API הנדרשים של שירות Google Cloud:

gcloud services enable \
    aiplatform.googleapis.com \
    artifactregistry.googleapis.com \
    cloudbuild.googleapis.com \
    cloudresourcemanager.googleapis.com \
    compute.googleapis.com \
    logging.googleapis.com \
    storage.googleapis.com \
    --project=PROJECT_ID

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

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

כדי להריץ הערכה, צריך הרשאות IAM נפרדות לשתי זהויות באמצעות Cloud Build ו-Gemini Enterprise Agent Platform:

  • משתמש מאומת במסוף (שמפעיל את המשימה וניגש לקטגוריות):
    • אדמין באחסון (roles/storage.admin)
    • משתמש בחשבון שירות (roles/iam.serviceAccountUser)
    • עריכה ב-Cloud Build (roles/cloudbuild.builds.editor)
  • חשבון שירות ייעודי (שמריץ את מאגר ההערכה):
    • משתמש ב-Agent Platform (roles/aiplatform.user)
    • משתמש באובייקטים באחסון (roles/storage.objectUser) או אדמין של אחסון (roles/storage.admin)

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

  • משתמש – ניהול ארכיוני המקור והגדרות הקטגוריות: אדמין של אחסון (roles/storage.admin)
  • משתמש – צירוף חשבון השירות הייעודי למשימה: משתמש בחשבון שירות (roles/iam.serviceAccountUser)
  • משתמש – שליחת משימות הערכה (cloudbuild.builds.create) וצפייה ביומנים: עריכה ב-Cloud Build‏ (roles/cloudbuild.builds.editor)
  • חשבון שירות – הפעלת מאגר codmod: משתמש בפלטפורמת הסוכן (roles/aiplatform.user)
  • חשבון שירות – קריאת ארכיונים של מקורות וכתיבת דוחות הערכה: משתמש באובייקטים באחסון (roles/storage.objectUser) או אדמין של אחסון (roles/storage.admin)

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

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

ההרשאות הנדרשות

כדי להתחיל הערכה ולהריץ את מאגר הניתוח, צריך את ההרשאות הבאות:

  • משתמש (Cloud Storage,‏ Cloud Build ו-IAM):
    • storage.objects.get (כדי להוריד או לקרוא קבצים)
    • ‫storage.objects.list (כדי להציג רשימה של הקבצים בקטגוריה)
    • storage.objects.create (כדי להעלות או ליצור קבצים חדשים)
    • storage.objects.update (כדי לשנות מטא-נתונים של קבצים קיימים)
    • storage.objects.delete (כדי למחוק קבצים או להחליף אותם)
    • storage.buckets.get (הצגת ההגדרות ברמת הקטגוריה)
    • ‫cloudbuild.builds.create (כדי לשלוח משימות הערכה)
    • ‫iam.serviceAccounts.actAs (כדי לצרף את חשבון השירות למשימה)
  • חשבון שירות (Agent Platform ו-Cloud Storage):
    • ‫aiplatform.endpoints.predict (כדי להריץ ניתוח קוד בעזרת AI)
    • ‫storage.objects.get (כדי לקרוא או להוריד ארכיונים של מקורות)
    • ‫storage.objects.list (כדי להציג את הקבצים בתיקיית הקלט)
    • ‫storage.objects.create (כדי לכתוב דוחות הערכה)
    • storage.objects.delete (כדי למחוק קבצים זמניים)

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

הגדרת קטגוריה של הגדרות סביבת העבודה

רושמים קטגוריה של Cloud Storage ייעודית בדף Modernization Hub > Settings (לדוגמה, gs://PROJECT_ID-modernization-hub) כדי לאחסן את קובצי תמונת המצב הבינאריים של סביבת העבודה (dotnet_jobs.pb,‏ java_jobs.pb ו-mainframe_jobs.pb).

בדיקת מגבלות הגודל של בסיס הקוד

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

  • גודל מקסימלי של בסיס הקוד: בערך שישה מיליון שורות קוד (LOC) לכל משימת הערכה. אם במאגר יש יותר מ-6 מיליון שורות קוד, צריך לפצל את בסיס הקוד למודולים או לשירותים קטנים ועצמאיים לפני ההעלאה.
  • מבנה ארכיון נקי: אל תכללו קובצי ZIP עם קבצים בינאריים שעברו הידור, מטמונים של חבילות ומטא-נתונים של ניהול גרסאות (כמו target/,‏ build/,‏ bin/,‏ node_modules/ ו-.git/), כדי שהמערכת תנתח רק קובצי מקור ותצורות build.

הכנה והעלאה של ארכיון המקור של Java

אורזים את בסיס הקוד של Java כקובץ ZIP שלא כולל פלט של גרסאות build, ומעלים את הקובץ לקטגוריה של Cloud Storage בפרויקט.

  1. במכונה המקומית, יוצרים קובץ ZIP של המאגר באחת מהשיטות הבאות:

    • באמצעות Git (מומלץ):

      git archive --format=zip -o repository.zip HEAD
      
    • באמצעות ה-CLI של zip:

      zip -r repository.zip . \
          -x "*.git*" "*/target/*" "*/build/*" "*/bin/*" "*/node_modules/*"
      
  2. מעלים את קובץ ה-ZIP לקטגוריה של Cloud Storage באמצעות Google Cloud CLI:

    gcloud storage cp repository.zip \
        gs://INPUT_BUCKET/codebase/repository.zip
    

    מחליפים את INPUT_BUCKET בשם של קטגוריה של Cloud Storage.

הרצת הערכה

כדי להתחיל משימת הערכה ב-Modernization Hub:

  1. נכנסים לדף Modernization Hub במסוף.

    כניסה ל-Modernization Hub

  2. בדף הנחיתה, מאתרים את הכרטיס Java Workloads ולוחצים על Start assessment.

  3. בשדה Job name, נותנים שם ייחודי למשימת ההערכה.

  4. בשדה Source code location, בוחרים קטגוריה של Cloud Storage שמכילה את קוד המקור כקובץ ZIP.

  5. בשדה Report location, בוחרים קטגוריה של Cloud Storage שבה רוצים לשמור את דוחות ההערכה שנוצרו.

  6. ברשימה Modernization recipe, בוחרים מתכון למודרניזציה.

  7. ברשימה Location, בוחרים אזור למשימת ההערכה.

  8. בשדה Service account, בוחרים חשבון שירות ייעודי עם תפקידי ה-IAM הנדרשים שמפורטים בקטע תפקידים נדרשים. ‫Cloud Build מריץ את משימת ההערכה באמצעות חשבון השירות הזה, שדורש הרשאות של משתמש בפלטפורמת הסוכן והרשאות של Cloud Storage.

  9. לוחצים על יצירת דוח.

    המסוף מפעיל קונטיינר להערכה ברקע, שמריץ את מנוע codmod כדי לנתח את הפרויקט. סטטוס המשימה מופיע בטבלה Assessment history.

בדיקת דוח ההערכה

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

כדי לגשת לתוצאות ההערכה:

  1. בטבלה Assessment history שבדף Modernization Hub, מאתרים את משימת ההערכה.
  2. כשהערך בעמודה Status משתנה ל-Completed, לוחצים על Download Report.
  3. בוחרים את פורמט הפלט הרצוי:
    • דוח HTML: סיכום אינטראקטיבי שמאפשר לסנן ממשקי API לא תואמים, לבדוק רשימות של גורמים חוסמים בכל קובץ בנפרד ולראות הצעות לתיקון.
    • דוח Markdown: תקציר מנהלים מעוצב שאפשר לשתף עם בעלי עניין ועם ועדות לבדיקת ארכיטקטורה.

בדיקת דוח ההערכה

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

  • ציון תאימות כולל: אחוז שורות המקור והתלויות שאפשר להעביר לסביבת זמן הריצה של Java בלי שינויים.
  • פירוט של הגורמים החוסמים: סביבות או יחסי תלות ספציפיים של Java מדור קודם שדורשים שינוי מבני, כמו:
    • שינויים במרחב השמות של Java EE (javax.*) ל-Jakarta EE (jakarta.*).
    • ממשקי API פנימיים של JDK שהוסרו או הוצאו משימוש (כמו חבילות sun.misc.* או מודולים של CORBA).
    • הגדרות או ממשקי API של שרתי אפליקציות קנייניים (כמו קובצי תיאור פריסה של WebLogic,‏ WebSphere או JBoss).
  • ניתוח יחסי תלות: מלאי מפורט של יחסי התלות הקיימים ב-Maven או ב-Gradle, שמציין אם כל ספרייה תומכת בגרסת זמן הריצה של Java או אם נדרש שדרוג.
  • פעולות מומלצות: הצעות לשינויי קוד, מתכונים לארגון הקוד מחדש בעזרת AI ונתיבי העברה שנוצרו על ידי codmod כדי להכין את האפליקציה ליצירת קונטיינרים ב- Google Cloud.

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