快速安装 Baetyl

相较于之前版本的手动下载安装方式，新版本 Baetyl 支持包管理器的安装方式。通过包管理器方式，用户可以在终端简单输入几条命令，快速安装 Baetyl。

Baetyl 包管理器目前支持的系统有: Ubuntu16.04、Ubuntu18.04、Debian9.、CentOS7.、Raspbian-stretch，支持的平台有 amd64、i386、armv7l 和 arm64。

Baetyl 支持两种运行模式，分别是 docker 容器模式和 native 进程模式。本文基于 docker 容器模式进行快速安装。

安装容器运行时

在 docker 容器模式下，Baetyl 依赖于 docker 容器运行时。如果用户机器尚未安装 docker 容器运行时，可通过以下命令安装 docker 的最新版本（适用于类 Linux 系统）:

  1. curl -sSL https://get.docker.com | sh

安装结束后，用户可以查看 docker 的版本号:

  1. docker version

注意：根据 官方 Release 日志 说明，低于 18.09.2 的 Docker 版本具有一些安全隐患，建议安装/更新 Docker 版本到 18.09.2 及以上。

更多内容请参考 官方文档。

安装 Baetyl

Baetyl 发布新版本的同时，也会发布对应的 rpm、deb 包。使用以下命令，用户可通过包管理器方式将 Baetyl 安装到设备上:

  1. curl -sSL http://dl.baetyl.io/install.sh | sudo -E bash -

执行完毕后，Baetyl 将会被安装到 /usr/local 目录下。

导入示例配置包（可选）

作为一个边缘计算框架，Baetyl 通过 hub 模块提供基于 MQTT 的消息路由服务，通过 function-manager 模块和 python27、python36、nodejs85、sql 等运行时模块来提供本地函数计算服务。用户需要通过编辑配置文件，来让 baetyl 主程序加载相应的模块以及设定模块本身的运行参数。关于各个模块的配置详情，可参考 配置解读 中的内容进行进一步了解。

Baetyl 官方提供了一套示例配置，用户可通过以下命令导入示例配置文件:

  1. curl -sSL http://dl.baetyl.io/install_with_docker_example.sh | sudo -E bash -

示例配置只用于学习和测试目的，用户应根据自己的实际工作场景按需配置。

如果用户不需要启动任何模块，那就不需要导入任何配置文件。

启动 Baetyl

采用快速安装方式后，Baetyl 可以使用 Systemd 守护，用户可使用以下命令启动 Baetyl:

  1. sudo systemctl start baetyl

如果之前安装过 Baetyl 或者导入了新的配置文件，建议使用重启方式:

  1. sudo systemctl restart baetyl

停止 Baetyl:

  1. sudo systemctl stop baetyl

如果用户只需要在前台运行 Baetyl，不需要 Systemd 进行守护，可执行以下命令:

  1. sudo baetyl start

验证是否成功安装

通过包管理器的方式安装 Baetyl 以后，用户可依据以下步骤验证 Baetyl 是否启动成功：

  • 在终端中命令 sudo systemctl status baetyl 来查看 baetyl 是否正常运行。正常如下图所示，否则说明主程序 baetyl 启动失败；../_images/systemctl-status1.pngBaetyl

  • 在终端中执行命令 docker stats 查看当前 docker 中容器的运行状态。由于主程序 baetyl 会先到镜像仓库拉取需要的镜像，用户需要等待 2~5 分钟执行此条命令。以上一步中导入的示例配置为例，待主程序拉取完成后，容器的运行状态如下图所示。如果用户本地的镜像与下述不一致，说明模块启动失败；../_images/docker-stats.png当前运行 docker 容器查询

  • 针对上述两种失败情况，用户需要查看主程序日志来了解具体的错误情况。主程序日志的默认存放位置为 /usr/local/var/log/baetyl/baetyl.log。针对日志中出现的错误，用户可先参考 常见问题 进行解决。必要时可以直接 提交 Issue。