עיצוב ופריסה של אפליקציה באמצעות Antigravity CLI

השרתים של Gemini Cloud Assist ו-Application Design Center Model Context Protocol‏ (MCP) מאפשרים לכם לתכנן, לפרוס ולפתור בעיות בתשתית שלGoogle Cloud ישירות ב-Antigravity CLI. אחרי שמחברים את שרתי ה-MCP ומתקינים את קובצי המיומנויות של הסוכן, אפשר ליצור תשתית לקוד האפליקציה. אתם יכולים גם להעריך את התאימות לתקני אבטחה ולפתור בעיות בפריסה באמצעות הנחיות בשפה טבעית.

מטרות

במדריך הזה מוסבר איך:

  • מגדירים את Antigravity CLI כך שישתמש בשרתי MCP של Gemini Cloud Assist ו-App Design Center.
  • תכנון ופריסה של תשתית Google Cloud שעברה אופטימיזציה להרצת קוד האפליקציה הקיים.
  • לנתח ולפתור בעיות טכניות.

עלויות

במסמך הזה משתמשים ברכיבים הבאים של Google Cloud, והשימוש בהם כרוך בתשלום:

  • App Design Center.
  • Google Cloud resources that you create as part of your application infrastructure.

בעזרת מחשבון העלויות אתם יכולים להעריך את העלויות בהתאם לשימוש הצפוי.

משתמשים חדשים של Google Cloud ? יכול להיות שאתם זכאים לתקופת ניסיון בחינם.

כשמסיימים את המשימות שמתוארות במסמך הזה אפשר למחוק את המשאבים שיצרתם כדי להימנע מחיובים נוספים. מידע נוסף זמין בקטע הסרת המשאבים.

לפני שמתחילים

  1. התקינו את ה-CLI של Google Cloud.

  2. הגדירו שה-CLI של gcloud ישתמש בזהות המאוחדת שלכם.

    איך נכנסים ל-CLI של gcloud באמצעות הזהות המאוחדת?

  3. כדי לאתחל את ה-CLI של gcloud, הריצו את הפקודה הבאה: 

    gcloud init

  4. יוצרים או בוחרים פרויקט ב- Google Cloud .

    התפקידים שנדרשים כדי לבחור או ליצור פרויקט

    • בחירת פרויקט: כדי לבחור פרויקט לא נדרש תפקיד IAM ספציפי – אתם יכולים לבחור כל פרויקט שקיבלתם בו תפקיד.
    • יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד "יצירת פרויקטים" (roles/resourcemanager.projectCreator), שכולל את ההרשאה resourcemanager.projects.create. איך מקצים תפקידים?

    • יוצרים פרויקט ב- Google Cloud :

      gcloud projects create PROJECT_ID

      מחליפים את PROJECT_ID בשם של הפרויקט ב- Google Cloud שאתם יוצרים.

    • בוחרים את הפרויקט שיצרתם ב- Google Cloud :

      gcloud config set project PROJECT_ID

      מחליפים את PROJECT_ID בשם הפרויקט ב- Google Cloud .

  5. מוודאים שהחיוב מופעל בפרויקט ב- Google Cloud .

  6. כדי לגשת ל-Gemini Cloud Assist דרך MCP, אתם צריכים להיות בתוכנית Trusted Tester. כדי לבקש גישה, פנו לצוות ניהול החשבון.
  7. מתקינים את Antigravity CLI.
  8. כדי לפרוס ולהריץ פקודות של Antigravity CLI, בקשו מהאדמין להקצות לכם את התפקידים הנדרשים בגבולות הפרויקט, כמו שמפורט בטבלה הבאה:
    משימה התפקידים הנדרשים
    הגדרת App Design Center בפרויקט אדמין ב-Application Design Center‏ (roles/designcenter.admin)
    איך ניגשים ל-Gemini Cloud Assist וקוראים לו באמצעות MCP ‫Gemini Cloud Assist Admin‏ (roles/geminicloudassist.admin), או
    Gemini Cloud Assist Editor‏ (roles/geminicloudassist.editor), או
    Gemini Cloud Assist User‏ (roles/geminicloudassist.user)

הכנת הסביבה

כדי להכין את הסביבה, מבצעים אימות ב- Google Cloud ומפעילים את השירותים הנדרשים.

אימות ב- Google Cloud

