安装 Watcher 的方法

本文档描述了一些安装 Watcher 的方法以便使用它。如果您打算在 Watcher 上或使用 Watcher 进行开发,请阅读 手动设置开发环境

先决条件

源安装说明特意避免使用平台特定的软件包,而是使用代码的源文件和 Python 包索引 (PyPi)。

预计您的系统已经安装了 python2.7、最新版本的 pipgit

您的系统还需要一些额外的系统库

在 Ubuntu 上(在 16.04LTS 上测试过)

$ sudo apt-get install python-dev libssl-dev libmysqlclient-dev libffi-dev

在基于 Fedora 的发行版上,例如 Fedora/RHEL/CentOS/Scientific Linux(在 CentOS 7.1 上测试过)

$ sudo yum install gcc python-devel openssl-devel libffi-devel mysql-devel

从源代码安装

克隆 Watcher 仓库

$ git clone https://opendev.org/openstack/watcher.git
$ cd watcher

安装 Watcher 模块

# python setup.py install

以下命令应在命令行路径上可用

  • watcher-api 用于处理 RESTful 请求的 Watcher Web 服务

  • watcher-decision-engine 用于构建行动计划的 Watcher 决策引擎,以实现优化目标。

  • watcher-applier 用于应用行动计划的 Watcher Applier 模块

  • watcher-db-manage 用于引导 Watcher 数据

您可以在 etc/watcher 中找到示例配置文件

  • watcher.conf.sample

安装 Watcher 模块依赖项

# pip install -r requirements.txt

从这里,请参考 配置 Watcher,将 Watcher 声明为 Keystone 中的新服务并配置其不同的模块。配置完成后,您可以通过发出以下命令来运行 Watcher 服务

$ watcher-api
$ watcher-decision-engine
$ watcher-applier

默认情况下,这将从启动它的控制台显示日志。启动后,您可以使用 Watcher Client 与 Watcher 服务进行交互。

从软件包安装:PyPI

Watcher 软件包在 PyPI 仓库中可用。要在您的系统上安装 Watcher

$ sudo pip install python-watcher

Watcher 服务及其依赖项应自动安装在您的系统上。

安装完成后,您仍然需要将 Watcher 声明为 Keystone 中的新服务并配置其不同的模块,您可以在 配置 Watcher 中找到相关说明。

从软件包安装:Debian(实验版)

实验性的 Debian 软件包在 Debian 仓库 中可用。使用它们最好的方法是将它们安装到 Docker 容器中。

以下是您可以用来运行 Docker 容器的 Dockerfile 片段

FROM debian:experimental
MAINTAINER David TARDIVEL <david.tardivel@b-com.com>

RUN  apt-get update
RUN  apt-get dist-upgrade
RUN  apt-get install vim  net-tools
RUN  apt-get install experimental watcher-api

CMD ["/usr/bin/watcher-api"]

使用此 Dockerfile 构建您的容器

$ docker build -t watcher/api .

要运行您的容器,请执行此命令

$ docker run -d -p 9322:9322 watcher/api

在您的日志中检查 Watcher API 是否已启动

$ docker logs <container ID>

您可以运行类似的容器,其中包含 Watcher 决策引擎(软件包 watcher-decision-engine)和 Watcher Applier(软件包 watcher-applier)。