פרטי כניסה מוכנים מאפשרים לכם לאחסן את פרטי הכניסה של אשכולות המשתמשים של Google Distributed Cloud software only for VMware ב-Secrets באשכול האדמין, כך שלא תצטרכו לשמור סיסמאות ומפתחות של חשבונות שירות בתחנת העבודה של האדמין. אתם יוצרים את הסודות מראש, ואז מפנים אליהם כשאתם יוצרים אשכולות של משתמשים או מחליפים את פרטי הכניסה שלהם.
לפני שמתחילים
אם עדיין אין לכם אשכול אדמין, צרו אחד.
סקירה כללית של התהליך
ממלאים קובץ תצורה של Secrets.
באשכול האדמין, יוצרים קבוצות של סודות. כל קבוצת סודות נמצאת במרחב שמות משלה ב-Kubernetes.
יוצרים אשכול משתמשים. בקובץ התצורה של אשכול המשתמש, מציינים שרוצים לקחת את פרטי הכניסה מ-Secrets במרחב שמות מסוים באשכול האדמין.
יוצרים קבוצות נוספות של סודות וגרסאות נוספות של הסודות לפי הצורך.
מעדכנים את פרטי הכניסה של אשכול משתמשים קיים לפי הצורך.
יוצרים אשכולות משתמשים נוספים לפי הצורך. בכל קובץ תצורה של אשכול משתמש, מציינים מרחב שמות של סודות. אתם יכולים גם לציין באיזו גרסה של סוד אתם רוצים להשתמש בשביל פרטי כניסה מסוימים.
מילוי קובץ התצורה של הסודות
יוצרים תבנית לקובץ תצורה של Secrets:
gkectl create-config secrets
הפקודה הקודמת יוצרת קובץ בשם secrets.yaml. אפשר לשנות את השם והמיקום של הקובץ הזה.
כדאי לקרוא את המאמר קובץ תצורה של סודות כדי להכיר את קובץ התצורה. מומלץ להשאיר את המסמך הזה פתוח בכרטיסייה או בחלון נפרדים.
בקובץ התצורה של הסודות, ממלאים את הערכים הרלוונטיים למצב שלכם. צריך למלא ערך בשדה namespace שמתחיל ב-gke-onprem-secrets-.
דוגמה לקובץ תצורה של Secrets עם קבוצת סודות אחת. לקבוצה יש ערכים של פרטי הכניסה ל-vCenter וארבעה מפתחות של חשבונות שירות:
apiVersion: v1
kind: ClusterSecrets
secretGroups:
- namespace: "gke-onprem-secrets-user-cluster-1"
secrets:
vCenter:
username: "my-vcenter-account"
password: "U$icUKEW#INE"
componentAccessServiceAccount:
serviceAccountKeyPath: "my-key-folder/component-access-key.json"
registerServiceAccount:
serviceAccountKeyPath: "my-key-folder/connect-register-key.json"
stackdriverServiceAccount:
serviceAccountKeyPath: "my-key-folder/log-mon-key.json"
cloudAuditLoggingServiceAccount:
serviceAccountKeyPath: "my-key-folder/audit-log-key.json"
יצירת סודות מוכנים
יוצרים סודות מוכנים באשכול האדמין:
gkectl prepare secrets --kubeconfig ADMIN_CLUSTER_KUBECONFIG --secret-config SECRETS_CONFIG
מחליפים את מה שכתוב בשדות הבאים:
ADMIN_CLUSTER_KUBECONFIG: הנתיב לקובץ kubeconfig של אשכול האדמין
SECRETS_CONFIG: הנתיב של קובץ התצורה של Secrets
הצגת הסודות שהכנתם
מציגים את הסודות שהוכנו באשכול האדמין:
gkectl list secrets --kubeconfig ADMIN_CLUSTER_KUBECONFIG
פלט לדוגמה:
The following secrets have been found:
- namespace: gke-onprem-secrets-user-cluster-1
- secrets with name prefix: component-access-sa-creds
name: component-access-sa-creds.1, version 1, age: 58s
- secrets with name prefix: cloud-audit-logging-service-account-creds
name: cloud-audit-logging-service-account-creds.1, version: 1, age: 58s
- secrets with name prefix: register-service-account-creds
name: register-service-account-creds.1, version: 1, age: 58s
- secrets with name prefix: stackdriver-service-account-creds
name: stackdriver-service-account-creds.1, version: 1, age: 58s
- secrets with name prefix: vsphere-creds
name: vsphere-creds.1, version: 1, age: 58s
אפשר גם להריץ את kubectl get secrets כדי להציג רשימה של הסודות במרחב שמות. לדוגמה:
kubectl --kubeconfig ADMIN_CLUSTER_KUBECONFIG get secrets --namespace gke-onprem-secrets-user-cluster-1
פלט לדוגמה:
component-access-sa-creds ... cloud-audit-logging-service-account-creds ... register-service-account-creds.1 ... stackdriver-service-account-creds.1 ... vsphere-creds.1 ...
בפלט שלמעלה, אפשר לראות שלכל שם של סוד יש סיומת שמציינת את גרסת הסוד. בדוגמה הזו, לכל הסודות יש גרסה 1.
יצירת אשכול משתמשים
פועלים לפי ההוראות במאמר יצירת אשכול משתמש.
כשממלאים את קובץ התצורה של אשכול המשתמשים, מזינים ערך בשדה preparedSecrets.namespace. הערך הזה צריך להתאים למרחב שמות שציינתם קודם בקובץ תצורה של Secrets.
דוגמה:
preparedSecrets: namespace: "gke-onprem-secrets-user-cluster-1"
בקובץ התצורה של אשכול המשתמש, אל תציינו ערכים בשדות הבאים. אין צורך בשדות האלה, כי תוכנת Google Distributed Cloud ל-VMware מקבלת את פרטי הכניסה והמפתחות מהסודות שהכנתם.
vCenter.credentials.fileRef.pathcomponentAccessServiceAccountKeyPathloadBalancer.f5BigIP.credentials.fileRef.pathgkeConnect.registerServiceAccountKeyPathstackdriver.serviceAccountKeyPathusageMetering.bigQueryServiceAccountKeyPathcloudAuditLogging.serviceAccountKeyPathprivateRegistry.credentials.fileRef.path
בקובץ התצורה של אשכול המשתמש, מציינים את הגרסאות של הסודות המוכנים שבהם רוצים להשתמש. בדוגמה הבאה מצוינת גרסה 1 לכל אחד מחמשת הסודות:
vCenter:
credentials:
secretRef:
version: "1"
...
componentAccessServiceAccountKey:
secretRef:
version: "1"
...
gkeConnect:
registerServiceAccountKey:
secretRef:
version: "1"
...
stackdriver:
serviceAccountKey:
secretRef:
version: "1"
...
cloudAuditLogging:
serviceAccountKey:
secretRef:
version: "1"
הערך של version חייב להיות מחרוזת של מספר שלם או המחרוזת "latest". אם לא מציינים ערך ל-version, המערכת משתמשת בגרסה העדכנית.
מסיימים ליצור את אשכול המשתמשים, כמו שמתואר במאמר יצירת אשכול משתמשים.
יצירת סודות מוכנים נוספים
בקטע הזה מוסבר איך ליצור גרסה 2 של חלק מהסודות במרחב שמות קיים.
יוצרים קובץ תצורה חדש של Secrets בשם secrets-2.yaml. מציינים מרחב שמות קיים ומספקים פרטי כניסה לסודות שנבחרו.
דוגמה:
apiVersion: v1
kind: ClusterSecrets
secretGroups:
- namespace: "gke-onprem-secrets-user-cluster-1"
secrets:
stackdriverServiceAccount:
serviceAccountKeyPath: "log-mon-sa-2.json"
cloudAuditLoggingServiceAccount:
serviceAccountKeyPath: "audit-log-sa-2.json"
בדוגמה שלמעלה מוצגים נתיבי מפתחות לסודות הבאים במרחב השמות gke-onprem-secrets-user-cluster-1.
- גרסה 2 של הסוד
stackdriver-service-account-creds - גרסה 2 של הסוד
cloud-audit-logging-service-account-creds
יוצרים את הסודות החדשים:
gkectl prepare secrets --kubeconfig ADMIN_CLUSTER_KUBECONFIG --secret-config secrets-2.yaml
מציגים את הסודות שהוכנו באשכול האדמין:
gkectl --kubeconfig ADMIN_CLUSTER_KUBECONFIG list secrets
פלט לדוגמה:
The following secrets have been found:
- namespace: gke-onprem-secrets-user-cluster-1
- secrets with name prefix: component-access-sa-creds
name: component-access-sa-creds.1, version 1, age: 11h
- secrets with name prefix: cloud-audit-logging-service-account-creds
name: cloud-audit-logging-service-account-creds.1, version: 1, age: 11h
name: cloud-audit-logging-service-account-creds.2, version: 2, age: 33m
- secrets with name prefix: register-service-account-creds
name: register-service-account-creds.1, version: 1, age: 11h
- secrets with name prefix: stackdriver-service-account-creds
name: stackdriver-service-account-creds.1, version: 1, age: 11h
name: stackdriver-service-account-creds.2, version: 2, age: 33m
- secrets with name prefix: vsphere-creds
name: vsphere-creds.1, version: 1, age: 11h
בפלט שלמעלה אפשר לראות שיש שתי גרסאות של הסוד stackdriver-service-account-creds ושתי גרסאות של הסוד cloud-audit-logging-service-account-creds.
החלפת פרטי הכניסה לאשכול משתמשים
בקטע הזה מוסבר איך להחליף פרטי כניסה נבחרים באשכול משתמשים קיים.
לפני שאתם מחליפים את פרטי הכניסה, בדקו את הגרסאות הנוכחיות של הסודות שבהם נעשה שימוש באשכול:
gkectl list secrets cluster --cluster-name USER_CLUSTER_NAME --kubeconfig ADMIN_CLUSTER_KUBECONFIG
פלט לדוגמה:
The following prepared secrets have been used for cluster "user-cluster-1": - namespace: gke-onprem-secrets-user-cluster-1 secret: vsphere-creds.1, version: 1 secret: f5-creds.1, version: 1 secret: component-access-sa-creds.1, version 1 secret: register-service-account-creds.1, version: 1 secret: stackdriver-service-account-creds.1, version: 1 secret: cloud-audit-logging-service-account-creds.1, version: 1
מעתיקים את קובץ התצורה של אשכול המשתמש לקובץ בשם user-cluster-update.yaml.
ב-user-cluster-update.yaml, מוסיפים serviceAccountKey קטעים. לדוגמה, בדוגמה הבאה יש serviceAccountKey קטעים ב-stackdriver וב-cloudAuditLogging:
stackdriver:
projectID: "my-project-123"
clusterLocation: "us-central1"
serviceAccountKey:
secretRef:
version: "2"
cloudAuditLogging:
projectID: "my-project-123"
clusterLocation: "us-central1"
serviceAccountKey:
secretRef:
version: "latest"
בדוגמה שלמעלה, כשמעדכנים את אשכול המשתמשים, הוא ישתמש ב:
גרסה 2 של הסוד
stackdriver-service-account-credsהגרסה העדכנית של הסוד
cloud-audit-logging-service-account-creds. בדוגמה הזו, זו גרסה 2.
מעדכנים את פרטי הכניסה של אשכול המשתמשים:
gkectl update credentials stackdriver --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config user-cluster-update.yaml gkectl update credentials cloudauditlogging --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config user-cluster-update.yaml
עכשיו אשכול המשתמשים משתמש בסודות המוכנים הבאים:
- גרסה 1 מתוך
vsphere-creds - גרסה 1 מתוך
component-access-sa-creds - גרסה 1 מתוך
register-service-account-creds - גרסה 2 מתוך
stackdriver-service-account-creds - גרסה 2 מתוך
cloud-audit-logging-service-account-creds
יצירת עוד סודות ואשכולות של משתמשים
אם אתם מתכננים ליצור עוד אשכולות של משתמשים, כדאי לחשוב איך אתם רוצים לארגן את הסודות שהכנתם. יכול להיות שתרצו ליצור מרחב שמות נפרד באשכול האדמין לכל אשכול משתמש. או שתרצו לשתף את אותו מרחב שמות מוכן של סודות עם כמה אשכולות משתמשים או עם כולם.
לדוגמה, נניח שלכל אחד מהמשתמשים אליס, בוב וקרול יהיה אשכול משתמשים. אפשר ליצור שלוש קבוצות של סודות, כמו בדוגמה הזו:
apiVersion: v1
kind: ClusterSecrets
secretGroups:
- namespace: "gke-onprem-secrets-alice"
secrets:
vCenter:
username: "alice"
password: "zC7r^URDPq2t"
componentAccessServiceAccount:
serviceAccountKeyPath: "component-access-sa-a.json"
registerServiceAccount:
serviceAccountKeyPath: "register-sa-a.json"
stackdriverServiceAccount:
serviceAccountKeyPath: "log-mon-sa-a.json"
cloudAuditLoggingServiceAccount:
serviceAccountKeyPath: "audit-log-sa-a.json"
- namespace: "gke-onprem-secrets-bob"
secrets:
vCenter:
username: "bob"
password: "zC8r^URDPq2t"
componentAccessServiceAccount:
serviceAccountKeyPath: "component-access-sa-b.json"
registerServiceAccount:
serviceAccountKeyPath: "register-sa-b.json"
stackdriverServiceAccount:
serviceAccountKeyPath: "log-mon-sa-b.json"
cloudAuditLoggingServiceAccount:
serviceAccountKeyPath: "audit-log-sa-b.json"
- namespace: "gke-onprem-secrets-carol"
secrets:
vCenter:
username: "carol"
password: "zC9r^URDPq2t"
componentAccessServiceAccount:
serviceAccountKeyPath: "component-access-sa-c.json"
registerServiceAccount:
serviceAccountKeyPath: "register-sa-c.json"
stackdriverServiceAccount:
serviceAccountKeyPath: "log-mon-sa-c.json"
cloudAuditLoggingServiceAccount:
serviceAccountKeyPath: "audit-log-sa-c.json"
עם הזמן תוכלו ליצור גרסאות נוספות של הסודות בכל קבוצת סודות.
בקובצי התצורה של אשכולות המשתמשים, צריך לציין ערכים ל-serviceAccountKey.secretRef.version כדי לציין באילו גרסאות של הסודות רוצים להשתמש. אפשר להגדיר את הערך ל-"latest", למחרוזת ריקה או למחרוזת של מספר שלם.
לדוגמה, נניח שלכל הסודות יש גרסאות 1, 2 ו-3. נניח שזה חלק מקובץ התצורה של אשכול המשתמשים של אליס.
apiVersion: v1
kind: UserCluster
name: "user-cluster-alice"
preparedSecrets:
namespace: "gke-onprem-secrets-alice"
...
vCenter:
credentials:
gkeConnect:
projectID: "project-a"
registerServiceAccountKey:
secretRef:
version: "2"
stackdriver:
projectID: "project-a"
clusterLocation: "us-central1"
serviceAccountKey:
secretRef:
version: "latest"
cloudAuditLogging:
projectID: "project-a"
clusterLocation: "us-central1"
serviceAccountKey:
secretRef:
version: ""
בדוגמה שלמעלה, אפשר לראות:
לא צוין
secretRefעבור vCenter, כך שהאשכול ישתמש בגרסה העדכנית של הסודvsphere-credsבמרחב השמותgke-onprem-secrets-alice.האשכול ישתמש בגרסה 2 של הסוד
register-service-account-credsבמרחב השמותgke-onprem-secrets-alice.האשכול ישתמש בגרסה העדכנית של הסוד
stackdriver-service-account-credsבמרחב השמותgke-onprem-secrets-alice. בדוגמה הזו, זו גרסה 3.הגרסה של
cloudAuditLoggingהיא מחרוזת ריקה, ולכן האשכול ישתמש בגרסה העדכנית של הסודcloud-audit-logging-service-account-credsבמרחב השמותgke-onprem-secrets-alice. בדוגמה הזו, זו גרסה 3.לא צוין
secretRef.versionלחשבון השירות של הגישה לרכיבים, ולכן האשכול ישתמש בגרסה העדכנית.
מחיקת סודות מוכנים
כדי להציג את כל הסודות המוכנים ומרחבי השמות שלהם:
gkectl list secrets --kubeconfig ADMIN_CLUSTER_KUBECONFIG
אם אף אשכול משתמשים לא משתמש במרחב שמות מוכן של Secret, אתם יכולים למחוק את מרחב השמות.
כדי למחוק מרחב שמות מוכן של Secret ואת כל הסודות שבו:
gkectl delete secret --namespace PREPARED_SECRET_NAMESPACE \
--kubeconfig ADMIN_CLUSTER_KUBECONFIG
אם אף אשכול משתמשים לא משתמש ב-Secret מוכן מסוים, אתם יכולים למחוק את ה-Secret.
כדי למחוק Secret מוכן ספציפי:
gkectl delete secret --namespace PREPARED_SECRET_NAMESPACE \
--kubeconfig ADMIN_CLUSTER_KUBECONFIG \
--secret-name SECRET