יצירת טווחים של קבוצות מולטיקאסט

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

סקירה כללית של תהליך ההגדרה של Cloud Multicast מופיעה במאמר סקירה כללית של הגדרת Cloud Multicast.

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

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

יצירת טווח של קבוצות מולטיקאסט

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

יצירת טווח קבוצה

משייכים טווח כתובות IP של קבוצת מולטיקאסט לדומיין המולטיקאסט.

gcloud

  1. מזמינים טווח פנימי ברשת ה-VPC של האדמין של שידור מרובה משתתפים, שמכיל את כתובות ה-IP של קבוצת השידור המרובה שרוצים להשתמש בה. כדי לשמור טווח פנימי, משתמשים בפקודה network-connectivity internal-ranges create.

    gcloud network-connectivity internal-ranges create INTERNAL_RANGE_NAME \
   --network=ADMIN_NETWORK \
   --ip-cidr-range=CIDR_RANGE

    מחליפים את הערכים הבאים:

    • ‫INTERNAL_RANGE_NAME: שם לטווח הפנימי שרוצים לשריין
    • ‫ADMIN_NETWORK: השם של רשת האדמין של ה-multicast

    • ‫CIDR_RANGE: טווח ה-CIDR שרוצים לשריין

      טווח ה-CIDR שאתם מציינים חייב להיות כתובת מסוג D (למשל 224.0.0.0 עד 239.255.255.255). בנוסף, המספר הכולל של כתובות ה-IP בטווח אחד או יותר של קבוצות מולטיקאסט שמשויכות לאותו דומיין לא יכול לחרוג מהמכסה של קבוצות מולטיקאסט לכל דומיין.

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

  2. יוצרים טווח של קבוצות מולטיקאסט באמצעות הטווח הפנימי שהזמנתם. כדי ליצור טווח של קבוצות מולטיקאסט, משתמשים בפקודה network-services multicast-group-ranges create.

    gcloud network-services multicast-group-ranges create GROUP_RANGE_NAME \
   --multicast-domain="projects/ADMIN_PROJECT/locations/global/multicastDomains/DOMAIN_NAME" \
   --reserved-internal-range="projects/ADMIN_PROJECT/locations/global/internalRanges/INTERNAL_RANGE_NAME" \
   --location=global \
   [--require-explicit-accept ] \
   [--consumer-accept-list=CONSUMER_ACCEPT_LIST] \
   [--distribution-scope=DISTRIBUTION_SCOPE] \
   [--enable-logging | --no-enable-logging]

    מחליפים את הערכים הבאים:

    • ‫GROUP_RANGE_NAME: שם לטווח של קבוצת מולטיקאסט
    • ‫DOMAIN_NAME: השם של תחום ה-multicast שיצרתם קודם
    • ‫ADMIN_PROJECT: המזהה של פרויקט האדמין של ה-Multicast
    • ‫INTERNAL_RANGE_NAME: השם של הטווח הפנימי שהזמנתם קודם

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

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

      • ‫--require-explicit-accept: קובע אילו פרויקטים יכולים להשתמש בטווח של קבוצת ה-Multicast אם הרשימה של צרכני ה-Multicast ריקה. ההגדרה הזו קובעת אם פרויקט צרכן מולטיקאסט יכול להפעיל רשת VPC של צרכן מולטיקאסט עבור טווח הקבוצות.
        • כדי לדחות את כל הפרויקטים, צריך לכלול את הדגל הזה. פרויקט יכול להשתמש בטווח הקבוצה רק אם מוסיפים אותו לרשימת המקבלים של שידורי מולטיקאסט.
        • (ברירת מחדל) כדי לאפשר את כל הפרויקטים, לא כוללים את הדגל הזה. כל פרויקט שיש לו גישה לדומיין של שידור מרובה משתתפים יכול להשתמש בטווח הקבוצה. בטופולוגיית הכוכב של Network Connectivity Center ‏ (NCC), מעניקים לפרויקט גישה לדומיין על ידי אישור שלו לרכזת.

      • ‫CONSUMER_ACCEPT_LIST: אם ציינתם --require-explicit-accept, תוכלו להזין רשימה של פרויקטים של צרכני Multicast שיכולים להשתמש בטווח הזה של קבוצות Multicast. אם פרויקט צרכן של שידור מרובה משתתפים לא נמצא ברשימת ההיתרים, הפרויקט לא יכול ליצור הגדרות של צרכן שידור מרובה משתתפים באמצעות טווח הכתובות של הקבוצה הזו.

        אפשר לציין עד 100 פרויקטים לפי מזהה הפרויקט או השם שלו.

      • ‫DISTRIBUTION_SCOPE: קובע את היקף המיקום של תעבורת מולטיקאסט. אי אפשר לעדכן את המאפיין הזה מאוחר יותר.

        • כדי לאפשר לטווח הזה לשלוח תנועת נתונים של Multicast רק בתוך אזור, צריך להגדיר את הדגל הזה ל-intra-zone.
        • (ברירת מחדל) כדי לאפשר לטווח הזה לשלוח תנועת מולטיקאסט בין אזורים, מגדירים את הדגל הזה ל-intra-region.

      • ‫--[no-]enable-logging: קובע אם רישום ביומן של אירועים לגבי חברות בקבוצה מופעל.

        • כדי להפעיל את הרישום ביומן, משתמשים ב---enable-logging.
        • (ברירת מחדל) כדי להשבית את הרישום ביומן, משתמשים באפשרות --no-enable-logging.

