העברת אפליקציות ל-Linux לקונטיינרים

השילוב של Migrate to Containers עם Cloud Code מאפשר לכם לחדש רכיבי אפליקציות של Linux שפועלים במכונות וירטואליות (VM), וליצור ארטיפקטים שאפשר לפרוס ב-Google Kubernetes Engine וב-Cloud Run, ישירות בסביבת הפיתוח המשולבת (IDE), באמצעות מכונת Linux.

במדריך הזה נסביר איך להעביר פלטפורמה של אפליקציה קיימת לקונטיינר GKE באמצעות התוסף Cloud Code בסביבת הפיתוח המשולבת במכונת Linux.

המדריך הזה מיועד למפתחים במכונת Linux שיש להם ידע מעשי ב-VS Code, שמכירים את Google Cloudויש להם מכונה וירטואלית שבה פועל רכיב האפליקציה שלהם.

הערה: כדי לבצע את השלבים במדריך הזה, צריך להשתמש במכונת Linux. ‫Cloud Code לא תומך בהעברת פלטפורמה של אפליקציות לקונטיינרים באמצעות Windows או macOS.

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

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

Verify that billing is enabled for your Google Cloud project.

Enable the Google Kubernetes Engine API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

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

Verify that billing is enabled for your Google Cloud project.

Enable the Google Kubernetes Engine API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

1. אם עוד לא עשיתם זאת, מתקינים את התוסף Cloud Code.
2. יצירה והגדרה של אשכול GKE.
3. חשוב לדעת איזה סוג העברה רוצים לבצע. מידע נוסף על עומסי עבודה נתמכים זמין במאמר בדיקת תאימות של מערכות הפעלה, עומסי עבודה וגרסאות Kubernetes.
4. הכנת המכונות המקומיות והמכונות של המקור למודרניזציה. ‫Cloud Code תומך רק ב-Linux לצורך מודרניזציה.

הוספת מקור להעברה בין פלטפורמות

בקטע הזה מוסבר איך להתקין במחשב המקומי את כלי ה-CLI של לקוח הגילוי של Migration Center‏ (mcdc) וכלי Migrate to Containers אחרים, אם עדיין לא עשיתם זאת, ואיך להוסיף מקור לשינוי פלטפורמה באמצעות השלבים הבאים:

1. בסרגל הפעילות של סביבת הפיתוח המשולבת, לוחצים על Cloud Code ואז מרחיבים את הסייר Replatform Apps.

2. אם זו הפעם הראשונה שאתם משתמשים ב-Migrate to Containers ב-Cloud Code, תצטרכו להתקין את mcdc CLI ואת הכלים האחרים של Migrate to Containers במחשב המקומי. לשם כך, לוחצים על Install tools (התקנת כלים). אם לא, עוברים לשלב הבא.

3. לוחצים על עריכת המקורות. ייפתח קובץ mcdc-sources.json ריק. מוסיפים את המקורות בפורמט הבא:

   [
     {
       "title": "SOURCE_NAME",
       "host": "HOSTNAME",
       "user": "USER",
       "identityFile":"IDENTITY-FILE-PATH"
     }
   ]
   

   הערה: אפשר להשתמש באותם משתנים host, user ו-identityFile בפקודת SSH.

4. כדי לראות את המקורות בכלי Replatform Apps, מעבירים את מצביע העכבר מעל הכלי Replatform Apps ולוחצים על הלחצן Reload sources cached שמופיע.

אופציונלי: יצירת התאמה

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

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

בסיום ההערכה, mcdc יוצר דוח התאמה (Fit Assessment Report) בסביבת הפיתוח המשולבת (IDE).

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

העברה של האפליקציה לפלטפורמה אחרת

‫Cloud Code יוצר סביבת עבודה ייעודית לכל פלטפורמה מחדש, ומאפשר להריץ את המשימות העתקה, ניתוח ויצירה בסביבת העבודה כדי להפוך את השלבים של הפלטפורמה מחדש לאוטומטיים. אם מריצים את המשימה Generate בלי להריץ קודם את המשימות Copy ו-Analyze, המערכת מריצה אותן באופן אוטומטי לפני יצירת הארטיפקטים.

