שמירת כתובת IP פנימית סטטית

המסוף

1. נכנסים לדף IP addresses במסוף Cloud de Confiance .

   מעבר אל כתובות IP

2. לוחצים על Reserve internal static IP address. יכול להיות שתצטרכו ללחוץ על התפריט more_vert פעולות נוספות כדי לראות את הלחצן הזה.
3. בשדה Name, מזינים שם לכתובת ה-IP.
4. ברשימה IP version בוחרים את גרסת ה-IP הנדרשת:
   • כדי לשמור כתובת IPv4 פנימית סטטית, בוחרים באפשרות IPv4.
   • כדי לשמור כתובת IPv6 פנימית סטטית, בוחרים באפשרות IPv6.
5. ברשימות Network ו-Subnetwork, בוחרים רשת VPC ורשת משנה, בהתאמה.
6. מציינים איך רוצים לשריין את כתובת ה-IP:
   • כדי לציין כתובת IPv4 פנימית סטטית להזמנה, בכתובת IP סטטית בוחרים באפשרות אני רוצה לבחור ומזינים כתובת IPv4 מותאמת אישית. אחרת, המערכת מקצה לכם באופן אוטומטי כתובת IPv4 פנימית סטטית ברשת המשנה.
   • לגבי כתובות IPv6, כדי לציין טווח סטטי של כתובות IPv6 פנימיות להקצאה, בוחרים באפשרות Let me choose (אני רוצה לבחור) בשדה Static IPv6 range (טווח סטטי של כתובות IPv6), ואז מזינים טווח מותאם אישית של כתובות IPv6‏ /96 מתוך טווח כתובות ה-IPv6 הפנימיות /64 של תת-הרשת. אחרת, המערכת מקצה לכם באופן אוטומטי טווח כתובות IPv6 פנימיות סטטיות בתת-הרשת.

7. אופציונלי: אם רוצים לשתף את כתובת ה-IPv4 הפנימית הסטטית בחזיתות שונות, בוחרים באפשרות Shared (משותפת) ברשימה Purpose (מטרה). ברירת המחדל היא לא משותף.

8. לוחצים על Reserve.

gcloud

• כדי לשמור כתובת IPv4 פנימית, משתמשים בפקודה compute addresses create:

  gcloud compute addresses create ADDRESS_NAMES \
      --region REGION --subnet SUBNETWORK \
      --addresses IPV4_ADDRESS
  

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

  • ADDRESS_NAMES: השמות של כתובות [--purpose=SHARED_LOADBALANCER_VIP] שרוצים ליצור (לפחות אחת). אם יש כמה כתובות, צריך לציין את כולן כרשימה, ולהפריד ביניהן באמצעות רווחים – לדוגמה, example-address-1 example-address-2 example-address-3
  • ‫REGION: האזור של הבקשה.
  • ‫SUBNETWORK: רשת המשנה של כתובת ה-IP הפנימית הזו.
  • ‫IPV4_ADDRESS: כתובת ה-IP שרוצים לשריין, שחייבת להיות בטווח כתובות ה-IP הראשי של רשת המשנה. אם לא מציינים כתובת IP, המערכת מקצה כתובת IP באופן אוטומטי מרשת המשנה.

• כדי לשמור כתובת IPv6 פנימית, משתמשים בפקודה compute addresses create. מציינים את הערך IPV6 עבור --ip-version:

  gcloud compute addresses create ADDRESS_NAMES \
      --region REGION --subnet SUBNETWORK \
      --ip-version IPV6  \
      --addresses IPV6_ADDRESS
  

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

  • ‫ADDRESS_NAMES: השמות של כתובת אחת או יותר שרוצים לשריין. אם יש כמה כתובות, צריך לציין את כולן כרשימה שמופרדת באמצעות רווחים – למשל, example-address-1 example-address-2 example-address-3
  • ‫REGION: האזור של הבקשה.
  • ‫SUBNETWORK: רשת המשנה של כתובת ה-IPv6 הפנימית הזו.
  • ‫IPV6_ADDRESS: כתובת ה-IP שרוצים לשריין, שחייבת להיות כתובת IPv6‏ /96 מטווח כתובות ה-IPv6 הפנימיות של תת-הרשת /64. אם לא מציינים כתובת IP, המערכת מקצה כתובת IP באופן אוטומטי מתת-הרשת.

דוגמאות

• שמירת כתובת IPv4 פנימית שהוקצתה באופן אוטומטי מתת-רשת:

  gcloud compute addresses create example-address-1 \
      --region us-central1 \
      --subnet subnet-1
  

