ארגון משאבים באמצעות תוויות

תוויות הן צמדי מפתח/ערך שאפשר להשתמש בהן ב- Cloud de Confiance by S3NS כדי לקבץ משאבים קשורים או משויכים. לדוגמה, ב-Compute Engine אפשר להשתמש בתוויות כדי לקבץ מכונות וירטואליות בקטגוריות כמו ייצור, הכנה או פיתוח, וכך לחפש משאבים ששייכים לכל שלב פיתוח.

אחרי שמוסיפים תוויות למשאבים, אפשר להשתמש בתכונה סינון מקונן כדי לבצע חיפושים מדויקים יותר של המשאבים באמצעות תוויות.

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

• קוראים את התיעוד בנושא דיסקים של אחסון מתמיד.
• קוראים את התיעוד בנושא תמונות.
• אם עדיין לא עשיתם את זה, תצטרכו להגדיר אימות. אימות הוא תהליך שבו מאמתים את הזהות שלכם כדי לקבל גישה לממשקי API ולשירותים של Cloud de Confiance by S3NS . כדי להריץ קוד או דוגמאות מסביבת פיתוח מקומית, אפשר לבצע אימות ל-Compute Engine באחת מהדרכים הבאות:

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

  המסוף

  כשמשתמשים במסוף Cloud de Confiance כדי לגשת לשירותים ולממשקי ה-API, לא צריך להגדיר אימות. Cloud de Confiance by S3NS

  gcloud

  1. התקינו את ה-CLI של Google Cloud ואז היכנסו ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם. אחרי שנכנסתם לחשבון, אתחלו את ה-CLI של Google Cloud באמצעות הפקודה הבאה:

     gcloud init

• הגדרת אזור ותחום כברירת מחדל

REST

כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של API בארכיטקטורת REST שבדף הזה, צריך להשתמש בפרטי הכניסה שאתם נותנים ל-CLI של gcloud.

התקינו את ה-CLI של Google Cloud ואז היכנסו ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם.

מידע נוסף מופיע במאמר אימות לשימוש ב-REST במסמכי האימות של Cloud de Confiance .

מהן תוויות?

תווית היא צמד מפתח/ערך שאפשר להקצות ל Cloud de Confiance by S3NS מופעים. הם עוזרים לכם לארגן את המשאבים האלה ולנהל את העלויות בקנה מידה נרחב, ברמת הפירוט שאתם צריכים. אפשר לצרף תוויות לכל משאב כדי לסנן את המשאבים לפי תוויות. המידע על התוויות מועבר למערכת החיוב, כך שתוכלו לפרט את החיובים לפי תוויות. בעזרת דוחות החיוב המובנים, אפשר לסנן ולקבץ את העלויות לפי תוויות משאבים.

הדרישות לגבי תוויות

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

• אפשר להוסיף עד 64 תוויות לכל משאב.
• כל תווית צריכה להיות צמד מפתח/ערך.
• האורך המינימלי של המפתחות הוא תו אחד, והאורך המקסימלי הוא 63 תווים. המפתחות לא יכולים להיות ריקים. הערכים יכולים להיות ריקים, והאורך המקסימלי שלהם הוא 63 תווים.
• המפתחות והערכים יכולים להכיל רק אותיות קטנות, ספרות, קווים תחתונים ומקפים. כל התווים צריכים להיות בקידוד UTF-8, ומותר להשתמש בתווים בינלאומיים. המפתחות צריכים להתחיל באות קטנה או בתו בינלאומי.
• החלק של המפתח בתווית חייב להיות ייחודי בתוך משאב יחיד. עם זאת, אפשר להשתמש באותו מפתח עם כמה משאבים.

המגבלות האלה חלות על המפתח והערך של כל תווית, ועל המשאבים Cloud de Confiance הבודדים שיש להם תוויות. אין הגבלה על מספר התוויות שאפשר להחיל על כל המשאבים בפרויקט.

שימושים נפוצים בתוויות

ריכזנו כאן כמה תרחישי שימוש נפוצים בתוויות:

• תוויות של צוותים או מרכזי עלות: אפשר להוסיף תוויות שמבוססות על צוות או על מרכז עלות כדי להבחין בין מקרים ששייכים לצוותים שונים (לדוגמה, team:research ו-team:analytics). אפשר להשתמש בסוג הזה של תוויות לניהול חשבונות או לתקצוב.

• תוויות רכיבים: לדוגמה, component:redis,‏ component:frontend,‏ component:ingest ו-component:dashboard.

• תוויות של סביבה או שלב: לדוגמה, environment:production ו-environment:test.

• תוויות של מדינות: לדוגמה, state:active,‏ state:readytodelete ו-state:archive.

• תוויות בעלות: משמשות לזיהוי הצוותים שאחראים על הפעולות, לדוגמה: team:shopping-cart.

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

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

תוויות ותגים

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

שימוש בתוויות ב-Compute Engine

אפשר להחיל תוויות על המשאבים הבאים של Compute Engine:

• מכונות וירטואליות (VM)
• תמונות
• דיסקים לאחסון מתמיד
• תמונות מצב של Persistent Disk

אפשר גם להשתמש בתוויות ברכיבים קשורים Cloud de Confiance by S3NS כמו אלה:

