當您為 CLI 部署準備 JSON 組態檔時,必須設定參數和值,來為 vCenter Server Appliance 或 Platform Services Controller 應用裝置的部署提供輸入資料。
JSON 部署檔案中組態參數的區段和子區段
用於 CLI 升級的 JSON 組態檔中的組態參數在區段和子區段中進行組織整理。
區段 | 子區段 | 說明 |
---|---|---|
new_vcsa - 描述您要部署的應用裝置 |
esxi |
僅當您要在 ESXi 主機上直接部署應用裝置時才使用。 |
vc |
僅當您要在 vCenter Server 執行個體的詳細目錄上部署應用裝置時才使用。 包含描述來自 vCenter Server 詳細目錄的目標 ESXi 主機或 DRS 叢集的組態參數。請參閱
備註: 必須填寫
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 Appliance 安裝程式未驗證
ovftool_arguments 子區段中的組態參數。如果您設定 OVF 工具無法識別的引數,則部署可能會失敗。
|
|
ceip - 描述加入 VMware 客戶經驗改進計劃 (CEIP) |
settings |
僅包含用來加入或不加入 VMware 客戶經驗改進計劃 (CEIP) 的 僅當您部署含內嵌式 Platform Services Controller 的 vCenter Server Appliance 或部署 Platform Services Controller 應用裝置時需要。
備註: 如果設定為
true ,則必須執行帶有
--acknowledge-ceip 引數的 CLI 部署命令。
如需有關 CEIP 的資訊,請參閱vCenter Server 和主機管理中的〈設定客戶體驗改進計劃〉一節。 |
字串值 (包括密碼) 必須僅包含 ASCII 字元。不支援延伸的 ASCII 和非 ASCII 字元。
若要設定包含反斜線 (\) 或引號 (") 字元的值,您必須在字元前面加上反斜線 (\) 字元。例如,"password":"my\"password"
可設定密碼 my”password;"image":"G:\\vcsa\\VMware-vCenter-Server-Appliance-6.7.0.XXXX-YYYYYYY_OVF10.ova"
可設定路徑 G:\vcsa\VMware-vCenter-Server-Appliance-6.7.0.XXXX-YYYYYYY_OVF10.ova。
布林值必須只包含小寫字元。可以是 true
或 false
。例如,"ssh_enable":false
。
new_vcsa
區段中的組態參數
名稱 | 類型 | 說明 |
---|---|---|
hostname |
string | 您要在其上部署應用裝置的目標 ESXi 主機的 IP 位址或 FQDN。 |
username |
string | 在目標 ESXi 主機上具有管理權限的使用者名稱,例如 root。 |
password |
string | 在目標 ESXi 主機上具有管理權限的使用者的密碼。 |
deployment_network |
string | 要連線應用裝置的網路名稱。
備註: 該網路必須可從目標
ESXi 主機進行存取。
如果目標 ESXi 主機只有一個網路,則忽略。 |
datastore |
string | 您要儲存所有虛擬機器組態檔和應用裝置的虛擬磁碟之資料存放區的名稱。
備註:
該資料存放區必須可從 ESXi 主機進行存取。 該資料存放區必須有足夠的可用空間。 |
port |
整數 | 目標 ESXi 主機的 HTTPS 反向 Proxy 連接埠。 預設連接埠為 443。僅當目標 ESXi 主機使用自訂 HTTPS 反向 Proxy 連接埠時使用。 |
名稱 | 類型 | 說明 |
---|---|---|
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"]或 "parent_folder, child_folder, datacenter_name"
備註: 值不區分大小寫。
|
datastore |
string | 您要儲存所有虛擬機器組態檔和應用裝置的虛擬磁碟之資料存放區的名稱。
備註:
資料存放區必須可從目標 ESXi 主機或 DRS 叢集進行存取。 資料存放區必須有至少 15 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"]或 "parent_folder, child_folder, esxi-host.domain.com"
如果目標
ESXi 主機是叢集的一部分,請使用以逗點分隔的多個字串的清單或以逗點分隔的作為單個字串的清單來提供路徑。例如,
["cluster_name", "esxi-host.domain.com"]或 "cluster_name, esxi-host.domain.com"
備註: 值不區分大小寫。
|
vm_folder |
string | 選擇性。用來向其中新增應用裝置的虛擬機器資料夾的名稱。 |
名稱 | 類型 | 說明 |
---|---|---|
thin_disk_mode |
Boolean | 設定為 true 以部署含精簡虛擬磁碟的應用裝置。 |
deployment_option |
string | 應用裝置的大小。
|
image |
string | 選擇性。vCenter Server Appliance 安裝套件的本機檔案路徑或 URL。 依預設,安裝程式會使用包含在 vcsa 資料夾的 ISO 檔案中的安裝套件。 |
name |
string | 應用裝置的虛擬機器名稱。 除了百分號 (%)、反斜線 (\) 或正斜線 (/) 之外,必須只包含 ASCII 字元,並且長度不得超過 80 個字元。 |
ovftool_path |
string | 選擇性。OVF 工具可執行檔的本機檔案路徑。 依預設,安裝程式會使用包含在 vcsa/ovftool 資料夾的 ISO 檔案中的 OVF 工具執行個體。 |
名稱 | 類型 | 說明 |
---|---|---|
ip_family |
string | 應用裝置網路的 IP 版本。 設定為 |
mode |
string | 應用裝置網路的 IP 指派。 設定為 |
ip |
string | 應用裝置的 IP 位址。 僅當您使用靜態指派,也就是將 您必須設定與網路 IP 版本,也就是與 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" 僅當您使用靜態指派,也就是將 |
prefix |
string | 網路首碼長度。 僅當 網路首碼長度是子網路遮罩中設定的位元數。例如,如果子網路遮罩是 255.255.255.0,則二進位版本的首碼長度中包含 24 個位元,因此網路首碼長度為 24。 對於 IPv4 版本,值必須在 對於 IPv6 版本,值必須在 |
gateway |
string | 預設閘道的 IP 位址。 對於 IPv6 版本,值可以為 |
ports |
string | (選擇性) vCenter Server Appliance 用於直接 HTTP 連線的連接埠號碼。依預設,連接埠 80 會將要求重新導向至 HTTPS 連接埠 443。您可以自訂 vCenter Server HTTP 和 HTTPS 連接埠。若要指定自訂 HTTP 和 HTTPS 連接埠號碼,請確保不會使用已由 vCenter Server 使用的連接埠或預設 HTTP 和 HTTPS 連接埠 80 和 443。 用於指定自訂連接埠的選項為: 下列範例將連接埠 81 和 444 分別指定為 HTTP 和 HTTPS 連接埠: ports: {"rhttpproxy.ext.port1":"81", "rhttpproxy.ext.port2":"444"} 如需有關 vCenter Server 使用的連接埠的詳細資訊,請參閱 vCenter Server 與 Platform Services Controller 所需的連接埠。 |
system_name |
string | 主要網路身分識別。 可以是 IP 位址或 FQDN,最好是 FQDN。 您無法在部署後變更此參數的值。 FQDN 和以點分隔的十進位數必須符合 RFC 1123 準則。 |
名稱 | 類型 | 說明 |
---|---|---|
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 | 選擇性。設定為 如果已設定 NTP 伺服器進行時間同步化,也就是說如果已設定 |
名稱 | 類型 | 說明 |
---|---|---|
password |
string | vCenter Single Sign-On 管理員使用者的密碼 administrator@your_domain_name。
|
domain_name |
string | vCenter Single Sign-On 網域名稱,例如 vsphere.local。
|
first_instance |
Boolean | 僅當您部署 Platform Services Controller 應用裝置時需要。 預設值為 如果要在現有 vCenter Single Sign-On 網域中加入 Platform Services Controller 應用裝置,則設定為 已加入的 Platform Services Controller 執行個體將複寫其基礎結構資料並啟用增強型連結模式。如需管理 Platform Services Controller 服務的相關資訊,請參閱Platform Services Controller 管理。 |
platform_services_controller |
string | 外部 Platform Services Controller 的系統名稱。 僅當您升級含外部 Platform Services Controller 的 vCenter Server Appliance 時需要。 |
replication_partner_hostname |
string | 合作夥伴 Platform Services Controller 的系統名稱。 僅當您將 Platform Services Controller 應用裝置部署為現有 vCenter Single Sign-On 網域的複寫合作夥伴時需要。 |
sso_port |
整數 | 合作夥伴 Platform Services Controller 的 HTTPS 反向 Proxy 連接埠。 預設連接埠為 443。僅當合作夥伴 Platform Services Controller 使用自訂 HTTPS 反向 Proxy 連接埠時使用。 |
site_name |
string | vCenter Single Sign-On 名稱。 僅在部署內嵌式 Platform Services Controller 應用裝置時需要。
備註: 為使用內嵌式
Platform Services Controller 的
vCenter Server Appliance 部署設定增強型連結模式支援時,使用
Default-First-Site 做為第一個執行個體的站台名稱。
|
ceip
區段中的組態參數
名稱 | 類型 | 說明 |
---|---|---|
ceip_enabled |
Boolean | 設定為 true 以加入此應用裝置的 CEIP。 |