מבצעים אימות ב- Google Cloud באמצעות הפקודה הבאה במסוף:

  1. מגדירים את Application Default Credentials כדי לאפשר לשרתי ה-MCP לשלוח קריאות ל-API.

     gcloud auth application-default login

הפעלת ממשקי ה-API

מפעילים בפרויקט את השירותים Gemini Cloud Assist ו-Application Design Center.

  1. מפעילים את שירות Gemini Cloud Assist בפרויקט:

     gcloud services enable geminicloudassist.googleapis.com

  2. מפעילים את שירות App Design Center בפרויקט:

     gcloud services enable designcenter.googleapis.com

הגדרת שרתי ה-MCP

שרתי ה-MCP של Gemini Cloud Assist ו-App Design Center עוזרים לכם לתכנן, להעריך, לפרוס ולפתור בעיות בתשתית של Google Cloudבאמצעות הנחיות בשפה טבעית. כדי להתחבר לשרתי ה-MCP, צריך לקבוע את ההגדרות של Antigravity.

כדי להגדיר את Antigravity CLI לשימוש בשרתי MCP:

  1. פותחים את קובץ התצורה של MCP באחד מהמיקומים הבאים:

    • היקף המשתמש: כדי להחיל את ההגדרות על כל הפרויקטים ב-Antigravity CLI, פותחים את ~/.gemini/config/mcp_config.json.
    • היקף סביבת העבודה: כדי להחיל הגדרות על פרויקט ספציפי ב-Antigravity CLI, פותחים את .agents/mcp_config.json.

    אם קובץ התצורה לא קיים, יוצרים קובץ חדש.

  2. בקובץ mcp_config.json, מוסיפים או ממזגים את בלוק ההגדרות הבא מתחת למפתח mcpServers.

      {
    "mcpServers": {
      "gemini-cloud-assist": {
        "serverUrl": "https://geminicloudassist.googleapis.com/mcp",
        "authProviderType": "google_credentials"
      },
      "application-design-center": {
        "serverUrl": "https://designcenter.googleapis.com/mcp",
        "authProviderType": "google_credentials"
      }
    }
  }

    ההגדרה הזו משתמשת באופן אוטומטי ב-Application Default Credentials.

  3. שומרים וסוגרים את קובץ התצורה.

  4. מפעילים את Antigravity CLI.

    agy

  5. מוודאים ששרתי ה-MCP מחוברים.

    /mcp list

התקנת SKILL.md קבצים

קובצי SKILL.md מספקים לשרתי ה-MCP של App Design Center ו-Gemini Cloud Assist הוראות ותהליכי עבודה לתכנון, לפריסה ולפתרון בעיות בתשתית.

כדי להוסיף קובצי SKILL.md ל-Antigravity CLI:

  1. יוצרים ספריית skills/design-and-deploy באחד מהמיקומים הבאים:

    • היקף המשתמש: כדי להחיל את ההגדרות על כל הפרויקטים ב-Antigravity CLI, יוצרים את ~/.gemini/config/skills/design-and-deploy/.
    • היקף סביבת העבודה: כדי להחיל הגדרות על פרויקט ספציפי ב-Antigravity CLI, יוצרים את .agents/skills/design-and-deploy/.

  2. בספרייה skills/design-and-deploy/, יוצרים קובץ SKILL.md באמצעות התוכן מ-designing-and-deploying-infrastructure.

  3. יוצרים ספריית skills/google-gemini-cloud-assist באחד מהמיקומים הבאים:

    • היקף המשתמש: כדי להחיל את ההגדרות על כל הפרויקטים ב-Antigravity CLI, יוצרים את ~/.gemini/config/skills/google-gemini-cloud-assist/.
    • היקף סביבת העבודה: כדי להחיל הגדרות על פרויקט ספציפי ב-Antigravity CLI, יוצרים את .agents/skills/google-gemini-cloud-assist/.

  4. בספרייה skills/google-gemini-cloud-assist/, יוצרים קובץ SKILL.md באמצעות התוכן מ-operating-google-cloud.

  5. יוצאים מהסשן של Antigravity CLI ומפעילים אותו מחדש.

    /quit

    כשמפעילים שוב את Antigravity CLI באמצעות agy, הוא מזהה באופן אוטומטי את קובצי המיומנויות.

  6. מוודאים שקובצי המיומנויות זוהו באופן אוטומטי.

    /skills list

