# 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)获取完整内容。


---

# 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/ai-assisted-deployment-guide.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.