• קטגוריות של Cloud Storage
• מקורות מידע בנושא רשתות:
  • כללי העברה שמשמשים עם מאזני עומסים פנימיים של אפליקציות (לא ניתן להשתמש בכללי העברה של מאזני עומסים אחרים)
  • מנהרות VPN
  • כתובות IP חיצוניות סטטיות

לדוגמה, אפשר להוסיף את התוויות הבאות כצמדים של מפתח/ערך למשאבים:

{
 "labels": {
    "vmrole": "webserver",
    "environment": "production",
    "location": "west",...
    }
 }

יצירת משאבים עם תוויות

כשיוצרים משאב חדש, אפשר להחיל עליו תוויות.

gcloud compute instances create ... \
    --labels webserver=backend,media=images

POST https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instances

{
 "name": "myVM",
 "machineType": "zones/us-central1-f/machineTypes/custom-2-15360-ext",
  ...,
 "labels": {
   "webserver": "backend",
   "media": "images"
  }
}

הוספה או עדכון של תוויות למשאבים קיימים

אפשר להוסיף תוויות או לעדכן תוויות קיימות במשאבים באמצעותCloud de Confiance המסוף, ה-CLI של gcloud או Compute Engine API. כדי להוסיף או לעדכן תוויות לכללי העברה, משתמשים ב-CLI של gcloud או ב-Compute Engine API.

gcloud compute disks update example-disk \
    --update-labels backend=webserver,media=images

POST https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instances/example-instance/setLabels

{
 "labels": {
  "environment": "test",
  "an-existing-tag": "yes"
 },
 "labelFingerprint": "42WmSpB8rSM="
}

הצגת תוויות

אפשר לראות את התוויות של המשאבים באמצעות Cloud de Confiance המסוף, ה-CLI של gcloud או Compute Engine API. כדי לראות את התוויות של כללי העברה, משתמשים ב-CLI של gcloud או ב-Compute Engine API.

gcloud compute disks describe example-disk

...
id: '5047929990219134234'
kind: compute#disk
labelFingerprint: GHZ1Un209U=0
labels:
  environment: dev
  department: finance
...

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME

קבלת טביעת אצבע של תווית לבקשות API

כשמעדכנים או מוסיפים תוויות ב-API, צריך לספק את טביעת האצבע העדכנית של התוויות עם הבקשה, כדי למנוע התנגשויות עם בקשות אחרות. נדרשת טביעת אצבע רק לבקשות API. לא נדרשת טביעת אצבע ל- Cloud de Confiance console ולכלי Google Cloud CLI.

כדי לקבל את הגרסה האחרונה של labelsFingerprint, שולחים בקשת GET למקורות המידע הבאים:

• למכונות וירטואליות, משתמשים בשיטה instances.get().
• לצילומי מצב, משתמשים בשיטה snapshots.get().
• לתמונות, משתמשים ב-images.get() method.
• לדיסקים, משתמשים בשיטה disks.get().
• לכללי העברה, משתמשים בשיטה forwardingRules.get().
• לכתובות IP חיצוניות סטטיות אזוריות, משתמשים בשיטה addresses.get() בגרסת בטא.
• לכתובות IP חיצוניות סטטיות גלובליות, משתמשים בשיטה beta globalAddresses.get().
• למנהרות VPN, משתמשים בשיטה בגרסת בטא vpnTunnels.get().

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

GET https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instances/example-instance

התשובה מכילה את המאפיין labelFingerprint:

200 OK

{
 "kind": "compute#instance",
 "id": "4392196237934605253",
 "creationTimestamp": "2015-09-15T14:05:16.475-07:00",
 "zone": "https://content.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f",
 "status": "RUNNING",
 ...
 "labels": {
  "environment": "test"
 },
 "labelFingerprint": "p1ty_9HoBk0="
}

הסרת תווית

אפשר להסיר תוויות ממשאבים באמצעות מסוף Cloud de Confiance , ה-CLI של gcloud או Compute Engine API. כדי להסיר תוויות מכללי העברה, משתמשים ב-CLI של gcloud או ב-Compute Engine API.

gcloud compute disks update example-disk \
    --remove-labels backend,media

POST https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instances/example-instance/setLabels

{
 "labels": { },
 "labelFingerprint": "42WmSpB8rSM="
}

סינון חיפושים באמצעות תוויות

אפשר לחפש את המשאבים ולסנן את התוצאות לפי תוויות באמצעותCloud de Confiance המסוף, ה-CLI של gcloud או Compute Engine API. כדי לסנן כללי העברה לפי תוויות, משתמשים ב-CLI של gcloud או ב-Compute Engine API.

gcloud compute instances list \
    --filter labels.env=dev

GET https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances?filter=labels.env%3Adev

הקשר בין תוויות של מכונות וירטואליות לבין תגים

בעבר, תוויות ותגים היו קשורים זה לזה. לדוגמה, אם הוספתם את התווית webserver:test למכונה וירטואלית, מערכת Compute Engine הוסיפה באופן אוטומטי את התג webserver למכונה הווירטואלית.

עכשיו התוויות והתגים נפרדים. אם יוצרים תווית במכונה וירטואלית,‏ Compute Engine לא יוצר תג למכונה הווירטואלית. אם אתם צריכים ליצור תג במכונה וירטואלית, אתם צריכים ליצור את התג באופן ידני.

לסקירה כללית על התגים

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

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