• שמירת כתובת IPv4 פנימית ספציפית מתת-רשת:

  gcloud compute addresses create example-address-1 \
      --region us-central1 \
      --subnet subnet-1 \
      --addresses 10.128.0.12
  

• שמירת כתובת IPv6 פנימית סטטית מתת-רשת:

  gcloud compute addresses create example-address-1 \
      --region us-central1 \
      --subnet subnet-1 \
      --ip-version IPV6
  

• כדי ליצור כמה כתובות IPv4, מעבירים יותר משם אחד של כתובת IPv4; כל הכתובות שמורות באותה תת-רשת:

  gcloud compute addresses create example-address-1 example-address-2 \
      --region us-central1 \
      --subnet subnet-1 \
      --addresses 10.128.0.12,10.128.0.13
  

Terraform

אתם יכולים להשתמש במודול של Terraform כדי ליצור כתובת IP פנימית.

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

module "address" {
  source     = "terraform-google-modules/address/google"
  version    = "~> 4.0"
  project_id = var.project_id # Replace this with your project ID in quotes
  region     = "asia-east1"
  subnetwork = "my-subnet"
  names      = ["internal-address1", "internal-address2"]
  addresses  = ["10.0.0.3", "10.0.0.4"]
}

בדוגמה הבאה נוצרות שתי כתובות IP פנימיות שהוקצו באופן דינמי:

module "address" {
  source     = "terraform-google-modules/address/google"
  version    = "~> 4.0"
  project_id = var.project_id # Replace this with your project ID in quotes
  region     = "asia-east1"
  subnetwork = "my-subnet"
  names      = ["internal-address1", "internal-address2"]
}

API

משתמשים בשיטה addresses.insert:

POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/REGION/addresses

גם לכתובות IPv4 וגם לכתובות IPv6, גוף הבקשה צריך לכלול את השדה addressType, שצריך להיות INTERNAL, את name של הכתובת ואת subnetwork שאליה כתובת ה-IP שייכת. גוף הבקשה יכול לכלול באופן אופציונלי את purpose של כתובת ה-IP הפנימית.

אתם יכולים לאפשר למערכת להקצות לכם כתובת IP באופן אוטומטי, או להשתמש ב-address כדי לציין כתובת IP פנימית. כתובת IPv4 שאתם שומרים חייבת להיות שייכת לטווח הכתובות הראשי של רשת המשנה. כתובת IPv6 שאתם שומרים חייבת להיות שייכת לטווח כתובות ה-IPv6 הפנימי של תת-הרשת.

{
  "addressType": "INTERNAL",
  "name": "IPV4_ADDRESS_NAME",
  "subnetwork": "regions/REGION/subnetworks/SUBNETWORK",
  "address": "IPV4_ADDRESS",
  "purpose": "GCE_ENDPOINT"
}

לדוגמה:

POST https://compute.s3nsapis.fr/compute/v1/projects/example-project/regions/us-central1/addresses
{
  "addressType": "INTERNAL",
  "name": "example-ipv4-address-1",
  "subnetwork": "regions/us-central1/subnetworks/my-custom-subnet",
  "address": "10.128.0.12",
  "purpose": "GCE_ENDPOINT"
}

לגבי כתובות IPv6 פנימיות, צריך לציין גם את ipVersion כ-IPV6.

{
  "addressType": "INTERNAL",
  "name": "IPV6_ADDRESS_NAME",
  "ipVersion": "IPV6",
  "subnetwork": "regions/REGION/subnetworks/SUBNETWORK",
  "address": "IPV6_ADDRESS",
  "purpose": "GCE_ENDPOINT"
}

לדוגמה:

POST https://compute.s3nsapis.fr/compute/v1/projects/example-project/regions/us-central1/addresses
{
  "addressType": "INTERNAL",
  "name": "example-ipv6-address-1",
  "ipVersion": "IPV6",
  "subnetwork": "regions/us-central1/subnetworks/my-custom-subnet",
  "address": "2001:db8:a0b:c0d:e0f:f0e::",
  "purpose": "GCE_ENDPOINT"
}

המסוף

1. נכנסים לדף IP addresses במסוף Cloud de Confiance .

   מעבר אל כתובות IP

