התקנה של תקופת הניסיון של פלטפורמת ABAP לשנת 2022 ב-Google Cloud Platform והתקנת ABAP SDK

1. מבוא

ב-codelab הזה מפורטים השלבים להתקנה של ABAP Platform Trial 2022 ב-Google Cloud, ולאחר מכן להתקנה של ABAP SDK for Google Cloud.

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

בסדנת הקוד הזו נעשה שימוש בשירותי Google Cloud הבאים:

• Compute Engine
• Network Services
• Cloud Shell

מה תפַתחו

הסקריפט ייצור את הפריטים הבאים:

• מכונה של Compute Engine עם ABAP Platform Trial 2022 שפועלת בקונטיינר Docker.
• כללי חומת אש.
• חשבון שירות לגישה ל-Google Cloud APIs באמצעות ABAP SDK for Google Cloud.

2. דרישות

• דפדפן, כמו Chrome או Firefox.
• פרויקט ב-Google Cloud עם חיוב מופעל או יצירת חשבון לניסיון חינם למשך 90 יום ב-Google Cloud Platform.
• ‫SAP GUI (Windows או Java) מותקן במערכת. אם SAP GUI כבר מותקן במחשב הנייד, מתחברים ל-SAP באמצעות כתובת ה-IP החיצונית של המכונה הווירטואלית ככתובת ה-IP של שרת האפליקציות. אם אתם משתמשים ב-Mac, אתם יכולים גם להתקין את SAP GUI for Java שזמין בקישור הזה.

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

1. ב-Google Cloud Console, בדף לבחירת הפרויקט, בוחרים או יוצרים פרויקט ב-Google Cloud (לדוגמה: abap-sdk-poc).
2. הקפידו לוודא שהחיוב מופעל בפרויקט שלכם ב-Cloud. כך בודקים אם החיוב מופעל בפרויקט אפשר לדלג על השלב הזה אם אתם משתמשים בחשבון עם תקופת ניסיון בחינם ל-90 יום.
3. תשתמשו ב-Cloud Shell, סביבת שורת פקודה שפועלת ב-Google Cloud.
4. בפינה הימנית העליונה של Cloud Console, לוחצים על Activate Cloud Shell:

5. מריצים את הפקודות הבאות כדי לבצע אימות לחשבון ולהגדיר את פרויקט ברירת המחדל ל-abap-sdk-poc. התחום us-west4-b משמש כדוגמה. אם צריך, משנים את הפרויקט ואת האזור בפקודות הבאות בהתאם להעדפות. הפרמטרים האלה משמשים את סקריפט ההתקנה.

gcloud auth login
gcloud config set project abap-sdk-poc
gcloud config set compute/zone us-west4-b

4. הפעלת סקריפט היצירה

• מריצים את הפקודה הבאה כדי להפעיל את הסקריפט create_vm_withdocker.sh.

mkdir sap-docker-2022
cd sap-docker-2022
git clone https://github.com/google-cloud-abap/abap-cloud-trial-2022-gcp.git
cd abap-cloud-trial-2022-gcp
chmod 755 create_vm_with_docker.sh
./create_vm_with_docker.sh

הסקריפט יבצע את הפעולות הבאות:

• יצירת מכונה וירטואלית (שם: abap-trial-docker, הגדרה: n2-highmem-4, מערכת הפעלה ודיסק: debian-12-bookworm-v20240815, 200gb).
• מתקינים את הגרסה האחרונה של Docker Engine.
• משיכת קונטיינר של docker והפעלתו בגרסת הניסיון של ABAP Platform 2022.
• מפעילים את IAM Service Account Credentials Service ואת Address Validation Service, שבהם נשתמש כדי להעריך את ABAP SDK במעבדות הקוד הבאות.
• יוצרים חשבון שירות [e-mail],שישמש את ABAP SDK.

הערה: התסריט יאשר אוטומטית את התנאים של רישיון SAP בשם המשתמש שמריץ אותו באמצעות הדגל –

agree-to-sap-license. (פרטים נוספים על הרישיון מופיעים בקטע הרישיון בדף docker hub)

5. מעקב אחרי ההתקנה

יצירת המכונה הווירטואלית תימשך כמה דקות, אבל התקנת מאגר SAP Docker תימשך כ-15 דקות.

כדי לעקוב אחרי תהליך ההתקנה:

1. אחרי שיוצרים את המכונה הווירטואלית, משתמשים באחת מהשיטות הבאות כדי להתחבר למערכת באמצעות SSH:

• לוחצים על הלחצן SSH ב-Cloud Console.

• מריצים את הפקודה הבאה במסוף Cloud Shell:

gcloud compute ssh "abap-trial-docker-2022"

2. סקריפט ההתקנה יוצר קובץ פלט /tmp/output.txt. כדי לעקוב אחרי תהליך ההתקנה, מריצים את הפקודה tail עם הקובץ הזה.

tail -f /tmp/output.txt

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

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

sudo docker ps

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

6. בדיקת החיבור למערכת SAP

עכשיו אפשר להתחבר למערכת SAP.

• מריצים את הפקודה הבאה כדי לקבל את כתובת ה-IP החיצונית של ה-VM או בודקים במסוף Google Cloud.

gcloud compute instances describe abap-trial-docker  \
--format='get(networkInterfaces[0].accessConfigs[0].natIP)'

כדי להתחבר מ-SAP GUI, צריך להשתמש במידע הבא:

• מזהה המערכת: A4H
• מספר המופע: 00
• שרת האפליקציה: <כתובת IP חיצונית>

שם המשתמש הוא DEVELOPER והסיסמה היא ABAPtr2022#00. הסיסמה מוגדרת מראש (אותה סיסמה) גם עבור לקוח 000, לקוח 001: SAP*, DDIC. פרטים נוספים זמינים כאן.

7. חידוש רישיון הניסיון של SAP

כדי לחדש את רישיון הניסיון של SAP, מבצעים את השלבים הבאים:

1. מתחברים למערכת באמצעות פרטי הכניסה הבאים:

לקוח:	001
מזהה משתמש:	SAP*
סיסמה:	ABAPtr2022#00

2. מקבלים את מפתח החומרה מ-Tcode: SLICENSE

3. יוצרים מפתח רישיון חדש באתר SAP License Keys for Preview, Evaluation and Developer Versions (מפתחות רישיון של SAP לגרסאות תצוגה מקדימה, הערכה ומפתחים). בוחרים את המערכת A4H, מעדכנים את הפרטים האישיים, את פרטי המערכת עם מפתח החומרה ומאשרים את הרישיון. לוחצים על הלחצן Generate (יצירה) כדי ליצור את קובץ מפתח הרישיון A4H_Multiple.txt

4. מתקינים את מפתח הרישיון החדש באמצעות Tcode: ‏ SLICENSE

• עוברים אל Tcode: SLICENSE, לוחצים על הלחצן Install (התקנה) ובוחרים את מסמך הטקסט שהורד A4H_Multiple.txt. המערכת תאריך את המינוי ב-3 חודשים נוספים.

8. הפעלת ההגדרה של TMS

כדי לייבא העברות למערכת, צריך להפעיל את ההגדרה של TMS.

1. מתחברים למערכת באמצעות שם המשתמש DEVELOPER עם הסיסמה ABAPtr2022#00.
2. עוברים אל TCode‏ STMS > סקירה כללית > ייבואים.

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

4. בוחרים באפשרות תוספים > הפצה והפעלה של ההגדרה.

5. עוברים אל TCode‏ STMS_IMPORT, שבו אמור להופיע המסך הבא:

עכשיו מערכת SAP מוכנה לייבא כל העברה.

9. הגדרת אישור מהימן

כדי להתחבר בצורה מאובטחת ל-Google APIs באמצעות ABAP SDK, נדרשים אישורי אמון.

1. מורידים את האישורים הבאים ממאגר Google Trust Services לשולחן העבודה:

• GTS Root R1 (PEM)
• GTS CA 1C3 (PEM)

2. ב-SAP GUI, משתמשים בעסקה STRUST כדי לייבא את אישור הבסיס ואת אישור המשנה לתיקיית ה-PSE של לקוח ה-SSL (Standard).
3. ב-STRUST, בוחרים בצומת SSL client SSL Client (Standard) (לקוח SSL לקוח SSL (רגיל)) ולוחצים על Import certificate (ייבוא אישור) כדי להעלות את שני הקבצים, לוחצים על Add to Certificate List (הוספה לרשימת האישורים) ועל Save (שמירה).

10. ייבוא הגרסה העדכנית של ABAP SDK for Google Cloud

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

1. מ-Cloud Shell, מתחברים ב-SSH למכונה הווירטואלית של SAP Docker:

gcloud compute ssh "abap-trial-docker-2022"

2. מורידים ומריצים את סקריפט ההעברה לייבוא:

wget https://raw.githubusercontent.com/google-cloud-abap/abap-cloud-trial-2022-gcp/main/import_abap_sdk.sh
chmod 755 import_abap_sdk.sh
./import_abap_sdk.sh

3. בסיום התהליך, בודקים אם החבילה /GOOG/ABAP_SDK נמצאת ב-SE80. עכשיו ה-ABAP SDK מותקן.

11. כתיבת תוכנית ABAP לדוגמה באמצעות ABAP SDK

נכתוב תוכנית ABAP לדוגמה כדי להשתמש בשירות לאימות כתובות ולתקן כתובת. צריך לפעול לפי ה-codelab‏ – Configure ABAP SDK authentication using tokens for SAP hosted on Compute Engine VM (הגדרת אימות של ABAP SDK באמצעות טוקנים עבור SAP שמתארח במכונה וירטואלית של Compute Engine)

12. מזל טוב

מעולה! התקנת בהצלחה את ABAP Platform Trial 2022 ב-Google Cloud Platform וייבאת את ההעברות עבור ABAP SDK ל-Google Cloud.

מערכת הניסיון של SAP תאפשר לכם לקבל מידע נוסף על ABAP SDK.

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

13. הסרת המשאבים

אם לא רוצים להמשיך עם ה-codelab הנוסף שקשור ל-ABAP SDK ל-Google Cloud, צריך להמשיך לניקוי.

מחיקת הפרויקט

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

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

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

• מחיקת הפרויקט ב-Google Cloud:

gcloud projects delete abap-sdk-poc

מחיקת משאבים ספציפיים

1. מוחקים את מכונת החישוב:

gcloud compute instances delete abap-trial-docker

2. מוחקים את הכללים של חומת האש:

gcloud compute firewall-rules delete sapmachine

3. מוחקים את חשבון השירות:

gcloud iam service-accounts delete \
    [e-mail]