使用 Docker 编译 StarRocks

本文介绍如何使用 Docker 编译 StarRocks。

概述

StarRocks 提供 Ubuntu（22.04 和 24.04）、CentOS 7.9 和 Rocky Linux 9 的开发环境镜像。通过该镜像，您可以在 Docker 容器中编译 StarRocks。

备注

自 v4.2 起，开发环境有如下变化：

• CentOS 7 已于 2024 年 6 月 30 日停止维护（End-of-Life），其编译发行版停止支持，并由 Rocky Linux 9 取代。CentOS 7 镜像仅适用于 v4.1 及更早版本。
• Ubuntu 开发环境由 Ubuntu 22.04（v4.1 及更早版本）升级为 Ubuntu 24.04（v4.2 及更高版本）。镜像名称 starrocks/dev-env-ubuntu 保持不变。

StarRocks 版本和开发环境镜像

StarRocks 的不同版本对应 StarRocks Docker Hub 上提供的不同开发环境镜像。

• Ubuntu（v4.1 及更早版本为 22.04，v4.2 及更高版本为 24.04）:

  分支名	镜像名
  main	starrocks/dev-env-ubuntu:latest
  branch-4.1	starrocks/dev-env-ubuntu:4.1-latest
  branch-4.0	starrocks/dev-env-ubuntu:4.0-latest
  branch-3.5	starrocks/dev-env-ubuntu:3.5-latest

• CentOS 7.9（v4.1 及更早版本；自 v4.2 起停止支持）:

  分支名	镜像名
  branch-4.1	starrocks/dev-env-centos7:4.1-latest
  branch-4.0	starrocks/dev-env-centos7:4.0-latest
  branch-3.5	starrocks/dev-env-centos7:3.5-latest

• Rocky Linux 9（v4.2 及更高版本）:

  分支名	镜像名
  main	starrocks/dev-env-rocky9:latest

前提条件

在编译 StarRocks 前，请确保满足以下要求：

• 硬件

  机器必须有 8 GB 以上内存

• 软件

  • 机器必须运行 Ubuntu 22.04 或 24.04、CentOS 7.9 或 Rocky Linux 9
  • 机器必须安装 Docker, docker 版本至少为 v20.10.10

第一步：下载镜像

运行以下命令下载开发环境镜像：

# 将 <image_name> 替换为您要下载的镜像的名称，例如 `starrocks/dev-env-ubuntu:latest`。
# 请确保为您的操作系统选择正确的镜像。
docker pull <image_name>

Docker 会自动识别机器的 CPU 架构，并下载对应的镜像。 其中 linux/amd64 镜像适用于基于 x86 架构的 CPU，而 linux/arm64 镜像适用于基于 ARM 架构的 CPU。

第二步：在 Docker 容器中编译 StarRocks

您可以在启动开发环境 Docker 容器时选择是否挂载本机路径。建议您选择挂载本地主机路径，从而避免下次编译时重新下载 Java 依赖，也无需手动将容器中的二进制文件复制到本机。

• 启动 Docker 容器并挂载本机路径：

  1. 将 StarRocks 源码克隆至本机。

     git clone https://github.com/StarRocks/starrocks.git

  2. 启动容器。

     # 将 <code_dir> 替换为 StarRocks 源代码目录的上级目录。
     # 将 <branch_name> 替换为镜像名称对应的分支名称。
     # 将 <image_name> 替换为您下载的镜像的名称。
     docker run -it -v <code_dir>/.m2:/root/.m2 \
         -v <code_dir>/starrocks:/root/starrocks \
         --name <branch_name> -d <image_name>

  3. 在容器内启动 bash shell。

     # 将 <branch_name> 替换为镜像名称对应的分支名称。
     docker exec -it <branch_name> /bin/bash

  4. 在容器内编译 StarRocks。

     cd /root/starrocks && ./build.sh

• 启动 Docker 容器，不挂载本机路径：

  1. 启动容器

     # 将 <branch_name> 替换为镜像名称对应的分支名称。
     # 将 <image_name> 替换为您下载的镜像的名称。
     docker run -it --name <branch_name> -d <image_name>

  2. 在容器内启动 bash shell。

     # 将 <branch_name> 替换为镜像名称对应的分支名称。
     docker exec -it <branch_name> /bin/bash

  3. 将 StarRocks 源码克隆至容器。

     git clone https://github.com/StarRocks/starrocks.git

  4. 在容器内编译 StarRocks。

     cd starrocks && ./build.sh

故障排除

Q：StarRocks BE 编译失败，返回如下错误信息：

g++: fatal error: Killed signal terminated program cc1plus
compilation terminated.

我该如何处理？

A：此错误消息表示 Docker 容器内存不足。您需要为容器分配至少 8 GB 的内存资源。