> For the complete documentation index, see [llms.txt](https://documentation.alluxio.io/os-cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.alluxio.io/os-cn/ufs/ozone.md).

# Alluxio集成Ozone作为底层存储

本指南介绍了如何将[Ozone](https://ozone.apache.org/)配置为Alluxio的底层存储系统。 Ozone是用于Hadoop的可扩展，冗余和分布式对象存储。除了可以扩展到数十亿个大小不同的对象外， Ozone可以在容器化环境(例如Kubernetes和YARN)中有效运行。

## 先决条件

要在一组计算机上运行Alluxio集群，必须将Alluxio二进制文件部署到集群的每台 计算机上。你可以使用[直接下载预编译的二进制文件](/os-cn/deploy/running-alluxio-locally.md)(具有正确的Hadoop版本(推荐))，或 [从Alluxio源代码编译二进制文件](/os-cn/contributor/building-alluxio-from-source.md)(适用于高级用户)。

在准备Ozone与Alluxio一起使用时，请遵循[Ozone本地安装](https://ozone.apache.org/docs/1.2.1/zh/start/onprem.html) 安装Ozone集群，并遵循[Cli命令](https://ozone.apache.org/docs/1.2.1/interface/cli.html)创建Ozone集群的卷和存储桶。

## 基本设置

要配置Alluxio使用Ozone做为底层存储系统，需要修改配置文件 `conf/alluxio-site.properties`。如果此文件不存在，请从模板创建此配置文件。

```console
$ cp conf/alluxio-site.properties.template conf/alluxio-site.properties
```

编辑`conf/alluxio-site.properties`将`alluxio.master.mount.table.root.ufs`底层存储地址设置为Ozone桶或想要挂载到Alluxio的Ozone目录。 Ozone 支持`o3fs`和`ofs`两种不同的 schema

### o3fs

例如，如果要将整个存储桶挂载到Alluxio的根目录，则将`alluxio.master.mount.table.root.ufs`设置为`o3fs://<OZONE_BUCKET>.<OZONE_VOLUME>/`； 如果仅将`<OZONE_VOLUME>`的`<OZONE_BUCKET>`Ozone桶内的`/alluxio/data`目录映射到Alluxio的根目录， 则可以设置为`o3fs://<OZONE_BUCKET>.<OZONE_VOLUME>/alluxio/data`。

将`alluxio-site.properties`中的`alluxio.master.mount.table.root.option.alluxio.underfs.hdfs.configuration`指向`ozone-site.xml`，确保配置在所有正在运行Alluxio的服务端上设置了。

```properties
alluxio.master.mount.table.root.ufs=o3fs://<OZONE_BUCKET>.<OZONE_VOLUME>/
alluxio.master.mount.table.root.option.alluxio.underfs.hdfs.configuration=/path/to/hdfs/conf/ozone-site.xml
```

### ofs

例如，如果要将整个存储桶挂载到Alluxio的根目录，则将`alluxio.master.mount.table.root.ufs`设置为`ofs://<OZONE_MANAGER>/<OZONE_VOLUME>/<OZONE_BUCKET>/`； 如果仅将`<OZONE_VOLUME>`的`<OZONE_BUCKET>`Ozone桶内的`/alluxio/data`目录映射到Alluxio的根目录， 则可以设置为`ofs://<OZONE_MANAGER>/<OZONE_VOLUME>/<OZONE_BUCKET>/alluxio/data`。

## Ozone HA模式

### o3fs

要让Alluxio挂载HA模式下Ozone，你应该配置Alluxio的服务端以让其可以找到OzoneManager。请注意一旦设置，你使用Alluxio客户端的应用程序不再需要任何特殊的配置。 在HA模式下`alluxio.master.mount.table.root.ufs`需要指定`<OM_SERVICE_IDS>` 例如：

```properties
alluxio.master.mount.table.root.ufs=o3fs://<OZONE_BUCKET>.<OZONE_VOLUME>.<OM_SERVICE_IDS>/
alluxio.master.mount.table.root.option.alluxio.underfs.hdfs.configuration=/path/to/hdfs/conf/ozone-site.xml
```

### ofs

```properties
alluxio.master.mount.table.root.ufs=ofs://<OZONE_MANAGER>/<OZONE_VOLUME>/<OZONE_BUCKET>/
alluxio.master.mount.table.root.option.alluxio.underfs.hdfs.configuration=/path/to/hdfs/conf/ozone-site.xml
```

`<OM_SERVICE_IDS>` 可以在`ozone-site.xml`中找到， 例如以下`ozone-site.xml`配置文件中`<OM_SERVICE_IDS>`为`omservice1`。

```xml
<property>
    <name>ozone.om.service.ids</name>
    <value>omservice1</value>
</property>
```

## 挂载特定版本Ozone

用户可以将具有指定版本的Ozone集群作为底层存储挂载到Alluxio命名空间。 在挂载特定版本Ozone之前，请确保已使用该特定版本Ozone构建了客户端。 你可以通过到Alluxio目录下的`lib`目录来检查该客户端是否存在。

当使用特定的Ozone版本挂载Alluxio根目录的底层存储时，可以添加以下内容到`conf/alluxio-site.properties`。

```properties
alluxio.master.mount.table.root.option.alluxio.underfs.version=<OZONE_VERSION>
```

## 示例:使用Ozone本地运行Alluxio

启动Alluxio服务器:

```console
$ ./bin/alluxio format
$ ./bin/alluxio-start.sh local
```

这将启动Alluxio master和Alluxio worker。可以在<http://localhost:19999>上看到 master UI。

运行一个简单的示例程序

```console
$ ./bin/alluxio runTests
```

使用HDFS shell或Ozone shell来访问Ozone目录`o3fs://<OZONE_BUCKET>.<OZONE_VOLUME>/<OZONE_DIRECTORY>` 来确认由Alluxio创建的文件和目录是存在的。对于此测试，应该看到名为 `<OZONE_BUCKET>.<OZONE_VOLUME>/<OZONE_DIRECTORY>/default_tests_files/BasicFile_CACHE_PROMOTE_MUST_CACHE`.的文件。

停止Alluxio运行

```console
$ ./bin/alluxio-stop.sh local
```

## 高级设置

### 挂载Ozone

一个Ozone位置可以挂载到Alluxio命名空间中一个嵌套目录来保证对多个底层存储的统一访问。可以使用Alluxio的 [Mount Command](/os-cn/operation/user-cli.md#mount)来挂载。 例如，以下命令将Ozone存储桶中的一个目录挂载到Alluxio目录 `/ozone`上:

```console
$ ./bin/alluxio fs mount \
  --option alluxio.underfs.hdfs.configuration=<DIR>/ozone-site.xml \
  /ozone o3fs://<OZONE_BUCKET>.<OZONE_VOLUME>/
```

如果需要挂载指定版本的Ozone，可以在挂载时通过`alluxio.underfs.version=<OZONE_VERSION>`参数指定版本。

```console
$ ./bin/alluxio fs mount \
  --option alluxio.underfs.hdfs.configuration=<DIR>/ozone-site.xml \
  --option alluxio.underfs.version=<OZONE_VERSION> \
  /ozone o3fs://<OZONE_BUCKET>.<OZONE_VOLUME>/
```

可能的 `ozone-site.xml` 文件设置

* `ozone-site.xml`

```xml
<configuration>
  <property>
    <name>ozone.om.address</name>
    <value>localhost</value>
  </property>
</configuration>
```

确保相关的配置文件在所有运行Alluxio的服务器节点上。

### 支持的Ozone版本

当前，与 Alluxio 测试过的 Ozone 版本是 `1.0.0`, `1.1.0`, `1.2.1`。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://documentation.alluxio.io/os-cn/ufs/ozone.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.