استقرار یک برنامه با Gemini CLI و مهارت‌های CI/CD

۱. مقدمه

در این آزمایشگاه کد، شما گردش کار «صفر تا صد» را برای مهندسی پلتفرم با استفاده از Gemini CLI و افزونه CI/CD تجربه خواهید کرد. شما نقش یک توسعه‌دهنده سازمانی را بر عهده خواهید گرفت که یک برنامه کاربردی (مانند نسخه آزمایشی Spring Petclinic یا یک برنامه Python Flask) ساخته است و اکنون می‌خواهد آن را در Google Cloud مستقر کند تا به اشتراک بگذارد.

به جای پیکربندی دستی خطوط لوله پیچیده، شما از زبان طبیعی برای هدایت Gemini استفاده خواهید کرد. این عامل پروژه شما را تجزیه و تحلیل می‌کند، زمان‌های اجرای هدف در مقیاس کوچک مانند Google Cloud Run را پیشنهاد می‌دهد، اسکن‌های امنیتی را برای اسرار فاش شده انجام می‌دهد و استقرار را مدیریت می‌کند و یک URL کاری در اختیار شما قرار می‌دهد.

کاری که انجام خواهید داد

  • یک مخزن را کلون کنید (می‌توانید از مخزن خودتان یا یک برنامه آزمایشی مانند Spring Petclinic استفاده کنید).
  • رابط خط فرمان Gemini و افزونه CI/CD را نصب و پیکربندی کنید.
  • از اعلانی مانند deploy my application برای فعال کردن مهارت استقرار استفاده کنید.
  • شاهد Gemini پروژه را تجزیه و تحلیل می‌کند، Cloud Run را پیشنهاد می‌دهد، بررسی‌های امنیتی را انجام می‌دهد و برنامه را مستقر می‌کند.
  • برنامه در حال اجرا را تأیید کنید.

آنچه نیاز دارید

  • یک مرورگر وب مانند کروم .
  • یک پروژه گوگل کلود با قابلیت پرداخت.

این آزمایشگاه کد برای توسعه‌دهندگان در تمام سطوح، از جمله مبتدیان، مناسب است.

۲. قبل از شروع

تنظیمات صورتحساب

یک پروژه Google Cloud ایجاد یا انتخاب کنید

ایجاد یک پروژه ابری گوگل

  1. در کنسول گوگل کلود ، در صفحه انتخاب پروژه، یک پروژه گوگل کلود را انتخاب یا ایجاد کنید .
  2. مطمئن شوید که صورتحساب برای پروژه ابری شما فعال است. یاد بگیرید که چگونه بررسی کنید که آیا صورتحساب در یک پروژه فعال است یا خیر .

شروع پوسته ابری

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

فعال کردن APIها

برای فعال کردن تمام API های مورد نیاز برای این آزمایشگاه، این دستور را در Cloud Shell اجرا کنید:

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

۳. راه‌اندازی رابط خط فرمان Gemini

در این مرحله، رابط خط فرمان Gemini و افزونه CI/CD را نصب و پیکربندی خواهید کرد.

  1. مطمئن شوید که Gemini CLI نصب شده است . اگر هنوز آن را نصب نکرده‌اید، دستورالعمل‌های موجود در راهنمای شروع به کار Gemini CLI را دنبال کنید.
  2. ورود : توصیه می‌کنیم با حساب گوگل خود وارد شوید. برای جزئیات بیشتر به راهنمای احراز هویت مراجعه کنید.
  3. افزونه CI/CD را نصب کنید : دستور زیر را برای نصب افزونه از GitHub اجرا کنید:
    gemini extensions install https://github.com/gemini-cli-extensions/cicd
    شما می‌توانید با فهرست کردن افزونه‌های نصب‌شده، نصب افزونه را تأیید کنید: 
    gemini extensions list
  4. پیکربندی اعتبارنامه‌های پیش‌فرض برنامه (ADC) : افزونه CI/CD نیاز به پیکربندی ADC دارد. دستور زیر را اجرا کنید: 
    gcloud auth login
