בקובץ התצורה של תחנת העבודה של האדמין מצוינים המשאבים של vCenter, הגדרות הרשת, המעבד, הזיכרון וגודלי הדיסקים שמשמשים את gkeadm ליצירת תחנת עבודה של אדמין לתוכנת Google Distributed Cloud ל-VMware בלבד. במסמך הזה מתואר כל שדה בקובץ, ויש בו דוגמה לקובץ תצורה מלא.
יצירת תבנית לקובץ התצורה
מורידים את כלי שורת הפקודה gkeadm.
כדי ליצור תבנית:
./gkeadm create config --config=OUTPUT_FILENAME
מחליפים את OUTPUT_FILENAME בנתיב לבחירתכם לתבנית שנוצרה. אם לא משתמשים בדגל הזה, הכלי gkeadm נותן לקובץ את השם admin-ws-config.yaml וממקם אותו בספרייה הנוכחית.
תבנית
מילוי קובץ התצורה
בקטעים הבאים מוסבר איך להזין את ערכי השדות בקובץ התצורה.
gcp
בקטע הזה מופיע מידע על חשבון השירות לגישה לרכיבים.
gcp.componentAccessServiceAccountKeyPath
מחרוזת. הנתיב של קובץ מפתח ה-JSON של חשבון השירות לגישה לרכיבים. למידע על יצירת קובץ מפתח JSON, ראו חשבון שירות לגישה לרכיבים.
לדוגמה:
gcp: componentAccessServiceAccountKeyPath: "my-key-folder/component-access-key.json"
vCenter
הקטע הזה מכיל מידע על סביבת vSphere.
vCenter.credentials.address
מחרוזת. כתובת ה-IP או שם המארח של שרת vCenter.
לפני שממלאים את השדה address, צריך להוריד ולבדוק את אישור ההצגה של שרת ה-vCenter. מזינים את הפקודה הבאה כדי להוריד את האישור ולשמור אותו בקובץ בשם vcenter.pem.
true | openssl s_client -connect VCENTER_IP:443 -showcerts 2>/dev/null | sed -ne '/-BEGIN/,/-END/p' > vcenter.pem
מחליפים את VCENTER_IP בכתובת ה-IP של שרת ה-vCenter.
פותחים את קובץ האישור כדי לראות את השם הפרטי של הבעלים (subject) ואת השם החלופי של הבעלים:
openssl x509 -in vcenter.pem -text -noout
השם הנפוץ (CN) של Subject מופיע בפלט. הערך יכול להיות כתובת IP או שם מארח. לדוגמה:
Subject: ... CN = 203.0.113.100
Subject: ... CN = my-host.my-domain.example
יכול להיות שהפלט יכלול גם שם DNS אחד או יותר בקטע Subject Alternative Name:
X509v3 Subject Alternative Name:
DNS:vcenter.my-domain.exampleבוחרים את השם הנפוץ של Subject או אחד משמות ה-DNS בקטע Subject Alternative Name כדי להשתמש בו כערך של vCenter.credentials.address בקובץ התצורה. לדוגמה:
vCenter:
credentials:
address: "203.0.113.1"
...
vCenter:
credentials:
address: "my-host.my-domain.example"
...
vCenter.credentials.fileRef.path
מחרוזת. הנתיב של קובץ תצורה של פרטי כניסה שמכיל את שם המשתמש והסיסמה של חשבון המשתמש ב-vCenter. לחשבון המשתמש צריך להיות תפקיד אדמין או הרשאות מקבילות. לדרישות של vSphere
כשמריצים את gkeadm create config, נוצרת תבנית לקובץ תצורה של תחנת עבודה אדמין בשם admin-ws-config.yaml. היא גם יוצרת תבנית לקובץ תצורה של פרטי כניסה בשם credential.yaml.
דוגמה:
vCenter:
credentials:
fileRef:
path: "credential.yaml"
vCenter.credentials.fileRef.entry
מחרוזת. השם של בלוק פרטי הכניסה בקובץ התצורה של פרטי הכניסה, שמכיל את שם המשתמש והסיסמה של חשבון המשתמש ב-vCenter.
ב-credential.yaml, gkeadm יוצר באופן אוטומטי בלוק של פרטי כניסה בשם vCenter.
דוגמה:
vCenter:
credentials:
fileRef:
entry: "vCenter"
vCenter.datacenter
מחרוזת. השם של מרכז הנתונים של vCenter. לדוגמה:
vCenter: datacenter: "MY-DATACENTER"
vCenter.datastore
מחרוזת. השם של מאגר הנתונים ב-vCenter. לדוגמה:
vCenter: datastore: "MY-DATASTORE"
vCenter.cluster
מחרוזת. השם של אשכול vCenter. לדוגמה:
vCenter: cluster: "MY-CLUSTER"
vCenter.network
מחרוזת. שם הרשת ב-vCenter שבה רוצים ליצור את תחנת העבודה של האדמין. לדוגמה:
vCenter: network: "MY-VM-NETWORK"
vCenter.folder
מחרוזת. התיקייה במרכז הנתונים שבה נמצא ה-VM של תחנת העבודה של האדמין. לדוגמה:
vCenter: folder: "MY-FOLDER"
vCenter.resourcePool
מחרוזת. אם אתם משתמשים במאגר משאבים שאינו ברירת המחדל, ציינו את השם של מאגר המשאבים של vCenter. לדוגמה:
vCenter: resourcePool: "MY-POOL"
אם אתם משתמשים במאגר המשאבים שמוגדר כברירת מחדל, הזינו את הערך הבא:
vCenter: resourcePool: "MY_CLUSTER/Resources"
מחליפים את MY_CLUSTER בשם של אשכול ה-vCenter.
מידע נוסף זמין במאמר Specifying the root resource pool for a standalone host.
vCenter.caCertPath
מחרוזת. כשלקוח, כמו תוכנת Google Distributed Cloud ל-VMware בלבד, שולח בקשה לשרת vCenter, השרת צריך להוכיח את הזהות שלו ללקוח על ידי הצגת אישור או חבילת אישורים. כדי לאמת את האישור או את החבילה, תוכנת Google Distributed Cloud ל-VMware בלבד חייבת לכלול את אישור הבסיס בשרשרת האמון.
מגדירים את vCenter.caCertPath לנתיב של אישור הבסיס. לדוגמה:
vCenter: caCertPath: "/usr/local/google/home/me/certs/vcenter-ca-cert.pem"
להתקנת VMware יש רשות אישורים (CA) שמנפיקה אישור לשרת vCenter. אישור הבסיס בשרשרת האמון הוא אישור בחתימה עצמית שנוצר על ידי VMware.
אם אתם לא רוצים להשתמש ב-CA של VMware, שהוא ברירת המחדל, אתם יכולים להגדיר את VMware כך שישתמש ברשות אישורים אחרת.
אם שרת ה-vCenter משתמש באישור שהונפק על ידי רשות האישורים (CA) של VMware, מורידים את האישור באופן הבא:
curl -k "https://SERVER_ADDRESS/certs/download.zip" > download.zip
מחליפים את SERVER_ADDRESS בכתובת של שרת vCenter.
מתקינים את הפקודה unzip ומחלצים את קובץ האישור:
sudo apt-get install unzip unzip download.zip
אם פקודת ה-unzip לא עובדת בפעם הראשונה, מזינים את הפקודה שוב.
מוצאים את קובץ האישור ב-certs/lin.
proxyUrl
מחרוזת. אם המכונה שבה משתמשים כדי להריץ את gkeadm משתמשת בשרת proxy כדי לגשת לאינטרנט, צריך להגדיר בשדה הזה את כתובת ה-URL של שרת ה-proxy. צריך לכלול את מספר היציאה גם אם הוא זהה ליציאת ברירת המחדל של הסכימה. לדוגמה:
proxyUrl: "https://my-proxy.example.local:80"
adminWorkstation
בקטע הזה מופיע מידע על תחנת העבודה של האדמין.
adminWorkstation.name
מחרוזת. שם לתחנת העבודה של האדמין. השדה הזה מאוכלס בערך שנוצר. אפשר להשאיר את הערך שנוצר או להזין שם אחר לבחירתכם. לדוגמה:
adminWorkstation: name: "gke-admin-ws-200617-113711"
adminWorkstation.cpus
מספר שלם. מספר המעבדים הווירטואליים של תחנת העבודה של האדמין. לדוגמה:
adminWorkstation: cpus: 4
adminWorkstation.memoryMB
מספר שלם. מספר המגה-בייטים של הזיכרון לתחנת העבודה של האדמין. לדוגמה:
adminWorkstation: memoryMB: 8192
adminWorkstation.diskGB
מספר שלם. הגודל, בג'יגה-בייט, של דיסק האתחול של תחנת העבודה של האדמין. אנחנו ממליצים על לפחות 100GB, ובגרסה 1.28 ואילך נדרשים 100GB. לדוגמה:
adminWorkstation: diskGB: 100
adminWorkstation.dataDiskName
מחרוזת. שם לדיסק אחסון מתמיד (persistent disk) שרוצים לטעון לספריית הבית.
השדה הזה מאוכלס בערך שנוצר. אפשר להשאיר את הערך שנוצר או לתת שם אחר. חייב להסתיים ב-.vmdk. לפני הפריסה, צריך ליצור את כל הספריות בנתיב שצוין. אם לא מוגדר ערך בשדה הזה, ברירת המחדל היא:
gke-on-prem-admin-workstation-data-disk/ADMIN_WORKSTATION_NAME-data-disk.vmdk
לדוגמה:
adminWorkstation: dataDiskName: "gke-on-prem-admin-workstation-data-disk/gke-admin-ws-200617-113711-data-disk.vmdk"
adminWorkstation.dataDiskMB
מספר שלם. גודל דיסק הנתונים במגה-בייט. אם לא מוגדר ערך לשדה הזה, ברירת המחדל היא 512. לדוגמה:
adminWorkstation: dataDiskMB: 512
adminWorkstation.network.ipAllocationMode
מחרוזת. אם רוצים שתחנת הניהול תקבל את כתובת ה-IP שלה משרת DHCP, צריך להגדיר את השדה הזה לערך "dhcp". אם רוצים שלתחנת העבודה של האדמין תהיה כתובת IP סטטית לבחירתכם, צריך להגדיר את הערך "static". לדוגמה:
adminWorkstation:
network:
ipAllocationMode: "static"
adminWorkstation.network.hostConfig
אם הגדרתם את ipAllocationMode ל-"static", מלאו את השדות בקטע הזה.
אם מגדירים את ipAllocationMode ל-"dhcp", צריך להסיר את הקטע הזה או להשאיר אותו מסומן כהערה.
adminWorkstation.network.hostConfig.ip
מחרוזת. כתובת IP לבחירתכם לתחנת העבודה של האדמין. לדוגמה:
adminWorkstation:
network:
hostConfig:
ip: "172.16.5.1"
adminWorkstation.network.hostConfig.gateway
מחרוזת. כתובת ה-IP של שער ברירת המחדל של הרשת שמכילה את תחנת העבודה של האדמין. לדוגמה:
adminWorkstation:
network:
hostConfig:
gateway: "172.16.6.254"
adminWorkstation.network.hostConfig.netmask
מחרוזת. מסכת הרשת של הרשת שמכילה את תחנת העבודה של האדמין. לדוגמה:
adminWorkstation:
network:
hostConfig:
netmask: "255.255.248.0"
adminWorkstation.network.hostConfig.dns
מערך מחרוזות. מערך של כתובות IP לשרתי DNS שבהם תחנת הניהול יכולה להשתמש. לדוגמה:
adminWorkstation:
network:
hostConfig:
dns:
- "172.16.255.1"
- "172.16.255.2"
adminWorkstation.proxyUrl
מחרוזת. אם הרשת נמצאת מאחורי שרת proxy, ואתם רוצים שתחנת העבודה של האדמין ואשכול האדמין ישתמשו באותו שרת proxy, הגדירו את adminWorkstation.proxyUrl לכתובת ה-URL של שרת ה-proxy.
צריך לכלול את מספר היציאה גם אם הוא זהה ליציאת ברירת המחדל של הסכימה. לדוגמה:
adminWorkstation: proxyUrl: "http://aw-proxy.example:80"
adminWorkstation.ntpServer
מחרוזת. שם המארח או כתובת ה-IP של שרת Network Time Protocol שבו תחנת העבודה של האדמין צריכה להשתמש. לדוגמה:
adminWorkstation: ntpServer: "216.239.35.0"
אם לא תזינו ערך, תוכנת Google Distributed Cloud ל-VMware תשתמש ב-"ntp.ubuntu.com".
דוגמה לקובץ תצורה מלא
דוגמה לקובץ תצורה מלא של תחנת עבודה אדמין:
gcp:
componentAccessServiceAccountKeyPath: "my-key-folder/component-access-key.json"
vCenter:
credentials:
address: "203.0.113.1"
fileRef:
path: "credential.yaml"
entry: "vCenter"
datacenter: "MY-DATACENTER"
datastore: "MY-DATASTORE"
cluster: "MY-CLUSTER"
network: "MY-VM-NETWORK"
resourcePool: "MY-POOL"
caCertPath: "/usr/local/google/home/me/certs/the-root.cert"
proxyUrl: ""
adminWorkstation:
name: "my-admin-workstation"
cpus: 4
memoryMB: 8192
diskGB: 100
dataDiskName: "gke-on-prem-admin-workstation-data-disk/gke-admin-ws-200617-113711-data-disk.vmdk"
dataDiskMB: 512
network:
ipAllocationMode: "static"
hostConfig:
ip: "172.16.5.1"
gateway: "172.16.6.254"
netmask: "255.255.248.0"
dns:
- "172.16.255.1"
- "172.16.255.2"
proxyUrl: ""
ntpServer: "216.239.35.0"