**************
多环境编译打包
**************

1. **准备工作**

  - **maven 安装，修改配置 settings.xml**

    - 修改镜像源

    .. code-block:: xml

      <!-- 推荐使用阿里云镜像库 -->
      <mirror>
          <id>alimaven</id>
              <name>aliyun maven</name>
              <url>
                  http://maven.aliyun.com/nexus/content/groups/public/
              </url>
          <mirrorOf>central</mirrorOf>
      </mirror>

    - 如果有 Proxy，推荐配置一下 Proxy，maven 打包前端时会去 github 下载 node-sass

    .. code-block:: xml

      <proxy>
          <id>optional</id>
          <active>true</active>
          <protocol>http</protocol>
          <host>127.0.0.1</host> <!-- 根据实际情况自行配置，推荐 V2ray -->
          <port>10809</port>
      </proxy>

    环境变量自行修改，mvn -version 最低 3.5

  - **Jdk8 安装**

    推荐阿里的 Alibaba Dragonwell8 JDK ，下载地址：``https://github.com/alibaba/dragonwell8/releases`` , 环境变量自行配置。

  .. note::

      推荐使用 Ubuntu Server 18.04 LTS 以上版本作为测试、生产环境，Ubuntu 编译前一定要安装一下 Python2，前端 node-sass 打包要用到，``sudo apt install python``

2. **拉取代码编译**

  - **clone**

  .. code-block:: bash

    1. git clone https://github.com/zmops/zeus-iot.git

    2. cd zeus-iot && git submodule update --init --recursive #确保子模块都拉取成功

  - **package**

  .. code-block:: bash

    1. mvn clean package -U -Dmaven.test.skip=true #依赖的库比较多，其次IoT Server 和 Webapp 是一起打包的，前端也编译，所以时间比较长

  - **编译成功效果**

  .. image:: /_static/images/mvn_package.png
        :width: 400

  编译成功后，会在 dist 目录生成一个 ``完整的 tar 包`` ，包括所有的 lib 和 启动脚本，外置的配置文件。

  - **tar包结构**

  .. image:: /_static/images/package.png

.. note::

    - 此处并未包含 数据库、初始化脚本以及Zabbix 的安装步骤，具体参考\ :ref:`安装 Zabbix 服务 <install_zabbix>`\ 和\ :ref:`安装 Zeus-IoT <install_zeus>`\ 。

    - 启动脚本执行前，不要忘记修改配置文件，具体的参考\ :ref:`服务启动配置 <initial_config>`\ 。