ניהול תוויות של סביבות ופירוט עלויות של סביבות

‫Managed Airflow (דור 3) | Managed Airflow (דור 2) | Managed Airflow (דור 1 מדור קודם)

בדף הזה מוסבר איך להקצות תוויות לסביבות Managed Airflow, ואז לפרט את עלויות החיוב על סמך התוויות האלה.

מידע על תוויות סביבה

תוויות סביבה הן צמדי מפתח/ערך שאפשר להקצות לסביבות. לדוגמה, אם owner:engineering-team היא תווית מותאמת אישית, אז owner הוא המפתח ו-engineering-team הוא הערך.

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

תוויות של סביבות בדוחות חיוב

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

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

התוויות לא חלות רטרואקטיבית. לדוגמה, אם תקצו תווית ב-15 במאי, עלויות החיוב של 14 במאי לא יכללו את התווית שהוקצתה.

הקצאת תוויות לסביבות חדשות

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

הקצאת תוויות לסביבות קיימות

המסוף

1. נכנסים לדף Environments במסוף Google Cloud :

   מעבר אל Environments

2. בוחרים את הסביבה.

3. עוברים לכרטיסייה תוויות.

4. לוחצים על עריכה ואז על הוספת תווית.

5. מוסיפים צמד מפתח/ערך לתווית ולוחצים על שמירה.

6. מחכים עד שהסביבה תתעדכן.

gcloud

כשמעדכנים סביבה באמצעות הפקודה gcloud composer, הארגומנטים הבאים מציינים תוויות לסביבה:

• ‫--clear-labels מסיר את כל התוויות.

• ‫--update-labels מעדכן תוויות שצוינו, ויוצר תוויות חדשות אם הן לא קיימות.

• ‫--remove-labels מסיר תוויות שצוינו. תוויות שצוינו שלא קיימות מושמטות.

אם משתמשים בכמה מהארגומנטים האלה, הם מוחלים בסדר הבא: --clear-labels, --update-labels, --remove-labels.

עדכון או יצירה של תוויות

gcloud composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --update-labels LABEL_KEY=LABEL_VALUE

הסרת תוויות שצוינו

gcloud composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --remove-labels LABEL_KEY

הסרת כל התוויות

gcloud composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --clear-labels

מחליפים את:

• ‫ENVIRONMENT_NAME בשם הסביבה.
• ‫LOCATION עם האזור שבו הסביבה ממוקמת.
• ‫LABEL_KEY עם מפתח התווית של הסביבה שרוצים ליצור, לעדכן או להסיר.
• ‫LABEL_VALUE עם ערך התווית של הסביבה.

דוגמה

בדוגמה הבאה אנחנו מעדכנים את התווית owner, יוצרים את התווית החדשה env ומסירים את התווית misc:

gcloud composer environments update example-environment \
    --location us-central1 \
    --update-labels owner=engineering-team,env=production \
    --remove-labels misc

API

כשמעדכנים סביבה, מציינים תוויות חדשות של הסביבה במשאב Environment.

החלפת כל התוויות

כדי להחליף את כל התוויות, צריך לכלול את labels בפרמטר השאילתה updateMask ולספק את התוויות החדשות בגוף הבקשה.

// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask.fieldPaths=labels

{
  "labels":{
      "LABEL_KEY": "LABEL_VALUE"
    }
}

מחליפים את:

• ‫LABEL_KEY עם מפתח של תווית הסביבה.
• ‫LABEL_VALUE עם ערך חדש לתווית הסביבה.

דוגמה:

// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask.fieldPaths=labels

{
  "labels": {
    "owner": "engineering-team",
    "env": "production"
  }
}

הסרת כל התוויות

כדי להסיר את כל התוויות, צריך לכלול את המחרוזת labels בפרמטר השאילתה updateMask ולא לציין את ערך ההחלפה.

עדכון תוויות פרטניות

כדי לעדכן תווית או להוסיף תווית חדשה לתוויות קיימות, כוללים את labels.LABEL_KEY בפרמטר השאילתה updateMask ומספקים החלפה בגוף הבקשה.

// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask=labels.LABEL_KEY

{
  "labels":{
      "LABEL_KEY": "LABEL_VALUE"
    }
}

מחליפים את:

• ‫LABEL_KEY עם מפתח של תווית הסביבה.
• ‫LABEL_VALUE עם ערך חדש לתווית הסביבה.

דוגמה:

// PATCH https://composer.googleapis.com/v1/
// ?name=projects/example-project/locations/
// us-central1/environments/example-environment
// &updateMask=labels.owner,labels.env

{
  "labels": {
    "owner": "engineering-team",
    "env": "production"
  }
}

הסרת תוויות ספציפיות

כדי להסיר תוויות, צריך לכלול את labels.LABEL_KEY בפרמטר השאילתה updateMask ולא לספק את ערך ההחלפה.

Terraform

כדי ליצור סביבה עם פרמטרים שמוגדרים כברירת מחדל במיקום שצוין, עורכים את הבלוק labels בהגדרות של Terraform ומריצים את הפקודה terraform apply.

resource "google_composer_environment" "example" {
  name = "example-environment"
  region = "us-central1"

  labels = {
    LABEL_KEY = "LABEL_VALUE"
  }

}

מחליפים את:

• ‫LABEL_KEY במפתח התווית של הסביבה שרוצים ליצור או לעדכן. כדי להסיר תוויות, מוחקים את השדות שלהן.
• ‫LABEL_VALUE עם ערך התווית של הסביבה.

דוגמה:

resource "google_composer_environment" "example" {
  name = "example-environment"
  region = "us-central1"

  labels = {
    owner = "engineering-team"
    env = "production"
  }
}

הצגת תוויות בדוחות

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

1. צפייה בדוחות החיוב ב-Cloud בחשבון לחיוב ב-Cloud.

2. בדף דוחות:

   1. לוחצים על הצגת המסננים.
   2. בתיבת הדו-שיח Filters, מרחיבים את הקטע Labels.
   3. סינון הנתונים שמוצגים על סמך מפתחות וערכים של תוויות הסביבה.

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

• תמחור של Managed Airflow