نشر تطبيق باستخدام Gemini CLI ومهارات CI/CD

1- مقدمة

في هذا الدرس التطبيقي حول الترميز، ستتعرّف على تجربة سير عمل "من البداية إلى الاحتراف" لهندسة المنصات باستخدام Gemini CLI وإضافة التكامل المستمر/التسليم المستمر (CI/CD). ستتولّى دور مطوّر برامج في مؤسسة أنشأ تطبيقًا (مثل العرض التوضيحي Spring Petclinic أو تطبيق Python Flask) ويريد الآن نشره على Google Cloud لمشاركته.

بدلاً من ضبط مسارات معقّدة يدويًا، ستستخدم اللغة الطبيعية لتوجيه Gemini. سيحلّل الوكيل مشروعك ويقترح أوقات تشغيل مستهدَفة صغيرة النطاق، مثل Google Cloud Run، ويُجري عمليات فحص أمني بحثًا عن الأسرار التي تم تسريبها، ويتولّى عملية النشر، ويقدّم لك عنوان URL صالحًا.

الإجراءات التي ستنفذّها

  • إنشاء نسخة طبق الأصل من مستودع (يمكنك استخدام مستودعك الخاص أو تطبيق تجريبي مثل Spring Petclinic)
  • تثبيت Gemini CLI وإضافة التكامل المستمر/التسليم المستمر (CI/CD) وضبطهما
  • استخدام طلب مثل deploy my application لتفعيل مهارة النشر
  • مراقبة Gemini أثناء تحليل المشروع واقتراح Cloud Run وإجراء عمليات الفحص الأمني ونشر التطبيق
  • التأكّد من تشغيل التطبيق

المتطلبات

  • متصفّح ويب مثل Chrome.
  • مشروع على Google Cloud مفعَّلة فيه الفوترة

هذا الدرس التطبيقي حول الترميز مخصّص للمطوّرين من جميع المستويات، بما في ذلك المبتدئون.

2. قبل البدء

إعداد الفوترة

إنشاء مشروع على السحابة الإلكترونية أو اختياره

إنشاء مشروع على Google Cloud

  1. في Google Cloud Console، في صفحة اختيار المشروع، اختَر مشروعًا على السحابة الإلكترونية أو أنشِئه.
  2. تأكَّد من تفعيل الفوترة لمشروعك على السحابة الإلكترونية. كيفية التحقّق مما إذا كانت الفوترة مفعَّلة في مشروع.

بدء Cloud Shell

Cloud Shell هي بيئة سطر أوامر تعمل على Google Cloud ومحمّلة مسبقًا بالأدوات اللازمة.

  1. انقر على تفعيل Cloud Shell في أعلى Google Cloud Console.
  2. بعد الاتصال بـ Cloud Shell، تحقَّق من مصادقتك:
    gcloud auth list
  3. تأكَّد من ضبط مشروعك:
    gcloud config get project
  4. إذا لم يتم ضبط مشروعك على النحو المتوقّع، اضبطه:
    export PROJECT_ID=<YOUR_PROJECT_ID>
gcloud config set project $PROJECT_ID

تفعيل واجهات برمجة التطبيقات

شغِّل هذا الأمر في Cloud Shell لتفعيل جميع واجهات برمجة التطبيقات المطلوبة لهذا المختبر:

gcloud services enable \
  cloudbuild.googleapis.com \
  run.googleapis.com \
  artifactregistry.googleapis.com

3. إعداد Gemini CLI

في هذه الخطوة، ستثبِّت Gemini CLI وإضافة التكامل المستمر/التسليم المستمر (CI/CD) وتضبطهما.

  1. تأكَّد من تثبيت Gemini CLI. إذا لم يسبق لك تثبيته، اتّبِع التعليمات الواردة في دليل البدء في Gemini CLI.
  2. سجِّل الدخول: ننصحك بتسجيل الدخول باستخدام حسابك على Google. راجِع دليل المصادقة للاطّلاع على التفاصيل.
  3. ثبِّت إضافة التكامل المستمر/التسليم المستمر (CI/CD): شغِّل الأمر التالي لتثبيت الإضافة من GitHub:
    gemini extensions install https://github.com/gemini-cli-extensions/cicd
    يمكنك التحقّق من تثبيت الإضافة من خلال إدراج الإضافات المثبَّتة:
    gemini extensions list
  4. اضبط بيانات الاعتماد التلقائية للتطبيق (ADC): تتطلّب إضافة التكامل المستمر/التسليم المستمر (CI/CD) ضبط بيانات الاعتماد التلقائية للتطبيق. شغِّل:
    gcloud auth login
