יצירת מאגרים מ-GitLab Enterprise Edition

דור שני Developer Connect

בעזרת Cloud Build אפשר ליצור טריגרים ל-build ממאגרים שמתארחים ב-GitLab Enterprise Edition. אתם יכולים להריץ בנייה בתגובה לאירועים כמו שליחת קומיטים או בקשות מיזוג שמשויכות למאגר שלכם ב-GitLab Enterprise Edition.

בדף הזה מוסבר איך להפעיל טריגרים של בנייה עבור מופע של GitLab Enterprise Edition. מידע נוסף זמין במאמרים בנושא טריגרים של Cloud Build ומאגרי Cloud Build.

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

פועלים לפי ההוראות להתחברות למארח של GitLab Enterprise Edition.

• מפעילים את Cloud Build API ואת Secret Manager API, אם הם עדיין לא מופעלים.

  תפקידים שנדרשים להפעלת ממשקי API

  כדי להפעיל ממשקי API, נדרשת ההרשאה serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד 'בעלים' (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד 'אדמין בממשק Service Usage' (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים

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

כדי ליצור טריגר למאגר GitLab Enterprise Edition, צריך ליצור חיבור בין Google Cloud למאגר. כדי ליצור חיבור דרך אפליקציית GitLab Enterprise Edition ב- Google Cloud, אפשר לעיין במאמר חיבור למאגר GitLab Enterprise Edition.

יצירת טריגר של GitLab Enterprise Edition

בקטע הזה מוסבר איך ליצור טריגר ולקשר אותו להתקנה של GitLab Enterprise.

מסוף Google Cloud

כדי ליצור טריגרים של GitLab Enterprise Edition באמצעות מסוף Google Cloud , פועלים לפי השלבים הבאים:

1. פותחים את הדף מפעילים:

   פתיחת הדף Triggers

2. בוחרים את Google Cloud הפרויקט הרלוונטי בחלק העליון של הדף ולוחצים על Open.

3. לוחצים על Create trigger (יצירת ביטוי להפעלה).

4. מזינים את הגדרות הטריגר הבאות:

   • שם: שם לטריגר.

   • אזור: בוחרים את האזור של הטריגר.

     • אם קובץ ההגדרות של ה-build שמשויך לטריגר מציין מאגר פרטי, Cloud Build משתמש במאגר הפרטי כדי להריץ את ה-build. במקרה הזה, האזור שאתם מציינים בטריגר צריך להיות זהה לאזור שבו יצרתם את המאגר הפרטי.
     • אם קובץ התצורה של ה-build שמשויך לטריגר לא מציין מאגר פרטי, Cloud Build משתמש במאגר ברירת המחדל כדי להריץ את ה-build באותו אזור שבו מוגדר הטריגר.

   • תיאור (אופציונלי): תיאור של הטריגר.

   • אירוע: בוחרים את אירוע המאגר להפעלת הטריגר.

     • Push to a branch: מגדירים את הטריגר להתחלת בנייה של קומיטים בענף מסוים.

     • Push new tag: מגדירים את הטריגר להתחלת בנייה בביצועי Commit שמכילים תג מסוים.

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

   • מקור: הגדרת מידע על מאגר GitLab Enterprise Edition:

     • שירות מאגר: בוחרים באפשרות Cloud Build.

     • Repository generation: בוחרים באפשרות 2nd generation כמקור.

     הערה: האזור של המאגר צריך להיות זהה לאזור של הטריגר.

     • מאגר: בוחרים מאגר מתוך רשימת המאגרים הזמינים.

     • Branch או Tag: מציינים ביטוי רגולרי עם ערך הענף או התג להתאמה. כאן אפשר לקרוא מידע על התחביר המקובל של ביטויים רגולריים.

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

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

       • חובה: כשמשתמש יוצר או מעדכן בקשת מיזוג, תהליכי הבנייה מופעלים רק אחרי שהבעלים או משתף הפעולה מגיבים /gcbrun לבקשת המיזוג. תהליכי Build מופעלים בכל פעם שמבוצע שינוי בבקשת משיכה.

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

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

   • Configuration (הגדרה): בוחרים את קובץ הגדרת ה-build שנמצא במאגר או מגדירים את ה-build בשורה בטריגר.

     • סוג: בוחרים את סוג ההגדרה שרוצים להשתמש בו ב-build.

       • קובץ תצורת Cloud Build (yaml או json): משתמשים בקובץ תצורת build להגדרה.
       • ‫Dockerfile: משתמשים ב-Dockerfile להגדרה.

     • מיקום: מציינים את המיקום של ההגדרה.

       • מאגר: אם קובץ ההגדרות נמצא במאגר, מציינים את המיקום של קובץ הגדרות הבנייה או של ספריית Dockerfile ואת השם של התמונה שנוצרת. אם ההגדרה היא Dockerfile, אפשר גם לספק זמן קצוב לתהליך הבנייה. אחרי שמזינים את Dockerfile ואת שם התמונה, מוצגת תצוגה מקדימה של פקודת docker build שה-build יבצע.

       • Inline: אם בחרתם באפשרות Cloud Build configuration file (yaml or json) (קובץ הגדרות Cloud Build (yaml או json)) כאפשרות ההגדרות, תוכלו לציין את הגדרות ה-build בשורה. לוחצים על Open Editor כדי לכתוב את קובץ ההגדרות של ה-build בGoogle Cloud מסוף באמצעות תחביר YAML או JSON. לוחצים על סיום כדי לשמור את הגדרות ה-build.

       הערה: אין תמיכה בתצורת build מוטבעת ב-Dockerfile.

5. לוחצים על Create (יצירה) כדי ליצור את הטריגר של GitLab Enterprise Edition.

‫CLI של gcloud

כדי ליצור טריגרים של GitLab Enterprise Edition באמצעות פקודות gcloud, מריצים את הפקודה הבאה:

    gcloud builds triggers create gitlab \
      --name=TRIGGER_NAME \
      --repository=projects/PROJECT_ID/locations/REGION/connections/CONNECTION_NAME/repositories/REPO_NAME \
      --branch-pattern=BRANCH_PATTERN # or --tag-pattern=TAG_PATTERN \
      --build-config=BUILD_CONFIG_FILE \
      --region=REGION \
      --service-account=SERVICE-ACCOUNT

כאשר:

• ‫TRIGGER_NAME הוא השם של הטריגר.
• ‫PROJECT_ID הוא Google Cloud מזהה הפרויקט.
• ‫REGION הוא האזור של הטריגר.
• ‫CONNECTION_NAME הוא השם של החיבור ל-GitLab Enterprise Edition.
• ‫REPO_NAME הוא שם המאגר
• ‫BRANCH_PATTERN הוא שם הענף במאגר שבו רוצים להפעיל את ה-build.
• ‫TAG_PATTERN הוא שם התג במאגר שמשמש להפעלת ה-build.
• ‫BUILD_CONFIG_FILE הוא הנתיב לקובץ התצורה של ה-build.
• ‫SERVICE-ACCOUNT הוא חשבון השירות שבו יש להשתמש לפעולות של הפעלה ובנייה.

API

כדי ליצור טריגר של GitLab Enterprise Edition באמצעות ה-API, משתמשים בתבנית ה-JSON הבאה:

{
    "filename": "cloudbuild.yaml",
    "name": "curl-trigger",
    "description": "curl trigger",
    "repository_event_config": {
      "repository": "REPO_NAME",
      "repository_type": "GITLAB_ENTERPRISE",
      // Field filter must be only one of the following:
      "pullRequest": "PULL_REQUEST_FILTER",
      "push": "PUSH_FILTER"
    }
}

כאשר:

• ‫REPO_NAME הוא השם של חיבור המאגר שהגדרתם ב-Cloud Build.
• ‫PULL_REQUEST_FILTER הוא מופע של PullRequestFilter, שמגדיר את המסנן שמאפשר ל-Cloud Build להפעיל בנייה כשמתבצעת בקשת מיזוג תואמת ב-GitLab Enterprise Edition.
• ‫PUSH_FILTER הוא מופע של PushFilter, שמגדיר את המסנן שמאפשר ל-Cloud Build להפעיל בנייה כשמתבצעת פעולת push תואמת ב-GitLab Enterprise Edition.

מזינים את הפקודה curl הבאה במסוף:

  curl -X POST -H "Authorization: Bearer "$(gcloud auth print-access-token) -H "Content-Type: application/json; charset=utf-8" -H "x-goog-user-project: PROJECT_NUMBER" https://cloudbuild.googleapis.com/v1/projects/PROJECT_ID/triggers -d @trigger.json

כאשר:

• ‫PROJECT_NUMBER הוא מספר הפרויקט. Google Cloud
• ‫PROJECT_ID הוא Google Cloud מזהה הפרויקט.

שיתוף נתונים

הנתונים שנשלחים אל GitLab Enterprise Edition מ-Cloud Build עוזרים לכם לזהות טריגרים לפי שם ולראות את תוצאות ה-build במאגרי GitLab Enterprise Edition.

הנתונים הבאים משותפים בין Cloud Build לבין המארח שלכם ב-GitLab Enterprise Edition:

• Google Cloud מזהה הפרויקט
• שם הטריגר

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

• איך מנהלים טריגרים של בנייה
• איך יוצרים מאגרים מ-GitLab Enterprise Edition ברשת פרטית
• איך מבצעים פריסות blue-green ב-Compute Engine