gcloud auth application-default login
  5. تنظیم پروژه و منطقه پیش‌فرض : پیکربندی gcloud با یک پروژه پیش‌فرض و یک پروژه سهمیه‌بندی شده برای ADC مفید است. جایگزین کنید با مقادیر واقعی شما (مثلاً my-project ): 
    gcloud config set project <PROJECT_ID>
gcloud auth application-default set-quota-project <PROJECT_ID>

۴. برنامه را مستقر کنید

اکنون آماده‌اید تا از رابط خط فرمان Gemini و افزونه CI/CD برای استقرار برنامه استفاده کنید.

مخزن را کلون کنید

در این آزمایش، ما از برنامه نمونه محبوب Spring Petclinic استفاده خواهیم کرد. اگر برنامه آماده‌ای دارید که از یک runtime پشتیبانی‌شده (مانند Python/Flask، Java/Spring Boot و غیره) استفاده می‌کند، می‌توانید از آن استفاده کنید.

  1. مخزن را کلون کنید و به دایرکتوری بروید: 
    git clone https://github.com/spring-projects/spring-petclinic.git
cd spring-petclinic

Gemini را وادار به استقرار کنید

  1. رابط خط فرمان Gemini را از دایرکتوری پروژه اجرا کنید: 
    gemini
  2. وقتی وارد پوسته Gemini CLI شدید، از افزونه CI/CD برای استقرار برنامه خود استفاده کنید. می‌توانید از یک اعلان زبان طبیعی ساده استفاده کنید: 
    deploy my application

بعدش چی میشه؟

Gemini مهارت google-cicd-deploy را فعال کرده و چندین اقدام انجام می‌دهد:

  • پروژه را تجزیه و تحلیل کنید : نوع برنامه (مثلاً Spring Boot) را مشخص می‌کند.
  • پیشنهاد زمان اجرا : این گزینه یک زمان اجرای مناسب، مانند Google Cloud Run، را پیشنهاد می‌دهد.
  • اسکن امنیتی : با استفاده از ابزارهای MCP، اطلاعات محرمانه فاش شده را اسکن می‌کند. در صورت درخواست، باید به ابزارها اجازه اجرا بدهید.
  • استخراج پیکربندی : از gcloud برای خواندن محیط پروژه فعلی شما استفاده خواهد کرد.
  • پارامترهای پیشنهادی : این گزینه، پیش‌فرض‌های معقولی را برای پارامترهای استقرار ارائه می‌دهد و از شما تأیید می‌خواهد.

پیکربندی پیشنهادی را بررسی و استقرار را تأیید کنید.

پس از تکمیل، Gemini آدرس اینترنتی برنامه در حال اجرا را در اختیار شما قرار می‌دهد.

۵. تمیز کردن

برای جلوگیری از هزینه‌های مداوم برای حساب Google Cloud خود، منابع ایجاد شده در طول این codelab را حذف کنید.

اگر سرویس را روی Cloud Run مستقر کرده‌اید، می‌توانید با استفاده از دستور زیر آن را حذف کنید (replace با منطقه محاسباتی شما، مثلاً us-central1 ): 

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

از طرف دیگر، اگر یک پروژه اختصاصی برای این آزمایشگاه کد ایجاد کرده‌اید، می‌توانید کل پروژه را حذف کنید: 

gcloud projects delete <YOUR_PROJECT_ID>

۶. تبریک

تبریک! شما با موفقیت از Gemini CLI و افزونه CI/CD برای استقرار یک برنامه در Google Cloud Run با استفاده از دستورات زبان طبیعی استفاده کردید.

آنچه آموخته‌اید

  • نحوه نصب و پیکربندی رابط خط فرمان Gemini و افزونه CI/CD .
  • چگونه از زبان طبیعی برای راه‌اندازی جریان استقرار استفاده کنیم.
  • چگونه Gemini پروژه شما را تجزیه و تحلیل می‌کند، اسکن‌های امنیتی را مدیریت می‌کند و زمان‌های اجرا را پیشنهاد می‌دهد.

مراحل بعدی

اسناد مرجع