Docker

Apache Ozone 可以通过 Docker Compose 快速部署，非常适合用于开发、测试和评估场景。本指南将带你使用预构建的 Docker 镜像搭建一个多节点 Ozone 集群。

快速开始

前置条件

Docker Engine - 最新稳定版本
Docker Compose - 最新稳定版本

运行 Ozone

获取 Docker Compose 配置

首先，获取 Ozone 的示例 Docker Compose 配置：




curl -O https://raw.githubusercontent.com/apache/ozone-docker/refs/heads/latest/docker-compose.yaml

启动集群

使用以下命令启动包含三个 Datanode 的 Ozone 集群：


docker compose up -d --scale datanode=3

此命令将：

自动从 Docker Hub 拉取所需的镜像
创建一个包含 Ozone 核心服务的多节点集群
以分离模式启动所有组件

验证部署

检查 Ozone 集群各组件的状态：
```
docker compose ps
```

你应该看到类似如下的输出：


NAME                IMAGE                      COMMAND                  SERVICE    CREATED          STATUS          PORTS

docker-datanode-1   apache/ozone:1.4.1-rocky   "/usr/local/bin/dumb…"   datanode   14 seconds ago   Up 13 seconds   0.0.0.0:32958->9864/tcp, :::32958->9864/tcp

docker-datanode-2   apache/ozone:1.4.1-rocky   "/usr/local/bin/dumb…"   datanode   14 seconds ago   Up 13 seconds   0.0.0.0:32957->9864/tcp, :::32957->9864/tcp

docker-datanode-3   apache/ozone:1.4.1-rocky   "/usr/local/bin/dumb…"   datanode   14 seconds ago   Up 12 seconds   0.0.0.0:32959->9864/tcp, :::32959->9864/tcp

docker-om-1         apache/ozone:1.4.1-rocky   "/usr/local/bin/dumb…"   om         14 seconds ago   Up 13 seconds   0.0.0.0:9874->9874/tcp, :::9874->9874/tcp

docker-recon-1      apache/ozone:1.4.1-rocky   "/usr/local/bin/dumb…"   recon      14 seconds ago   Up 13 seconds   0.0.0.0:9888->9888/tcp, :::9888->9888/tcp

docker-s3g-1        apache/ozone:1.4.1-rocky   "/usr/local/bin/dumb…"   s3g        14 seconds ago   Up 13 seconds   0.0.0.0:9878->9878/tcp, :::9878->9878/tcp

docker-scm-1        apache/ozone:1.4.1-rocky   "/usr/local/bin/dumb…"   scm        14 seconds ago   Up 13 seconds   0.0.0.0:9876->9876/tcp, :::9876->9876/tcp

检查 Ozone 版本


docker compose exec om bash

ozone version

访问 Ozone Recon 服务器，它提供监控和管理功能，可通过打开 Recon 服务器主页访问。

配置

你可以通过修改 docker-compose.yaml 文件中的配置参数来自定义 Ozone 部署：

通用配置：位于 x-common-config 部分下
各服务专属设置：位于各服务的 environment 部分下

例如，要更新 Recon 监听的端口，请追加以下配置：


x-common-config:

  ...

  OZONE-SITE.XML_ozone.recon.http-address: 0.0.0.0:9090

更多配置方面的指导，请参阅为生产环境配置 Ozone页面。

后续步骤

现在你的 Ozone 集群已经启动并运行，你可以进入任意容器中探索环境。


docker compose exec om bash

接下来，学习如何读写数据到 Ozone 中。