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

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, תוכלו להזין רשימה של פרויקטים של צרכני מולטיקאסט שיכולים להשתמש בטווח הזה של קבוצות מולטיקאסט. אם פרויקט צרכן של שידור מרובה משתתפים לא נמצא ברשימת ההיתרים, הפרויקט לא יכול ליצור הגדרות של צרכן שידור מרובה משתתפים באמצעות טווח הקבוצות הזה.

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

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

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

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

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

API

1. מזמינים טווח פנימי ברשת ה-VPC של האדמין של שידור מרובה משתתפים, שמכיל את כתובות ה-IP של קבוצת השידור המרובה שרוצים להשתמש בה. כדי לשמור טווח פנימי, משתמשים ב-method ‏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: השם של הטווח הפנימי שהזמנתם קודם

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

   • ‫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.
     • (ברירת מחדל) כדי לאפשר לטווח הזה לשלוח תעבורת מולטיקאסט בין אזורים, צריך להגדיר את הערך INTRA_REGION.

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

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

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.