בדף הזה מוסבר איך לבצע רוטציה של מפתחות לחשבונות השירות הבאים:
כדי להחליף את המפתחות של חשבונות השירות:
יוצרים ספרייה לאחסון גיבוי של הסודות הנוכחיים:
mkdir backup
שימו לב לפרטים הבאים לגבי חשבון השירות הרלוונטי:
גישה לרכיבים
אשכול סוד מרחב שמות אדמין admin-cluster-creds kube-system אדמין user-cluster-creds CLUSTER_NAME-gke-onprem-mgmt אדמין private-registry-creds kube-system משתמש private-registry-creds kube-system - אם אתם לא משתמשים במרשם פרטי, ה-Secret של
private-registry-credsמכיל את המפתח לחשבון השירות שלכם עם גישה לרכיבים. - אם אתם משתמשים במרשם פרטי, ה-Secret של
private-registry-credsמכיל את פרטי הכניסה למרשם הפרטי, ולא את המפתח של חשבון השירות לגישה לרכיבים.
Connect-register
אשכול סוד מרחב שמות אדמין admin-cluster-creds kube-system אדמין user-cluster-creds CLUSTER_NAME-gke-onprem-mgmt Logging-monitoring
אשכול סוד מרחב שמות אדמין admin-cluster-creds kube-system אדמין user-cluster-creds CLUSTER_NAME-gke-onprem-mgmt משתמש google-cloud-credentials kube-system משתמש stackdriver-service-account-key knative-serving רישום ביומן ביקורת
אשכול סוד מרחב שמות אדמין admin-cluster-creds kube-system אדמין user-cluster-creds CLUSTER_NAME-gke-onprem-mgmt אדמין kube-apiserver CLUSTER_NAME Stackdriver
אשכול סוד מרחב שמות אדמין admin-cluster-creds kube-system אדמין user-cluster-creds CLUSTER_NAME-gke-onprem-mgmt משתמש google-cloud-credentials kube-system משתמש stackdriver-service-account-key knative-serving - אם אתם לא משתמשים במרשם פרטי, ה-Secret של
יוצרים גיבוי של כל סוד באמצעות הפקודה הבאה:
kubectl get secret SECRET --namespace NAMESPACE \ --kubeconfig KUBECONFIG -o json > backup/SECRET-NAMESPACE.jsonמחליפים את מה שכתוב בשדות הבאים:
-
NAMESPACE: מרחב השמות שבו נמצא הסוד. לדוגמה,kube-system. -
KUBECONFIG: הנתיב לקובץ kubeconfig של אשכול האדמין או של אשכול המשתמש. -
SECRET: שם הסוד. לדוגמה,admin-cluster-creds.
לדוגמה, מריצים את הפקודות הבאות לחשבון השירות של רישום ביומן הביקורת:
kubectl get secret admin-cluster-creds --namespace kube-system \ --kubeconfig KUBECONFIG -o json > backup/admin-cluster-creds-kube-system.json kubectl get secret user-cluster-creds --namespace NAMESPACE \ --kubeconfig KUBECONFIG -o json > backup/user-cluster-creds-NAMESPACE.json kubectl get secret kube-apiserver --namespace NAMESPACE \ --kubeconfig KUBECONFIG -o json > backup/kube-apiserver-NAMESPACE.json-
כדי ליצור קובץ מפתח חדש של חשבון שירות, מריצים את הפקודה הבאה:
gcloud iam service-accounts keys create NEW_KEY_FILE --iam-account IAM_ACCOUNT
מחליפים את מה שכתוב בשדות הבאים:
-
NEW_KEY_FILE: השם של קובץ המפתח החדש של חשבון השירות -
IAM_ACCOUNT: כתובת האימייל של חשבון השירות
-
בקובץ התצורה של אשכול האדמין, מאתרים את השדה
componentAccessServiceAccountKeyPath, את הקטעgkeConnect, את הקטעstackdriverואת הקטעcloudAuditLogging. במקומות האלה, מחליפים את הנתיבים לקובצי המפתחות של חשבונות השירות.בקובץ התצורה של אשכול המשתמש, מאתרים את השדה
componentAccessServiceAccountKeyPath, את הקטעgkeConnect, את הקטעstackdriverואת הקטעcloudAudigLogging. במקומות האלה, מחליפים את הנתיבים לקובצי המפתחות של חשבונות השירות.כדי לשמור את השינויים שביצעתם, מריצים את הפקודות הבאות:
אפשר להחליף את המפתחות של רכיב אחד בכל פעם, או להחליף את כל המפתחות בבת אחת על ידי הגדרת הרכיב לערך
sakeys.gkectl update credentials COMPONENT \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --config ADMIN_CLUSTER_CONFIG \ --admin-cluster gkectl update credentials COMPONENT \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --config USER_CLUSTER_CONFIGמחליפים את הערכים בשדות הבאים:
COMPONENT: אחת מהאפשרויות הבאות:componentaccessregistercloudauditloggingstackdriver-
sakeys(רוטציה של כל מפתחות הרכיבים)
ADMIN_CLUSTER_KUBECONFIG: הנתיב לקובץ kubeconfig של אשכול האדמין.
ADMIN_CLUSTER_CONFIG: הנתיב לקובץ התצורה של אשכול האדמין.
USER_CLUSTER_CONFIG: הנתיב לקובץ התצורה של אשכול המשתמש.
יצירה מחדש של צומת
יכול להיות שחלק מרוטציות המפתחות של חשבונות שירות יימשכו יותר זמן, כי צריך ליצור מחדש את הצומת:
| חשבון שירות | צריך ליצור מחדש את הצמתים |
|---|---|
| גישה לרכיבים | אם משתמשים ב-Artifact Registry: כן אם משתמשים במאגר פרטי: לא |
| רישום ביומן ביקורת | אשכול אדמין: כן, אבל רק צומתי מישור בקרה אשכול משתמש שמשתמש ב-kubeception: לא אשכול משתמש שמשתמש ב-Controlplane V2: כן, אבל רק צומתי מישור בקרה |
| Logging-monitoring | לא |
| Connect-register | לא |
אם רוטציית המפתחות דורשת יצירה מחדש של הצמתים, הצמתים מוחלפים בתהליך של עדכון בהדרגה (rolling). כלומר, הצמתים נוצרים מחדש אחד אחרי השני.
זמן ההשבתה האפשרי במהלך רוטציית מפתחות דומה לזמן ההשבתה במהלך שדרוג אשכול. למידע נוסף, קראו את המאמר זמן השבתה במהלך שדרוגים.
שחזור גיבויים
אם אתם צריכים לשחזר את הגיבויים של הסודות שיצרתם קודם, הריצו את הפקודה הבאה:
kubectl apply -f backup/
הבדלים מתקדמים בין אשכולות ברוטציית מפתחות של חשבונות שירות
הפקודה gkectl update credentials נתמכת רק באופן חלקי באשכולות מתקדמים. בטבלה הבאה מפורטות וריאציות של פקודות שנתמכות ושלא נתמכות:
| פקודה | תיאור | תמיכה |
|---|---|---|
gkectl update credentials certificate-authorities rotate |
להחליף את רשויות האישורים. | נתמך |
gkectl update credentials certificate-authorities status |
(גרסת טרום-השקה (Preview)) הצגת סטטוס הרוטציה של רשויות האישורים. | נתמך |
gkectl update credentials certificate-authorities update-kubeconfig |
מורידים קובץ kubeconfig עם אישור הלקוח האחרון. | נתמך |
gkectl update credentials cloudauditlogging |
עדכון פרטי הכניסה ליומני הביקורת של Cloud. | לא נתמך |
gkectl update credentials componentaccess |
עדכון פרטי הכניסה של מפתח חשבון השירות לגישה לרכיבים באשכולות שנוצרו באמצעות Google Distributed Cloud ל-VMware. | נתמך |
gkectl update credentials f5bigip |
עדכון פרטי הכניסה של מאזן העומסים F5 BIG-IP. | אין צורך |
gkectl update credentials ksa-signing-key rotate |
החלפת מפתח החתימה של טוקן חשבון השירות של Kubernetes (KSA). | לא נתמך |
gkectl update credentials ksa-signing-key status |
לראות את הסטטוס של רוטציית מפתחות פעילה לחתימה על טוקנים של KSA. | לא נתמך |
gkectl update credentials |
עדכון פרטי הכניסה לאשכול. | נתמך |
gkectl update credentials privateregistry |
עדכון פרטי הכניסה של מרשם פרטי לאשכול. | נתמך |
gkectl update credentials register |
מעדכנים את פרטי הכניסה של מפתח חשבון השירות הרשום. | נתמך |
gkectl update credentials sakeys |
עדכון פרטי הכניסה של מפתחות לחשבונות שירות באשכול. | נתמך |
gkectl update credentials stackdriver |
(גרסת טרום-השקה) עדכון פרטי הכניסה ל-Google Cloud Observability. | נתמך |
gkectl update credentials vsphere |
עדכון פרטי הכניסה ל-vSphere באשכול. | נתמך |