הגדרת פרויקט ל-Vertex AI

‫Vertex AI ב-Google Distributed Cloud (GDC) במכשיר עם air gap מאפשר להריץ עומסי עבודה של למידת מכונה (ML) ובינה מלאכותית (AI) באפליקציות. לפני שאתם מטמיעים את שירותי Vertex AI, אתם צריכים להכין את הפרויקט ולהגדיר את gdcloud CLI ואת חשבונות השירות בסביבת הפיתוח. אם אין לכם את ההרשאות הנדרשות, בקשו מהאדמין להגדיר את הפרויקט בשבילכם.

לבקש מאדמין להגדיר פרויקט בשבילכם

כדי לבצע את רוב המשימות להגדרת פרויקט, צריך הרשאת אדמין. כדי להגדיר פרויקט שבו תוכלו להריץ שירותי Vertex AI במרחב השמות של הפרויקט, האדמין צריך לבצע את הפעולות הבאות:

  1. מגדירים את המכשיר עם פרטי ה-DNS.
  2. בוחרים שם ומזהה לפרויקט שיעזרו לזהות אותו.
  3. מגדירים פרויקט לפי ההוראות שבמסמך הזה.

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

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

  • כדי ליצור פרויקט, צריך לקבל את התפקיד "יצירת פרויקטים" (project-creator).
  • כדי ליצור חשבונות שירות, צריך לקבל את התפקיד "אדמין IAM בפרויקט" (project-iam-admin).

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

אחר כך יוצרים פרויקט כדי לקבץ את שירותי Vertex AI.

התקנת ה-gdcloud CLI

כדי להפעיל את השירותים של מכשיר GDC עם air gap ולקבל גישה לכלים ולרכיבים, צריך להתקין את gdcloud CLI.

כדי להתקין את ה-gdcloud CLI ולנהל את הרכיבים הנדרשים:

  1. מורידים את gdcloud CLI.
  2. מאתחלים את ה-gdcloud CLI:

    gdcloud init
    

    מידע נוסף זמין במאמר התקנת ה-gdcloud CLI.

  3. מתקינים את הרכיבים הנדרשים:

    gdcloud components install COMPONENT_ID
    

    מחליפים את COMPONENT_ID בשם הרכיב שרוצים להתקין.

    מידע נוסף זמין במאמר ניהול רכיבי gdcloud CLI.

  4. אימות באמצעות gdcloud CLI:

    gdcloud auth login
    

    למידע נוסף על אימות באמצעות ספק הזהויות שהגדרתם וקבלת קובץ kubeconfig לזהות המשתמש ולאשכול Kubernetes, קראו את המאמר אימות gdcloud CLI.

הגדרת חשבונות שירות

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

כדי להגדיר חשבונות שירות ל-Vertex AI, צריך לציין את שם חשבון השירות, את מזהה הפרויקט ואת השם של קובץ ה-JSON לזוגות המפתחות.

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

כדי להגדיר חשבונות שירות באמצעות gdcloud CLI:

  1. יוצרים חשבון שירות:

    gdcloud iam service-accounts create SERVICE_ACCOUNT --project=PROJECT_ID
    

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

    • ‫SERVICE_ACCOUNT: השם של חשבון השירות. השם חייב להיות ייחודי במרחב השמות של הפרויקט.
    • ‫PROJECT_ID: מזהה הפרויקט שבו רוצים ליצור את חשבון השירות. אם gdcloud init כבר מוגדר, אפשר להשמיט את הדגל --project.
  2. יוצרים את קובץ ה-JSON של פרטי הכניסה שמוגדרים כברירת מחדל לאפליקציה ואת זוגות המפתחות הציבוריים והפרטיים:

    gdcloud iam service-accounts keys create APPLICATION_DEFAULT_CREDENTIALS_FILENAME \
        --project=PROJECT_ID \
        --iam-account=SERVICE_ACCOUNT \
        --ca-cert-path=CA_CERTIFICATE_PATH
    

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

    • ‫APPLICATION_DEFAULT_CREDENTIALS_FILENAME: השם של קובץ ה-JSON, למשל my-service-key.json.
    • ‫PROJECT_ID: הפרויקט שבו רוצים ליצור את המפתח.
    • ‫SERVICE_ACCOUNT: השם של חשבון השירות שאליו רוצים להוסיף את המפתח.
    • ‫CA_CERTIFICATE_PATH: דגל אופציונלי לנתיב לאישור של רשות האישורים (CA) שמאמת את נקודת הקצה לאימות. אם לא מציינים את הנתיב הזה, המערכת משתמשת באישורי ה-CA של המערכת. צריך להתקין את ה-CA באישורי ה-CA של המערכת.

    מכשיר GDC עם air gap מוסיף את המפתח הציבורי למפתחות של חשבון השירות שמשמשים לאימות אסימוני האינטרנט מסוג JSON ‏ (JWT) שהמפתח הפרטי חותם עליהם. המפתח הפרטי נכתב בקובץ ה-JSON של פרטי הכניסה שמוגדרים כברירת מחדל באפליקציה.

  3. מקצים לחשבון השירות תפקיד כדי לתת לו גישה למשאבים בפרויקט. שם התפקיד תלוי בשירות של Vertex AI שבו רוצים להשתמש בחשבון השירות.

    gdcloud iam service-accounts add-iam-policy-binding \
        --project=PROJECT_ID \
        --iam-account=SERVICE_ACCOUNT \
        --role=ROLE
    

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

    • ‫PROJECT_ID: הפרויקט שבו יוצרים את קישור התפקידים.
    • ‫SERVICE_ACCOUNT: השם של חשבון השירות שבו רוצים להשתמש.
    • ‫ROLE: התפקיד המוגדר מראש שרוצים להקצות לחשבון השירות. מציינים את התפקידים בפורמט Role/name, כאשר Role הוא הסוג של Kubernetes, כמו Role או ProjectRole, ו-name הוא השם של התפקיד המוגדר מראש. לדוגמה, אלה התפקידים שאפשר להקצות לחשבונות שירות כדי להשתמש בממשקי API שאומנו מראש של Vertex AI:

      • כדי להקצות את התפקיד "מפתח AI OCR"‏ (ai-ocr-developer), מגדירים את התפקיד כ-Role/ai-ocr-developer.
      • כדי להקצות את התפקיד "מפתח AI Speech"‏ (ai-speech-developer), מגדירים את התפקיד ל-Role/ai-speech-developer.
      • כדי להקצות את התפקיד "מפתח AI Translation"‏ (ai-translation-developer), מגדירים את התפקיד ל-Role/ai-translation-developer.