API

  1. מזמינים טווח פנימי ברשת ה-VPC של האדמין של שידור מרובה משתתפים, שמכיל את כתובות ה-IP של קבוצת השידור המרובה שרוצים להשתמש בה. כדי לשמור טווח פנימי, משתמשים בשיטת internalRanges.create.

    POST https://networkconnectivity.googleapis.com/v1/projects/ADMIN_PROJECT/locations/global/internalRanges?internalRangeId=INTERNAL_RANGE_NAME
{
  "network": "projects/ADMIN_PROJECT/global/networks/ADMIN_NETWORK",
  "ipCidrRange": "CIDR_RANGE"
}

    מחליפים את הערכים הבאים:

    • ‫INTERNAL_RANGE_NAME: שם לטווח הפנימי שרוצים לשריין
    • ‫ADMIN_PROJECT: המזהה של פרויקט האדמין של ה-Multicast
    • ‫ADMIN_NETWORK: השם של רשת האדמין של ה-multicast

    • ‫CIDR_RANGE: טווח ה-CIDR שרוצים לשריין

      טווח ה-CIDR שאתם מציינים חייב להיות כתובת מסוג D (למשל 224.0.0.0 עד 239.255.255.255). בנוסף, המספר הכולל של כתובות ה-IP בטווח אחד או יותר של קבוצות מולטיקאסט שמשויכות לאותו דומיין לא יכול לחרוג מהמכסה של קבוצות מולטיקאסט לכל דומיין.

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

  2. יוצרים טווח של קבוצות מולטיקאסט באמצעות הטווח הפנימי שהזמנתם. כדי ליצור טווח של קבוצות מולטיקאסט, משתמשים בשיטה multicastGroupRanges.create.

    POST https://networkservices.googleapis.com/v1/projects/ADMIN_PROJECT/locations/global/multicastGroupRanges?multicastGroupRangeId=GROUP_RANGE_NAME
{
  "multicastDomain": "projects/ADMIN_PROJECT/locations/global/multicastDomains/DOMAIN_NAME",
  "reservedInternalRange": "projects/ADMIN_PROJECT/locations/global/internalRanges/INTERNAL_RANGE_NAME",
  "requireExplicitAccept": "REQUIRE_EXPLICIT_ACCEPT",
  "consumerAcceptList": [
      "CONSUMER_ACCEPT_LIST"
  ],
  "distributionScope": "DISTRIBUTION_SCOPE",
  "logConfig": {
      "enabled": "LOGGING_ENABLED"
 }
}

    מחליפים את הערכים הבאים:

    • ‫GROUP_RANGE_NAME: שם לטווח של קבוצת מולטיקאסט
    • ‫ADMIN_PROJECT: המזהה של פרויקט האדמין של ה-Multicast
    • ‫DOMAIN_NAME: השם של תחום ה-multicast שיצרתם קודם
    • ‫INTERNAL_RANGE_NAME: השם של הטווח הפנימי שהזמנתם קודם

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

    • ‫REQUIRE_EXPLICIT_ACCEPT: קובע אילו פרויקטים יכולים להשתמש בטווח של קבוצת ה-Multicast אם consumerAcceptList ריק. ההגדרה הזו קובעת אם פרויקט צרכן מולטיקאסט יכול להפעיל רשת VPC של צרכן מולטיקאסט עבור טווח הקבוצות.
      • כדי לדחות את כל הפרויקטים, מגדירים את הערך true. אפשר להשתמש בטווח הקבוצה בפרויקט רק אם מוסיפים אותו ל-consumerAcceptList.
      • (ברירת מחדל) כדי לאפשר את כל הפרויקטים, מגדירים את הערך false. כל פרויקט שיש לו גישה לדומיין של שידור מרובה משתתפים יכול להשתמש בטווח הקבוצה. בטופולוגיית הכוכב של NCC, מעניקים לפרויקט גישה לדומיין על ידי אישור שלו במרכז.

    • ‫CONSUMER_ACCEPT_LIST: אם מגדירים את requireExplicitAccept ל-true, אפשר להזין רשימה של פרויקטים של צרכני מולטיקאסט שיכולים להשתמש בטווח הזה של קבוצות מולטיקאסט.

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

      אפשר לציין עד 100 פרויקטים לפי מזהה הפרויקט או השם שלו. צריך להשתמש בפורמט הבא: "consumerAcceptList": ["project-1", "project-2"].

    • ‫DISTRIBUTION_SCOPE: קובע את היקף המיקום של תעבורת מולטיקאסט. אי אפשר לעדכן את המאפיין הזה מאוחר יותר.

      • כדי לאפשר לטווח הזה לשלוח תנועת מולטיקאסט רק בתוך אזור, צריך להגדיר את הערך INTRA_ZONE.
      • (ברירת מחדל) כדי לאפשר לטווח הזה לשלוח תנועת נתונים של Multicast בין אזורים, צריך להגדיר את הערך INTRA_REGION.

    • ‫LOGGING_ENABLED: קובע אם רישום ביומן של אירועים לגבי חברות בקבוצה מופעל.

      • כדי להפעיל את הרישום ביומן, מגדירים את הערך true.
      • (ברירת מחדל) כדי להשבית את הרישום ביומן, מגדירים את הערך false.

