הגדרת Gemini Cloud Assist

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

הגדרת Gemini Cloud Assist לפרויקט

בשלבים הבאים מוסבר איך להגדיר את Gemini Cloud Assist לפרויקט ב Google Cloud מסוף או באמצעות Google Cloud CLI.

המסוף

  1. עוברים לדף אדמין ל-Gemini.

    כניסה לדף Gemini for Google Cloud

  2. בכלי לבחירת פרויקטים בחלק העליון של הדף, בוחרים את משאב הפרויקט.

  3. בוחרים באפשרות Get Gemini Cloud Assist (קבלת Gemini Cloud Assist).

  4. בתיבת הדו-שיח Get Gemini Cloud Assist (קבלת Gemini Cloud Assist):

    1. לוחצים על החץ להרחבת הרשימה בקטע Required & recommended APIs.

    2. ברשימה Recommended APIs (ממשקי API מומלצים), בוחרים ממשקי API נוספים שרוצים להפעיל כדי לשפר את הביצועים של Gemini Cloud Assist.

    3. אופציונלי: בוחרים באפשרות עזרה ל-Google לשפר את Cloud Assist על ידי שיתוף ההנחיות והתשובות שלך.

    4. בוחרים באפשרות הפעלת Gemini Cloud Assist ללא עלות.

  5. לוחצים על Save.

  6. מקצים את התפקידים ב-IAM שנדרשים בשביל Gemini Cloud Assist.

    1. עוברים לדף IAM & Admin.

      כניסה לדף IAM & Admin

    2. בעמודה Principal, מחפשים את החשבון הראשי שרוצים לתת לו גישה ל-Gemini Cloud Assist, ולוחצים על Edit principal בשורה הזו.

    3. בחלונית גישת עריכה לוחצים על Add another role.

    4. ברשימת התפקידים Select a role בוחרים את Gemini Cloud Assist User.

    5. לוחצים על Add another role ובוחרים באפשרות Cloud Asset Viewer.

    6. אם החשבון הראשי רוצה לקבל עזרה במוצרים שאין לו גישה אליהם, יכול להיות שתצטרכו להקצות לו תפקידי IAM נוספים. לשם כך, לוחצים על Add another role ובוחרים תפקידים נוספים. במאמר דרישות IAM לשימוש ב-Gemini Cloud Assist מופיעה טבלה של תפקידי IAM שמאפשרים חוויית שימוש אופטימלית ב-Gemini Cloud Assist במוצרים שונים.

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

  7. (אופציונלי) מגדירים את ההגדרות של הפרויקט.

gcloud

  1. במסוף Google Cloud , מפעילים את Cloud Shell.

    הפעלת Cloud Shell

  2. מפעילים את Gemini Cloud Assist API באמצעות הפקודה gcloud services enable:

    gcloud services enable geminicloudassist.googleapis.com

    בשלב הזה מופעל גם Gemini for Google Cloud API, שנדרש גם לשימוש ב-Gemini Cloud Assist.

    אם רוצים להפעיל את Gemini Cloud Assist API בפרויקט אחר ב-Google Cloud , מוסיפים את הפרמטר --project:

    gcloud services enable geminicloudassist.googleapis.com --project PROJECT_ID

    מחליפים את PROJECT_ID במזהה הפרויקט שבו רוצים להפעיל את Gemini Cloud Assist.

    הפלט אמור להיראות כך:

    Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.

  3. מפעילים ממשקי API נדרשים אחרים באמצעות הפקודה gcloud services enable, כמו שעשיתם כדי להפעיל את Gemini Cloud Assist API:

    gcloud services enable cloudasset.googleapis.com designcenter.googleapis.com appoptimize.googleapis.com apphub.googleapis.com --project PROJECT_ID

  4. (אופציונלי) מפעילים ממשקי API מומלצים באמצעות הפקודה gcloud services enable, כמו שעשיתם כדי להפעיל את Gemini Cloud Assist API.

  5. מקצים תפקידי IAM בפרויקט ב- Google Cloud . מידע נוסף זמין במאמרים הקצאת תפקיד יחיד וgcloud projects add-iam-policy-binding.

    1. הקצאת התפקיד roles/geminicloudassist.user:

      gcloud projects add-iam-policy-binding PROJECT_ID \
  --member=PRINCIPAL --role=roles/geminicloudassist.user

      מחליפים את מה שכתוב בשדות הבאים:

      • ‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud . לדוגמה: 1234567890.
      • ‫PRINCIPAL: המזהה של החשבון הראשי. לדוגמה: user:cloudysanfrancisco@gmail.com.

      תיווצר רשימה של קישורי מדיניות עם הפרטים הבאים:

      - members:
  - user:PRINCIPAL
  role: roles/geminicloudassist.user

    2. חוזרים על השלב הקודם לתפקיד roles/cloudasset.viewer.

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

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

  6. (אופציונלי) מגדירים את ההגדרות של הפרויקט.

API