בקטעים הבאים מוסבר איך לבצע כל אחת מהמשימות האלה ולהעביר את האפליקציה לפלטפורמה אחרת באמצעות Cloud Code.

מידע נוסף על מחזור החיים של העברה זמין במאמר בנושא ארכיטקטורת Migrate to Containers CLI.

יצירת סביבת עבודה חדשה למעבר פלטפורמה

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

כדי ליצור סביבת עבודה חדשה להעברה של פלטפורמה עם ארטיפקטים בסביבת הפיתוח המשולבת (IDE), פועלים לפי השלבים הבאים:

1. בסייר Replatform Apps, לוחצים לחיצה ימנית על המקור שרוצים לבצע לו Replatform ואז לוחצים על Replatform.

2. בוחרים באפשרות הרצויה מתוך רשימת האפשרויות שמופיעה בתפריט.

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

4. בוחרים את פרמטרי ההעברה לסוג ההעברה.

5. אופציונלי: אם בחרתם בסוג ההעברה WebSphere ואתם רוצים להשתמש בסורק בינארי, בוחרים את הקובץ binaryAppScanner.jar.

   יצירת סביבת העבודה נמשכת כמה שניות. תיקיית סביבת העבודה החדשה תיפתח בחלון חדש של סביבת הפיתוח המשולבת.

העתקת קבצים מהמכונה הווירטואלית לסביבת העבודה

כדי להעתיק את הקבצים מהמכונה הווירטואלית לסביבת העבודה ב-IDE, מבצעים את השלבים הבאים:

1. אופציונלי: ממשק mcdc CLI מחיל מסננים כדי להקטין את הגודל של העותק, אבל אפשר לשנות את קובץ filters.txt כדי להקטין עוד יותר את הגודל של העותק. במאמר הקטנת הגודל של מערכת הקבצים שהועתקה מוסבר איך להקטין את הגודל של העותק.

2. מקישים על Ctrl+Shift+P כדי לפתוח את לוח הפקודות.

3. מחפשים את האפשרות משימות: הפעלת משימה ובוחרים אותה, ואז בוחרים באפשרות m2c: Copy. העתקת הקבצים עשויה להימשך כמה דקות.

ניתוח של מערכת הקבצים של מכונה וירטואלית ויצירת תוכנית העברה

כדי לנתח את מערכת הקבצים של מכונת ה-VM וליצור תוכנית העברה:

1. מקישים על Ctrl+Shift+P כדי לפתוח את לוח הפקודות.

2. מחפשים את האפשרות משימות: הפעלת משימה ובוחרים אותה, ואז בוחרים באפשרות m2c: ניתוח.

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

   אם הניתוח מצליח, Cloud Code יוצר ספרייה בשם migration-plan שמכילה את תוצאות הניתוח בצורה של קובץ migration-plan.config.yaml אתם יכולים לערוך את הקובץ הזה כדי לשנות את אופן יצירת הארטיפקטים.

   המבנה של קובץ config.yaml משתנה בהתאם לסוג ההעברה. מידע נוסף על סוגי ההעברה הנתמכים מופיע בדפים הבאים:

   • מכונות וירטואליות של Linux
   • שרתי Tomcat
   • עומסי עבודה של WebSphere
   • שרתי JBoss
   • שרתי Apache
   • אתרי WordPress

