ההוראות האלה מיועדות למפתחי אפליקציות, לאדמינים של פלטפורמות ולמנהלי אבטחה שרוצים להשתמש במאגרי קוד המקור של Bitbucket Data Center עם Google. באופן ספציפי, אתם יכולים להשתמש במאגרים של Bitbucket Data Center עם Gemini Code Assist.
סקירה כללית על Developer Connect
לפני שמתחילים
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Developer Connect, Secret Manager APIs, if any are not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.-
מוודאים שיש לכם גישה לחשבון ב-Bitbucket Data Center.
כדי לשמור על אבטחת העבודה של הצוות, מומלץ להשלים את המשימות במדריך הזה באמצעות חשבון בוט או חשבון שמשותף לצוות, ולא באמצעות חשבון אישי.
- מוודאים שאתם הבעלים של מאגר Bitbucket מרכז נתונים, או שיש לכם הרשאות ברמת אדמין במאגר משותף.
- אופציונלי: יוצרים מפתח הצפנה בניהול הלקוח (CMEK) כדי להצפין את סודות האימות שנוצרים על ידי Developer Connect.
- אופציונלי: כדי להשתמש בהוראות של שורת הפקודה במדריך הזה, מבצעים את השלבים הבאים:
- מתקינים את Google Cloud CLI. אם כבר התקנתם את ה-CLI של gcloud, צריך לוודא שפועלת אצלכם הגרסה העדכנית ביותר של
gcloud components update. - יוצרים חשבון שירות של Developer Connect באמצעות הפקודה הבאה, כאשר PROJECT_ID הוא Google Cloud מזהה הפרויקט:
gcloud beta services identity create \ --service=developerconnect.googleapis.com \ --project=PROJECT_ID
- מתקינים את Google Cloud CLI. אם כבר התקנתם את ה-CLI של gcloud, צריך לוודא שפועלת אצלכם הגרסה העדכנית ביותר של
התפקידים הנדרשים
כדי לקבל את ההרשאות שדרושות ליצירת חיבורים וקישורים, בקשו מהאדמין להקצות לכם את התפקידים הבאים ב-IAM:
-
אם אתם לא הבעלים של הפרויקט: התפקיד אדמין ב-Developer Connect (
roles/developerconnect.admin) בחשבון המשתמש שלכם. -
אם אתם מתכננים להשתמש ב-CMEK כדי להצפין את הסודות שנוצרו על ידי Developer Connect:
Cloud KMS CryptoKey Encrypter/Decrypter (
roles/cloudkms.cryptoKeyEncrypterDecrypter) בחשבון השירות של Secret Manager. -
אם אתם מתכננים להשתמש ב-CLI של gcloud כדי לבצע את השלבים במדריך הזה: תפקיד אדמין של Secret Manager (
roles/secretmanager.admin) בחשבון השירות של Developer Connect. -
אם אתם מתכננים להשתמש במסוף Google Cloud כדי לבצע את השלבים שבמדריך הזה: אדמין IAM של פרויקט (
roles/resourcemanager.projectIamAdmin) בחשבון המשתמש שלכם.
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.
יצירת טוקני גישה
כדי ליצור טוקני גישה אישיים ב-Bitbucket מרכז נתונים:
פועלים לפי ההוראות במסמכי התיעוד של Bitbucket Data Center כדי ליצור שני אסימוני גישה ל-HTTP ולהעניק את ההיקפים הבאים.
Developer Connect תומך בטוקני גישה של משתמשים, פרויקטים ומאגרים.
- יוצרים אסימון אחד עם ההיקף
repository admin. ב-Developer Connect, הטוקן הזה נקרא טוקן גישה של אדמין. - יוצרים אסימון אחד עם ההיקף
repository read. ב-Developer Connect, הטוקן הזה נקרא טוקן גישה לקריאה.
אתם אחראים לנהל את משך החיים של הטוקנים של Bitbucket Data Center ב-Bitbucket Data Center. כדי להגן על קוד המקור, אתם יכולים להגדיר תאריך תפוגה במהלך יצירת הטוקן. אם לא מגדירים תאריך תפוגה, האסימון נשאר בתוקף עד שמבטלים אותו ב-Bitbucket Data Center.
- יוצרים אסימון אחד עם ההיקף
מעתיקים את טוקני הגישה כדי להשתמש בהם בתהליכים הבאים.
יצירת חיבור
בקטע הזה מוסבר איך ליצור חיבור בין Developer Connect לבין Bitbucket Data Center. אם אתם משתמשים במסוף Google Cloud , תוכלו גם להתחיל להוסיף קישורים למאגרים כשתסיימו להגדיר את החיבור.
כדי ליצור חיבור חדש ל-Bitbucket Data Center, בוחרים באחת מהאפשרויות הבאות:
המסוף
כדי ליצור חיבור:
במסוף Google Cloud , פותחים את Developer Connect.
בדף Git repositories ב-Developer Connect,
- אם מוצגת רשימה של ספקי ניהול של קוד מקור: בוחרים ספק ניהול של קוד מקור ומתחילים להגדיר את החיבור הראשון. לוחצים על Connect בכרטיס Bitbucket מרכז נתונים.
אם מופיעה טבלה עם רשימה של חיבורים קיימים: מגדירים את הספק של ניהול קוד המקור בלחיצה על Create connection > Bitbucket מרכז נתונים.
הדף Create Connection נפתח.
בשדה Region, בוחרים אזור למשאבי החיבור.
- בשדה Name, נותנים שם לחיבור החדש.
בשדה Host URL, מזינים את כתובת ה-URL של מרכז הנתונים של Bitbucket שאליו רוצים להתחבר.
בקטע Access Tokens, מזינים את טוקני הגישה של Bitbucket מרכז נתונים:
Admin access token: מזינים את טוקן הגישה עם הרשאת האדמין למאגר.
טוקן גישה לקריאה: מזינים את הטוקן עם גישה להיקף הקריאה של המאגר.
לוחצים על הצגת הגדרות נוספות כדי לראות הגדרות אישיות אופציונליות.
אופציונלי: כברירת מחדל, Developer Connect יכול לשמש כשרת proxy לקריאות Git ל-Bitbucket מרכז נתונים. כדי להשבית את האפשרות הזו, מבטלים את הסימון בתיבה Enable Developer Connect proxy.
אופציונלי: בקטע Encryption, בוחרים מפתח CMEK כדי להצפין את הסודות ב-Secret Manager שנוצרו על ידי Developer Connect.
לוחצים על הכפתור המשך. החיבור נוצר ב-Developer Connect. התהליך הזה יכול לקחת כמה שניות.
אחרי שיוצרים את החיבור, מופיע הדף Link repositories.
כדי לקשר מאגרים לחיבור:
ברשימת המאגרים הזמינים, בוחרים את המאגרים שבהם רוצים להשתמש.
לוחצים על OK.
לוחצים על קישור.
החיבור נוסף לדף Connections והקישורים למאגרים נוספים לדף Repositories במסוף Google Cloud . תמיד אפשר להוסיף עוד קישורים לחיבורים קיימים.
אם אתם מגדירים את Gemini Code Assist, המשיכו בתהליך לפי השלבים שמפורטים במאמר הגדרה ושימוש בעיגון בקוד של הארגון ב-Gemini Code Assist.
gcloud
כדי ליצור סוד של webhook ב-Secret Manager, מריצים את הפקודה הבאה, כאשר WEBHOOK_SECRET_NAME הוא שם הסוד של ה-webhook:
cat /proc/sys/kernel/random/uuid | tr -d '\n' | gcloud secrets create WEBHOOK_SECRET_NAMEכדי לאחסן את טוקני הגישה ב-Secret Manager, מריצים את הפקודות הבאות:
gcloud secrets create ADMIN_SECRET_NAME echo -n ADMIN_SECRET_DATA | gcloud secrets versions add ADMIN_SECRET_NAME --data-file=- gcloud secrets create READ_SECRET_NAME echo -n READ_SECRET_DATA | gcloud secrets versions add READ_SECRET_NAME --data-file=-מחליפים את מה שכתוב בשדות הבאים:
- ADMIN_SECRET_NAME: שם לסוד שבו מאוחסן טוקן הגישה של הרשאת האדמין.
- ADMIN_SECRET_DATA: אסימון הגישה של האדמין.
- READ_SECRET_NAME: שם לסוד שבו מאוחסן טוקן הגישה לקריאה.
- READ_SECRET_DATA: טוקן הגישה לקריאה.
מריצים את הפקודה
gcloud developer-connect connections createכדי ליצור חיבור ל-Bitbucket מרכז נתונים:gcloud developer-connect connections create CONNECTION_NAME \ --location=REGION \ --bitbucket-data-center-config-host-uri=HOST_URI \ --bitbucket-data-center-config-authorizer-credential-user-token-secret-version=projects/PROJECT_ID/secrets/ADMIN_SECRET_NAME/versions/VERSION \ --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version=projects/PROJECT_ID/secrets/READ_SECRET_NAME/versions/VERSION \ --bitbucket-data-center-config-webhook-secret-version=projects/PROJECT_ID/secrets/WEBHOOK_SECRET_NAME/versions/VERSION \ --git-proxy-config-enabledמחליפים את מה שכתוב בשדות הבאים:
- CONNECTION_NAME: שם לחיבור.
- REGION: האזור שבו משתמשים לחיבור.
- HOST_URI: ה-URI של המארח של Bitbucket מרכז נתונים, כולל הקידומת
https://. - PROJECT_ID: מזהה הפרויקט ב- Google Cloud.
- ADMIN_SECRET_NAME: השם של הסוד ב-Secret Manager שמכיל את טוקן הגישה של האדמין.
- READ_SECRET_NAME: השם של הסוד ב-Secret Manager שמכיל את טוקן הגישה לקריאה.
- WEBHOOK_SECRET_NAME: השם של הסוד ב-Secret Manager שמכיל את הסוד של ה-webhook.
- VERSION: מספר הגרסה של כל סוד. אפשר להשתמש ב-
latestכדי להשתמש במספר הגרסה העדכני ביותר. -
--git-proxy-config-enabled: דגל אופציונלי שמאפשר ל-Developer Connect לפעול כשרת proxy לקריאות Git ל-Bitbucket Data Center.
Developer Connect משלים את החיבור ל-Bitbucket Data Center. בשלב הבא, מקשרים למאגרים.
קישור למאגרים באמצעות חיבור קיים
אחרי שיוצרים חיבור ל-Bitbucket Data Center, אפשר לקשר למאגרים. אפשר לחזור על השלבים האלה בהמשך כדי לקשר מאגרים נוספים לפי הצורך.
כדי ליצור קישורים למאגרים בחיבור קיים ל-Bitbucket Data Center, בוחרים אחת מהאפשרויות הבאות:
המסוף
כדי ליצור קישורים למאגרים:
פותחים את הדף Repositories במסוף Google Cloud .
לוחצים על Link repository.
החלונית Link Git repositories נפתחת.
ברשימת החיבורים, בוחרים חיבור.
לוחצים על Continue.
ברשימת המאגרים, בוחרים את המאגרים שרוצים לקשר.
ב-Developer Connect מוצגים שמות מוצעים למשאבי המאגר.
בוחרים אפשרות למתן שמות למשאבים במאגר:
- Generated: שימוש בשמות המשאבים שנוצרו במאגר.
- ידנית: מזינים שמות משלכם.
לוחצים על יצירה.
הקישורים למאגרים נוצרים ב-Developer Connect ומוצגים במסוף Google Cloud .
gcloud
כדי ליצור קישור למאגר ב-Bitbucket מרכז נתונים, מריצים את הפקודה הבאה:
gcloud developer-connect connections git-repository-links create REPO_NAME \
--clone-uri=REPO_URI \
--connection=CONNECTION_NAME \
--location=REGION
מחליפים את מה שכתוב בשדות הבאים:
- REPO_NAME: שם לקישור החדש בין Developer Connect לבין המאגר שלכם ב-Bitbucket מרכז נתונים.
- REPO_URI: כתובת ה-URL של המאגר ב-Bitbucket מרכז נתונים, כולל הקידומת
https://והסיומת.git. - CONNECTION_NAME: השם של החיבור ל-Bitbucket מרכז נתונים.
- REGION: האזור של החיבור.
Developer Connect יוצר את הקישורים למאגרים.
כדי להציג רשימה של מאגרים מקושרים, מריצים את הפקודה developer-connect connections git-repository-linkslist.
אם אתם מגדירים את Gemini Code Assist, המשיכו בתהליך לפי השלבים שמפורטים במאמר הגדרה ושימוש בעיגון בקוד של הארגון ב-Gemini Code Assist.