> For the complete documentation index, see [llms.txt](https://documentation.alluxio.io/ee-ai-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/ee-ai-cn/start/ai-assisted-deployment-guide.md).

# AI 辅助部署指南

AI 辅助部署指南是一个 [Claude Code](https://claude.ai/claude-code) 技能，帮助你从"我拿到了安装文件和 license"到运行起 Alluxio 集群——无需任何 Alluxio 使用经验。

安装后，指南会向你提几个关于环境的问题（Kubernetes + Operator 还是 Linux 主机 + Docker、存储后端、访问接口、规模），然后抓取 Alluxio 文档中的相关内容，为你生成个性化的分步部署计划。全程它都会陪伴你：把任何报错粘贴过来，它会帮你诊断原因、给出修复建议，并推动你继续前进。

{% hint style="warning" %}
本指南是 AI 辅助助手，不保证一次成功。它生成的方案可能不会 100% 适配你的环境——请把方案当作起点，在生产环境执行前先验证命令；如果某一步卡住，可以退回到 [Kubernetes](/ee-ai-cn/start/installing-on-kubernetes.md) 或 [Docker](/ee-ai-cn/start/installing-on-docker.md) 手动指南（或联系 Alluxio 支持）。
{% endhint %}

## 前提条件

* 机器上已安装并运行 [Claude Code](https://claude.ai/claude-code)
* Alluxio 企业版试用包（Docker 镜像或 Operator bundle + license 字符串）——[申请免费试用](https://www.alluxio.io/alluxio-ai-free-trial-c)

## 安装

1. 创建技能目录：

   ```shell
   mkdir -p ~/.claude/skills/alluxio-deploy-guide
   ```
2. 前往[英文页面的 SKILL.md 内容](https://github.com/TachyonNexus/documentation/blob/AI-3.9-16.0.x/docs-ai/en/start/ai-assisted-deployment-guide.md#skill.md-content)，将代码块内的全部内容复制到 `~/.claude/skills/alluxio-deploy-guide/SKILL.md` 并保存。技能文件本身为英文，Claude Code 直接使用英文版。
3. 无需重启——Claude Code 会自动加载新技能。

## 使用方法

打开 Claude Code，输入类似如下内容：

> "帮我部署 Alluxio。" "我有 Alluxio 的 Docker 镜像和 license，从哪里开始？" "启动 Alluxio 时报 LicenseCheckException。"

指南会自我介绍，询问你几个环境相关问题，然后生成一份可以逐步执行的个性化部署计划。

## 本指南涵盖的内容

| 主题             | 提供内容                                                     |
| -------------- | -------------------------------------------------------- |
| **环境准备**       | 带有可直接复制执行的验证命令的前提条件清单                                    |
| **License 配置** | 如何在启动集群前将 `alluxio.license` 写入 `alluxio-site.properties` |
| **集群配置**       | 根据你的硬件（NVMe/SSD 容量、节点数）生成的配置片段                           |
| **存储连接**       | 针对 S3、GCS、Azure Blob、HDFS 或 NAS 的凭证设置和挂载命令               |
| **集群启动**       | 启动命令及健康检查验证                                              |
| **数据访问**       | 针对你所选接口的设置：POSIX/FUSE、S3 API 或 Python FSSpec             |
| **端到端测试**      | 可直接复制执行的写入 + 读取命令，验证整体流程                                 |
| **故障排查**       | 粘贴报错或日志时的在线诊断                                            |

## 工作原理

本指南以 Claude Code 技能的形式实现——一组运行时在被触发时遵循的指令。生成部署计划时，它会实时抓取 [documentation.alluxio.io](https://documentation.alluxio.io) 上的相关文档内容，使指导内容反映最新版本。本地不捆绑任何文档内容，需要访问互联网。

技能文件是开放可读的。如果你希望在运行前了解它的具体行为，可在安装后查看 `~/.claude/skills/alluxio-deploy-guide/SKILL.md`。

## 更新

前往[英文页面的 SKILL.md 内容](https://github.com/TachyonNexus/documentation/blob/AI-3.9-16.0.x/docs-ai/en/start/ai-assisted-deployment-guide.md#skill.md-content)，将最新内容覆盖写入 `~/.claude/skills/alluxio-deploy-guide/SKILL.md` 即可。

## 相关链接

* [免费试用](https://www.alluxio.io/alluxio-ai-free-trial-c) — 申请 Alluxio 企业版试用包
* [前提条件](/ee-ai-cn/start/prerequisites.md) — 详细的硬件、软件和网络要求
* [Kubernetes 安装](/ee-ai-cn/start/installing-on-kubernetes.md) — Kubernetes 完整手动指南
* [Docker 安装](/ee-ai-cn/start/installing-on-docker.md) — Docker / 裸机完整手动指南

## SKILL.md 内容

技能文件为英文，请前往[英文页面](https://github.com/TachyonNexus/documentation/blob/AI-3.9-16.0.x/docs-ai/en/start/ai-assisted-deployment-guide.md#skill.md-content)获取完整内容。