在執行 CLI 安裝程式以部署 vCenter ServerAppliance 之前，您必須先針對部署規格準備含有組態參數及其值的 JSON 檔案。

vCenter Server安裝程式包含所有部署選項的 JSON 範本。如需範本的相關資訊，請參閱 vCenter Server Appliance 之 CLI 部署的 JSON 範本。

您可以針對自己的規格，透過將值設定為 JSON 範本中的組態參數，以最低組態部署應用裝置。對於自訂組態，您可以編輯預設值、移除組態參數及新增組態參數。

如需組態參數及其說明的完整清單，請導覽至作業系統的安裝程式子目錄並執行 vcsa-deploy install --template-help命令，或參閱部署組態參數。

必要條件

程序

  1. 在 vCenter Server安裝程式中，導覽至 vcsa-cli-installer 目錄並開啟 templates 子資料夾。
  2. 將部署範本從 install 子資料夾複製到您的工作區。
    重要： JSON 組態檔的路徑必須僅包含 ASCII 字元。不支援延伸的 ASCII 和非 ASCII 字元。
  3. 在文字編輯器中開啟您的規格的範本檔案。
    為確保 JSON 組態檔的語法正確，請使用 JSON 編輯器。
  4. 填寫必要組態參數的值，並選擇性地輸入其他參數及其值。
    例如，如果想要針對應用裝置的網路使用 IPv4 DHCP 指派，請在範本的 network子區段中，將 mode 參數的值變更為 dhcp 並移除適用於靜態指派的預設組態參數。 
            "network": {
            "ip_family": "ipv4",
            "mode": "dhcp"
        },
    重要：

    字串值 (包括密碼) 必須僅包含 ASCII 字元。不支援延伸的 ASCII 和非 ASCII 字元。

    若要設定包含反斜線 (\) 或引號 (") 字元的值，您必須在字元前面加上反斜線 (\) 字元。例如，"password":"my\"password" 可設定密碼 my”password；"image":"G:\\vcsa\\VMware-vCenter-Server-Appliance-8.0.0.XXXX-YYYYYYY_OVF10.ova" 可設定路徑 G:\vcsa\VMware-vCenter-Server-Appliance-8.0.0.XXXX-YYYYYYY_OVF10.ova。

    布林值必須僅包含小寫字元，即值可以是 true或false。例如，"ssh_enable":false。

  5. (選擇性) 使用所選擇的 JSON 編輯器驗證 JSON 檔案。
  6. 以 UTF-8 格式儲存並關閉檔案。

下一步

如果需要，您可以針對部署規格建立和儲存其他範本。

vCenter Server Appliance 之 CLI 部署的 JSON 範本

vCenter Server 安裝程式包含 JSON 範本 (具有所有部署選項的最低組態參數)。範本位於 vcsa-cli-installer/templates/install 目錄中。

對於每個部署選項，有一個範本用於在 ESXi 主機上部署應用裝置，另一個範本用於在 vCenter Server 執行個體上部署應用裝置。

表 1. 包含在 vCenter Server 安裝程式中的部署 JSON 範本
範本 說明
embedded_vCSA_on_ESXi.json 包含在 ESXi 主機上部署 vCenter Server Appliance 所需的最低組態參數。
vCSA_with_cluster_on_ESXi.json 包含在 ESXi 主機上部署 vCenter Server Appliance 以及單一節點 vSAN 和 vLCM 管理叢集所需的最低組態參數。
embedded_vCSA_on_VC.json 包含在 vCenter Server 執行個體上部署 vCenter Server Appliance 所需的最低組態參數。
embedded_vCSA_replication_on_ESXi.json 包含在 ESXi 主機上部署 vCenter Server Appliance 做為另一個內嵌式 vCenter Server 之複寫合作夥伴所需的最低組態參數。
embedded_vCSA_replication_on_VC.json 包含在 vCenter Server 執行個體上將 vCenter Server Appliance 複寫合作夥伴部署至另一個 vCenter Server Appliance 所需的最低組態參數。

部署組態參數

當您為 CLI 部署準備 JSON 組態檔時，必須設定參數和值，來為 vCenter Server Appliance 的部署提供輸入資料。

JSON 部署檔案中組態參數的區段和子區段

用於 CLI 升級的 JSON 組態檔中的組態參數在區段和子區段中進行組織整理。

表 2. JSON 部署檔案中組態參數的區段和子區段
區段 子區段 說明
new_vcsa - 描述您要部署的應用裝置 esxi

僅當您要在 ESXi 主機上直接部署應用裝置時才使用。

包含描述目標 ESXi 主機的組態參數。

根據您是否要在部署期間設定 vSAN 或 vLCM 管理叢集，來參閱相關章節，以取得有關組態參數的詳細資訊。
備註： 必須填寫 esxi 或 vc 子區段。
vc

僅當您要在 vCenter Server 執行個體的詳細目錄上部署應用裝置時才使用。

包含描述來自 vCenter Server 詳細目錄的目標 ESXi 主機或 DRS 叢集的組態參數。請參閱new_vcsa 區段 vc 子區段中的組態參數。

備註： 必須填寫 vc 或 esxi 子區段。
appliance 包含描述應用裝置的組態參數。請參閱new_vcsa 區段 appliance 子區段中的組態參數。
network 包含描述適用於應用裝置的網路設定的組態參數。請參閱new_vcsa 區段 network 子區段中的組態參數。
os 包含描述適用於應用裝置的作業系統設定的組態參數。請參閱new_vcsa 區段 os 子區段中的組態參數。
sso 包含描述適用於應用裝置的 vCenter Single Sign-On 設定的組態參數。請參閱new_vcsa 區段 sso 子區段中的組態參數。
ovftool_arguments 選用子區段，用於將任意引數和它們的值新增至安裝程式產生的 OVF 工具命令。
重要： vCenter Server 安裝程式未驗證 ovftool_arguments 子區段中的組態參數。如果您設定 OVF 工具無法識別的引數，則部署可能會失敗。
ceip- 描述加入 VMware 客戶經驗改進計劃 (CEIP) settings

僅包含用來加入或不加入 VMware 客戶經驗改進計劃 (CEIP) 的 ceip_enabled 組態參數。請參閱ceip 區段 settings 子區段中的組態參數。

備註： 如果設定為 true，則必須執行帶有 --acknowledge-ceip 引數的 CLI 部署命令。

如需有關 CEIP 的資訊，請參閱vCenter Server 和主機管理中的〈設定客戶體驗改進計劃〉一節。

重要：

字串值 (包括密碼) 必須僅包含 ASCII 字元。不支援延伸的 ASCII 和非 ASCII 字元。

若要設定包含反斜線 (\) 或引號 (") 字元的值，您必須在字元前面加上反斜線 (\) 字元。例如，"password":"my\"password" 會設定密碼 my"password。同樣地，"image":"G:\\vcsa\\VMware-vCenter-Server-Appliance-8.0.0.XXXX-YYYYYYY_OVF10.ova" 會設定路徑 G:\vcsa\VMware-vCenter-Server-Appliance-8.0.0.XXXX-YYYYYYY_OVF10.ova。

布林值必須只包含小寫字元。它必須是 true 或 false。例如，"ssh_enable":false。

new_vcsa 區段中的組態參數

表 3. new_vcsa 區段之 esxi 子區段中的組態參數，用於具有 vSAN 和 vLCM 管理叢集的部署
名稱 類型 說明
hostname string 您要在其上部署應用裝置的目標 ESXi 主機的 IP 位址或 FQDN。
username string 在目標 ESXi 主機上具有管理權限的使用者名稱，例如 root。
password string 在目標 ESXi 主機上具有管理權限的使用者的密碼。
deployment_network string

要連線應用裝置的網路名稱。

備註： 該網路必須可從目標 ESXi 主機進行存取。

如果目標 ESXi 主機只有一個網路，則忽略。

datacenter string 您想要建立的特定資料中心。
cluster string vSAN 或 vLCM 管理叢集的名稱。
compression_only 布林值 將此值設定為 true，以對 vSAN 叢集啟用壓縮。如果此參數設定為 true，則 deduplication_and_compression 參數必須設定為 false。
deduplication_and_compression 布林值 將此值設定為 true，以對 vSAN 叢集啟用壓縮和重複資料刪除。如果此參數設定為 true，則 compression_only 參數必須設定為 false。
cache_disk 要用於快取之磁碟的 UUID 或正式名稱的清單。僅指定 SSD。
capacity_disk 要用於儲存之磁碟的 UUID 或正式名稱的清單。指定 SSD 或 HDD。
enable_vlcm 布林值 設定為 true，以建立 vLCM 管理叢集。
enable_vsan_esa 布林值 設定為 true 以建立啟用了 vSAN ESA 的 vSAN 叢集。vSAN Express Storage Architecture 是新一代架構，旨在充分利用高效能儲存裝置，進而提升效能和效率。
single_tier 陣列 要新增至 vSAN 儲存區集區之磁碟的 UUID 或正式名稱的清單。僅當將 enable_vsan_esa 設定為 true 時需要。
vsan_hcl_database_path 字串 本機 vSAN HCL 資料庫路徑。如果位於此位置的 vSAN HCL 資料庫已過期，則安裝程式會下載舊版本並將其取代為最新版本。僅當將 enable_vsan_esa 設定為 true 時需要。
datastore string

您要在其中儲存應用裝置之組態檔和虛擬磁碟的資料存放區的名稱。

備註：

該資料存放區必須可從 ESXi 主機進行存取。

如果您使用精簡型磁碟模式，則資料存放區大小應至少有 25 GB 空間。
port 整數

目標 ESXi 主機的 HTTPS 反向 Proxy 連接埠。

預設連接埠為 443。僅當目標 ESXi 主機使用自訂 HTTPS 反向 Proxy 連接埠時使用。

表 4. new_vcsa 區段之 esxi 子區段中的組態參數，用於不具有 vSAN 或 vLCM 管理叢集的部署
名稱 類型 說明
hostname string 您要在其上部署應用裝置的目標 ESXi 主機的 IP 位址或 FQDN。
username string 在目標 ESXi 主機上具有管理權限的使用者名稱，例如 root。
password string 在目標 ESXi 主機上具有管理權限的使用者的密碼。
deployment_network string

要連線應用裝置的網路名稱。

備註： 該網路必須可從目標 ESXi 主機進行存取。

如果目標 ESXi 主機只有一個網路，則忽略。

datastore string

您要在其中儲存應用裝置之組態檔和虛擬磁碟的資料存放區的名稱。

備註：

該資料存放區必須可從 ESXi 主機進行存取。

如果您使用精簡型磁碟模式，則資料存放區大小應至少有 25 GB 空間。
port 整數

目標 ESXi 主機的 HTTPS 反向 Proxy 連接埠。

預設連接埠為 443。僅當目標 ESXi 主機使用自訂 HTTPS 反向 Proxy 連接埠時使用。

表 5. new_vcsa 區段 vc 子區段中的組態參數
名稱 類型 說明
hostname string 您要在其上部署應用裝置的目標 vCenter Server 執行個體的 IP 位址或 FQDN。
username string 目標 vCenter Server 執行個體上的 vCenter Single Sign-On 管理員使用者名稱，例如，[email protected]。
password string 目標 vCenter Server 執行個體上的 vCenter Single Sign-On 管理員使用者的密碼。
deployment_network string

要連線應用裝置的網路名稱。

備註： 該網路必須可從您要在其上部署應用裝置的目標 ESXi 主機或 DRS 叢集進行存取。

如果目標 ESXi 主機或 DRS 叢集只有一個網路，則忽略。

datacenter 陣列

包含您要在其上部署應用裝置的目標 ESXi 主機或 DRS 叢集的 vCenter Server 資料中心。

如果資料中心位於資料夾或資料夾結構中，請將值指定為以逗點分隔的多個字串的清單。例如， 
["parent_folder", "child_folder", "datacenter_name"]
備註： 值不區分大小寫。
datastore string

您要在其中儲存應用裝置之組態檔和虛擬磁碟的資料存放區的名稱。

備註：

資料存放區必須可從目標 ESXi 主機或 DRS 叢集進行存取。

資料存放區必須有至少 25 GB 的可用空間。

port 整數

目標 vCenter Server 執行個體的 HTTPS 反向 Proxy 連接埠。

預設連接埠為 443。僅當目標 vCenter Server 執行個體使用自訂 HTTPS 反向 Proxy 連接埠時使用。

target 陣列

您要在其上部署應用裝置的目標 ESXi 主機或 DRS 叢集。

重要： 您必須提供在 vCenter Server 詳細目錄中顯示的名稱。例如，如果目標 ESXi 主機的名稱是 vCenter Server 詳細目錄中的 IP 位址，則您無法提供 FQDN。
如果目標 ESXi 主機或者 DRS 叢集位於資料夾或資料夾結構中，請將值指定為以逗點分隔的多個字串的清單。例如， 
["parent_folder", "child_folder", "esxi-host.domain.com"]
如果目標 ESXi 主機是叢集的一部分，請將路徑指定為以逗號分隔的多個字串的清單。例如， 
["cluster_name", "esxi-host.domain.com"]
備註： 值不區分大小寫。
vm_folder string 選擇性。部署應用裝置所在的虛擬機器資料夾的名稱。
表 6. new_vcsa 區段 appliance 子區段中的組態參數
名稱 類型 說明
thin_disk_mode Boolean 設定為 true 以部署含精簡虛擬磁碟的應用裝置。
deployment_option string 應用裝置的大小。
  • 如果您要為具有預設儲存區大小的最多 10 台主機和 100 台虛擬機器部署 vCenter Server Appliance，則設定為 tiny。

    部署具有 2 個 CPU、12 GB 記憶體和 315 GB 儲存區的應用裝置。

  • 如果您要為具有大型儲存區大小的最多 10 台主機和 100 台虛擬機器部署 vCenter Server Appliance，則設定為 tiny-lstorage。

    部署具有 2 個 CPU、12 GB 記憶體和 1390 GB 儲存區的應用裝置。

  • 如果您要為具有超大型儲存區大小的最多 10 台主機和 100 台虛擬機器部署 vCenter Server Appliance，則設定為 tiny-xlstorage。

    部署具有 2 個 CPU、12 GB 記憶體和 3145 GB 儲存區的應用裝置。

  • 如果您要為具有預設儲存區大小的最多 100 台主機和 1,000 台虛擬機器部署 vCenter Server Appliance，則設定為 small。

    部署具有 4 個 CPU、19 GB 記憶體和 380 GB 儲存區的應用裝置。

  • 如果您要為具有大型儲存區大小的最多 100 台主機和 1,000 台虛擬機器部署 vCenter Server Appliance，則設定為 small-lstorage。

    部署具有 4 個 CPU、19 GB 記憶體和 1435 GB 儲存區的應用裝置。

  • 如果您要為具有超大型儲存區大小的最多 100 台主機和 1,000 台虛擬機器部署 vCenter Server Appliance，則設定為 small-xlstorage。

    部署具有 4 個 CPU、19 GB 記憶體和 3195 GB 儲存區的應用裝置。

  • 如果您要為具有預設儲存區大小的最多 400 台主機和 4,000 台虛擬機器部署 vCenter Server Appliance，則設定為 medium。

    部署具有 8 個 CPU、28 GB 記憶體和 600 GB 儲存區的應用裝置。

  • 如果您要為具有大型儲存區大小的最多 400 台主機和 4,000 台虛擬機器部署 vCenter Server Appliance，則設定為 medium-lstorage。

    部署具有 8 個 CPU、28 GB 記憶體和 1600 GB 儲存區的應用裝置。

  • 如果您要為具有超大型儲存區大小的最多 400 台主機和 4,000 台虛擬機器部署 vCenter Server Appliance，則設定為 medium-xlstorage。

    部署具有 8 個 CPU、28 GB 記憶體和 3360 GB 儲存區的應用裝置。

  • 如果您要為具有預設儲存區大小的最多 1,000 台主機和 10,000 台虛擬機器部署 vCenter Server Appliance，則設定為 large。

    部署具有 16 個 CPU、37 GB 記憶體和 965 GB 儲存區的應用裝置。

  • 如果您要為具有大型儲存區大小的最多 1,000 台主機和 10,000 台虛擬機器部署 vCenter Server Appliance，則設定為 large-lstorage。

    部署具有 16 個 CPU、37 GB 記憶體和 1665 GB 儲存區的應用裝置。

  • 如果您要為具有超大型儲存區大小的最多 1,000 台主機和 10,000 台虛擬機器部署 vCenter Server Appliance，則設定為 large-xlstorage。

    部署具有 16 個 CPU、37 GB 記憶體和 3425 GB 儲存區的應用裝置。

  • 如果您要為具有預設儲存區大小的最多 2,000 台主機和 35,000 台虛擬機器部署 vCenter Server Appliance，則設定為 xlarge。

    部署具有 24 個 CPU、56 GB 記憶體和 1705 GB 儲存區的應用裝置。

  • 如果您要為具有大型儲存區大小的最多 2,000 台主機和 35,000 台虛擬機器部署 vCenter Server Appliance，則設定為 xlarge-lstorage。

    部署具有 24 個 CPU、56 GB 記憶體和 1805 GB 儲存區的應用裝置。

  • 如果您要為具有超大型儲存區大小的最多 2,000 台主機和 35,000 台虛擬機器部署 vCenter Server Appliance，則設定為 xlarge-xlstorage。

    部署具有 24 個 CPU、56 GB 記憶體和 3565 GB 儲存區的應用裝置。

image string

選擇性。vCenter Server Appliance 安裝套件的本機檔案路徑或 URL。

依預設，安裝程式會使用包含在 vcsa 資料夾的 ISO 檔案中的安裝套件。

name string

應用裝置的虛擬機器名稱。

除了百分號 (%)、反斜線 (\) 或正斜線 (/) 之外，必須只包含 ASCII 字元，並且長度不得超過 80 個字元。

ovftool_path string

選擇性。OVF 工具可執行檔的本機檔案路徑。

依預設，安裝程式會使用包含在 vcsa/ovftool 資料夾的 ISO 檔案中的 OVF 工具執行個體。

表 7. new_vcsa 區段 network 子區段中的組態參數
名稱 類型 說明
ip_family string

應用裝置網路的 IP 版本。

設定為 ipv4 或 ipv6。

mode string 應用裝置網路的 IP 指派。

設定為 static 或 dhcp。

ip string

應用裝置的 IP 位址。

僅當您使用靜態指派，也就是將 mode 參數設定為 static 時需要。

您必須設定與網路 IP 版本，也就是與 ip.family 參數的值對應的 IPv4 或 IPv6 位址。

IPv4 位址必須符合 RFC 790 準則。

IPv6 位址必須符合 RFC 2373 準則。

dns_servers 字串或陣列

一或多個 DNS 伺服器的 IP 位址。

若要設定多個 DNS 伺服器，請使用以逗點分隔的多個字串的清單或是以逗點分隔的作為單個字串的清單來提供路徑。例如， 
["x.y.z.a", "x.y.z.b"]
或 
"x.y.z.a, x.y.z.b"

僅當 mode 參數設定為 static 時可選。模式設定為 DHCP 時不受支援。
prefix string

網路首碼長度。

僅當 mode 參數設定為 static 時使用。僅當 mode 參數設定為 dhcp 時移除。

網路首碼長度是子網路遮罩中設定的位元數。例如，如果子網路遮罩是 255.255.255.0，則二進位版本的首碼長度中包含 24 個位元，因此網路首碼長度為 24。

對於 IPv4 版本，值必須在 0 和 32 之間。

對於 IPv6 版本，值必須在 0 和 128 之間。

gateway string

預設閘道的　IP 位址。

對於 IPv6 版本，值可以為 default。

ports string

選擇性。vCenter Server Appliance 用於直接 HTTP 連線的連接埠號碼。依預設，連接埠 80 會將要求重新導向至 HTTPS 連接埠 443。您可以自訂 vCenter Server HTTP 和 HTTPS 連接埠。若要指定自訂 HTTP 和 HTTPS 連接埠號碼，請確保不會使用已由 vCenter Server 使用的連接埠或預設 HTTP 和 HTTPS 連接埠 80 和 443。

用於指定自訂連接埠的選項為："rhttpproxy.ext.port1":"port_number" (用於 HTTP 連接埠) 和 "rhttpproxy.ext.port2:"port_number" (用於 HTTPS 連接埠)。

下列範例將連接埠 81 和 444 分別指定為 HTTP 和 HTTPS 連接埠： 

ports: {"rhttpproxy.ext.port1":"81", "rhttpproxy.ext.port2":"444"}

如需有關 vCenter Server 使用的連接埠的詳細資訊，請參閱 vCenter Server 所需的連接埠。

system_name string

主要網路身分識別。

可以是 IP 位址或 FQDN，最好是 FQDN。

您無法在部署後變更此參數的值。

FQDN 和以點分隔的十進位數必須符合 RFC 1123 準則。

表 8. new_vcsa 區段 os 子區段中的組態參數
名稱 類型 說明
password string

應用裝置作業系統的根使用者密碼。

密碼必須包含 8 至 20 個字元，至少一個大寫字元、一個小寫字元、一個數字，以及一個特殊字元，例如，貨幣符號 ($)、雜湊鍵 (#)、記號 (@)、句點 (.) 或驚歎號 (!)。所有字元必須僅包含不含空格的下部 ASCII 字元。

ntp_servers 字串或陣列

選擇性。用於時間同步化之一或多部 NTP 伺服器的主機名稱或 IP 位址。

若要設定多個 NTP 伺服器，請使用以逗點分隔的多個字串的清單或是以逗點分隔的做為單個字串的清單來提供路徑。例如， 
["x.y.z.a", "x.y.z.b"]
或 
"x.y.z.a, x.y.z.b"
ssh_enable Boolean 設定為 true，以便 SSH 管理員登入應用裝置。
備註： vCenter Server Appliance 高可用性需要對應用裝置的遠端 SSH 存取權。
time_tools_sync Boolean

選擇性。設定為 true，以便使用 VMware Tools 時間同步化部署應用裝置。VMware Tools 將應用裝置的時間與 ESxi 主機的時間同步。

如果已設定 NTP 伺服器進行時間同步化，也就是說如果已設定 ntp.servers 參數，則忽略此項。

表 9. new_vcsa 區段 sso 子區段中的組態參數
名稱 類型 說明
password string

vCenter Single Sign-On 管理員使用者的密碼 administrator@your_domain_name。

如果要將 vCenter Server Appliance 部署為新 vCenter Single Sign-On 網域的第一個執行個體，則必須為 vCenter Single Sign-On 管理員使用者設定密碼。

密碼必須包含 8 至 20 個字元，至少一個大寫字元、一個小寫字元、一個數字，以及一個特殊字元，例如，貨幣符號 ($)、雜湊鍵 (#)、記號 (@)、句點 (.) 或驚歎號 (!)。所有字元都必須為 ASCII 字元。

domain_name string

vCenter Single Sign-On 網域名稱，例如 vsphere.local。

如果要將 vCenter Server Appliance 部署為新 vCenter Single Sign-On 網域的第一個執行個體，則必須為新的 vCenter Single Sign-On 網域設定密碼。
replication_partner_hostname string

合作夥伴 vCenter Server 的系統名稱。

僅當您部署現有 vCenter Single Sign-On 網域中的複寫合作夥伴時需要。

sso_port 整數

合作夥伴 vCenter Server 的 HTTPS 反向 Proxy 連接埠。

預設連接埠為 443。僅當合作夥伴使用自訂 HTTPS 反向 Proxy 連接埠時使用。

ceip 區段中的組態參數

表 10. ceip 區段 settings 子區段中的組態參數
名稱 類型 說明
ceip_enabled Boolean 設定為 true 以加入此應用裝置的 CEIP。