bitteam/bit-docker

Bit-docker

此仓库仅用于legacy（非Harmony）范围。Harmony范围请使用 https://github.com/teambit/bit/blob/master/scripts/docker-teambit-bit/README.md

用于运行私有https://www.github.com/teambit/bit%E6%9C%8D%E5%8A%A1%E5%99%A8%E7%9A%84Dockerfile%E9%85%8D%E7%BD%AE%E3%80%82
如果无需Docker搭建基础Bit远程服务器，请参考此指南。

核心功能与特性

• 提供Docker容器化的Bit服务器部署方案
• 支持通过SSH协议进行组件的导入与导出
• 支持挂载本地SSH密钥实现身份验证
• 轻量级部署，快速搭建私有组件仓库

使用场景与适用范围

适用于需要搭建私有Bit组件服务器的团队或个人，用于管理分布式代码组件，支持多语言环境，实现组件的版本控制、共享与复用。

快速开始

1. 克隆仓库

sh
git clone https://github.com/teambit/bit-docker.git
cd bit-docker

2. 构建镜像并运行服务器

sh
# 构建镜像
docker build . -t bit

# 运行容器（映射SSH端口，挂载SSH公钥）
docker run --rm --name bit -d -P --volume ~/.ssh/id_rsa.pub:/tmp/id_rsa.pub docker.xuanyuan.run/bitcli/bit-docker

# 查看映射的SSH端口
docker port bit 22

3. 配置工作区连接服务器

sh
bit remote add ssh://root@<服务器主机名>:<映射端口>:/tmp/scope -g

4. 导出组件到服务器

sh
bit export scope

5. 从服务器导入组件

sh
bit import scope.<组件名称>

6. 停止服务器

sh
docker kill bit

故障排除

无法连接到服务器

• 检查容器是否运行：

  sh
  docker ps --all | grep bit
  

• 确认SSH端口配置正确：

  sh
  docker port bit 22
  

• 验证工作区服务器配置：

  sh
  bit remote
  

无法导入/导出组件

Bit使用SSH进行网络通信，此配置会https://github.com/teambit/bit-docker/blob/master/Dockerfile#L24%E3%80%82%E5%A6%82%E9%9C%80%E6%89%8B%E5%8A%A8%E9%85%8D%E7%BD%AE%E8%AE%A4%E8%AF%81%E6%88%96%E6%B7%BB%E5%8A%A0%E5%85%B6%E4%BB%96%E5%AF%86%E9%92%A5%EF%BC%9A

1. 复制公钥到容器：

   sh
   docker cp ~/.ssh/id_rsa bit:/root/.ssh/
   

2. 进入容器bash：

   sh
   docker exec -it bit /bin/bash
   

3. 配置容器SSH守护进程（在容器内执行）：

   sh
   bit config ssh_key_file /root/.ssh/id_rsa
   

在容器中运行bash

需要在Bit服务器执行命令时，先进入容器bash：

sh
docker exec -it bit /bin/bash

此后执行的命令将直接在服务器容器内运行。

查看服务器日志

需先进入容器bash，然后执行：

sh
tail -f /root/Library/Caches/Bit/logs/debug.log

维护者指南 - 从本地构建运行服务器

从源代码构建Bit后，使用以下命令运行：

sh
docker run --rm --name bit -d -P \
  --volume <bit源代码克隆路径>:/bit-bin \
  --volume ~/.ssh/id_rsa.pub:/tmp/id_rsa.pub \
  --env 'DEVELOPMENT=true' \
  docker.xuanyuan.run/bitcli/bit-docker

贡献

始终欢迎任何大小的贡献。

许可证

MIT许可证。