יצירת פריטי מידע שנוצרו בתהליך פיתוח (Artifact

כדי ליצור ארטיפקטים, צריך להריץ את המשימה Generate בסביבת הפיתוח המשולבת. אם לא הפעלתם את המשימות Copy ו-Analyze בקטעים הקודמים, המשימה Generate תפעיל אותן באופן אוטומטי לפני יצירת הארטיפקטים.

כדי ליצור את הארטיפקטים:

1. מקישים על Ctrl+Shift+P כדי לפתוח את לוח הפקודות.

2. מחפשים את האפשרות משימות: הפעלת משימה ובוחרים אותה, ואז בוחרים באפשרות m2c: Generate (m2c: יצירה). הפעולה הזו יוצרת את הארטיפקטים בספרייה src, שמכילה קובץ skaffold.yaml שמשמש ליצירת גרסת build ולפריסה של קובץ אימג' של קונטיינר. כל סוג של העברה יוצר ארטיפקטים שונים, אבל בדרך כלל כל סוג של העברה יוצר קובץ dockerfile אחד או יותר ומפרט פריסה של GKE שמתייחס אליהם.skaffold.yaml

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

3. אופציונלי: אם רוצים לשנות את תוכנית ההעברה, עורכים את config.yaml הקובץ ומריצים מחדש את המשימה m2c: Generate.

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

הפעלת האפליקציה בקונטיינר GKE

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

אם עדיין לא יצרתם והגדרתם אשכול GKE, פועלים לפי ההוראות במאמר יצירה והגדרה של אשכול GKE ב-Cloud Code ל-VS Code.

מידע נוסף על ניפוי באגים באפליקציות GKE זמין במאמר ניפוי באגים באפליקציות Kubernetes באמצעות Cloud Code ל-VS Code.

הפעלה והצגה של האפליקציה

עכשיו כשהכול מוכן, אפשר להריץ את האפליקציה ולצפות בה בשידור חי. ‫Cloud Code עוקב אחרי שינויים במערכת הקבצים כדי שתוכלו לערוך את האפליקציה ולהריץ אותה מחדש בזמן אמת.

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

1. בסרגל הסטטוס של Cloud Code, לוחצים על שם הפרויקט הפעיל.

   

2. בתפריט 'בחירה מהירה' שמופיע, בוחרים באפשרות הפעלה ב-Kubernetes.

3. מאשרים אם להשתמש בהקשר הנוכחי של האשכול או לעבור להקשר אחר.

4. אם מתבקשים, בוחרים מאגר תמונות שאליו רוצים להעלות את התמונות. אם אתם יוצרים מאגר תמונות חדש באמצעות gcr.io/PROJECT_ID, ודאו שמאגר התמונות נמצא באותו פרויקט כמו האשכול.

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

5. אחרי שהאפליקציה פועלת ב-Kubernetes, כתובת IP מוצגת בחלון הפלט. כדי להשתמש בכתובת ה-IP המקושרת הזו כדי לגשת לאפליקציה, מקישים על Ctrl ולוחצים על הכתובת.

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

אם משימה מסוימת מצליחה, מופיע סימן וי check_circle לצד השלב.

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

הסרת המשאבים

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

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

כדי למחוק את האשכול:

1. לוחצים על Cloud Code ומרחיבים את הסייר Kubernetes.
2. מעבירים את מצביע העכבר מעל שם האשכול ולוחצים על open_in_new ואז על Open in Google Cloud console (פתיחה במסוף).
3. לוחצים על מחיקה ואז על מחיקה.

כדי למחוק את הפרויקט (ואת המשאבים שמשויכים אליו, כולל אשכולות):

זהירות: כשמוחקים פרויקט:

• התוכן של הפרויקט נמחק כולו. אם השתמשתם בפרויקט קיים כדי לתרגל את המשימות במדריך הזה, כשתמחקו אותו תימחק גם כל העבודה שביצעתם באותו פרויקט.
• מאבדים את מזהה הפרויקט בהתאמה אישית. כשיצרתם את הפרויקט, יכולתם לבחור לו מזהה פרויקט בהתאמה אישית כדי להשתמש בו בעתיד. כדי לשמור על כתובות ה-URL שמשתמשות במזהה הפרויקט, כמו appspot.com, צריך למחוק את המשאבים שנבחרו בפרויקט אבל לא את הפרויקט כולו.

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

1. במסוף Google Cloud , נכנסים לדף Manage resources.

   כניסה לדף Manage resources

2. ברשימת הפרויקטים, בוחרים את הפרויקט שרוצים למחוק ולוחצים על Delete.
3. כדי למחוק את הפרויקט, כותבים את מזהה הפרויקט בתיבת הדו-שיח ולוחצים על Shut down.

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

1. פותחים את לוח הפקודות (Ctrl+Shift+P).
2. מחפשים את האפשרות משימות: הפעלת משימה ובוחרים אותה, ואז בוחרים באפשרות m2c: Cleanup.