gcloud auth application-default login
  5. اضبط المشروع والمنطقة التلقائيَين: من المفيد ضبط gcloud باستخدام مشروع تلقائي ومشروع حصة لبيانات الاعتماد التلقائية للتطبيق. استبدِل بالقيم الفعلية (مثل my-project):
    gcloud config set project <PROJECT_ID>
gcloud auth application-default set-quota-project <PROJECT_ID>

4. نشر التطبيق

أنت الآن مستعدّ لاستخدام Gemini CLI وإضافة التكامل المستمر/التسليم المستمر (CI/CD) لنشر التطبيق.

إنشاء نسخة طبق الأصل من المستودع

في هذا المختبر، سنستخدم التطبيق النموذجي الشائع Spring Petclinic. يمكنك أيضًا استخدام تطبيقك الخاص إذا كان لديك تطبيق جاهز يستخدم وقت تشغيل متوافقًا (مثل Python/Flask أو Java/Spring Boot أو غير ذلك).

  1. أنشِئ نسخة طبق الأصل من المستودع وانتقِل إلى الدليل: 
    git clone https://github.com/spring-projects/spring-petclinic.git
cd spring-petclinic

اطلب من Gemini نشر التطبيق

  1. شغِّل Gemini CLI من دليل المشروع:
    gemini
  2. بعد الدخول إلى واجهة Gemini CLI، استخدِم إضافة التكامل المستمر/التسليم المستمر (CI/CD) لنشر تطبيقك. يمكنك استخدام طلب بسيط بلغة طبيعية:
    deploy my application

الإجراءات التالية

سيفعِّل Gemini مهارة google-cicd-deploy وينفّذ عدة إجراءات:

  • تحليل المشروع: سيحدّد نوع التطبيق (مثل Spring Boot)
  • اقتراح وقت التشغيل: سيقترح وقت تشغيل مناسبًا، مثل Google Cloud Run.
  • الفحص الأمني: سيُجري فحصًا بحثًا عن الأسرار التي تم تسريبها باستخدام أدوات MCP. عليك السماح بتشغيل الأدوات إذا طُلب منك ذلك.
  • استخراج الإعدادات: سيستخدم gcloud لقراءة بيئة مشروعك الحالية.
  • اقتراح المَعلمات: سيقدّم قيمًا تلقائية مناسبة لمَعلمات النشر ويطلب منك تأكيدها.

راجِع الإعدادات المقترَحة وأكِّد عملية النشر.

بعد اكتمال العملية، سيقدّم لك Gemini عنوان URL لتطبيقك قيد التشغيل.

5- تَنظيم

لتجنُّب فرض رسوم مستمرة على حسابك على Google Cloud، احذف الموارد التي تم إنشاؤها خلال هذا الدرس التطبيقي حول الترميز.

إذا نشرت على Cloud Run، يمكنك حذف الخدمة باستخدام الأمر التالي (استبدِل بمنطقة الحوسبة، مثلاً us-central1):

gcloud run services delete spring-petclinic --region <REGION>

بدلاً من ذلك، إذا أنشأت مشروعًا مخصّصًا لهذا الدرس التطبيقي حول الترميز، يمكنك حذف المشروع بأكمله:

gcloud projects delete <YOUR_PROJECT_ID>

6. تهانينا

تهانينا! لقد استخدمت بنجاح Gemini CLI وإضافة التكامل المستمر/التسليم المستمر (CI/CD) لنشر تطبيق على Google Cloud Run باستخدام طلبات باللغة الطبيعية.

ما الذي تعلّمته

  • كيفية تثبيت Gemini CLI وإضافة التكامل المستمر/التسليم المستمر (CI/CD) وضبطهما
  • كيفية استخدام اللغة الطبيعية لتفعيل سير عمل النشر
  • كيفية تحليل Gemini لمشروعك، والتعامل مع عمليات الفحص الأمني، واقتراح أوقات التشغيل

الخطوات التالية

مستندات مرجعية