你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

安装 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 的副本,然后选择“ 全部提取”。 This will create a sub-folder named cyclecloud-cli-installer-<VERSION>.

cyclecloud-cli-installer-<VERSION> 子文件夹中,你将找到一个名为 install.ps1的 PowerShell 脚本。 双击 install.ps1 脚本以完成 CLI 安装。

CycleCloud CLI 现在应该在系统 PATH 中为新的 PowerShell 或命令提示符会话提供。

初始化 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

深入阅读