doc: add docs to repo

docs/Installation.md

@@ -0,0 +1,127 @@
+## 运行环境
+
+HttpRunner 是一个基于 Python 开发的测试框架，可以运行在 macOS、Linux、Windows 系统平台上。
+
+**Python 版本**：HttpRunner 支持 Python 3.4 及以上的所有版本，并使用 Travis-CI 进行了[持续集成测试][travis-ci]，测试覆盖的版本包括 2.7/3.4/3.5/3.6/3.7。虽然 HttpRunner 暂时保留了对 Python 2.7 的兼容支持，但强烈建议使用 Python 3.4 及以上版本。
+
+**操作系统**：推荐使用 macOS/Linux。
+
+## 安装方式
+
+HttpRunner 的稳定版本托管在 PyPI 上，可以使用 `pip` 进行安装。
+
+```bash
+$ pip install httprunner
+```
+
+如果你需要使用最新的开发版本，那么可以采用项目的 GitHub 仓库地址进行安装：
+
+```bash
+$ pip install git+https://github.com/HttpRunner/HttpRunner.git@master
+```
+
+## 版本升级
+
+假如你之前已经安装过了 HttpRunner，现在需要升级到最新版本，那么你可以使用`-U`参数。该参数对以上三种安装方式均生效。
+
+```bash
+$ pip install -U HttpRunner
+$ pip install -U git+https://github.com/HttpRunner/HttpRunner.git@master
+```
+
+## 安装校验
+
+在 HttpRunner 安装成功后，系统中会新增如下 5 个命令：
+
+- `httprunner`: 核心命令
+- `ate`: 曾经用过的命令（当时框架名称为 ApiTestEngine），功能与 httprunner 完全相同
+- `hrun`: httprunner 的缩写，功能与 httprunner 完全相同
+- `locusts`: 基于 [Locust][Locust] 实现[性能测试](run-tests/load-test.md)
+- [`har2case`][har2case]: 辅助工具，可将标准通用的 HAR 格式（HTTP Archive）转换为`YAML/JSON`格式的测试用例
+
+httprunner、hrun、ate 三个命令完全等价，功能特性完全相同，个人推荐使用`hrun`命令。
+
+运行如下命令，若正常显示版本号，则说明 HttpRunner 安装成功。
+
+```text
+$ hrun -V
+2.0.2
+
+$ har2case -V
+0.2.0
+```
+
+## 开发者模式
+
+默认情况下，安装 HttpRunner 的时候只会安装运行 HttpRunner 的必要依赖库。
+
+如果你不仅仅是使用 HttpRunner，还需要对 HttpRunner 进行开发调试（debug），那么就需要进行如下操作。
+
+HttpRunner 使用 [pipenv][pipenv] 对依赖包进行管理，若你还没有安装 pipenv，需要先执行如下命令进行按照：
+
+```bash
+$ pip install pipenv
+```
+
+获取 HttpRunner 源码：
+
+```bash
+$ git clone https://github.com/HttpRunner/HttpRunner.git
+```
+
+进入仓库目录，安装所有依赖：
+
+```bash
+$ pipenv install --dev
+```
+
+运行单元测试，若测试全部通过，则说明环境正常。
+
+```bash
+$ pipenv run python -m unittest discover
+```
+
+查看 HttpRunner 的依赖情况：
+
+```text
+$ pipenv graph
+
+HttpRunner==2.0.0
+  - colorama [required: Any, installed: 0.4.0]
+  - colorlog [required: Any, installed: 3.1.4]
+  - har2case [required: Any, installed: 0.2.0]
+    - PyYAML [required: Any, installed: 3.13]
+  - Jinja2 [required: Any, installed: 2.10]
+    - MarkupSafe [required: >=0.23, installed: 1.0]
+  - PyYAML [required: Any, installed: 3.13]
+  - requests [required: Any, installed: 2.20.0]
+    - certifi [required: >=2017.4.17, installed: 2018.10.15]
+    - chardet [required: >=3.0.2,<3.1.0, installed: 3.0.4]
+    - idna [required: >=2.5,<2.8, installed: 2.7]
+    - urllib3 [required: >=1.21.1,<1.25, installed: 1.24]
+  - requests-toolbelt [required: Any, installed: 0.8.0]
+    - requests [required: >=2.0.1,<3.0.0, installed: 2.20.0]
+      - certifi [required: >=2017.4.17, installed: 2018.10.15]
+      - chardet [required: >=3.0.2,<3.1.0, installed: 3.0.4]
+      - idna [required: >=2.5,<2.8, installed: 2.7]
+      - urllib3 [required: >=1.21.1,<1.25, installed: 1.24]
+```
+
+调试运行方式：
+
+```bash
+# 调试运行 hrun
+$ pipenv run python main-debug.py hrun -h
+
+# 调试运行 locusts
+$ pipenv run python main-debug.py locusts -h
+```
+
+## Docker
+
+TODO
+
+[travis-ci]: https://travis-ci.org/HttpRunner/HttpRunner
+[Locust]: http://locust.io/
+[har2case]: https://github.com/HttpRunner/har2case
+[pipenv]: https://docs.pipenv.org/