תחילת העבודה עם Config Connector

במדריך הזה מוסבר איך לבצע את הפעולות הבאות כדי ללמוד את היסודות של ניהול משאבים ב-Config Connector:

  • מפעילים API Google Cloud .
  • יצירה וניהול של נושא Pub/Sub.

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

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

חיפוש משאבים זמינים Google Cloud

כדי לראות אילו סוגים של Google Cloud משאבים אפשר ליצור באמצעות Config Connector, מריצים את הפקודה:

kubectl get crds --selector cnrm.cloud.google.com/managed-by-kcc=true

הפלט הוא רשימה של כל המשאבים שגרסת Config Connector יכולה ליצור ולנהל.

לדוגמה, אפשר להציג את תיאור ה-API של המשאב PubSubTopic באמצעות kubectl describe:

kubectl describe crd pubsubtopics.pubsub.cnrm.cloud.google.com

אפשר לראות מידע על משאבים זמינים גם במאמר בנושא משאבי Config Connector.

הפעלת שירות Pub/Sub

כדי להפעיל את Pub/Sub API באמצעות Config Connector, צריך להחיל הגדרת YAML על האשכול:

  1. יוצרים קובץ בשם enable-pubsub.yaml ומעתיקים אליו את קוד ה-YAML הבא:

    apiVersion: serviceusage.cnrm.cloud.google.com/v1beta1
kind: Service
metadata:
  name: pubsub.googleapis.com
spec:
  projectRef:
    external: projects/PROJECT_ID

    מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud.

  2. משתמשים בפקודה kubectl apply כדי להחיל את ההגדרה על האשכול. כדי להפעיל את Pub/Sub API, מריצים את הפקודה הבאה:

    kubectl apply -f enable-pubsub.yaml

יצירת מופע Pub/Sub

יוצרים קובץ בשם pubsub-topic.yaml עם התוכן הבא:

  apiVersion: pubsub.cnrm.cloud.google.com/v1beta1
  kind: PubSubTopic
  metadata:
    annotations:
      cnrm.cloud.google.com/project-id: PROJECT_ID
    labels:
      LABEL_KEY: LABEL_VALUE
    name: TOPIC_NAME

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫LABEL_KEY: LABEL_VALUE: זוג של מפתח וערך של תוויות. לדוגמה, environment: production.
  • ‫TOPIC_NAME: שם נושא ה-Pub/Sub.

כשיוצרים משאב, Config Connector יוצר את המשאב אם הוא לא קיים. אם משאב Google Cloud כבר קיים עם אותו שם, Config Connector מקבל את המשאב ומנהל אותו. מידע נוסף על רכישת משאב קיים זמין במאמר ניהול משאבים ומחיקתם.

משתמשים בפקודה kubectl apply כדי ליצור משאבים. כדי ליצור את נושא ה-Pub/Sub, מריצים את הפקודה הבאה:

kubectl apply -f pubsub-topic.yaml

תיאור משאב

כדי לקבל פרטים על משאב, משתמשים ב-kubectl describe.

לדוגמה, כדי לראות את כל הנושאים של Pub/Sub, מריצים את הפקודה הבאה:

kubectl describe pubsubtopics

ברשימה הזו אמור להופיע נושא Pub/Sub שיצרתם בקטע הקודם.

אימות של מוכנות משאב

אחרי שיוצרים נושא Pub/Sub, אפשר לבדוק את status.condition שלו. לדוגמה, כדי לבדוק אם משאב הנושא של Pub/Sub מוכן, מריצים את הפקודה הבאה:

kubectl wait --for=condition=READY pubsubtopics TOPIC_NAME

מחליפים את TOPIC_NAME בשם הנושא של Pub/Sub.

הפלט אמור להיראות כך:

pubsubtopic.pubsub.cnrm.cloud.google.com/TOPIC_NAME condition met

עדכון משאב

אפשר לעדכן את המטא-נתונים של המשאבים על ידי עדכון קובץ ה-YAML והחלה מחדש שלו באמצעות kubectl.

כדי לשנות את התווית בנושא Pub/Sub שיצרתם בקטע הקודם, מבצעים את הפעולות הבאות:

  1. משנים את התווית בקטע metadata בקובץ pubsub-topic.yaml:

      apiVersion: pubsub.cnrm.cloud.google.com/v1beta1
  kind: PubSubTopic
  metadata:
    annotations:
      cnrm.cloud.google.com/project-id: PROJECT_ID
    labels:
      NEW_LABEL_VALUE
    name: TOPIC_NAME

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
    • ‫NEW_LABEL_VALUE: ערך מעודכן של התווית שהוספתם קודם. לדוגמה, environment: staging.
    • ‫TOPIC_NAME: שם נושא ה-Pub/Sub

  2. משתמשים ב-kubectl apply כדי לעדכן את המשאב. מריצים את הפקודה הבאה:

    kubectl apply -f pubsub-topic.yaml

  3. בודקים את המופע של Pub/Sub כדי לראות אם השם השתנה:

    kubectl describe pubsubtopics

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

מחיקת משאב

משתמשים ב-kubectl delete כדי למחוק משאבים. לדוגמה, כדי למחוק את PubSubTopic שיצרתם קודם, מריצים את הפקודה kubectl delete עם הקובץ pubsub-topic.yaml:

kubectl delete -f pubsub-topic.yaml

תקבלו אישור שהמשאב נמחק:

pubsubtopic.pubsub.cnrm.cloud.google.com "TOPIC_NAME" deleted

כברירת מחדל, Config Connector מוחק את משאב PubSubTopic. אם אתם מעדיפים לשמור את המשאב הזה, תוכלו לעיין בהוראות שבמאמר ניהול ומחיקה של משאבים.

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