2. לוחצים על כתובות IP פנימיות.
3. אופציונלי: בשדה Filter, כדי לחפש כתובות IP זמניות, מזינים ephemeral ואז בוחרים באפשרות Ephermal : Type מהרשימה הנפתחת.
4. בוחרים את כתובת ה-IP הפנימית שרוצים לקדם.
5. בתפריט More actions (more_vert) בסוף שורת התצוגה של כתובת ה-IP שנבחרה, בוחרים באפשרות Promote to static IP address.
6. מזינים שם לכתובת ה-IP הסטטית החדשה ולוחצים על שמירה.

gcloud

1. לפני שמעלים לקידום כתובת IPv6 פנימית קיימת וזמנית, צריך לדעת את הערך של כתובת ה-IP הזו. משתמשים ב-Google Cloud CLI כדי לשלוח בקשת describe למשאב ולקבל את הערך של כתובת ה-IP.

   • למכונה עם כתובת IPv4, משתמשים בפקודה הבאה:

     gcloud compute instances describe INSTANCE_NAME --zone ZONE | grep "networkIP"
     

   • למכונה עם כתובת IPv6, משתמשים בפקודה הבאה:

     gcloud compute instances describe INSTANCE_NAME --zone ZONE | grep "ipv6Address"
     

   • עבור כלל העברה אזורי, משתמשים בפקודה הבאה:

     gcloud compute forwarding-rules describe FORWARDING_RULE_NAME --region REGION | grep "IPAddress"
     

     לכלל העברה גלובלי, משתמשים בדגל --global במקום בדגל --region.

2. קידום הכתובת:

   • כדי להעביר כתובות IPv4 פנימיות קיימות לרמה גבוהה יותר, משתמשים בפקודה compute addresses create ומספקים את הדגל --addresses עם כתובות ה-IP הפנימיות הספציפיות שרוצים להעביר לרמה גבוהה יותר:

     gcloud compute addresses create IPV4_ADDRESS_NAMES \
       --addresses IPV4_ADDRESSES \
       --region REGION \
       --prefix-length PREFIX_LENGTH \
       --subnet SUBNETWORK
     

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

     • ‫IPV4_ADDRESS_NAMES: השמות של כתובות ה-IPv4. אם יש כמה כתובות, צריך לציין את כל שמות הכתובות כרשימה שמופרדת באמצעות רווחים – לדוגמה, example-address-name-1 example-address-name-2 example-address-name-3. מצהירים על השמות באותו סדר שבו מצהירים על כתובות ה-IP. לדוגמה, נניח שציינתם את שמות הכתובות כ- example-address-name-1 example-address-name-2 example-address-name-3ואת כתובות ה-IPv4 כ-192.0.2.0 192.0.2.1 192.0.2.2. בתרחיש הזה, Compute Engine ממפה את השמות והכתובות באופן הבא:

       • example-address-name-1: 192.0.2.0
       • example-address-name-2: ‏192.0.2.1
       • example-address-name-3: 192.0.2.2

     • ‫IPV4_ADDRESSES: כתובות ה-IPv4 לקידום. אם יש כמה כתובות, צריך לציין את כולן כרשימה שמופרדת באמצעות רווחים – לדוגמה, 192.0.2.0 192.0.2.1 192.0.2.2.

     • ‫REGION: האזור שבו רוצים לשריין את הכתובת הזו.

     • ‫PREFIX_LENGTH: אופציונלי. אורך הקידומת של טווח כתובות ה-IPv4. הערך צריך להיות מספר שלם בין 7 ל-31. צריך לכלול את השדה הזה רק אם מציינים טווח כתובות. אם כתובת ה-IPv4 שצוינה היא כתובת IP יחידה, צריך להשמיט את השדה הזה.

     • ‫SUBNETWORK: רשת המשנה של הבקשה הזו.

   • כדי להקצות כתובת IPv6 חיצונית לכתובת IPv6 פנימית קיימת אחת או יותר, משתמשים בפקודה compute addresses create ומספקים את הדגל --addresses עם כתובות ה-IPv6 הפנימיות הספציפיות:

     gcloud compute addresses create IPV6_ADDRESS_NAMES \
      --addresses IPV6_ADDRESSES \
      --region REGION \
      --prefix-length PREFIX_LENGTH \
      --subnet SUBNETWORK
     

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

     • ‫IPV6_ADDRESS_NAMES: השמות של הכתובת. מצהירים על השמות באותו סדר שבו מצהירים על כתובות ה-IPv6. במקרה הזה, IPV6_ADDRESS_NAME_1 תואם ל-IPV6_ADDRESS_1, ו-IPV6_ADDRESS_NAME_2 תואם ל-IPV6_ADDRESS_2.
     • ‫IPV6_ADDRESS_1,[IPV6_ADDRESS_2,...]: כתובות ה-IPv6 לקידום בפורמט CIDR.
     • ‫PREFIX_LENGTH_1,[PREFIX_LENGTH_2,...]: אורך הקידומת של כתובות IPv6.
     • ‫REGION: האזור שבו רוצים לשריין את הכתובת הזו.
     • ‫SUBNETWORK: רשת המשנה של הבקשה הזו.

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

