تثبيت الإصدار التجريبي من ABAP Platform لعام 2022 على Google Cloud Platform وتثبيت حزمة تطوير البرامج (SDK) ABAP

1. مقدمة

في هذا الدرس التطبيقي، أدرجنا خطوات تثبيت الإصدار التجريبي من منصة ABAP لعام 2022 على Google Cloud، ثم تثبيت حزمة تطوير البرامج (SDK) لمنصة ABAP على Google Cloud.

نستخدم النصوص البرمجية المستضافة في مستودع GitHub هذا. يحتوي ملف README في المستودع على مستندات تفصيلية حول وظائف النص البرمجي.

يتم استخدام خدمات Google Cloud التالية في هذا الدرس العملي:

• Compute Engine
• خدمات الشبكة
• Cloud Shell

ما ستنشئه

ستنشئ ما يلي باستخدام النص البرمجي:

• آلة افتراضية على Compute Engine تعمل عليها نسخة تجريبية من منصة ABAP لعام 2022 في حاوية Docker
• قواعد جدار الحماية
• حساب الخدمة للوصول إلى واجهات برمجة تطبيقات Google Cloud باستخدام حزمة تطوير البرامج (SDK) للغة ABAP في 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، انقر على تفعيل 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.
• اسحب حاوية ABAP Platform Trial 2022 docker وابدأ تشغيلها.
• فعِّل خدمة بيانات اعتماد حساب الخدمة في "إدارة الهوية وإمكانية الوصول" وخدمة التحقّق من صحة العناوين، وهما الخدمتان اللتان نستخدمهما لتقييم حزمة تطوير البرامج (SDK) ABAP في دروس الترميز التطبيقية اللاحقة.
• أنشئ حساب خدمة [e-mail],سيتم استخدامه من قِبل حزمة تطوير البرامج (SDK) للغة ABAP.

ملاحظة: سيوافق النص البرمجي تلقائيًا على بنود ترخيص 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. انتظِر إلى أن تظهر رسالة التأكيد أدناه في ملف الإخراج بأنّ حاوية SAP Docker قيد التشغيل.

يمكنك أيضًا تنفيذ الأمر التالي للتحقّق مما إذا كان الحاوي قيد التشغيل:

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. الحصول على مفتاح الأجهزة من رمز المعاملة: SLICENSE

3. أنشئ مفتاح ترخيص جديدًا من الموقع الإلكتروني SAP License Keys for Preview, Evaluation and Developer Versions. انقر على رمز النظام A4H، وعدِّل البيانات الشخصية ومعلومات النظام باستخدام مفتاح الجهاز، ثم وافِق على الترخيص. انقر على الزر إنشاء لإنشاء ملف مفتاح الترخيص A4H_Multiple.txt

4. ثبِّت مفتاح الترخيص الجديد باستخدام رمز المعاملة: SLICENSE

• انتقِل إلى رمز المعاملة: SLICENSE، وانقر على الزر تثبيت، ثم اختَر مستند النص الذي تم تنزيله A4H_Multiple.txt. سيتم تمديد النظام لمدة 3 أشهر أخرى.

8. تفعيل إعدادات نظام إدارة النقل

لاستيراد عمليات النقل إلى النظام، يجب تفعيل إعدادات نظام إدارة النقل (TMS).

1. سجِّل الدخول إلى النظام باستخدام اسم المستخدم DEVELOPER وكلمة المرور ABAPtr2022#00.
2. انتقِل إلى رمز المعاملة STMS > نظرة عامة > عمليات الاستيراد.

3. اختَر البيئة > نظرة عامة على النظام.

4. انقر على الإضافات > توزيع إعدادات التفعيل.

5. انتقِل إلى رمز المعاملة STMS_IMPORT، حيث من المفترض أن تظهر لك الشاشة التالية:

أصبح نظام SAP الآن جاهزًا لاستيراد أي عمليات نقل.

9- ضبط شهادة الثقة

للاتصال بشكل آمن بواجهات Google APIs باستخدام حزمة تطوير البرامج (SDK) ABAP، يجب توفُّر شهادات موثوقة.

1. نزِّل الشهادات التالية من مستودع Google Trust Services إلى الكمبيوتر المكتبي:

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

2. في واجهة مستخدم SAP الرسومية، استخدِم المعاملة STRUST لاستيراد كل من شهادة الجذر والشهادة الفرعية إلى مجلد PSE الخاص ببروتوكول SSL (المعياري) لعميل SSL.
3. في STRUST، اختَر العقدة SSL client SSL Client (Standard) وانقر على Import certificate (استيراد الشهادة) لتحميل كلا الملفين، ثم انقر على Add to Certificate List (الإضافة إلى قائمة الشهادات) وSave (حفظ).

10. استيراد أحدث إصدار من حزمة تطوير البرامج (SDK) للغة ABAP على Google Cloud

تتوفّر ملفات النقل الخاصة بحزمة تطوير البرامج (SDK) ABAP لخدمة Google Cloud على الرابط هذا. لتسريع العملية، سننفّذ عملية الاستيراد باستخدام نص برمجي.

1. من Cloud Shell، استخدِم بروتوكول النقل الآمن (SSH) للوصول إلى الجهاز الافتراضي (VM) لحاوية 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. تم الآن تثبيت حزمة تطوير البرامج (SDK) للغة ABAP.

11. كتابة نموذج برنامج ABAP باستخدام حزمة تطوير البرامج (SDK) ABAP

لنكتب نموذجًا لبرنامج ABAP لاستخدام خدمة "التحقّق من صحة العنوان" لتصحيح عنوان. يُرجى اتّباع الدرس التطبيقي حول الترميز: ضبط مصادقة حزمة تطوير البرامج (SDK) ABAP باستخدام الرموز المميزة لنظام SAP المستضاف على جهاز Compute Engine الظاهري

12. تهانينا

تهانينا! لقد ثبّتَ الإصدار التجريبي من منصة ABAP لعام 2022 بنجاح على Google Cloud Platform واستوردت عمليات النقل لحزمة تطوير البرامج (SDK) لمنصة ABAP على Google Cloud.

سيتيح لك نظام SAP التجريبي التعرّف أكثر على حزمة تطوير البرامج (SDK) ABAP.

يمكنك الآن الانتقال إلى دروس ABAP SDK التطبيقية الأخرى لمواصلة رحلتك التعليمية حول استخدام حزمة تطوير البرامج (SDK) ABAP لخدمة Google Cloud من أجل الوصول إلى خدمات Google Cloud المختلفة.

13. تَنظيم

إذا كنت لا تريد مواصلة استخدام دروس البرمجة الإضافية المتعلّقة بحزمة تطوير البرامج (SDK) للغة ABAP على 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]