הפעלת בנייה במאגר פרטי

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

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

  • מוודאים שיצרתם מאגר פרטי לפי השלבים שמפורטים במאמר יצירה וניהול של מאגרים פרטיים.

  • כדי להשתמש בדוגמאות של שורת הפקודה במדריך הזה, צריך להתקין ולהגדיר את Google Cloud CLI.

  • אתם יכולים להשתמש באותו פרויקט ב- Google Cloud כדי ליצור את המאגר הפרטי ואת ה-builds של Cloud Build, או להשתמש בפרויקטים שונים. אם ה-builds נמצאים בפרויקט אחר מהמאגר הפרטי, צריך להגדיר ב-CLI של gcloud את פרויקט ברירת המחדל לפרויקט שממנו מגיעים ה-builds:

    gcloud config set project BUILD_ORIGIN_PROJECT_ID
    

הרשאות IAM

  • כדי להריץ גרסאות build באמצעות ה-CLI של gcloud או Cloud Build API, צריך להקצות את התפקיד משתמש ב-WorkerPool בפרויקט של המאגר הפרטי לחשבון המשתמש או לחשבון השירות שמבקש את גרסת ה-build.

  • כדי להריץ גרסאות build אוטומטיות באמצעות טריגרים:

    • אם הפרויקט שבו אתם מתחילים את ה-build הוא אותו פרויקט שבו נמצא המאגר הפרטי, אתם לא צריכים לתת הרשאות.
    • אם הפרויקט שבו אתם מתחילים את ה-build שונה מהפרויקט שבו נמצא המאגר הפרטי, אתם צריכים להקצות את התפקיד Cloud Build WorkerPool User‏ (roles/cloudbuild.workerPoolUser) בפרויקט של המאגר הפרטי לחשבון השירות הקודם של Cloud Build (TRIGGER_PROJECT_NUMBER@cloudbuild.gserviceaccount.com) מהפרויקט שבו פועל הטריגר:

    המסוף

    1. פותחים את הדף IAM במסוף Google Cloud .

      פותחים את הדף IAM Permissions

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

    3. לוחצים על הענקת גישה.

    4. מזינים את ההגדרות הבאות של חשבון המשתמש והתפקיד:

      • Add principals: מזינים את כתובת האימייל של חשבון השירות הקודם של Cloud Build (TRIGGER_PROJECT_NUMBER@cloudbuild.gserviceaccount.com) מהפרויקט שבו פועל הטריגר.

      • Assign roles: בוחרים את התפקיד Cloud Build WorkerPool User.

    5. לוחצים על Save כדי לשמור את הרשאות ה-IAM החדשות.

    gcloud

    כדי להקצות את התפקיד roles/cloudbuild.workerPoolUser לחשבון השירות הקודם של Cloud Build מהפרויקט של הטריגר:

      gcloud projects add-iam-policy-binding PRIVATEPOOL_PROJECT_ID \
          --member=serviceAccount:TRIGGER_PROJECT_NUMBER@cloudbuild.gserviceaccount.com \
          --role=roles/cloudbuild.workerPoolUser
    

    מחליפים את הערכים הזמניים לשמירת מקום בפקודה שלמעלה בערכים הבאים:

    • ‫PRIVATEPOOL_PROJECT_ID הוא המזהה של הפרויקט עם המאגר הפרטי שבו פועל ה-build.
    • ‫TRIGGER_PROJECT_NUMBER הוא מספר הפרויקט שבו הטריגר פועל.

הרצת גרסאות build

אתם יכולים לשלוח גרסאות build מאותו פרויקט ב- Google Cloud שבו יצרתם את המאגר הפרטי, או מפרויקט אחר ב- Google Cloud . אפשר לציין את המאגר הפרטי בקובץ תצורת ה-build או ישירות בפקודה gcloud:

ציון המאגר הפרטי בקובץ התצורה של ה-build:

  1. בקובץ התצורה של Cloud Build, מוסיפים את האפשרות pool ומציינים את שם המשאב המלא של המאגר הפרטי שבו רוצים להריץ את ה-build:

    YAML

    steps:
    - name: 'bash'
      args: ['echo', 'I am running in a private pool!']
    options:
      pool:
        name: 'projects/PRIVATEPOOL_PROJECT_ID/locations/REGION/workerPools/PRIVATEPOOL_ID'
    

    JSON

    {
      "steps": [
      {
        "name": "bash",
        "args": [
          "echo",
          "I am running in a private pool!"
        ]
      }
      ],
      "options": {
        "pool" : {
          "name" : "projects/PRIVATEPOOL_PROJECT_ID/locations/REGION/workerPools/PRIVATEPOOL_ID"
        }
      }
    }
    

    מחליפים את הערכים הזמניים לשמירת מקום (פלייסהולדרים) בקובץ התצורה שלמעלה בערכים הבאים:

    • ‫PRIVATEPOOL_PROJECT_ID: הפרויקט ב- Google Cloud שבו נמצא המאגר הפרטי.
    • ‫REGION: האזור שבו יצרתם את המאגר הפרטי.
    • ‫PRIVATEPOOL_ID: המזהה הייחודי של המאגר הפרטי שציינתם כשנוצר המאגר הפרטי.
  2. משתמשים בקובץ תצורת ה-build שנוצר למעלה כדי להריץ את ה-build באמצעות gcloud או API, או באמצעות טריגרים. אם המכונה שלכם מתארחת באופן מקומי, Cloud Build מספק גם תמיכה בפונקציונליות של טריגרים לכמה מערכות חיצוניות לניהול קוד מקור, כמו GitHub Enterprise או Bitbucket Server.

ציון המאגר הפרטי בפקודת gcloud:

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

YAML

  steps:
  - name: 'bash'
    args: ['echo', 'I am running in a private pool!']

JSON

  {
    "steps": [
    {
      "name": "bash",
      "args": [
        "echo",
        "I am running in a private pool!"
      ]
    }
    ],
  }

הפקודה הבאה יוצרת build באמצעות קובץ תצורת ה-build ומציינת את מאגר ה-workers בפקודה:

gcloud builds submit --config=CONFIG_FILE
  --worker-pool=projects/PRIVATEPOOL_PROJECT_ID/locations/REGION/workerPools/PRIVATEPOOL_ID

מחליפים את הערכים הזמניים לשמירת מקום בפקודות שלמעלה בערכים הבאים:

  • ‫CONFIG_FILE: הנתיב לקובץ התצורה של ה-build.
  • ‫PRIVATEPOOL_ID: המזהה הייחודי של המאגר הפרטי שציינתם כשנוצר המאגר הפרטי.
  • ‫PRIVATEPOOL_PROJECT_ID: הפרויקט ב- Google Cloud שבו נמצא המאגר הפרטי.
  • ‫REGION: האזור שבו יצרתם את המאגר הפרטי.

מה השלב הבא?