关于 azure-hpc-cache
azure-hpc-cache 为 Azure HPC Cache 用户提供故障排查、架构、安全和运维指南。它结合本地速查内容与远程文档获取,涵盖存储目标、缓存优化及区域恢复等主题。
主要功能
- 01存储目标与 NFS 故障排查
- 02缓存性能优化建议
- 03命名空间及区域恢复设计
- 04访问策略与加密配置
- 05存储目标和客户端配置
- 06实例部署与迁移指导
适用场景
- 01排查 Blob 防火墙或 NFS 存储问题
- 02优化数据导入及缓存命中率
- 03规划跨区域冗余与故障转移
- 04创建或迁移 HPC Cache 实例
MCP 相关
技能可优先通过 mcp_microsoftdocs 的 microsoft_docs_fetch 获取文档;也提供网页抓取作为备用方式。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-hpc-cache安装后在 Claude Code 中输入/azure-hpc-cache确认已加载。
详细介绍
Azure HPC Cache 技能
此技能为 Azure HPC Cache 提供专业指导,涵盖故障排除、最佳实践、决策制定、架构与设计模式、限制与配额、安全性、配置、集成与编码模式以及部署。它结合了本地快速参考内容和远程文档获取功能。
如何使用此技能
重要提示(面向 Agent):使用下方的类别索引定位相关章节。对于标有行范围的类别(例如
L35-L120),使用read_file读取指定行。对于带有文件链接的类别(例如[security.md](security.md)),使用read_file读取链接的参考文件
重要提示(面向 Agent):如果
metadata.generated_at的时间早于 3 个月以上,建议用户从存储库拉取最新版本。如果mcp_microsoftdocs工具不可用,建议用户安装:安装指南
此技能需要网络访问权限来获取文档内容:
- 首选:使用
mcp_microsoftdocs:microsoft_docs_fetch,查询字符串为from=learn-agent-skill。返回 Markdown。 - 备用:使用
fetch_webpage,查询字符串为from=learn-agent-skill&accept=text/markdown。返回 Markdown。
类别索引
| 类别 | 行 | 说明 |
|---|---|---|
| 故障排除 | L37-L42 | 诊断和解决 Azure HPC Cache 与 Blob 存储防火墙及 NFS 存储目标相关的问题,包括连接、访问和配置问题。 |
| 最佳实践 | L43-L51 | 优化 Azure HPC Cache 的指南:客户端负载均衡、高效数据移动和手动复制到 Blob 目标、Blob 上的 NFS 注意事项,以及通过预热缓存提高命中率。 |
| 决策制定 | L52-L57 | 关于何时适合使用 Azure HPC Cache 的指南,比较使用模式、工作负载模式和性能需求,并决定是否以及何时在架构中采用它。 |
| 架构与设计模式 | L58-L63 | 设计跨多个后端存储系统的 Azure HPC Cache 命名空间,并规划缓存工作负载的区域冗余、高可用性和故障转移策略。 |
| 限制与配额 | L64-L68 | 如何申请和管理 Azure HPC Cache 配额提升,包括缓存实例、容量方面的限制,以及提高配额的支持流程。 |
| 安全性 | L69-L76 | 配置 HPC Cache 安全性:客户端访问策略、目录/AD 集成和扩展组、客户管理的加密密钥,以及整体缓存安全设置。 |
| 配置 | L77-L90 | 配置和运行 Azure HPC Cache:CLI 设置、网络/DNS/NTP、存储目标和命名空间、挂载 NFS 客户端、生命周期管理、指标和环境先决条件。 |
| 集成与编码模式 | L91-L98 | 用于引入数据的脚本和模式(msrsync、parallelcp)、通过 flush_file.py 控制回写,以及将 Azure HPC Cache 与 Azure NetApp Files 集成。 |
| 部署 | L99-L103 | 通过门户/CLI 创建 Azure HPC Cache 实例,以及在保留配置和数据路径的同时重新创建或将现有缓存迁移到其他区域 |
故障排除
| 主题 | URL |
|---|---|
| 解决 HPC Cache 目标的 Blob 防火墙问题 | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-blob-firewall-fix |
| 排查 Azure HPC Cache 中的 NFS 存储目标问题 | https://learn.microsoft.com/en-us/azure/hpc-cache/troubleshoot-nas |
最佳实践
| 主题 | URL |
|---|---|
| 在 Azure HPC Cache IP 之间对客户端连接进行负载均衡 | https://learn.microsoft.com/en-us/azure/hpc-cache/client-load-balancing |
| 优化向 Azure HPC Cache Blob 目标的数据移动 | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-ingest |
| 手动将数据复制到 Azure HPC Cache Blob 目标 | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-ingest-manual |
| 应用 Azure HPC Cache 的 NFS Blob 存储注意事项 | https://learn.microsoft.com/en-us/azure/hpc-cache/nfs-blob-considerations |
| 预热 Azure HPC Cache 以提高缓存命中率 | https://learn.microsoft.com/en-us/azure/hpc-cache/prime-cache |
决策制定
| 主题 | URL |
|---|---|
| 选择 Azure HPC Cache 使用模型 | https://learn.microsoft.com/en-us/azure/hpc-cache/cache-usage-models |
| 判断 Azure HPC Cache 是否适合您的工作负载 | https://learn.microsoft.com/en-us/azure/hpc-cache/usage-scenarios |
架构与设计模式
| 主题 | URL |
|---|---|
| 设计 Azure HPC Cache 聚合命名空间 | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-namespace |
| 设计 Azure HPC Cache 的区域冗余和故障转移 | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-region-recovery |
限制与配额
| 主题 | URL |
|---|---|
| 申请提高 Azure HPC Cache 配额 | https://learn.microsoft.com/en-us/azure/hpc-cache/increase-quota |
安全性
| 主题 | URL |
|---|---|
| 定义 Azure HPC Cache 客户端访问策略 | https://learn.microsoft.com/en-us/azure/hpc-cache/access-policies |
| 为 Azure HPC Cache 配置客户管理的加密密钥 | https://learn.microsoft.com/en-us/azure/hpc-cache/customer-keys |
| 为 HPC Cache 配置目录服务和扩展组 | https://learn.microsoft.com/en-us/azure/hpc-cache/directory-services |
| 了解 Azure HPC Cache 的安全配置 | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-security-info |
配置
| 主题 | URL |
|---|---|
| 设置 Azure HPC Cache 命名空间路径 | https://learn.microsoft.com/en-us/azure/hpc-cache/add-namespace-paths |
| 准备用于管理 HPC Cache 的 Azure CLI 环境 | https://learn.microsoft.com/en-us/azure/hpc-cache/az-cli-prerequisites |
| 配置 HPC Cache 的网络、NTP、DNS 和快照 | https://learn.microsoft.com/en-us/azure/hpc-cache/configuration |
| 配置 Azure HPC Cache 的存储目标 | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-add-storage |
| 修改 Azure HPC Cache 存储目标设置 | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-edit-storage |
| 操作和更新 Azure HPC Cache 实例 | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-manage |
| 在 NFS 客户端上装载 Azure HPC Cache | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-mount |
| 验证 Azure HPC Cache 的环境先决条件 | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-prerequisites |
| 管理 Azure HPC Cache 存储目标生命周期 | https://learn.microsoft.com/en-us/azure/hpc-cache/manage-storage-targets |
| 监视 Azure HPC Cache 指标和报告 | https://learn.microsoft.com/en-us/azure/hpc-cache/metrics |
集成与编码模式
| 主题 | URL |
|---|---|
| 使用 flush_file.py 控制 HPC Cache 写回 | https://learn.microsoft.com/en-us/azure/hpc-cache/custom-flush-script |
| 使用 msrsync 将数据载入 HPC Cache | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-ingest-msrsync |
| 使用 parallelcp 脚本为 HPC Cache 载入数据 | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-ingest-parallelcp |
| 将 Azure HPC Cache 与 Azure NetApp Files 集成 | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-netapp |
部署
| 主题 | URL |
|---|---|
| 通过门户或 CLI 创建 Azure HPC Cache 实例 | https://learn.microsoft.com/en-us/azure/hpc-cache/hpc-cache-create |
| 在其他区域重新创建或移动 Azure HPC Cache | https://learn.microsoft.com/en-us/azure/hpc-cache/move-resource |
评论
支持 Markdown