通过

你当前正在访问 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 安装程序文件

作为 CycleCloud 安装包的一部分，可以获取 CLI 安装程序。 在 UI 的右上角选择 “？ ”以访问 关于 页面。 使用 “下载 CLI 工具 ”按钮在浏览器中下载安装程序。

下载 CLI 安装程序

还可以使用以下命令直接从命令行下载安装程序。 如果 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 show_cluster 以测试 CycleCloud CLI 是否正常工作。

延伸阅读