主機鑑別資訊 (hostAuthInfo)
可供群體控制器接受伺服器主機鑑別的連線詳細資料。
| 屬性名稱 | 資料類型 | 預設值 | 說明 |
|---|---|---|---|
| rpcHost | 字串 | localhost | 完整主機名稱或 IP 位址。 '*' 萬用字元會導致偵測主機名稱;對於多網路系統,不建議這麼做,它可能導致非預期的行為。 主機名稱在網路內必須是唯一的,必須是遠端連線通訊協定用來接聽的主機名稱(SSH 或 OS 專用 RPC)。 如果未設定的話,這個值會繼承 defaultHostName 變數。 這裡設定的主機名稱會直接控制伺服器資訊在群體控制器儲存庫內的儲存位置。 |
| rpcPort | int | 22 | 遠端連線通訊協定用來接聽的埠(SSH 或 OS 專用 RPC)。 請參閱產品說明文件,以瞭解支援的 RPC 機制。 |
| rpcUser | 字串 | 用來連接主機的作業系統使用者 ID。 | |
| rpcUserHome | 字串 | 使用者登入 ID 的起始目錄。 只有在使用 sudo,且會自動產生 SSH 時,才需要設定。 | |
| rpcUserPassword | 可反向編碼的密碼(字串) | 作業系統使用者的密碼。 如果未設定這個內容,會使用金鑰型鑑別。 建議您在支援 SSH 的主機上使用金鑰型鑑別。 如果設定了這個內容,同時也設定了 sshPrivateKeyPath,這個金鑰優先。 | |
| sshPrivateKeyPassword | 可反向編碼的密碼(字串) | SSH 私密金鑰的密碼。 | |
| sshPrivateKeyPath | 字串 | SSH 私密金鑰檔的路徑。 如果金鑰組不存在,會自動產生金鑰組。 金鑰型鑑別需要私密金鑰。 | |
| sshPublicKeyPath | 字串 | SSH 公開金鑰檔的路徑。 如果金鑰組不存在,會自動產生金鑰組。 如果不存在,公開金鑰會放在所配置使用者 ID 的 authorized_keys 檔中。 您不需要設定公開金鑰的路徑。 | |
| sudoUser | 字串 | sudo 使用者 ID。當 useSudo=false 時,不應設定這個內容。 | |
| sudoUserPassword | 可反向編碼的密碼(字串) | sudo 使用者的密碼。 當 useSudo=false 時,不應設定這個內容。 | |
| useHostCredentials | 布林 | 如果這個內容設為 true,產品會使用主機的 RPC 認證來呼叫指令,並忽略「主機鑑別資訊」元素中的其他參數。 | |
| useSudo | 布林 | 如果這個內容設為 true,就會利用 sudo 來呼叫指令。 設定 sudoUser 屬性可以控制 sudo as 的使用者。 如果沒有設定 sudoUser,sudo as 的使用者就是主機所配置的預設 sudo 使用者。 如果未設定這個內容,但設定了 sudoUser 或 sudoUserPassword,就會假設 useSudo 是 true。 如果這個內容設為 false,且設定了 sudoUser 或 sudoUserPassword,就會列印一則警告,並忽略 sudo 選項。 |
參照主題