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

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

השימוש במוצר הזה בגרסת טרום-GA של Gemini Cloud Assist כפוף ל Google Cloud הסכם, כולל לתנאי השימוש במוצרים בגרסת טרום-GA שמופיעים Google Cloud בתנאים הספציפיים לשירות, ולתנאים של תוכנית הבודקים הנאמנים של Gemini Google Cloud .

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

מטרות

במדריך הזה תלמדו:

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

עלויות

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

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

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

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

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

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

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

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

אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

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

gcloud init

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

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

• Select a project: כדי לבחור פרויקט לא צריך תפקיד IAM ספציפי – אפשר לבחור כל פרויקט שקיבלתם בו תפקיד.
• יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד Project Creator (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 .

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

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

אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

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

gcloud init

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

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

• Select a project: כדי לבחור פרויקט לא צריך תפקיד IAM ספציפי – אפשר לבחור כל פרויקט שקיבלתם בו תפקיד.
• יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד Project Creator (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 .

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

1. כדי לגשת ל-Gemini Cloud Assist דרך MCP, אתם צריכים להשתתף בתוכנית Trusted Tester. כדי לקבל גישה, צריך לפנות לצוות ניהול החשבון.
2. התקנת Antigravity CLI
3. כדי לפרוס ולהריץ פקודות של 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.
   • היקף Workspace: כדי להחיל הגדרות על פרויקט ספציפי של 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 לחיבור לשרתי MCP של App Design Center ו-Gemini Cloud Assist ויצרתם קובצי מיומנויות.

עיצוב התשתית 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.
   

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

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

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

הסרת המשאבים

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

זהירות: כשמוחקים פרויקט:

• התוכן של הפרויקט נמחק כולו. אם השתמשתם בפרויקט קיים כדי לתרגל את המשימות במדריך הזה, כשתמחקו אותו תימחק גם כל העבודה שביצעתם באותו פרויקט.
• מאבדים את מזהה הפרויקט בהתאמה אישית. כשיצרתם את הפרויקט, יכולתם לבחור לו מזהה פרויקט בהתאמה אישית כדי להשתמש בו בעתיד. כדי לשמור על כתובות ה-URL שמשתמשות במזהה הפרויקט, כמו appspot.com, צריך למחוק את המשאבים שנבחרו בפרויקט אבל לא את הפרויקט כולו.

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

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

gcloud projects delete PROJECT_ID

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

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