בהוראות האלה נעשה שימוש ב-cURL כדי לקרוא ל-methods של API.

  1. מפעילים את Gemini Cloud Assist API באמצעות השיטה services.enable:

    curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/geminicloudassist.googleapis.com:enable"

    מחליפים את PROJECT_ID במזהה הפרויקט שבו רוצים להפעיל את Gemini Cloud Assist.

    אם הפקודה מצליחה, היא מחזירה long-running operation, שכולל את השדה name. אפשר להשתמש בערך בשדה name כדי לבדוק את סטטוס הפעולה.

  2. מפעילים את ממשקי ה-API הנוספים הנדרשים באמצעות השיטה services.enable, כמו שהפעלתם את Gemini Cloud Assist API:

    • cloudasset.googleapis.com
    • designcenter.googleapis.com
    • appoptimize.googleapis.com
    • apphub.googleapis.com

  3. (אופציונלי) מפעילים ממשקי API מומלצים באמצעות השיטה services.enable, כמו שהפעלתם את Gemini Cloud Assist API.

  4. מקצים תפקידי IAM ל Google Cloud פרויקט המשויך.

    1. יוצרים קובץ JSON שמכיל את הפרטים הבאים:

        {
    "options": {
      "requestedPolicyVersion": 3
    }
  }

    2. מאחזרים את מדיניות ה-IAM הקיימת של הפרויקט באמצעות השיטה projects.getIamPolicy:

        curl -X POST --data-binary @JSON_FILE_NAME \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://cloudresourcemanager.googleapis.com/v1/projects/PROJECT_ID:getIamPolicy"

      מחליפים את מה שכתוב בשדות הבאים:

      • ‫JSON_FILE_NAME: הנתיב לקובץ JSON שיצרתם בשלב הקודם.

      • ‫PROJECT_ID: מזהה הפרויקט.

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

    3. מעתיקים את מדיניות ה-IAM של הפרויקט לקובץ JSON ריק, ומוסיפים את המידע הבא לתוכן הקיים:

        {
    "role": "roles/geminicloudassist.user",
    "members": [
      "PRINCIPAL"
    ]
  },
  {
    "role": "roles/cloudasset.viewer",
    "members": [
      "PRINCIPAL"
    ]
  }

      מחליפים את PRINCIPAL במזהה של החשבון הראשי שרוצים להעניק לו גישה ל-Gemini Cloud Assist.

    4. מחילים את מדיניות ה-IAM המעודכנת על הפרויקט באמצעות ה-method projects.setIamPolicy:

        curl -X POST --data-binary @JSON_FILE_NAME \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://cloudresourcemanager.googleapis.com/v1/projects/PROJECT_ID:setIamPolicy"

      מחליפים את מה שכתוב בשדות הבאים:

      • ‫JSON_FILE_NAME: הנתיב לקובץ JSON שיצרתם בשלב הקודם.

      • ‫PROJECT_ID: מזהה הפרויקט.

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

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

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

  5. (אופציונלי) מגדירים את ההגדרות של הפרויקט.

הגדרת Gemini Cloud Assist לתיקייה

בשלבים הבאים מוסבר איך להגדיר את Gemini Cloud Assist לתיקייה באמצעות מסוף Google Cloud . אי אפשר להשתמש ב-Google Cloud CLI או ב-API כדי להגדיר את Gemini Cloud Assist לתיקיות.

  1. מפעילים את ממשקי ה-API הנדרשים והמומלצים.

    1. עוברים לדף אדמין ל-Gemini.

      כניסה למרכז Admin ל-Gemini

    2. בכלי לבחירת פרויקטים בחלק העליון של הדף, בוחרים את משאב התיקייה.

    3. בוחרים באפשרות הפעלת ממשקי Cloud Assist API.

      מופיעה תיבת הדו-שיח Enable API for existing projects within folder (הפעלת API לפרויקטים קיימים בתיקייה).

    4. בתיבת הדו-שיח Enable API for existing projects within a folder, לוחצים על החץ להרחבה שנמצא בקטע Required & recommended APIs.

    5. ברשימה Recommended APIs (ממשקי API מומלצים), בוחרים את ממשקי ה-API האופציונליים שרוצים להפעיל.

    6. אופציונלי: בוחרים באפשרות עזרה ל-Google לשפר את Cloud Assist על ידי שיתוף ההנחיות והתשובות שלך.

    7. בוחרים באפשרות הפעלת Gemini Cloud Assist ללא עלות.

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

  2. מקצים את תפקידי ה-IAM הבאים או יוצרים תפקידים בהתאמה אישית עם הרשאות שוות ערך בתיקייה:

    • Gemini Cloud Assist User
    • Cloud Asset Viewer

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

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

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

    1. חוזרים לדף אדמין ל-Gemini.

      כניסה למרכז Admin ל-Gemini

    2. בוחרים באפשרות הפעלת ניהול אפליקציות.

      מופיע דף ההגדרות IAM ואדמין.

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

      מופיעה תיבת הדו-שיח הפעלת ממשקי API של אפליקציות בתיקייה הזו.

    4. לוחצים על הפעלה.

      תוכלו לראות את ההתקדמות בשורת הסטטוס. דף ההגדרות IAM & Admin מתרענן כשהפעלת ה-API מסתיימת.

    5. לוחצים על ניהול החיוב.

      יופיע הדף חשבון מקושר.

    6. בוחרים חשבון לחיוב מהרשימה ולוחצים על הגדרת החשבון.

  5. מקצים את תפקידי ה-IAM שהקציתם לתיקייה בשלב 2, או יוצרים תפקידים בהתאמה אישית עם הרשאות שוות ערך לפרויקט הניהול שנוצר בשלב הקודם.

    מוצאים את פרויקט הניהול של התיקייה:

    1. חוזרים לדף אדמין ל-Gemini.

      כניסה למרכז Admin ל-Gemini

    2. בכלי לבחירת פרויקטים בחלק העליון של הדף, בוחרים את משאב התיקייה.

    3. בוחרים באפשרות ניהול ההגדרות של Gemini Cloud Assist.

      מופיעה תיבת הדו-שיח Manage Gemini Cloud Assist (ניהול Gemini Cloud Assist).

    4. שימו לב לפרויקט הניהול.

  6. (אופציונלי) מגדירים הגדרות לפרויקטים בתיקייה.

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