京东云CLI提供使用命令行的方式访问您的云中资源。
京东云CLI基于Python语言和京东云Python SDK开发，使用CLI前请安装Python 2.7/3.x版本和pip包管理工具。请访问官网下载并安装Python和pip。
https://www.python.org/downloads
- CentOS
yum install python - Ubuntu
apt-get install python2.7 - macOS
brew install python@2
https://www.python.org/downloads
- CentOS
yum install python36u - Ubuntu
apt-get install python3.5 - macOS
brew install python@3
-
官网安装请参考：https://pip.pypa.io/
具体命令为
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py python get-pip.py -
使用各发行版包管理工具安装pip，请参考安装方法
京东云Python SDK不用手动安装，Python包管理工具会自动下载并安装对应版本的依赖包。如果您已经安装了京东云Python SDK，并且因为CLI版本与之不对应而不能正常工作，请参考下面的版本对应表，安装对应版本SDK或删除旧的Python SDK并重新安装CLI。
| 发布日期 | 京东云CLI | 京东云Python SDK |
|---|---|---|
| 2018.06.04 | 0.1.0 | 1.1.1 |
| 2018.06.23 | 0.2.0 | 1.1.1 |
| 2018.06.25 | 0.2.1 | 1.1.2 |
| 2018.07.19 | 0.3.0 | 1.2.0 |
| 2018.07.26 | 0.4.0 | 1.2.4 |
| 2018.08.06 | 0.5.2 | 1.2.10 |
| 2018.08.31 | 0.6.0 | 1.2.12 |
| 2018.09.06 | 0.7.0 | 1.2.13 |
| 2018.10.10 | 0.7.1 | 1.2.16 |
| 2018.11.21 | 0.7.2 | 1.2.18 |
| 2018.12.28 | 0.8.2 | 1.3.0 |
| 2019.01.02 | 0.9.0 | 1.3.0 |
| 2019.01.24 | 1.0.3 | 1.4.0 |
| 2019.04.28 | 1.1.0 | 1.5.9 |
pip安装：
pip install -U jdcloud_cli
源码安装（不依赖pip）：
python setup.py install
python3 setup.py install
安装后执行以下脚本，打开自动完成功能：
echo 'eval "$(register-python-argcomplete jdc)"' >> .bashrc
echo 'export COLUMNS=100' >> .bashrc
source ~/.bashrc
京东云CLI在Windows上运行依赖Git 2.9.0以上版本，建议使用最新版本。
下载地址为：https://git-scm.com/download/win
请注意：安装时模拟终端选项要选择“Use MinTTY (the default terminal of MSYS2)”。
pip安装：
pip install -U jdcloud_cli
源码安装（不依赖pip）：
python setup.py install
安装后在git bash中执行以下脚本，打开自动完成功能：
curl https://raw.githubusercontent.com/jdcloud-api/jdcloud-cli/master/jdcloud_cli/resources/jdc.rc > ~/jdc.rc
echo 'source ~/jdc.rc' >> ~/.bashrc
echo 'export PYTHONIOENCODING="UTF-8"' >> ~/.bashrc
source ~/.bashrc
jdc configure add --access-key your-ak --secret-key your-sk
说明：access-key和secret-key可以从京东云控制台申请开通。默认为华北区域。
jdc [options] command sub-command [--parameters values]
例如：
jdc vm describe-instances
目前支持Linux、Mac、Windows三种平台的Bash中的自动完成功能，输入两次tab键，可提示辅助信息。 创建资源时，json串的获取可以使用各产品线子命令下的 generate-skeleton 获取，如：
jdc vm generate-skeleton --api create-instances
如果需要设置额外的header，例如要调用开启了MFA操作保护的接口，需要传递x-jdcloud-security-token，则按照如下方式：
jdc nc delete-container --headers '{"x-jdcloud-security-token":"xxx"}' --container-id xxxxx
更多帮助信息及OpenAPI官方文档，请见： https://docs.jdcloud.com/cn/common-declaration/api/introduction
Windows平台中，容器交互命令为exprimental阶段。在命令前需要增加winpty前缀，如：
winpty jdc nc attach --container-id c-abcdefg
建议使用Linux 或 Mac平台。