大网数据广告活动
数据库部署与 SQL 参考

准备部署文件

· 52CE 我爱测

目前 镜舟官网提供的 StarRocks 软件包仅支持在 x86 架构的 CPU 上部署。如需在 ARM 架构 CPU 上部署 StarRocks,您需要通过 StarRocks Docker 镜像获取部署文件。

准备部署文件

本文介绍如何准备 StarRocks 部署文件。

目前 镜舟官网提供的 StarRocks 软件包仅支持在 x86 架构的 CPU 上部署。如需在 ARM 架构 CPU 上部署 StarRocks,您需要通过 StarRocks Docker 镜像获取部署文件。

为 x86 架构 CPU 准备部署文件

自 v3.1.14、v3.2.10 和 v3.3.3 版本起,StarRocks 的二进制包的名称格式为 StarRocks-{Version}-{OS}-{ARCH}.tar.gz,其中 Version 表示版本号(例如 3.3.3),OS 表示操作系统(包括 centos 和 ubuntu),ARCH 表示 CPU 架构(目前仅支持 amd64,相当于 x86_64)。请确保您选择了正确版本的发行包。

在 v3.1.14、v3.2.10 和 v3.3.3 版本之前,StarRocks 二进制包的名称格式为 StarRocks-version.tar.gz。

步骤

  1. 您可选择从 下载 StarRocks 页面直接下载 StarRocks 二进制包,或在终端中运行以下命令获取:

    # 将 <version> 替换为您想要下载的 StarRocks 版本,例如 3.3.3,
    # 并将 <OS> 替换为 centos 或 ubuntu。
    wget https://releases.starrocks.io/starrocks/StarRocks-<version>-<OS>-amd64.tar.gz
    
  2. 解压二进制包。

    # 将 <version> 替换为您想要下载的 StarRocks 版本,例如 3.3.3,
    # 并将 <OS> 替换为 centos 或 ubuntu。
    tar -xzvf StarRocks-<version>-<OS>-amd64.tar.gz
    

    二进制包中包含以下路径及文件:

    路径/文件 说明
    apache_hdfs_broker Broker 节点的部署路径。
    fe FE 节点的部署路径。
    be BE 节点的部署路径。
    LICENSE.txt StarRocks license 文件。
    NOTICE.txt StarRocks notice 文件。
  3. 将路径 fe 分发至所有 FE 实例,将路径 be 分发至所有 BE 或 CN 实例以用于手动部署。

为 ARM 架构 CPU 准备部署文件

前提条件

您需要在计算机上安装 Docker Engine (17.06.0 以上)。

步骤

从 v3.1.14、v3.2.10 和 v3.3.3 版本开始,StarRocks 提供的 Docker 镜像命名格式为 starrocks/artifacts-{OS}:{Version},其中 OS 表示操作系统(ubuntu、centos7 或 rocky9),Version 表示版本号(例如 3.3.3)。Docker 将自动识别您的 CPU 架构并拉取相应的镜像。请确保您选择了正确版本的镜像。

在 v3.1.14、v3.2.10 和 v3.3.3 版本之前,StarRocks 提供的 Docker 镜像位于 starrocks/artifacts-ubuntu 和 starrocks/artifacts-centos7 仓库中。

自 v4.2 起,CentOS 7 编译发行版停止支持,并由 Rocky Linux 9 取代。v4.2 及更高版本请使用 starrocks/artifacts-rocky9;starrocks/artifacts-centos7 仅适用于 v4.1 及更早版本。

  1. 从 StarRocks Docker Hub 下载 StarRocks Docker 镜像。 您可以根据 Tag 选择特定版本的镜像。

    # 将 <OS> 替换为 ubuntu、centos7(v4.1 及更早版本)或 rocky9(v4.2 及更高版本),
    # 并将 <version> 替换为您想要下载的 StarRocks 版本,例如 3.3.3。
    # 例如 docker pull starrocks/artifacts-centos7:3.3.3 或 docker pull starrocks/artifacts-ubuntu:3.3.3
    docker pull starrocks/artifacts-<OS>:<version>
    
  2. 运行以下命令将 StarRocks 部署文件从 Docker 镜像复制到您的主机:

    # 将 <OS> 替换为 ubuntu、centos7(v4.1 及更早版本)或 rocky9(v4.2 及更高版本),
    # 并将 <version> 替换为您想要下载的 StarRocks 版本,例如 3.3.3。
    docker run --rm starrocks/artifacts-<OS>:<version> \
        tar -cf - -C /release . | tar -xvf -
    
  3. 将部署文件分发至所有实例以用于手动部署。

本文来自 StarRocks 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
StarRocks 文档贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。