BAETYL 0.1.6 Documentation

• 语言: 英语
• 格式: .epub
• 来源: baetyl.readthedocs.io

摘要

文档详细介绍了Baetyl项目的安装、构建、配置和使用方法。内容涵盖环境配置、源代码编译、服务部署、日志管理以及系统更新等方面。文档还提供了多个官方模块的配置示例，包括云代理服务、消息路由服务、远程MQTT桥接服务、函数管理服务等，并详细说明了如何配置和管理这些服务。

AI总结

# BAETYL 0.1.6 文档总结

## 1. 概述
- **Baetyl** 是一个用于扩展云计算能力到边缘设备的平台。
- 提供无缝连接云端与边缘设备的能力，支持模块化设计和功能扩展。

## 2. 安装
### 快速安装
- **依赖**：安装 Docker（推荐版本 18.09.2 及以上）。
- **命令**：

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

- **启动**：

  start Baetyl

### 从源代码构建
- **环境配置**：
- 安装 Go（版本 1.10.0 及以上）：

    tar -C /usr/local -zxf go$VERSION.$OS-$ARCH.tar.gz
    export PATH=$PATH:/usr/local/go/bin
    export GOPATH=yourpath

- 安装 Docker（如未安装）。
- **编译源代码**：
- 环境配置完成后，进行源代码编译。

## 3. 配置
### Master 配置
- **默认配置文件**：`etc/baetyl/conf.yml`
- **参数说明**：
- `mode`：默认为 `docker`，支持 `docker` 和 `native` 模式。
- `grace`：默认 `30s`，服务优雅退出超时时间。
- `server`：API 服务配置，包含地址和超时设置。
- `logger`：日志配置，支持文本和 JSON 格式，包含日志路径、级别、文件大小和保留数量。

### 应用配置
- **默认配置文件**：`var/db/baetyl/application.yml`
- **示例**：

  version: v0
  services:
    - name: localhub
      image: hub.baidubce.com/baetyl/baetyl-hub
      replica: 1
      ports:
        - 1883:1883
      mounts:
        - name: localhub-conf path: etc/baetyl readonly: true

## 4. 核心模块
- **官方模块**：
- `baetyl-agent`：提供云端状态报告和应用 OTA 更新。
- `baetyl-hub`：基于 MQTT 的消息路由服务。
- `baetyl-remote-mqtt`：用于 Hub 和远程 MQTT 服务的消息同步。
- `baetyl-function-manager`：管理函数实例和服务调用。
- `baetyl-function-python27`、`baetyl-function-python36`、`baetyl-function-node85`：支持 Python 2.7、Python 3.6 和 Node.js 8.5 的函数运行时。

## 5. 工作流程
- **连接测试**：通过 Hub 服务实现设备间的消息传输。
- **消息路由**：使用 MQTT 协议进行消息分发和处理。
- **函数服务**：支持基于函数名称的调用和消息触发。
- **同步功能**：通过 `baetyl-remote-mqtt` 模块实现 Hub 与远程 MQTT 服务的消息同步。

## 6. 开发指南
- 支持 Python 和 Node.js 脚本开发，提供函数名称和参数规范。
- **第三方库导入**：
- Python：支持 `requests` 和 `PyTorch`。
- Node.js：支持 `Lodash`。

## 7. 系统更新
- 提供应用和服务二进制文件的更新功能（OTA）。
- 更新流程：
1. 订阅更新主题。
2. 比较配置文件，若有变更则重启服务。

## 8. 配置示例
- **应用配置示例**：

  version: v0
  services:
    - name: function-sayhi3
      image: hub.baidubce.com/baetyl/baetyl-function-python36
      replica: 0
      mounts:
        - name: function-sayhi-conf path: etc/baetyl readonly: true

## 9. 总结
Baetyl 提供了从边缘设备到云端的一站式解决方案，支持多种运行时环境和模块化扩展，适用于 IoT 和边缘计算场景。通过灵活的配置和丰富的功能，用户可以快速搭建和管理边缘计算环境。