איך מתחילים להשתמש ב-Config Connector

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

  • מפעילים Google Cloud API.
  • יצירה וניהול של נושא 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. אם אתם מעדיפים לשמור את המשאב הזה, קראו את ההוראות במאמר ניהול ומחיקה של משאבים.

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