ZStack AIOS

环境准备

面向开发者的 API 使用规范、SDK 调用方式和 AIOS 相关接口说明。

使用Java SDK 或Python SDK前，需准备以下软件工具：

Java

Java开发工具（Intellij IDEA）
根据自己使用习惯，下载并安装合适的Java开发工具，并完成初始化工作。例如：Intellij IDEA、Eclipse等，本文以Intellij IDEA为例进行介绍。
Java JDK工具
提前安装Java JDK工具，推荐使用Java 8版本Java JDK工具。
ZStack AIOS Java SDK依赖jar包
使用ZStack AIOS SDK前，需要提前获取Java SDK jar文件，该文件存放在ZStack AIOS安装包中：
- ZStack AIOS安装包：
  - 软件名称：ZStack-Cloud-installer-5.5.22.bin
  - 下载地址：请联系官方技术支持
- Java SDK依赖包
  - 文件名称：sdk-5.5.22.jar
  - 存放路径：/usr/local/zstack/apache-tomcat/webapps/zstack/WEB-INF/lib/sdk-5.5.22.jar

SDK依赖的第三方jar：

依赖jar包内容详情如下：

<dependencies>
    <dependency>
        <groupId>org.zstack</groupId>
        <artifactId>sdk</artifactId>
        <version>3.4.0</version>
    </dependency>
    <dependency>
        <groupId>com.squareup.okhttp3</groupId>
        <artifactId>okhttp</artifactId>
        <version>3.5.0</version>
    </dependency>
    <dependency>
        <groupId>com.google.code.gson</groupId>
        <artifactId>gson</artifactId>
        <version>2.1</version>
    </dependency>
    <dependency>
        <groupId>commons-beanutils</groupId>
        <artifactId>commons-beanutils</artifactId>
        <version>1.9.3</version>
    </dependency>
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>servlet-api</artifactId>
        <version>2.5</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>commons-codec</groupId>
        <artifactId>commons-codec</artifactId>
        <version>1.9</version>
    </dependency>
</dependencies>

Python

准备ZStack AIOS环境，支持以下两种方式：
- 直接安装ZStack AIOS环境至待用作管理节点的主机。
  - ZStack AIOS安装包：
    - 软件名称：ZStack-Cloud-installer-5.5.22.bin
    - 下载地址：请联系官方技术支持
- 使用本机新建一个虚拟临时环境目录，例如/var/lib/virtualenv，并执行以下命令拷贝已有ZStack AIOS环境目录 /var/lib/zstack/virtualenv/zstackcli 到本机新建的虚拟临时环境目录下：
```
scp -r /var/lib/zstack/virtualenv/zstackcli $LocalHostIP:$VirtualDirectory //LocalHostIP为本机IP地址，VirtualDirectory为虚拟临时环境目录
```
  说明：请确保本机与管理节点网络互通，且已安装Python2环境。
启用ZStack-CloudCLI命令行工具，以调用Python SDK。
- 若使用管理节点，执行以下命令启用：
```
source /var/lib/zstack/virtualenv/zstackcli/bin/activate
```
- 若使用本机，执行以下命令启用：
```
source $VirtualDirectory/zstackcli/bin/activate //VirtualDirectory为虚拟临时环境目录
```
执行以下命令指定管理节点IP地址：
- 若使用管理节点，执行以下命令指定：
```
export ZS_SERVER_IP=127.0.0.1
```
- 若使用本机，执行以下命令指定：
```
export ZS_SERVER_IP=MN_IP //MN_IP为管理节点IP地址
```