管理員工作站設定檔

本頁面說明 Google Distributed Cloud 管理工作站設定檔中的欄位。

產生設定檔範本

下載 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

字串。vCenter 伺服器的 IP 位址或主機名稱。

填寫 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 替換為 vCenter Server 的 IP 位址。

開啟憑證檔案,查看主體一般名稱和主體替代名稱:

openssl x509 -in vcenter.pem -text -noout

輸出結果會顯示 Subject 一般名稱 (CN)。這可能是 IP 位址或主機名稱。例如:

Subject: ... CN = 203.0.113.100
Subject: ... CN = my-host.my-domain.example

輸出內容也可能包含 Subject Alternative Name 下的一或多個 DNS 名稱:

X509v3 Subject Alternative Name:
    DNS:vcenter.my-domain.example

選擇「Common Name」(通用名稱) 或「DNS names」(DNS 名稱) 下的其中一個名稱SubjectSubject 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 叢集的名稱。

請參閱「為獨立主機指定根資源集區」。

vCenter.caCertPath

字串。當 Google Distributed Cloud 等用戶端將要求傳送至 vCenter 伺服器時,伺服器必須出示憑證或憑證組合,向用戶端證明自己的身分。如要驗證憑證或組合,Google Distributed Cloud 必須擁有信任鏈結中的根憑證。

vCenter.caCertPath 設為根憑證的路徑。例如:

vCenter:
  caCertPath: "/usr/local/google/home/me/certs/vcenter-ca-cert.pem"

VMware 安裝作業會建立憑證授權單位 (CA),並向 vCenter 伺服器核發憑證。信任鏈中的根憑證是由 VMware 建立的自行簽署憑證。

如果您不想使用預設的 VMWare CA,可以設定 VMware 使用其他憑證授權單位

如果 vCenter Server 使用預設 VMware CA 核發的憑證,請按照下列步驟下載憑證:

curl -k "https://SERVER_ADDRESS/certs/download.zip" > download.zip

SERVER_ADDRESS 替換為 vCenter 伺服器的位址。

安裝 unzip 指令並解壓縮憑證檔案:

sudo apt-get install unzip
unzip download.zip

如果第一次執行解壓縮指令時發生錯誤,請再次輸入指令。

certs/lin 中找出憑證檔案。

proxyUrl

字串:如果您用來執行 gkeadm 的機器使用 Proxy 伺服器存取網際網路,請將這個欄位設為 Proxy 伺服器的網址。即使通訊埠號碼與架構的預設通訊埠相同,也請一併加入。例如:

proxyUrl: "https://my-proxy.example.local:80"

adminWorkstation

這個部分包含管理員工作站的相關資訊。

adminWorkstation.name

字串。管理員工作站的名稱。這個欄位會填入系統產生的值。您可以保留系統產生的值,也可以提供您選擇的其他名稱。例如:

adminWorkstation
  name: "gke-admin-ws-200617-113711"

adminWorkstation.cpus

整數。管理工作站的虛擬 CPU 數量。例如:

adminWorkstation:
  cpus: 4

adminWorkstation.memoryMB

整數。管理員工作站的記憶體容量 (以 MB 為單位)。例如:

adminworkstation:
  memoryMB: 8192

adminWorkstation.diskGB

整數。管理員工作站開機磁碟的大小 (以 GB 為單位)。建議至少 100 GB,且在 1.28 以上版本中,必須有 100 GB。例如:

adminWorkstation:
  diskGB: 100

adminWorkstation.dataDiskName

字串。要掛接至主目錄的永久磁碟名稱。 這個欄位會填入產生的值。您可以保留系統產生的值,或提供自選名稱。必須以 .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

整數。資料磁碟的大小 (以 MB 為單位)。如果未針對這個欄位設定任何值,則預設為 512。例如:

adminWorkstation:
  dataDiskMB: 512

adminWorkstation.network.ipAllocationMode

字串。如要讓管理員工作站從 DHCP 伺服器取得 IP 位址,請將此設定設為 "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

字串陣列。管理工作站可使用的 DNS 伺服器 IP 位址陣列。例如:

adminWorkstation:
  network:
    hostconfig:
      dns:
      - "172.16.255.1"
      - "172.16.255.2"

adminWorkstation.proxyUrl

字串。如果您的網路位於 Proxy 伺服器後方,且您希望管理工作站和管理叢集使用相同的 Proxy 伺服器,請將 adminworkstation.proxyURL 設為 Proxy 伺服器的網址。即使通訊埠號碼與架構的預設通訊埠相同,也請一併加入。例如:

adminworkstation:
  proxyUrl: "http://aw-proxy.example:80"

adminWorkstation.ntpServer

字串。管理員工作站應使用的網路時間通訊協定伺服器主機名稱或 IP 位址。例如:

adminWorkstation:
  ntpServer: "216.239.35.0"

如果將這個欄位留空,Google Distributed Cloud 會使用 "ntp.ubuntu.com"

完成的設定檔範例

以下是完整的管理員工作站設定檔範例:

gcp:
  componentAccessServiceAccountKeyPath: "my-key-folder/component-access-key.json"
vCenter:
  credentials:
    address: "203.0.113.1"
    username: "administrator.vsphere.local"
    password: "#STyZ2T#Ko2o"
  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: 50
  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"