# 入门指南

本节将引导您完成从首次下载到运行中的 Alluxio 集群并验证数据访问的全过程。每个安装指南均自包含，涵盖集群部署、存储挂载和初步验证。

## 部署内容概览

一个 Alluxio 集群由三类组件构成：

| 组件              | 职责                              | 数量          |
| --------------- | ------------------------------- | ----------- |
| **Worker**      | 将数据缓存在本地 NVMe/SSD 上，直接向客户端提供读服务 | 1+          |
| **Coordinator** | 后台任务：缓存加载、挂载表管理、Worker 健康监控     | 1           |
| **etcd**        | 集群成员管理和挂载表存储                    | 3（生产），1（测试） |

集群部署完成后，您的应用通过 **FUSE**（本地文件系统挂载）、**S3 API**（HTTP，S3 兼容）或 **Python FSSpec** 访问数据。各访问方式在集群启动后单独配置——安装指南仅涵盖集群本身的部署。

## 资源需求速览

| 组件                   | 评估（最低）          | PoC（推荐）          |
| -------------------- | --------------- | ---------------- |
| Worker：CPU / 内存      | 4 核 / 12 GB     | 8 核 / 24 GB      |
| Worker：缓存磁盘          | 100 GB NVMe/SSD | 100 GB+ NVMe/SSD |
| Coordinator：CPU / 内存 | 4 核 / 12 GB     | 8 核 / 16 GB      |
| K8s 节点（如适用）          | 8 核 / 32 GB     | 16 核 / 64 GB     |

详细的硬件、软件和网络要求，请参阅[前提条件](https://documentation.alluxio.io/ee-ai-cn/start/prerequisites)。

## 开始前需要准备

* **Alluxio 下载链接** — 包含 Docker 镜像 `.tar` 文件和 License 字符串。
* **私有 Docker 镜像仓库**（*仅 Kubernetes*）— 镜像需推送至集群节点可访问的仓库后才能部署。Docker / 裸机部署无需私有仓库，直接在每台主机上 `docker load` 即可。
* **存储后端就绪** — S3 存储桶（含凭据）、GCS、HDFS 或其他受支持的 UFS。完整列表请参阅[底层存储](https://documentation.alluxio.io/ee-ai-cn/ufs)。

## 选择安装指南

|          | [Kubernetes（Operator）](https://documentation.alluxio.io/ee-ai-cn/start/installing-on-kubernetes) | [Docker / 裸机](https://documentation.alluxio.io/ee-ai-cn/start/installing-on-docker) |
| -------- | ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------- |
| **适用场景** | 已有 Kubernetes 集群                                                                                 | Linux 主机、EC2 实例或 Slurm——无 Kubernetes                                                |

两条路径部署的集群完全一致，选择取决于您的基础设施环境。

云平台专用指南建立在 Kubernetes 路径之上：

* [OCI OKE](https://documentation.alluxio.io/ee-ai-cn/start/installing-on-kubernetes/oci-oke) —— Oracle Cloud Infrastructure Kubernetes Engine，包含 VCN 配置、OCIR 镜像推送和 `oci-bv` Worker page store 配置。


---

# Agent Instructions: 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:

```
GET https://documentation.alluxio.io/ee-ai-cn/start.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.