לשירות או לגרסה של Cloud Run יש זהות שירות שמשמשת כחשבון המאומת כדי לגשת לממשקי ה-API של Google Cloud ממארז המכונה של Cloud Run. למידע נוסף על זהות השירות, קראו את המדריך מבוא לזהות השירות.
איך משתמשים בזהות בשירות
ב-Cloud Run, זהות השירות היא חשבון שירות שהוא גם משאב וגם חשבון משתמש.
- זהות השירות כמשאב: כדי לצרף חשבון שירות כזהות השירות, לחשבון הפריסה צריכה להיות גישה למשאב של זהות השירות. בפעולות מסוימות, כמו יצירה או עדכון של שירות או גרסה, נדרשות הרשאות במשאב של זהות השירות בחשבון הפריסה.
- זהות השירות כחשבון משתמש: כדי לגשת לממשקי ה-API של Google Cloud משירות או מגרסה של Cloud Run, צריך לתת לזהות השירות את התפקידים או ההרשאות שנדרשים לפעולות שרוצים שהשירות או הגרסה יבצעו.
בקטע הבא מוסבר אילו תפקידים נדרשים כדי לתת לחשבון הפריסה גישה למשאב של זהות השירות, ואילו תפקידים או הרשאות נדרשים לחשבון המשתמש של חשבון השירות.
התפקידים הנדרשים
אתם או האדמין שלכם צריכים להקצות תפקידים והרשאות ב-IAM לחשבון הפריסה ולזהות השירות.
לחצו כדי לראות את התפקידים הנדרשים לחשבון הפריסה
כדי לקבל את ההרשאות שנדרשות כדי לצרף חשבון שירות בתור זהות השירות בשירות או בגרסה, אתם או האדמין צריכים לתת לחשבון הפריסה את התפקיד משתמש בחשבון שירות (roles/iam.serviceAccountUser) בחשבון השירות שמשמש כזהות השירות.
התפקיד המוגדר מראש הזה כולל את ההרשאה iam.serviceAccounts.actAs, שנדרשת כדי לצרף חשבון שירות לשירות או לגרסה. יכול להיות שתוכלו לקבל את ההרשאה הזו גם באמצעות הגדרה של תפקידים בהתאמה אישית או באמצעות תפקידים מוגדרים מראש אחרים.
במאמר הרשאות פריסה מוסבר איך מקצים לחשבון הפריסה את התפקיד הזה בזהות השירות. אם חשבון השירות נמצא בפרויקט אחר מהשירות או מהגרסה של Cloud Run, אתם או האדמין שלכם צריכים גם להגדיר תפקיד IAM לסוכן השירות של Cloud Run ולהגדיר מדיניות ארגונית. למידע נוסף, קראו את המאמר שימוש בחשבונות שירות בפרויקטים אחרים.
לחיצה כדי לראות את התפקידים הנדרשים לזהות השירות
כדי לאפשר לזהות השירות לגשת לממשקי ה-API של Google Cloud מ-Cloud Run, אתם או האדמין שלכם צריכים לתת לזהות השירות את ההרשאות או התפקידים שנדרשים לפעולות שאתם רוצים לבצע. כדי לגשת לספריות לקוח ספציפיות של Cloud, עיינו ב Google Cloud מסמכי התיעוד של שירות Google Cloud .
אם שירות או גרסה של Cloud Run לא ניגשים לשירותי Google Cloud אחרים, לא צריך להקצות לזהות השירות תפקידים או הרשאות, ואפשר להשתמש בחשבון השירות שמוגדר כברירת מחדל שהוקצה לפרויקט.
קבלת המלצות ליצירת חשבונות שירות ייעודיים
כשיוצרים חשבון שירות חדש ממסוף Google Cloud , השלב האופציונלי "מתן גישה לחשבון השירות הזה לפרויקט" מיועד לכל גישה נוספת שנדרשת. לדוגמה, שירות Cloud Run אחד יכול להפעיל שירות Cloud Run פרטי אחר, או לגשת למסד נתונים של Cloud SQL. בשני המקרים נדרשים תפקידי IAM ספציפיים. מידע נוסף זמין במאמר ניהול הגישה.
שירות Recommender גם מספק באופן אוטומטי המלצות ליצירת חשבונות שירות ייעודיים עם קבוצת ההרשאות המינימלית הנדרשת.
הגדרת זהות השירות
אם עדיין לא יצרתם חשבון שירות, אתם יכולים ליצור חשבון שירות בניהול המשתמש ב-IAM או ב-Cloud Run.
כדי להגדיר את זהות השירות, אתם יכולים להשתמש במסוף Google Cloud , ב-CLI של gcloud, ב-API (YAML) כשאתם יוצרים שירות חדש או פורסים גרסה חדשה, או ב-Terraform:
המסוף
נכנסים לדף Cloud Run במסוף Google Cloud :
בתפריט הניווט של Cloud Run, לוחצים על Services:
אם אתם מגדירים שירות חדש, לוחצים על Deploy container וממלאים את דף הגדרות השירות הראשוני. ואז לוחצים על Containers, Networking, Security כדי להרחיב את דף הגדרת השירות.
אם אתם מגדירים שירות קיים, לוחצים על השירות.
לוחצים על הכרטיסייה אבטחה.
לוחצים על התפריט הנפתח Service account ובוחרים חשבון שירות קיים, או לוחצים על Create a new service account, אם רלוונטי.
כדי ליצור שירות חדש, לוחצים על יצירה. לוחצים על View diff & redeploy ואז על Deploy changes בשירות קיים.
gcloud
כדי לעדכן שירות קיים כך שיהיה לו חשבון שירות חדש, משתמשים בפקודה הבאה:
gcloud run services update SERVICE --service-account SERVICE_ACCOUNT
מחליפים את מה שכתוב בשדות הבאים:
- SERVICE: שם השירות.
- SERVICE_ACCOUNT: חשבון השירות שמשויך לזהות החדשה. הערך הזה הוא כתובת האימייל של חשבון השירות, לדוגמה
example@myproject..
אפשר גם להגדיר חשבון שירות במהלך הפריסה באמצעות הפקודה:
gcloud run deploy --image IMAGE_URL --service-account SERVICE_ACCOUNT
מחליפים את מה שכתוב בשדות הבאים:
-
IMAGE_URL: הפניה לקובץ האימג' של הקונטיינר, לדוגמהus-docker.pkg.dev/cloudrun/container/hello:latest. אם אתם משתמשים ב-Artifact Registry, המאגר REPO_NAME כבר צריך להיות קיים. כתובת ה-URL צריכה להיות בפורמטLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG. - SERVICE_ACCOUNT: חשבון השירות שמשויך לזהות החדשה. הערך הזה הוא כתובת האימייל של חשבון השירות, לדוגמה
example@myservice..
YAML
אם אתם יוצרים שירות חדש, דלגו על השלב הזה. אם אתם מעדכנים שירות קיים, הורידו את הגדרת ה-YAML שלו:
gcloud run services describe SERVICE --format export > service.yaml
מעדכנים את המאפיין
serviceAccountName::apiVersion: serving.knative.dev/v1 kind: Service metadata: name: SERVICE spec: template: spec: serviceAccountName: SERVICE_ACCOUNT
מחליפים את מה שכתוב בשדות הבאים:
- SERVICE: השם של שירות Cloud Run.
- SERVICE_ACCOUNT: חשבון השירות שמשויך לזהות החדשה. הערך הזה הוא כתובת האימייל של חשבון השירות, לדוגמה
SERVICE_ACCOUNT_NAME@PROJECT_ID..
יוצרים או מעדכנים את השירות באמצעות הפקודה הבאה:
gcloud run services replace service.yaml
כברירת מחדל, הפקודה
gcloud run services replaceמשתמשת בקובץservice.yamlאם הוא קיים.
Terraform
כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.
מוסיפים את הקוד הבא למשאבgoogle_cloud_run_v2_service בתצורה של Terraform:כדי ליצור חשבון שירות, מוסיפים את המשאב הבא לקובץ main.tf הקיים:
יוצרים או מעדכנים שירות Cloud Run וכוללים את חשבון השירות:
שימוש בחשבונות שירות בפרויקטים אחרים
אם אתם מגדירים חשבון שירות מפרויקט ב- Google Cloud ששונה מהמשאב של Cloud Run, בצעו את הפעולות הבאות:
אתם או האדמין צריכים להקצות את התפקיד "משתמש בחשבון שירות" (
roles/iam.serviceAccountUser) בחשבון השירות שבו אתם משתמשים בתור זהות השירות.המסוף
נכנסים לדף Service accounts במסוף Google Cloud :
בוחרים את כתובת האימייל של חשבון השירות שמשמשת כזהות השירות.
לוחצים על הכרטיסייה Principals with access.
לוחצים על הכפתור Grant access.
מזינים את כתובת האימייל של חשבון הפריסה שתואמת לחשבון המשתמש שאתם נותנים לו את התפקיד "אדמין" או "מפתח".
בתפריט הנפתח Select a role, בוחרים את התפקיד Service Accounts > Service Account User.
לוחצים על Save.
gcloud
משתמשים בפקודה
gcloud iam service-accounts add-iam-policy-bindingומחליפים את המשתנים המודגשים בערכים המתאימים:gcloud iam service-accounts add-iam-policy-binding \ SERVICE_ACCOUNT_NAME@SERVICE_ACCOUNT_PROJECT_ID. \ --member="PRINCIPAL" \ --role="roles/iam.serviceAccountUser"
מחליפים את מה שכתוב בשדות הבאים:
-
SERVICE_ACCOUNT_NAME: השם של חשבון השירות שאליו מצרפים את המשאב של Cloud Run. -
SERVICE_ACCOUNT_PROJECT_ID: מזהה הפרויקט שבו נמצא חשבון השירות. PRINCIPAL: חשבון הפריסה שאליו מוסיפים את הקישור, בפורמט
user|group|serviceAccount:emailאוdomain:domain. לדוגמה:user:test-user@gmail.comgroup:admins@example.comserviceAccount:test123@example.domain.comdomain:example.domain.com
אתם או האדמין שלכם צריכים להקצות לסוכן השירות של המשאב ב-Cloud Run את התפקיד "יצירת אסימונים בחשבון שירות" (
roles/iam.serviceAccountTokenCreator) בחשבון השירות שבו אתם משתמשים בתור זהות השירות. הפורמט של סוכן השירות הואservice-PROJECT_NUMBER@serverless-robot-prod..המסוף
נכנסים לדף Service accounts במסוף Google Cloud :
בוחרים את כתובת האימייל של חשבון השירות שמשמשת כזהות השירות.
לוחצים על הכרטיסייה Permissions.
לוחצים על הכפתור Grant access.
מזינים את כתובת האימייל של סוכן השירות. לדוגמה:
service-PROJECT_NUMBER@serverless-robot-prod..בתפריט הנפתח Select a role, בוחרים את התפקיד Service Accounts > Service Account Token Creator.
לוחצים על Save.
gcloud
משתמשים בפקודה
gcloud iam service-accounts add-iam-policy-binding:gcloud iam service-accounts add-iam-policy-binding \ SERVICE_ACCOUNT_NAME@SERVICE_ACCOUNT_PROJECT_ID. \ --member="serviceAccount:service-CLOUD_RUN_RESOURCE_PROJECT_NUMBER@serverless-robot-prod." \ --role="roles/iam.serviceAccountTokenCreator"
מחליפים את מה שכתוב בשדות הבאים:
-
SERVICE_ACCOUNT_NAME: השם של חשבון השירות שאליו מצרפים את המשאב של Cloud Run. -
SERVICE_ACCOUNT_PROJECT_ID: מזהה הפרויקט שבו נמצא חשבון השירות. CLOUD_RUN_RESOURCE_PROJECT_NUMBER: מספר הפרויקט שבו נמצא Cloud Run.
הפקודה מדפיסה את מדיניות ההרשאה המעודכנת לחשבון השירות המנוהל על ידי המשתמש.
בפרויקט שמכיל את חשבון השירות הזה, צריך להגדיר את מדיניות הארגון
iam.disableCrossProjectServiceAccountUsageלערך false או לא לאכוף אותה ברמת התיקייה, או שהיא צריכה לעבור בירושה מההגדרות ברמת הפרויקט. כברירת מחדל, ההגדרה היאtrue.המסוף
נכנסים לדף Organization policies במסוף Google Cloud :
בכלי לבחירת פרויקטים, בוחרים את הארגון ואת הפרויקט שבהם רוצים להשבית את השימוש בחשבונות שירות בפרויקטים שונים.
בוחרים את המדיניות disable cross-project service account usage.
לוחצים על ניהול המדיניות.
בקטע מקור המדיניות, בוחרים באפשרות במקום המדיניות של המשאב הראשי.
לוחצים על Add a rule.
בקטע אכיפה, לוחצים על השבתה.
כדי לאכוף את המדיניות, לוחצים על הגדרת מדיניות.
gcloud
בפרויקט שבו נמצא חשבון השירות, מוודאים שהאילוץ
iam.disableCrossProjectServiceAccountUsageשל מדיניות הארגון לא נאכף. האילוץ הזה נאכף כברירת מחדל.כדי להשבית את אילוץ מדיניות הארגון הזה, מריצים את הפקודה:
gcloud resource-manager org-policies disable-enforce iam.disableCrossProjectServiceAccountUsage --project=SERVICE_ACCOUNT_PROJECT_ID
מחליפים את SERVICE_ACCOUNT_PROJECT_ID במזהה הפרויקט שמכיל את חשבון השירות.
אפשר להחיל חברויות בתפקידים ישירות על המשאב של חשבון השירות, או לרשת אותן מרמות גבוהות יותר בהיררכיית המשאבים.
המאמרים הבאים
- למידע נוסף על חשבונות שירות, קראו את המדריכים בנושא חשבון שירות של IAM וחשבון שירות בניהול המשתמש.
- אם השירות, המשימה, מאגר ה-Workers או המכונה של Cloud Run ניגשים לממשקי API או לשירותים של Google Cloud , אתם צריכים להגדיר את חשבון השירות כזהות השירות. מידע נוסף