הגדרתם בהצלחה את Antigravity CLI להתחבר לשרתי App Design Center ו-Gemini Cloud Assist MCP, ויצרתם קובצי מיומנויות.

תכנון התשתית של Google Cloud

תכנון תשתית שמותאמת לאחסון ולהפעלה של קוד האפליקציה.

  1. מגדירים את הפרויקט שבו רוצים להשתמש:

    gcloud config set project PROJECT_ID

  2. בקשו את Google Cloud תכנון התשתית.

     My application code is in REPOSITORY_URL. Design the Google Cloud infrastructure required for my application.

    הסוכן יבקש להפעיל את המיומנויות שהגדרתם. הנציג יוצר תוכנית לעיצוב התשתית ומבקש את האישור שלכם.

  3. מאשרים את התוכנית.

    Continue with the plan.

    הנציג מזהה את הכלים שבהם צריך להשתמש כדי ליצור את התשתית, ומבקש להשתמש בכלי setup_adc, שמגדיר את App Design Center בפרויקט.

  4. מאשרים ל-Gemini Cloud Assist להשתמש בכלים המוצעים.

    הסוכן מציע עיצוב ושואל אם אתם מוכנים לפרוס אותו.

  5. מבצעים איטרציה על העיצוב המוצע.

    The infrastructure looks good, but I want to add a cache for frequently accessed data.

    הסוכן מעדכן את העיצוב בהתאם לדרישה שלכם. הנציג שואל אם אתם רוצים הסבר על השינויים או אם אתם רוצים לבדוק את השינויים.

יצרתם את התכנון הראשוני של התשתית, ושיפרתם אותו.

הערכת התאימות לתקני אבטחה

סביר להניח שהאדמינים בארגון שלכם הגדירו מסגרות אבטחה ספציפיות שמשפיעות על התכנון והפריסה של התשתית. בקטע הזה, מוודאים שהעיצוב תואם לתקני האבטחה שהוגדרו.

  1. חשוב לוודא שתכנון התשתית תואם לתקני האבטחה של הארגון.

    I want to make sure that infrastructure design is compliant with my organization's security standards.

    הנציג מנתח את תכנון התשתית על סמך מסגרות האבטחה שהאדמין של הארגון ציין ב-Security Command Center. אם בביקורת נמצאות בעיות תאימות, הסוכן מציע שיפורים באבטחה ומבקש את אישורכם.

  2. החלת שיפורי האבטחה המומלצים

    Apply the recommended security enhancements.

    הסוכן מבצע את השינויים ושואל אם אתם מוכנים לאשר את העיצוב.

תכנון התשתית תואם למסגרות האבטחה של הארגון.

פריסת תכנון התשתית

פורסים את עיצוב התשתית ב- Google Cloud.

  1. מאשרים את העיצוב ופורסים אותו.

    Deploy the infrastructure design to my Google Cloud project.

    הסוכן פורס את העיצוב הסופי בפרויקט ב- Google Cloud . הנציג מבקש מכם לאשר את השינויים בפרויקט. לדוגמה, יכול להיות שתצטרכו להפעיל API.

    אם האפליקציה נפרסת בהצלחה, הנציג מציג את פרטי הפריסה, רכיבי הארכיטקטורה והשלבים לשימוש באפליקציה.

  2. אם הפריסה נכשלת, אתם יכולים לקבל עזרה בפתרון הבעיות. לדוגמה, יכול להיות שתצטרכו לתקן את פרטי ההגדרות של הרכיבים או את ההרשאות של ניהול הזהויות והרשאות הגישה (IAM).

    Fix the component configuration errors.

    הנציג מספק המלצות להגדרות של רכיבים ויוצר תצוגת diff כדי שתוכלו לבדוק ולאשר אותן.

  3. כדי לנסות לפרוס שוב אחרי שביצעתם שינויים, חזרו על השלבים בקטע הזה.

פרסתם את קוד האפליקציה ואת עיצוב התשתית ב-Google Cloud.

הסרת המשאבים

כדי להימנע מחיובים בחשבון Google Cloud בגלל השימוש במשאבים שנעשה במסגרת המדריך הזה, אפשר למחוק את הפרויקט שמכיל את המשאבים או להשאיר את הפרויקט ולמחוק את המשאבים הנפרדים.

    כדי למחוק פרויקט ב- Google Cloud :

    gcloud projects delete PROJECT_ID

המאמרים הבאים