API

משתמשים בשיטה addresses.insert:

POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/REGION/addresses

גם לכתובות IPv4 וגם לכתובות IPv6, גוף הבקשה צריך לכלול את addressType, שצריך להיות INTERNAL, את name של הכתובת, את address לקידום ואת subnetwork שאליה שייכת כתובת ה-IP. בנוסף, בכתובות IPv6, גוף הבקשה צריך לכלול את prefixLength עם 96 בתור הערך.

• גוף הבקשה לקידום כתובות IPv4 פנימיות:

  {
  "name": "ADDRESS_NAME",
  "addressType": "INTERNAL",
  "address": "IP_ADDRESS",
  "subnetwork": "regions/REGION/subnetworks/SUBNETWORK"
  }
  

  לדוגמה:

  POST https://compute.s3nsapis.fr/compute/v1/projects/example-project/regions/us-central1/addresses
  {
  "name": "example-IPv4-address-1",
  "addressType": "INTERNAL",
  "address": "10.128.0.2",
  "subnetwork": "regions/us-central1/subnetworks/my-custom-subnet"
  }
  

• גוף הבקשה לקידום כתובות IPv6 פנימיות:

  {
  "name": "ADDRESS_NAME",
  "addressType": "INTERNAL",
  "address": "IP_ADDRESS",
  "subnetwork": "regions/REGION/subnetworks/SUBNETWORK"
  "prefixLength": 96
  }
  

  לדוגמה:

  POST https://compute.s3nsapis.fr/compute/v1/projects/example-project/regions/us-central1/addresses
  {
  "name": "example-IPv6-address-1",
  "addressType": "INTERNAL",
  "address": "fd20:0:0::",
  "subnetwork": "regions/us-central1/subnetworks/my-custom-subnet"
  "prefixLength": 96
  }
  

המסוף

1. נכנסים לדף IP addresses במסוף Cloud de Confiance .

   מעבר אל כתובות IP

2. לוחצים על כתובות IP פנימיות.

gcloud

משתמשים בפקודה gcloud compute addresses list:

gcloud compute addresses list

API

משתמשים בשיטה addresses.list:

GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/REGION/addresses

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

• ‫PROJECT_ID: מזהה הפרויקט של הבקשה הזו
• ‫REGION: שם האזור של הבקשה

כדי להציג את כל הכתובות בכל האזורים, משתמשים ב-method‏ addresses.aggregatedList:

GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/aggregated/addresses

המסוף

1. נכנסים לדף IP addresses במסוף Cloud de Confiance .

   מעבר אל כתובות IP

2. בוחרים בכרטיסייה כתובות IP פנימיות.
3. אופציונלי: בשדה Filter, מזינים static ואז בוחרים באפשרות Static : Type מהרשימה הנפתחת.
4. בוחרים את כתובת ה-IP הפנימית הקבועה שרוצים לבטל את ההקצאה שלה.

5. לוחצים על Release static address (שחרור כתובת סטטית) ואז על Release (שחרור) בתיבת הדו-שיח כדי לאשר את הפעולה.

   אם האפשרות הזו לא מופיעה, לוחצים על תפריט פעולות נוספות (more_vert) בסרגל התפריטים העליון, ואז בוחרים באפשרות הסרת כתובת סטטית מהרשימה.

gcloud

משתמשים בפקודה compute addresses delete:

gcloud compute addresses delete ADDRESS_NAME \
    --region REGION

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

• ‫ADDRESS_NAME: השם של הכתובת שרוצים למחוק.
• ‫REGION: האזור שאליו שייכת הכתובת.

לדוגמה:

gcloud compute addresses delete example-address-to-delete \
    --region us-west1

API

משתמשים בשיטה addresses.delete:

DELETE https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/REGION/addresses/ADDRESS_NAME

בדוגמה הזו נמחקת כתובת באזור us-west1:

DELETE https://compute.s3nsapis.fr/compute/v1/projects/myproject/regions/us-west1/addresses/example-address-to-delete