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

1. مقدمة

في هذا الدرس التطبيقي حول الترميز، ستجرّب سير عمل "من المبتدئ إلى المحترف" في هندسة المنصات باستخدام Gemini CLI وإضافة الدمج المستمر/النشر المستمر. ستتولّى دور مطوّر في مؤسسة أنشأ تطبيقًا (مثل العرض التوضيحي 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 أو اختياره

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

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

بدء Cloud Shell

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

  1. انقر على تفعيل Cloud Shell في أعلى "وحدة تحكّم Google Cloud".
  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 باستخدام مشروع تلقائي ومشروع حصة لخدمة "إعلانات Google الديناميكية". استبدِل بقيمك الفعلية (مثلاً، 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 مشروعك ويتعامل مع عمليات فحص الأمان ويقترح أوقات تشغيل

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

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