קובץ התצורה של תחנת העבודה של האדמין

בקובץ התצורה של תחנת העבודה של האדמין מצוינים המשאבים של 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"