1. قبل البدء
Cloud Shell هي أداة سطر أوامر مستنِدة إلى المتصفّح تتيح لك الوصول إلى موارد Google Cloud. تسهّل Cloud Shell إدارة مشاريع Cloud Console ومواردها بدون الحاجة إلى تثبيت Cloud SDK وأدوات أخرى على نظامك.
ستستخدم Cloud Shell لإنشاء تطبيق Spring Boot وتشغيله بدون مغادرة المتصفّح. لإجراء ذلك، عليك استخدام الرمز النموذجي من إنشاء تطبيق باستخدام Spring Boot.
المتطلبات الأساسية
- معرفة بلغة البرمجة Java وأدواتها
- معرفة أدوات تحرير النصوص العادية في Linux، مثل Vim وEmacs وnano
المهام التي ستنفذها
- استخدِم Cloud Shell.
- أنشئ تطبيقًا بسيطًا باستخدام Spring Boot في Cloud Shell.
- عدِّل التطبيق باستخدام محرّر الرموز البرمجية في Cloud Shell.
- شغِّل التطبيق من Cloud Shell.
المتطلبات
- مشروع Google Cloud
- متصفّح، مثل Google Chrome
2. الإعداد والمتطلبات
إعداد البيئة بالسرعة التي تناسبك
- إذا لم يكن لديك حساب على Google، عليك إنشاء حساب. سجِّل الدخول إلى Cloud Console وأنشِئ مشروعًا جديدًا.


تذكَّر رقم تعريف المشروع، وهو اسم فريد في جميع مشاريع Google Cloud (الاسم الوارد في الصورة مستخدَم حاليًا ولن يكون متاحًا لك، نأسف لذلك). سيتم الإشارة إليه لاحقًا في الدرس التطبيقي حول الترميز باسم PROJECT_ID.
- بعد ذلك، عليك تفعيل الفوترة في Cloud Console لاستخدام موارد Google Cloud. لن تكلفك تجربة هذا الدرس البرمجي أكثر من بضعة دولارات، ولكن قد تكون التكلفة أعلى إذا قررت استخدام المزيد من الموارد أو إذا تركتها قيد التشغيل.
يمكن لمستخدمي Google Cloud الجدد الاستفادة من فترة تجريبية مجانية بقيمة 300 دولار أمريكي.
Cloud Shell
يتم تحميل هذا الجهاز الظاهري المستند إلى Debian بجميع أدوات التطوير التي تحتاج إليها. توفّر هذه الخدمة دليلًا منزليًا دائمًا بسعة 5 غيغابايت وتعمل في Google Cloud، ما يؤدي إلى تحسين أداء الشبكة والمصادقة بشكل كبير. يعني ذلك أنّ كل ما تحتاج إليه لهذا الدرس التطبيقي حول الترميز هو متصفّح (نعم، يمكن استخدامه على جهاز Chromebook).
- لتفعيل Cloud Shell من Cloud Console، ما عليك سوى النقر على تفعيل Cloud Shell
(يستغرق توفير البيئة والاتصال بها بضع لحظات فقط).


بعد الاتصال بـ Cloud Shell، من المفترض أن يظهر لك أنّه تم إثبات هويتك وأنّ المشروع تم ضبطه على PROJECT_ID.
gcloud auth list
ناتج الأمر
Credentialed accounts: - <myaccount>@<mydomain>.com (active)
gcloud config list project
ناتج الأمر
[core] project = <PROJECT_ID>
إذا لم يتم ضبط المشروع لسبب ما، ما عليك سوى تنفيذ الأمر التالي:
gcloud config set project <PROJECT_ID>
هل تبحث عن PROJECT_ID؟ يمكنك الاطّلاع على المعرّف الذي استخدمته في خطوات الإعداد أو البحث عنه في لوحة بيانات Cloud Console:

يضبط Cloud Shell أيضًا بعض متغيرات البيئة تلقائيًا، ما قد يكون مفيدًا عند تنفيذ الأوامر المستقبلية.
echo $GOOGLE_CLOUD_PROJECT
ناتج الأمر
<PROJECT_ID>
- أخيرًا، اضبط المنطقة التلقائية وإعدادات المشروع.
gcloud config set compute/zone us-central1-f
يمكنك اختيار مجموعة متنوعة من المناطق المختلفة. لمزيد من المعلومات، يُرجى الاطّلاع على المناطق والأقاليم.
3- بدء تطبيق Spring Boot جديد
بعد تثبيت أداة سطر الأوامر Spring Boot، يمكنك تهيئة تطبيق ويب جديد "Hello, World" وإعداده.
$ curl https://start.spring.io/starter.tgz \ -d dependencies=web \ -d type=maven-project \ -d baseDir=helloworld | tar -xzvf -
سيؤدي ذلك إلى إنشاء دليل جديد يتضمّن مشروع Maven جديدًا، بالإضافة إلى pom.xml من Maven، وبرنامج تضمين Maven، ونقطة دخول التطبيق.
4. إنشاء خدمة RESTful جديدة باستخدام أداة تعديل الرموز
- افتح أداة تعديل الرموز من خلال النقر على فتح أداة التعديل
في قائمة Cloud Shell. - بعد فتح المحرِّر، ابحث عن الملف
helloworld/src/main/java/com/example/demo/DemoApplication.java.

- بعد فتح الرمز، أنشئ وحدة تحكّم RESTful جديدة للردّ على
Hello. في ملفDemoApplication.java، أضِف تعريف فئةHelloworldجديدًا بالإضافة إلى التعريف الحالي.
src/main/java/com/example/demo/DemoApplication.java
package com.example;
...
// Add the import
import org.springframework.web.bind.annotation.*;
@SpringBootApplication
public class DemoApplication {
...
}
// Add the controller
@RestController
class Helloworld {
@GetMapping("/")
public String greet() {
return "Hello!";
}
}
- احفظ الملف.
5- تشغيل التطبيق محليًا
- افتح نافذة طرفية في محرّر الرموز من خلال النقر على
Terminalثم علىNew Terminalمن قائمة المحرّر. - تأكَّد من ضبط
JAVA_HOMEعلى إصدار JDK الصحيح:
$ export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64/
- يمكنك بدء تطبيق Spring Boot بشكل عادي باستخدام مكوّن Spring Boot الإضافي.
$ cd $HOME/helloworld $ ./mvnw -DskipTests spring-boot:run

- بعد بدء تشغيل التطبيق، انقر على معاينة الويب
في شريط أدوات Cloud Shell، ثم انقر على معاينة على المنفذ 8080.

سيتم فتح علامة تبويب في المتصفّح والاتصال بالخادم الذي بدأته.

6. تهانينا
تعرّفت على كيفية إنشاء تطبيق ويب جديد باستخدام Spring Boot ولغة Java وتشغيله مباشرةً من Cloud Shell.