安裝 CycleCloud CLI

  • 發行項

Azure CycleCloud 命令列介面 (CLI) 提供 CycleCloud 應用程式的主控台存取權，讓可從命令列取得的 GUI 中看到函式。 它可以用來直接或透過腳本控制 CycleCloud 和 CycleCloud 叢集。

必要條件

CycleCloud CLI 需要現有的 Python 3.6 或更新版本安裝。 雖然大部分的 Linux 和 Mac 系統已經有有效的 Python 3 安裝，但您必須 安裝適用于 Windows 的 Python。

CycleCloud CLI 安裝程式檔案

CLI 安裝程式會散發為 CycleCloud 安裝套件的一部分。 按一下 UI 右上角的 ？ 以存取 關於 頁面。 使用 [ 下載 CLI 工具 ] 按鈕來執行瀏覽器內下載。

Download CLI installer

或者，您也可以使用此命令直接從命令列下載。 如果 CycleCloud 實例沒有符合其主機名稱的憑證，則可能需要將 --no-check-certificate 旗標新增至下列 wget 命令。

wget https://<your CycleCloud domain name>/static/tools/cyclecloud-cli.zip

適用于 Linux 的 CycleCloud CLI 安裝

將 cyclecloud-cli.zip 的內容解壓縮到臨時目錄：

cd /tmp
unzip /opt/cycle_server/tools/cyclecloud-cli.zip

這會建立名為 cyclecloud-cli-installer的子目錄。 若要完成安裝，請在 目錄中執行 install.sh 腳本：

cd /tmp/cyclecloud-cli-installer
./install.sh

CycleCloud CLI 將會安裝至 ${HOME}/bin。 或者，在安裝 CLI 之後，請將 ${HOME}/bin 目錄新增至設定檔中的 PATH 環境變數。

if [[ -d ${HOME}/bin ]]; then
  export PATH=${HOME}/bin:$PATH
fi

適用于 Windows 的 CycleCloud CLI 安裝

在 Windows 檔案總管中，將 CLI 安裝程式 zip 檔案複製到臨時目錄，例如 下載 或 $env：TMP。 以滑鼠右鍵按一下 cyclecloud-cli.zip 複本，然後選取 [ 全部擷取]。 這會建立名為 的 cyclecloud-cli-installer-<VERSION> 子資料夾。

在 cyclecloud-cli-installer-<VERSION> 子資料夾中，您會發現名為 install.ps1的 PowerShell 腳本。 按兩下 install.ps1 腳本以完成 CLI 安裝。

CycleCloud CLI 現在應該可在新的 PowerShell 或命令提示字元會話的系統 PATH 中使用。

初始化 CycleCloud CLI

安裝 CLI 之後，您必須將其連線到 Azure CycleCloud 伺服器。 Azure CycleCloud CLI 會使用 REST API 與伺服器通訊，而且必須使用您的 Azure CycleCloud 伺服器 URL 初始化：

  1. 使用 cyclecloud initialize 初始化伺服器。 系統會提示您輸入 CycleServer URL，這是應用程式伺服器的 FQDN。 以 格式 https://FQDN 輸入它。
  2. 已安裝的 Azure CycleCloud 伺服器會使用 Let's Encrypt SSL 憑證或自我簽署憑證。 當系統要求允許憑證時輸入 yes 。
  3. 使用 CycleCloud Web 介面所使用的相同使用者名稱和密碼登入。
  4. 測試 CycleCloud CLI 是否使用 cyclecloud show_cluster 。

深入閱讀