הפעלת טווח הקבוצות

מפעילים את טווח הקבוצות בכל אזור שבו יצרני או צרכני Multicast צריכים להשתמש בכתובות ה-IP המשויכות של הקבוצה.

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

gcloud

כדי להפעיל טווח של קבוצות מולטיקאסט, משתמשים בפקודה network-services multicast-group-range-activations create.

  gcloud network-services multicast-group-range-activations create GROUP_RANGE_ACTIVATION_NAME \
     --multicast-domain-activation="projects/ADMIN_PROJECT/locations/ZONE/multicastDomainActivations/DOMAIN_ACTIVATION_NAME" \
     --multicast-group-range="projects/ADMIN_PROJECT/locations/global/multicastGroupRanges/GROUP_RANGE_NAME" \
     --location=ZONE \
     [--enable-logging | --no-enable-logging]

מחליפים את הערכים הבאים:

  • ‫GROUP_RANGE_ACTIVATION_NAME: שם להפעלה של טווח קבוצות מולטיקאסט
  • ‫ADMIN_PROJECT: מזהה הפרויקט של מנהל ה-Multicast
  • ‫ZONE: האזור שבו רוצים להפעיל את טווח הקבוצה. האזור הזה חייב להיות אזור שבו הפעלתם בעבר את הדומיין.
  • ‫DOMAIN_ACTIVATION_NAME: השם של הפעלת הדומיין שיצרתם קודם באזור הזה
  • ‫GROUP_RANGE_NAME: השם של טווח הקבוצות שיצרתם קודם
  • ‫--[no-]enable-logging: אופציונלי, קובע אם רישום ביומן של אירועים לגבי חברות בקבוצה מופעל. הגדרת הדגל הזה בהפעלה של טווח קבוצות אזוריות מחליפה את ההגדרה של טווח הקבוצות הגלובלי.
    • כדי להפעיל את הרישום ביומן, משתמשים ב---enable-logging.
    • (ברירת מחדל) כדי להשבית את הרישום ביומן, משתמשים באפשרות --no-enable-logging.

API

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

POST https://networkservices.googleapis.com/v1/projects/ADMIN_PROJECT/locations/ZONE/multicastGroupRangeActivations?multicastGroupRangeActivationId=GROUP_RANGE_ACTIVATION_NAME
{
    "multicastDomainActivation": "projects/ADMIN_PROJECT/locations/ZONE/multicastDomainActivations/DOMAIN_ACTIVATION_NAME",
    "multicastGroupRange": "projects/ADMIN_PROJECT/locations/global/multicastGroupRanges/GROUP_RANGE_NAME",
    "logConfig": {
          "enabled": "LOGGING_ENABLED"
    }
}

מחליפים את הערכים הבאים:

  • ‫GROUP_RANGE_ACTIVATION_NAME: שם להפעלה של טווח קבוצות מולטיקאסט
  • ‫ADMIN_PROJECT: מזהה הפרויקט של מנהל ה-Multicast
  • ‫ZONE: האזור שבו רוצים להפעיל את טווח הקבוצה. האזור הזה חייב להיות אזור שבו הפעלתם בעבר את הדומיין.
  • ‫DOMAIN_ACTIVATION_NAME: השם של הפעלת הדומיין שיצרתם קודם באזור הזה
  • ‫GROUP_RANGE_NAME: השם של טווח הקבוצות שיצרתם קודם
  • ‫LOGGING_ENABLED: קובע אם רישום ביומן של אירועים לגבי חברות בקבוצה מופעל. הגדרת רישום ביומן בהפעלה של טווח קבוצות אזורי מבטלת את ההגדרה של טווח הקבוצות הגלובלי.
    • כדי להפעיל את הרישום ביומן, מגדירים את הערך true.
    • (ברירת מחדל) כדי להשבית את הרישום ביומן, מגדירים את הערך false.

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