- משאב: Cluster
- Fleet
- ClusterNetworking
- הרשאה
- ClusterUser
- MaintenancePolicy
- MaintenanceWindow
- RecurringTimeWindow
- TimeWindow
- MaintenanceExclusionWindow
- ControlPlane
- מרחוק
- מקומי
- SharedDeploymentPolicy
- SystemAddonsConfig
- Ingress
- VMServiceConfig
- ControlPlaneEncryption
- סטטוס
- MaintenanceEvent
- סוג
- תזמון
- מדינה
- ReleaseChannel
- SurvivabilityConfig
- ConnectionState
- מדינה
- ExternalLoadBalancerPool
- ZoneStorageEncryption
- Methods
משאב: אשכול
אשכול Kubernetes ב-Google Distributed Cloud Edge.
| ייצוג ב-JSON |
|---|
{ "name": string, "createTime": string, "updateTime": string, "labels": { string: string, ... }, "fleet": { object ( |
| שדות | |
|---|---|
name |
חובה. שם המשאב של האשכול. |
create |
פלט בלבד. השעה שבה נוצר האשכול. הפורמט הוא RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמל לפי Z ומשתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: |
update |
פלט בלבד. המועד שבו האשכול עודכן לאחרונה. משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמל ל-Z ומשתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: |
labels |
תוויות שמשויכות למשאב הזה. אובייקט שמכיל רשימה של צמדי |
fleet |
חובה. הגדרת ה-Fleet. |
networking |
חובה. הגדרת רשתות ברמת האשכול. |
authorization |
חובה. לא ניתן לשינוי. מדיניות RBAC שתופעל ותנוהל על ידי GEC. |
default |
זה שינוי אופציונלי. מספר הפודים המקסימלי שמוגדר כברירת מחדל לכל צומת, אם לא צוין ערך מקסימלי באופן מפורש למאגר צמתים באשכול הזה. אם לא מציינים ערך, המערכת משתמשת בערך ברירת המחדל של Kubernetes. |
endpoint |
פלט בלבד. כתובת ה-IP של שרת ה-API של Kubernetes. |
port |
פלט בלבד. מספר היציאה של שרת ה-API של Kubernetes. |
cluster |
פלט בלבד. האישור הציבורי בקידוד PEM של רשות האישורים (CA) של האשכול. |
maintenance |
זה שינוי אופציונלי. הגדרת מדיניות התחזוקה בכל האשכול. |
control |
פלט בלבד. גרסת ההפצה של מישור הבקרה |
node |
פלט בלבד. גרסת ההפצה הנמוכה ביותר מבין כל הצמתים העובדים. השדה הזה יכול להיות ריק אם אין באשכול צומתי עובדים. |
control |
זה שינוי אופציונלי. ההגדרה של מישור הבקרה של האשכול. |
system |
זה שינוי אופציונלי. ההגדרות של התוספים למערכת. |
external |
זה שינוי אופציונלי. מאגרים של כתובות IPv4 לאיזון עומסים חיצוני במישור הנתונים של האשכול. |
control |
זה שינוי אופציונלי. אפשרויות הצפנת דיסק של מישור בקרה מרוחק. השדה הזה משמש רק כשמפעילים תמיכה ב-CMEK. |
status |
פלט בלבד. הסטטוס הנוכחי של האשכול. |
maintenance |
פלט בלבד. כל אירועי התחזוקה שתוזמנו לאשכול, כולל אלה שמתבצעים, מתוכננים לעתיד ובוצעו בעבר (עד 90 יום). |
target |
זה שינוי אופציונלי. גרסת אשכול היעד. לדוגמה: "1.5.0". |
release |
זה שינוי אופציונלי. ערוץ ההפצה שאליו האשכול רשום. |
survivability |
זה שינוי אופציונלי. הגדרת השרידות של האשכול, למשל במקרה של אובדן החיבור לרשת. הערה: האפשרות הזו רלוונטית רק לאשכולות של מישור בקרה מקומי. |
external |
זה שינוי אופציונלי. מאגרי כתובות IPv6 לאיזון עומסים חיצוני במישור הנתונים של האשכול. |
connection |
פלט בלבד. מצב החיבור הנוכחי של האשכול. |
external |
זה שינוי אופציונלי. מאגרים של מאזני עומסים חיצוניים לאשכול. |
zone |
זה שינוי אופציונלי. הגדרת ההצפנה של האחסון באזור |
Fleet
הגדרות שקשורות ל-Fleet.
"ציים" הוא מושג ב-Google Cloud שמתייחס לארגון לוגי של אשכולות, שמאפשר להשתמש ביכולות של כמה אשכולות ולנהל אותן, ולהחיל כללי מדיניות עקביים על כל המערכות.
| ייצוג ב-JSON |
|---|
{ "project": string, "membership": string } |
| שדות | |
|---|---|
project |
חובה. שם הפרויקט המארח של ה-Fleet שבו האשכול הזה יירשם. שמות הפרויקטים הם בפורמט |
membership |
פלט בלבד. השם של משאב המינוי המנוהל ב-Hub שמשויך לאשכול הזה. שמות המינויים מופיעים בפורמט |
ClusterNetworking
הגדרת רשתות ברמת האשכול.
| ייצוג ב-JSON |
|---|
{ "clusterIpv4CidrBlocks": [ string ], "servicesIpv4CidrBlocks": [ string ] } |
| שדות | |
|---|---|
cluster |
חובה. לכל ה-Pods באשכול מוקצית כתובת RFC1918 IPv4 מהבלוקים האלה. יש תמיכה רק בבלוק אחד. אי אפשר לשנות את השדה הזה אחרי שיוצרים את המרחב. |
services |
חובה. כל השירותים באשכול מקבלים כתובת RFC1918 IPv4 מהבלוקים האלה. יש תמיכה רק בבלוק אחד. אי אפשר לשנות את השדה הזה אחרי שיוצרים את המרחב. |
הרשאה
מדיניות RBAC שתופעל ותנוהל על ידי GEC.
| ייצוג ב-JSON |
|---|
{
"adminUsers": {
object ( |
| שדות | |
|---|---|
admin |
חובה. המשתמש שיקבל את התפקיד "אדמין של אשכול" באשכול, שנותן גישה מלאה לאשכול. כרגע זה שדה יחיד, אבל בעתיד הוא יורחב כדי לאפשר כמה אדמינים. |
ClusterUser
חשבון משתמש למדיניות RBAC.
| ייצוג ב-JSON |
|---|
{ "username": string } |
| שדות | |
|---|---|
username |
חובה. שם משתמש פעיל ב-Google. |
MaintenancePolicy
הגדרת מדיניות התחזוקה.
| ייצוג ב-JSON |
|---|
{ "window": { object ( |
| שדות | |
|---|---|
window |
מציינת את חלון זמן לתחזוקה שבו אפשר לבצע תחזוקה. |
maintenance |
זה שינוי אופציונלי. החרגות מתחזוקה אוטומטית. בחלונות הזמן האלה לא אמורות להתבצע פעולות תחזוקה שאינן דחופות. לכל החרגה יש שם ייחודי, והיא יכולה להיות פעילה או לא בתוקף. אפשר להגדיר עד 3 החרגות תחזוקה בו-זמנית. |
MaintenanceWindow
הגדרת חלון זמן לתחזוקה
| ייצוג ב-JSON |
|---|
{
"recurringWindow": {
object ( |
| שדות | |
|---|---|
recurring |
הגדרה של חלון זמן לתחזוקה חוזר. |
RecurringTimeWindow
מייצג חלון זמן שרירותי שחוזר על עצמו.
| ייצוג ב-JSON |
|---|
{
"window": {
object ( |
| שדות | |
|---|---|
window |
חלון הזמנים של החזרה הראשונה. |
recurrence |
כלל חזרה (RRULE) (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) שמגדיר את החזרה של חלון הזמנים הזה. הם נמשכים לאורך פרק הזמן שבין שעת ההתחלה לשעת הסיום. |
TimeWindow
מייצג חלון זמן שרירותי.
| ייצוג ב-JSON |
|---|
{ "startTime": string, "endTime": string } |
| שדות | |
|---|---|
start |
השעה שבה החלון מתחיל. משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמל ל-Z ומשתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: |
end |
השעה שבה החלון מסתיים. שעת הסיום חייבת להיות אחרי שעת ההתחלה. משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמל ל-Z ומשתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: |
MaintenanceExclusionWindow
מייצג חלון החרגה של תחזוקה.
| ייצוג ב-JSON |
|---|
{
"window": {
object ( |
| שדות | |
|---|---|
window |
זה שינוי אופציונלי. חלון הזמן. |
id |
זה שינוי אופציונלי. מזהה ייחודי (לכל אשכול) של החלון. |
ControlPlane
ההגדרה של מישור הבקרה של האשכול.
| ייצוג ב-JSON |
|---|
{ // Union field |
| שדות | |
|---|---|
שדה של איחוד הערך |
|
remote |
הגדרת מישור בקרה מרחוק. |
local |
הגדרת מישור הבקרה המקומי. אזהרה: צריך ליצור אשכולות של מישור בקרה מקומי בפרויקט משלהם. אשכולות עם מישור בקרה מקומי לא יכולים להתקיים באותו פרויקט עם אשכולות מסוגים אחרים, כולל אשכולות שהם לא GDCE. שילוב של אשכולות GDCE עם מישור בקרה מקומי עם כל סוג אחר של אשכולות באותו פרויקט עלול לגרום לאובדן נתונים. |
אפליקציה עם פעולה מרחוק
בסוג הזה אין שדות.
הגדרה ספציפית לאשכולות עם מישור בקרה שמתארח מרחוק.
מקומי
הגדרה ספציפית לאשכולות עם מישור בקרה שמתארח באופן מקומי.
אזהרה: צריך ליצור אשכולות של מישור בקרה מקומי בפרויקט משלהם. אשכולות עם מישור בקרה מקומי לא יכולים להתקיים באותו פרויקט עם אשכולות מסוגים אחרים, כולל אשכולות שהם לא GDCE. שילוב של אשכולות GDCE עם מישור בקרה מקומי עם כל סוג אחר של אשכולות באותו פרויקט עלול לגרום לאובדן נתונים.
| ייצוג ב-JSON |
|---|
{
"nodeLocation": string,
"nodeCount": integer,
"machineFilter": string,
"sharedDeploymentPolicy": enum ( |
| שדות | |
|---|---|
node |
השם של אזורי Google Distributed Cloud Edge שבהם ייווצר מאגר הצמתים הזה. לדוגמה: |
node |
מספר הצמתים שישמשו כרפליקות של מישור הבקרה. |
machine |
רק מכונות שתואמות למסנן הזה יוכלו לארח צומתי מישור בקרה. שפת הסינון מקבלת מחרוזות כמו "name= |
shared |
הגדרת המדיניות לגבי פריסת אפליקציות של משתמשים. |
control |
זה שינוי אופציונלי. שם לסכימת האחסון של צומתי מישור הבקרה. אזהרה: התכונה "סכימה ניתנת להגדרה של אחסון מקומי בצומת" היא תכונה ניסיונית, ולא מומלץ להשתמש בה באופן כללי באשכולות או במאגרי צמתים בסביבת הייצור. |
SystemAddonsConfig
הגדרות שהלקוחות יכולים להגדיר לתוספים של מערכת GDCE.
| ייצוג ב-JSON |
|---|
{ "ingress": { object ( |
| שדות | |
|---|---|
ingress |
זה שינוי אופציונלי. הגדרות ל-Ingress. |
vm |
זה שינוי אופציונלי. הגדרת שירות VM. |
תעבורת נתונים נכנסת (Ingress)
הגדרת התוסף Ingress שמאפשר ללקוחות ליצור אובייקט Ingress כדי לנהל את הגישה החיצונית לשרתים באשכול. התוסף מורכב מ-istiod ומ-istio-ingress.
| ייצוג ב-JSON |
|---|
{ "disabled": boolean, "ipv4Vip": string } |
| שדות | |
|---|---|
disabled |
זה שינוי אופציונלי. אם Ingress מושבת. |
ipv4 |
זה שינוי אופציונלי. Ingress VIP. |
VMServiceConfig
VMServiceConfig מגדיר את התצורה של שירות GDCE VM.
| ייצוג ב-JSON |
|---|
{ "vmmEnabled": boolean } |
| שדות | |
|---|---|
vmm |
זה שינוי אופציונלי. אם VMM מופעל. |
ControlPlaneEncryption
הגדרת התמיכה במפתח KMS בניהול הלקוח לצומתי מישור הבקרה.
| ייצוג ב-JSON |
|---|
{ "kmsKey": string, "kmsKeyActiveVersion": string, "kmsKeyState": enum ( |
| שדות | |
|---|---|
kms |
זה שינוי אופציונלי. מפתח ההצפנה של Cloud KMS, למשל projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}, שמשמש להגנה על הדיסקים של מישור הבקרה. אם לא תציינו מפתח, המערכת תשתמש במפתח בניהול Google. |
kms |
פלט בלבד. הגרסה של Cloud KMS CryptoKeyVersion שמשמשת כרגע להגנה על דיסקים של מישור הבקרה. רלוונטי רק אם kmsKey מוגדר. |
kms |
פלט בלבד. הזמינות של Cloud KMS CryptoKey. אם לא משתמשים ב- |
kms |
פלט בלבד. סטטוס השגיאה שמוחזר על ידי Cloud KMS כשמשתמשים במפתח הזה. אפשר לאכלס את השדה הזה רק אם הערך של |
resource |
פלט בלבד. מצב המשאב הנוכחי שמשויך ל-CMEK. |
סטטוס
מציין את סטטוס האשכול.
| טיפוסים בני מנייה (enum) | |
|---|---|
STATUS_UNSPECIFIED |
הסטטוס לא ידוע. |
PROVISIONING |
האשכול נוצר. |
RUNNING |
האשכול נוצר ומוכן לשימוש. |
DELETING |
האשכול נמחק. |
ERROR |
הסטטוס מציין שאירעו כמה שגיאות במהלך ההתאמה או המחיקה של האשכול. |
RECONCILING |
האשכול עובר תהליך מסוים, כמו שדרוגי גרסאות וכו'. |
MaintenanceEvent
אירוע תחזוקה הוא פעולה שעלולה לגרום לשיבושים זמניים בעומסי העבודה של האשכול, כולל שדרוגים של האשכול שמופעלים על ידי Google או על ידי המשתמש, שינויים בהגדרות האישיות של האשכול שמופעלים על ידי המשתמש ומחייבים הפעלה מחדש של הצמתים וכו'.
| ייצוג ב-JSON |
|---|
{ "uuid": string, "targetVersion": string, "operation": string, "type": enum ( |
| שדות | |
|---|---|
uuid |
פלט בלבד. ה-UUID של אירוע התחזוקה. |
target |
פלט בלבד. גרסת היעד של האשכול. |
operation |
פלט בלבד. הפעולה להרצת אירוע התחזוקה. מצוין בפורמט projects/*/locations/*/operations/*. אם אירוע התחזוקה מפוצל לכמה פעולות (למשל, בגלל חלונות זמן לתחזוקה), הפעולה האחרונה מתועדת. |
type |
פלט בלבד. סוג אירוע התחזוקה. |
schedule |
פלט בלבד. לוח הזמנים של אירוע התחזוקה. |
state |
פלט בלבד. המצב של אירוע התחזוקה. |
create |
פלט בלבד. השעה שבה נוצרה הבקשה לאירוע התחזוקה. משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמל ל-Z ומשתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: |
start |
פלט בלבד. השעה שבה התחיל אירוע התחזוקה. משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמל ל-Z ומשתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: |
end |
פלט בלבד. השעה שבה אירוע התחזוקה הסתיים, בין אם בהצלחה ובין אם לא. אם אירוע התחזוקה מפוצל לכמה חלונות זמן לתחזוקה, הערך של endTime מתעדכן רק כשהתהליך כולו מסתיים. משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמל ל-Z ומשתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: |
update |
פלט בלבד. השעה שבה עודכנה ההודעה על אירוע התחזוקה. משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמל ל-Z ומשתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: |
סוג
מציין את סוג אירוע התחזוקה.
| טיפוסים בני מנייה (enum) | |
|---|---|
TYPE_UNSPECIFIED |
לא צוין. |
USER_INITIATED_UPGRADE |
המשתמשים התחילו את השדרוג. |
GOOGLE_DRIVEN_UPGRADE |
השדרוג מבוצע על ידי Google. |
תזמון
מציין מתי צריך לבצע את אירוע התחזוקה.
| טיפוסים בני מנייה (enum) | |
|---|---|
SCHEDULE_UNSPECIFIED |
לא צוין. |
IMMEDIATELY |
מיד אחרי קבלת הבקשה. |
מדינה
מציין את מצב אירוע התחזוקה.
| טיפוסים בני מנייה (enum) | |
|---|---|
STATE_UNSPECIFIED |
לא צוין. |
RECONCILING |
אירוע התחזוקה נמשך. יכול להיות שלא ניתן להשתמש באשכול. |
SUCCEEDED |
אירוע התחזוקה הסתיים בהצלחה. |
FAILED |
אירוע התחזוקה נכשל. |
ReleaseChannel
ערוץ ההפצה שאליו האשכול רשום.
| טיפוסים בני מנייה (enum) | |
|---|---|
RELEASE_CHANNEL_UNSPECIFIED |
ערוץ הפצה לא מוגדר. כברירת מחדל, הערוץ יהיה ערוץ רגיל. |
NONE |
אין ערוץ הפצה. |
REGULAR |
ערוץ הפצה רגיל. |
SurvivabilityConfig
הגדרת השרידות של האשכול, למשל במקרה של אובדן החיבור לרשת.
| ייצוג ב-JSON |
|---|
{ "offlineRebootTtl": string } |
| שדות | |
|---|---|
offline |
זה שינוי אופציונלי. פרק הזמן שבו אפשר להפעיל מחדש את הצמתים באשכול ולהפוך אותם לפונקציונליים בלי חיבור לרשת של Google. ערך ברירת המחדל 0 פירושו שהפעולה אסורה. הערך המקסימלי הוא 7 ימים. משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-" |
ConnectionState
ConnectionState מכיל את מצב החיבור הנוכחי מהאשכול ל-Google.
| ייצוג ב-JSON |
|---|
{
"state": enum ( |
| שדות | |
|---|---|
state |
פלט בלבד. מצב החיבור הנוכחי. |
update |
פלט בלבד. השעה שבה מצב החיבור השתנה בפעם האחרונה. משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמל ל-Z ומשתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: |
מדינה
מצב החיבור.
| טיפוסים בני מנייה (enum) | |
|---|---|
STATE_UNSPECIFIED |
מצב החיבור לא ידוע. |
DISCONNECTED |
האשכול הזה מנותק כרגע מ-Google. |
CONNECTED |
האשכול הזה מחובר כרגע ל-Google. |
CONNECTED_AND_SYNCING |
האשכול הזה מחובר כרגע ל-Google, אבל יכול להיות שהוא התחבר מחדש לאחרונה אחרי שהתנתק. הסנכרון עדיין מתבצע. |
ExternalLoadBalancerPool
מאגר של מאזני עומסים חיצוניים עם הגדרות אישיות כמו שם, הקצאה ידנית/אוטומטית, טווח כתובות IPv4 שלא חופף וטווח כתובות IPv6 אופציונלי.
| ייצוג ב-JSON |
|---|
{ "addressPool": string, "ipv4Range": [ string ], "ipv6Range": [ string ], "avoidBuggyIps": boolean, "manualAssign": boolean } |
| שדות | |
|---|---|
address |
זה שינוי אופציונלי. השם של מאגר מאזני העומסים החיצוניים. |
ipv4 |
חובה. טווח כתובות IPv4 שלא חופף למאגר של מאזן העומסים החיצוני. |
ipv6 |
זה שינוי אופציונלי. טווח כתובות IPv6 שלא חופף למאגר של מאזן העומסים החיצוני. |
avoid |
זה שינוי אופציונלי. אם הערך הוא True, המאגר משמיט כתובות IP שמסתיימות ב- .0 וב- .255. חלק מחומרת הרשת מפילה את התנועה לכתובות המיוחדות האלה. ערך ברירת המחדל הוא False. |
manual |
זה שינוי אופציונלי. אם הערך הוא True, הכתובות במאגר הזה לא מוקצות באופן אוטומטי לשירותי Kubernetes. אם הערך הוא True, כתובת IP במאגר הזה משמשת רק כששירות מציין אותה במפורש. ערך ברירת המחדל הוא False. |
ZoneStorageEncryption
הגדרת תמיכה ב-CMEK לאחסון אזורי
| ייצוג ב-JSON |
|---|
{
"kmsKey": string,
"kmsKeyActiveVersion": string,
"resourceState": enum ( |
| שדות | |
|---|---|
kms |
זה שינוי אופציונלי. מפתח Cloud KMS |
kms |
פלט בלבד. הגרסה של Cloud KMS CryptoKeyVersion שמשמשת כרגע להצפנה או לפענוח |
resource |
פלט בלבד. מצב המשאב הנוכחי של ה-CMEK |
Methods |
|
|---|---|
|
יצירת אשכול חדש בפרויקט ובמיקום נתונים. |
|
מחיקת אשכול אחד. |
|
יצירת טוקן גישה לאשכול. |
|
יוצר פרטי כניסה אופליין לאשכול. |
|
קבלת פרטים של אשכול יחיד. |
|
הצגת רשימה של אשכולות בפרויקט ובמיקום נתונים. |
|
עדכון הפרמטרים של אשכול אחד. |
|
שדרוג של אשכול אחד. |