החלפת מפתחות של חשבונות שירות

בדף הזה מוסבר איך לבצע רוטציה של מפתחות לחשבונות השירות הבאים:

כדי להחליף את המפתחות של חשבונות השירות:

  1. יוצרים ספרייה לאחסון גיבוי של הסודות הנוכחיים:

    mkdir backup
  2. שימו לב לפרטים הבאים לגבי חשבון השירות הרלוונטי:

    גישה לרכיבים

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

    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
  4. כדי ליצור קובץ מפתח חדש של חשבון שירות, מריצים את הפקודה הבאה:

    gcloud iam service-accounts keys create NEW_KEY_FILE --iam-account IAM_ACCOUNT

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

    • ‫NEW_KEY_FILE: השם של קובץ המפתח החדש של חשבון השירות
    • ‫IAM_ACCOUNT: כתובת האימייל של חשבון השירות
  5. בקובץ התצורה של אשכול האדמין, מאתרים את השדה componentAccessServiceAccountKeyPath, את הקטע gkeConnect, את הקטע stackdriver ואת הקטע cloudAuditLogging. במקומות האלה, מחליפים את הנתיבים לקובצי המפתחות של חשבונות השירות.

  6. בקובץ התצורה של אשכול המשתמש, מאתרים את השדה componentAccessServiceAccountKeyPath, את הקטע gkeConnect, את הקטע stackdriver ואת הקטע cloudAudigLogging. במקומות האלה, מחליפים את הנתיבים לקובצי המפתחות של חשבונות השירות.

  7. כדי לשמור את השינויים שביצעתם, מריצים את הפקודות הבאות:

    אפשר להחליף את המפתחות של רכיב אחד בכל פעם, או להחליף את כל המפתחות בבת אחת על ידי הגדרת הרכיב לערך 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: אחת מהאפשרויות הבאות:

      • componentaccess
      • register
      • cloudauditlogging
      • stackdriver
      • ‫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 באשכול. נתמך