transitive 的安装和配置教程

项目基础介绍

transitive 是一个全栈机器人框架，由 Transitive Robotics 开发。该框架旨在简化机器人开发流程，支持实时数据同步、透明且高效的数据共享、全栈包管理等功能。它特别为与机器人操作系统（ROS）配合使用而设计，但也同样适用于不使用 ROS 的场景。

该项目主要使用的编程语言是 JavaScript，同时使用了 Shell 脚本、C++、CSS、Dockerfile 等技术。

项目使用的关键技术和框架

• MQTTSync：实现机器人、云和 UI 之间的实时数据同步。
• Web Components：用于 UI 组件的抽象，易于嵌入其他 Web 应用程序或框架如 React、Angular。
• Docker：容器化技术，用于简化部署和运行环境的一致性。
• 全栈包管理：提供封装并允许与第三方共享的包（"capabilities"）的概念。

安装和配置准备工作

在开始安装 transitive 之前，请确保您的系统已安装以下软件：

• Docker
• Git

确保您的系统环境满足以上要求后，可以继续以下安装步骤。

安装步骤

1. 克隆项目仓库

   打开终端，使用以下命令克隆项目仓库到本地：

   git clone https://github.com/transitiverobotics/transitive.git
   

2. 配置环境变量

   进入项目目录，复制 sample.env 文件为 .env 并根据您的实际情况编辑环境变量：

   cd transitive
   cp sample.env .env
   

   使用文本编辑器打开 .env 文件，根据注释和您的需求配置变量。

3. 启动开发环境

   在 cloud/ 目录下，运行以下命令以启动所有服务：

   ./dev.sh
   

   在开发模式下，系统会启动一个本地的 mDNS 服务来处理子域名解析。

4. 访问管理界面

   在浏览器中输入 http://portal.localhost，您应该能够看到管理界面。

5. 生产环境部署

   若要部署到生产环境，请在项目目录中执行以下命令：

   docker-compose build && docker-compose up -d
   

   确保您的 DNS 记录中添加了所有必要的子域名，如 portal.YOUR-DOMAIN.NAME，然后通过浏览器访问该域名。

6. 添加机器人

   从管理界面添加机器人，执行页面中显示的 curl 命令来完成机器人的注册。

按照以上步骤操作，您应该能够成功安装和配置 transitive。如果在安装过程中遇到任何问题，请查阅项目的官方文档或加入社区获取帮助。