בדף הזה מוסבר איך להגדיר מרחב שמות של Service Directory, לרשום שירות במרחב השמות ולהוסיף נקודות קצה לשירות. אפשר ליצור מרחב שמות כשרושמים שירות או לפני שרושמים שירות.
לפני שמריצים את הפקודות שמפורטות בדף הזה, כדאי לעיין במושגים שבמאמר סקירה כללית על Service Directory ובמונחים מרכזיים שקשורים ל-Service Directory.
הגדרת הפרויקט
- נכנסים לחשבון Google Cloud . אם אתם משתמשים חדשים ב- Google Cloud, צרו חשבון כדי שתוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Service Directory API.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enablepermission. Learn how to grant roles.-
התקינו את ה-CLI של Google Cloud.
-
אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.
-
כדי לאתחל את ה-CLI של gcloud, הריצו את הפקודה הבאה:
gcloud init -
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Service Directory API.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enablepermission. Learn how to grant roles.-
התקינו את ה-CLI של Google Cloud.
-
אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.
-
כדי לאתחל את ה-CLI של gcloud, הריצו את הפקודה הבאה:
gcloud init
הגדרת משאבים ב-Service Directory
כדי לאכלס את Service Directory בשירותים, צריך ליצור מרחב שמות ולרשום את השירות במרחב השמות.
הגדרת מרחב שמות
בפרויקט, יוצרים מרחב שמות באזור. האזור הזה לא חייב להיות המקום שבו כל השירותים ונקודות הקצה שלכם פועלים, אבל הוא צריך להיות קרוב ככל האפשר.
אפשר לרשום את השירותים בכל אזור של ספריית השירותים, והם עדיין ניתנים לפתרון באופן גלובלי. בתוך אזור מסוים, בפרויקטים יכולים להיות כמה מרחבי שמות, והמרחבים האלה יכולים להיות באזורים שונים. מרחב שמות יחיד לא יכול לכלול כמה אזורים.
המסוף
נכנסים לדף Service Directory namespaces במסוף Google Cloud .
- לוחצים על יצירת מרחב שמות.
- ברשימה Region, בוחרים אזור למרחב השמות.
- בשדה שם מרחב השמות, נותנים שם למרחב השמות.
- לוחצים על יצירה.
gcloud
כדי להשתמש ב-Service Directory בשורת הפקודה, קודם צריך להתקין את הגרסה האחרונה של Google Cloud CLI או לשדרג אליה.
יצירת מרחב שמות
gcloud service-directory namespaces create NAMESPACE \ --location REGION
מחליפים את מה שכתוב בשדות הבאים:
-
NAMESPACE: השם של מרחב השמות שאתם יוצרים. -
REGION: האזור Google Cloud שמכיל את מרחב השמות.
-
אופציונלי: מגדירים מדיניות IAM במרחב השמות. כך המשתמש או הקבוצה שצוינו מקבלים את התפקיד שצוין במרחב השמות הזה ובכל השירותים ששייכים למרחב השמות.
gcloud service-directory namespaces add-iam-policy-binding NAMESPACE \ --member user:someone@example.com \ --role ROLE \ --location REGION
מחליפים את מה שכתוב בשדות הבאים:
-
NAMESPACE: השם של מרחב השמות שיצרתם. -
ROLE: התפקיד שאתם מקצים. -
REGION: האזור Google Cloud שמכיל את מרחב השמות.
-
C#
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח בשפת C# ולהתקין את Service Directory C# SDK.
Go
כדי להריץ את הקוד הזה, צריך קודם להגדיר סביבת פיתוח של Go ולהתקין את Service Directory Go SDK.
Java
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח בשפת Java ולהתקין את Service Directory Java SDK.
Node.js
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של Node.js ולהתקין את Service Directory Node.js SDK.
PHP
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של PHP ולהתקין את Service Directory PHP SDK.
Python
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח בשפת Python ולהתקין את Service Directory Python SDK.
Ruby
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של Ruby ולהתקין את Service Directory Ruby SDK.
הגדרת שירות
יוצרים שירות במרחב השמות. שירות מורכב משם ומאנוטציות אופציונליות שקשורות לשירות. יש כמה הגבלות על הפורמט של שמות השירותים:
- שמות השירותים צריכים להיות ייחודיים במרחב שמות.
- שמות השירותים צריכים להיות בהתאם למוסכמת מתן השמות של תוויות DNS.
כדי ליצור כלל העברה של Private Service Connect ולרשום אותו כשירות ב-Service Directory, אפשר לעיין במאמר רישום של נקודת קצה של Private Service Connect ב-Service Directory.
כדי לרשום שירות רגיל ב-Service Directory, פועלים לפי השלבים הבאים:
המסוף
נכנסים לדף Service Directory במסוף Google Cloud .
- לוחצים על Register Service (רישום שירות).
- לוחצים על Standard ואז על Next.
- בוחרים Region כדי לרשום את השירות.
- בוחרים מרחב שמות שבו רוצים לרשום את השירות.
אם אין לכם מרחב שמות, אתם יכולים ליצור אותו כך:
- בתיבה Namespace, לוחצים על Create namespace (יצירת מרחב שמות).
- מזינים שם של מרחב שמות.
- לוחצים על יצירה.
- מזינים שם שירות.
- אופציונלי: אם רוצים להוסיף הערות לשירות, מבצעים את הפעולות הבאות:
- לוחצים על הוספת הערה.
- מוסיפים מפתח וערך.
- כדי להוסיף עוד הערות, לוחצים שוב על הוספת הערה.
- לוחצים על יצירה.
gcloud
כדי להשתמש ב-Service Directory בשורת הפקודה, קודם צריך להתקין את הגרסה האחרונה של Google Cloud CLI או לשדרג אליה.
יוצרים שירות במרחב שמות.
gcloud service-directory services create SERVICE \ --annotations KEY_1=VALUE_1,KEY_2=VALUE_2 \ --namespace NAMESPACE \ --location REGION
מחליפים את מה שכתוב בשדות הבאים:
-
SERVICE: השם של השירות שאתם יוצרים. -
NAMESPACE: השם של מרחב השמות שמכיל את השירות. -
REGION: האזור Google Cloud שמכיל את מרחב השמות. -
KEY_1,VALUE_1,KEY_2,VALUE_2: קבוצת מחרוזות של מפתח וערך בזוגות.
-
אופציונלי: מגדירים מדיניות IAM בשירות. כך נותנים למשתמש או לקבוצה שצוינו את התפקיד שצוין בשירות הזה ובכל נקודות הקצה ששייכות לשירות.
gcloud service-directory services add-iam-policy-binding SERVICE \ --member user:someone@example.com \ --role ROLE \ --namespace NAMESPACE \ --location REGION
מחליפים את מה שכתוב בשדות הבאים:
-
SERVICE: השם שנתתם לשירות. -
NAMESPACE: השם של מרחב השמות שמכיל את השירות -
ROLE: התפקיד שאתם מקצים. -
REGION: האזור Google Cloud שמכיל את מרחב השמות.
-
C#
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח בשפת C# ולהתקין את Service Directory C# SDK.
Go
כדי להריץ את הקוד הזה, צריך קודם להגדיר סביבת פיתוח של Go ולהתקין את Service Directory Go SDK.
Java
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח בשפת Java ולהתקין את Service Directory Java SDK.
Node.js
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של Node.js ולהתקין את Service Directory Node.js SDK.
PHP
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של PHP ולהתקין את Service Directory PHP SDK.
Python
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח בשפת Python ולהתקין את Service Directory Python SDK.
Ruby
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של Ruby ולהתקין את Service Directory Ruby SDK.
הגדרת נקודת קצה
אחרי שרושמים את השירות, מוסיפים כמה נקודות קצה. נקודת קצה מורכבת משם ייחודי, מכתובת IP ומפורט (אופציונליים) ומביאורים של צמדי מפתח-ערך. אם מציינים כתובת IP, היא צריכה להיות כתובת IPv4 או IPv6 תקינה.
המסוף
נכנסים לדף Service Directory במסוף Google Cloud .
- לוחצים על שירות.
- לוחצים על הוספת נקודת קצה.
- מזינים שם של נקודת קצה.
- מזינים כתובת IP מסוג IPv4 או IPv6.
- מזינים מספר יציאה.
- אופציונלי: אם רוצים להוסיף הערות לנקודת הקצה, מבצעים את הפעולות הבאות:
- בקטע הערות, לוחצים על הוספת הערה.
- מוסיפים מפתח וערך.
- כדי להוסיף עוד הערות, לוחצים שוב על הוספת הערה.
- לוחצים על יצירה.
gcloud
כדי להשתמש ב-Service Directory בשורת הפקודה, קודם צריך להתקין את הגרסה האחרונה של Google Cloud CLI או לשדרג אליה.
אחרי שרושמים את השירות, מוסיפים כמה נקודות קצה.
gcloud service-directory endpoints create ENDPOINT \ --address IP_ADDRESS \ --port PORT_NUMBER \ --annotations KEY_1=VALUE_1,KEY_2=VALUE_2 \ --service SERVICE \ --namespace NAMESPACE \ --location REGION
gcloud service-directory endpoints create ENDPOINT2 \ --address IP_ADDRESS2 \ --port PORT_NUMBER2 \ --service SERVICE \ --namespace NAMESPACE \ --location REGION
מחליפים את מה שכתוב בשדות הבאים:
-
ENDPOINTו-ENDPOINT2: השמות של נקודות הקצה שאתם יוצרים בשירות. -
IP_ADDRESSו-IP_ADDRESS2: כתובות ה-IPv6 ו-IPv4 של נקודות הקצה, בהתאמה. -
PORT_NUMBERו-PORT_NUMBER2: היציאות שבהן פועלות נקודות הקצה. -
SERVICE: השם של השירות שמכיל את נקודת הקצה. -
NAMESPACE: השם של מרחב השמות שמכיל את השירות. -
REGION: האזור Google Cloud שמכיל את מרחב השמות. -
KEY_1,VALUE_1,KEY_2,VALUE_2: קבוצת מחרוזות של מפתח וערך בזוגות.
C#
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח בשפת C# ולהתקין את Service Directory C# SDK.
Go
כדי להריץ את הקוד הזה, צריך קודם להגדיר סביבת פיתוח של Go ולהתקין את Service Directory Go SDK.
Java
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח בשפת Java ולהתקין את Service Directory Java SDK.
Node.js
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של Node.js ולהתקין את Service Directory Node.js SDK.
PHP
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של PHP ולהתקין את Service Directory PHP SDK.
Python
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח בשפת Python ולהתקין את Service Directory Python SDK.
Ruby
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של Ruby ולהתקין את Service Directory Ruby SDK.
פתרון בעיה בשירות
באמצעות Service Directory, לקוחות יכולים לפתור בעיות בשירותים באמצעות DNS, HTTP ו-gRPC. הפעלת הפונקציה resolve מחזירה את כל המאפיינים של השירות, את כל נקודות הקצה ואת כל ההערות.
gcloud
כדי להשתמש ב-Service Directory בשורת הפקודה, קודם צריך להתקין את הגרסה האחרונה של Google Cloud CLI או לשדרג אליה.
gcloud service-directory services resolve SERVICE \ --namespace NAMESPACE \ --location REGION
מחליפים את מה שכתוב בשדות הבאים:
-
SERVICE: השם של השירות שרוצים לפתור. -
NAMESPACE: השם של מרחב השמות שמכיל את השירות. -
REGION: האזור Google Cloud שמכיל את מרחב השמות.
C#
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח בשפת C# ולהתקין את Service Directory C# SDK.
Go
כדי להריץ את הקוד הזה, צריך קודם להגדיר סביבת פיתוח של Go ולהתקין את Service Directory Go SDK.
Java
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח בשפת Java ולהתקין את Service Directory Java SDK.
Node.js
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של Node.js ולהתקין את Service Directory Node.js SDK.
PHP
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של PHP ולהתקין את Service Directory PHP SDK.
Python
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח בשפת Python ולהתקין את Service Directory Python SDK.
Ruby
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של Ruby ולהתקין את Service Directory Ruby SDK.
מחיקת משאבים
אם אתם לא צריכים משאב מסוים, אתם יכולים למחוק אותו מ-Service Directory.
מחיקת נקודת קצה משירות
המסוף
נכנסים לדף Service Directory במסוף Google Cloud .
- לוחצים על השירות שממנו רוצים למחוק את נקודת הקצה.
- מסמנים את התיבה לצד נקודת הקצה שרוצים למחוק.
- לוחצים על Delete.
- בתיבת הדו-שיח לאישור, לוחצים שוב על מחיקה.
gcloud
כדי להשתמש ב-Service Directory בשורת הפקודה, קודם צריך להתקין את הגרסה האחרונה של Google Cloud CLI או לשדרג אליה.
gcloud service-directory endpoints delete ENDPOINT \
--service=SERVICE \
--namespace=NAMESPACE \
--location=REGION
מחליפים את מה שכתוב בשדות הבאים:
-
ENDPOINT: השם של נקודת הקצה שרוצים למחוק. -
SERVICE: השם של השירות שמכיל את נקודת הקצה. -
NAMESPACE: השם של מרחב השמות שמכיל את השירות. -
REGION: האזור Google Cloud שמכיל את מרחב השמות.
C#
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח בשפת C# ולהתקין את Service Directory C# SDK.
Go
כדי להריץ את הקוד הזה, צריך קודם להגדיר סביבת פיתוח של Go ולהתקין את Service Directory Go SDK.
Java
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח בשפת Java ולהתקין את Service Directory Java SDK.
Node.js
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של Node.js ולהתקין את Service Directory Node.js SDK.
PHP
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של PHP ולהתקין את Service Directory PHP SDK.
Python
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח בשפת Python ולהתקין את Service Directory Python SDK.
Ruby
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של Ruby ולהתקין את Service Directory Ruby SDK.
מחיקת שירות ממרחב שמות
אפשר למחוק שירות שיש לו נקודות קצה. כששירות נמחק, גם כל נקודות הקצה שלו נמחקות.
אפשר למחוק שירות שיש לו אזור בספריית השירותים שמפנה אליו. כל שאילתת DNS נוספת לגבי השירות הזה תחזיר NXDOMAIN.
המסוף
נכנסים לדף Service Directory במסוף Google Cloud .
- מסמנים את התיבה לצד השירות שרוצים למחוק.
- לוחצים על Delete.
- בתיבת הדו-שיח לאישור, לוחצים שוב על מחיקה.
gcloud
כדי להשתמש ב-Service Directory בשורת הפקודה, קודם צריך להתקין את הגרסה האחרונה של Google Cloud CLI או לשדרג אליה.
gcloud service-directory services delete SERVICE \
--namespace=NAMESPACE \
--location=REGION
מחליפים את מה שכתוב בשדות הבאים:
-
SERVICE: השם של השירות שרוצים למחוק. -
NAMESPACE: השם של מרחב השמות שמכיל את השירות. -
REGION: האזור Google Cloud שמכיל את מרחב השמות.
C#
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח בשפת C# ולהתקין את Service Directory C# SDK.
Go
כדי להריץ את הקוד הזה, צריך קודם להגדיר סביבת פיתוח של Go ולהתקין את Service Directory Go SDK.
Java
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח בשפת Java ולהתקין את Service Directory Java SDK.
Node.js
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של Node.js ולהתקין את Service Directory Node.js SDK.
PHP
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של PHP ולהתקין את Service Directory PHP SDK.
Python
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח בשפת Python ולהתקין את Service Directory Python SDK.
Ruby
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של Ruby ולהתקין את Service Directory Ruby SDK.
מחיקת מרחב שמות
אפשר למחוק מרחב שמות שיש בו שירותים ונקודות קצה. כשמרחב שמות נמחק, גם כל השירותים ונקודות הקצה שלו נמחקים.
אפשר למחוק מרחב שמות שמצביע עליו אזור של Service Directory. כל שאילתות ה-DNS הנוספות (לא כולל בקשות SOA/NS למקור האזור) מחזירות NXDOMAIN.
המסוף
נכנסים לדף Service Directory namespaces במסוף Google Cloud .
- מסמנים את תיבת הסימון לצד מרחב השמות שרוצים למחוק.
- לוחצים על Delete.
- בתיבת הדו-שיח לאישור, לוחצים שוב על מחיקה.
gcloud
כדי להשתמש ב-Service Directory בשורת הפקודה, קודם צריך להתקין את הגרסה האחרונה של Google Cloud CLI או לשדרג אליה.
gcloud service-directory namespaces delete NAMESPACE \
--location=REGION
מחליפים את מה שכתוב בשדות הבאים:
-
NAMESPACE: שם מרחב השמות שרוצים למחוק. -
REGION: האזור Google Cloud שמכיל את מרחב השמות.
C#
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח בשפת C# ולהתקין את Service Directory C# SDK.
Go
כדי להריץ את הקוד הזה, צריך קודם להגדיר סביבת פיתוח של Go ולהתקין את Service Directory Go SDK.
Java
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח בשפת Java ולהתקין את Service Directory Java SDK.
Node.js
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של Node.js ולהתקין את Service Directory Node.js SDK.
PHP
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של PHP ולהתקין את Service Directory PHP SDK.
Python
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח בשפת Python ולהתקין את Service Directory Python SDK.
Ruby
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של Ruby ולהתקין את Service Directory Ruby SDK.
המאמרים הבאים
- כדי להגדיר אזור Service Directory כך שתוכלו לשלוח שאילתות לשירות באמצעות DNS, אפשר לעיין במאמר הגדרת אזור Service Directory.
- במאמר סקירה כללית על Service Directory תוכלו לקרוא סקירה כללית על השירות.
- כדי למצוא פתרונות לבעיות נפוצות שאולי תיתקלו בהן כשאתם משתמשים ב-Service Directory, אפשר לעיין במאמר פתרון בעיות.