关于 azure-automation
azure-automation 是面向 Azure Automation 运维与配置任务的指导技能,供 Agent 参考。它结合本地速查内容与联网获取 Microsoft 文档的能力,涵盖故障排查、安全和部署。
主要功能
- 01Runbook 故障排查与实践
- 02迁移和 Runbook 类型指导
- 03安全与身份配置
- 04限制、配额和部署
- 05远程获取文档
适用场景
- 01诊断 Runbook 执行失败
- 02规划托管标识迁移
- 03检查账户安全设置
- 04配置 Hybrid Runbook Worker
MCP 相关
该技能可在工具可用时通过 mcp_microsoftdocs 获取 Microsoft 文档,也支持使用网页抓取作为备用方式。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-automation安装后在 Claude Code 中输入/azure-automation确认已加载。
详细介绍
Azure Automation 技能
此技能提供 Azure Automation 专业指导,涵盖故障排除、最佳实践、决策、限制和配额、安全性、配置、集成与编码模式,以及部署。它结合了本地快速参考内容和远程文档获取功能。
如何使用此技能
IMPORTANT for Agent:使用下方的类别索引查找相关章节。对于带有行范围的类别(例如
L35-L120),使用read_file读取指定行。对于带有文件链接的类别(例如[security.md](security.md)),使用read_file读取链接的参考文件
IMPORTANT for 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。
类别索引
| 类别 | 行 | 描述 |
|---|---|---|
| 故障排除 | L36-L45 | 诊断和修复 Azure Automation 问题:运行手册失败、DSC/State Configuration、Hybrid Runbook Workers、托管标识、共享资源,以及收集日志以便获得支持。 |
| 最佳实践 | L46-L55 | 组织和运行 Automation 运行手册的最佳实践:模块化父子设计、执行模式、错误处理、流和输出的使用,以及避免上下文或锁定问题。 |
| 决策 | L56-L63 | 选择运行手册类型和规划迁移的指导:从 Orchestrator 迁移到 Automation、从 Log Analytics 迁移到 AMA、从基于 Agent 的工作器迁移到基于扩展的工作器,以及从 Run As 帐户迁移到托管标识。 |
| 限制和配额 | L64-L71 | Azure Automation 的限制、配额和版本详情:DSC 扩展历史记录、Automation 帐户容量、作业和运行手册限制,以及支持 AMA 的 Change Tracking/Inventory 支持矩阵。 |
| 安全性 | L72-L92 | 保护 Automation 帐户:标识(系统分配/用户分配)、Entra 身份验证、RBAC、加密、凭据/证书、专用终结点、策略和安全最佳实践。 |
| 配置 | L93-L134 | 配置 Azure Automation 运行手册、DSC/State Configuration、Hybrid Runbook Workers、警报、计划、模块/包、策略、网络,以及部署/集成设置。 |
| 集成与编码模式 | L135-L147 | 将运行手册与 AWS、ARM/SQL/Office 365、webhook、电子邮件(SendGrid)和 Azure Monitor 日志记录集成的模式,以及使用托管标识的图形化运行手册 SDK |
| 部署 | L148-L152 | 部署 Automation 资源的指南:使用 Chocolatey 设置 DSC 持续部署,以及安装/配置 Windows 和 Linux Hybrid Runbook Worker Agent(基于 Agent 和扩展)。 |
故障排除
| 主题 | URL |
|---|---|
| 为 Azure Automation 支持案例收集诊断数据 | https://learn.microsoft.com/en-us/azure/automation/troubleshoot/collect-data-microsoft-azure-automation-case |
| 排查 Azure Automation State Configuration 问题 | https://learn.microsoft.com/en-us/azure/automation/troubleshoot/desired-state-configuration |
| 排查基于扩展的 Hybrid Runbook Worker 故障 | https://learn.microsoft.com/en-us/azure/automation/troubleshoot/extension-based-hybrid-runbook-worker |
| 排查 Azure Automation 中的托管标识问题 | https://learn.microsoft.com/en-us/azure/automation/troubleshoot/managed-identity |
| 诊断并修复 Azure Automation Runbook 问题 | https://learn.microsoft.com/en-us/azure/automation/troubleshoot/runbooks |
| 排查 Azure Automation 共享资源问题 | https://learn.microsoft.com/en-us/azure/automation/troubleshoot/shared-resources |
最佳实践
| 主题 | URL |
|---|---|
| 在 Azure Automation 中设计模块化的父子 Runbook | https://learn.microsoft.com/en-us/azure/automation/automation-child-runbooks |
| 设计和管理 Azure Automation Runbook 执行 | https://learn.microsoft.com/en-us/azure/automation/automation-runbook-execution |
| 在 Azure Automation 图形化 Runbook 中实现错误处理 | https://learn.microsoft.com/en-us/azure/automation/automation-runbook-graphical-error-handling |
| 配置 Automation Runbook 中的输出和消息流 | https://learn.microsoft.com/en-us/azure/automation/automation-runbook-output-and-messages |
| 避免 Azure Automation Runbook 中的上下文切换问题 | https://learn.microsoft.com/en-us/azure/automation/context-switching |
| 使用推荐的设计模式管理 Azure Automation Runbook | https://learn.microsoft.com/en-us/azure/automation/manage-runbooks |
决策
| 主题 | URL |
|---|---|
| 将 System Center Orchestrator Runbook 迁移到 Azure Automation | https://learn.microsoft.com/en-us/azure/automation/automation-orchestrator-migration |
| 选择合适的 Azure Automation Runbook 类型 | https://learn.microsoft.com/en-us/azure/automation/automation-runbook-types |
| 将 Change Tracking 从 Log Analytics agent 迁移到 AMA | https://learn.microsoft.com/en-us/azure/automation/change-tracking/guidance-migration-log-analytics-monitoring-agent |
| 规划并执行从 Run As 迁移到托管标识 | https://learn.microsoft.com/en-us/azure/automation/migrate-run-as-accounts-managed-identity |
限制和配额
| 主题 | URL |
|---|---|
| 查看 Azure DSC 扩展版本历史详细信息 | https://learn.microsoft.com/en-us/azure/automation/automation-dsc-extension-history |
| 查看和管理 Azure Automation 限制与配额 | https://learn.microsoft.com/en-us/azure/automation/automation-limits-quotas |
| Azure Automation 订阅限制与配额参考 | https://learn.microsoft.com/en-us/azure/automation/automation-subscription-limits-faq |
| 使用 AMA 的 Change Tracking 和 Inventory 支持矩阵 | https://learn.microsoft.com/en-us/azure/azure-change-tracking-inventory/change-tracking-inventory-support-matrix |
安全性
配置
集成与编码模式
部署
| 主题 | URL |
|---|---|
| 使用 DSC 和 Chocolatey 设置持续部署 | https://learn.microsoft.com/en-us/azure/automation/automation-dsc-cd-chocolatey |
| 部署基于扩展的 Hybrid Runbook Worker | https://learn.microsoft.com/en-us/azure/automation/extension-based-hybrid-runbook-worker-install |
评论
支持 Markdown