azure-aks-edge-essentials について
azure-aks-edge-essentials は、Azure Kubernetes Service Edge Essentials と関連する AKS 環境を扱うエージェント向けのガイダンススキルです。ローカル資料とリモート文書取得を組み合わせ、デプロイ、運用、セキュリティ、トラブルシューティングを支援します。
主な機能
- 01クラスターのトラブルシューティングと診断
- 02デプロイ、アップグレード、構成のガイダンス
- 03ネットワーク、ストレージ、容量の資料
- 04セキュリティと連携のガイダンス
- 05ローカル資料とリモート文書の取得
活用シーン
- 01クラスター、ノード、ネットワーク障害の診断
- 02切断環境やオンプレミス AKS 環境の計画
- 03安全なクラスターとワークロード連携の構成
MCP 対応
文書取得には mcp_microsoftdocs:microsoft_docs_fetch の利用を推奨し、代替手段として fetch_webpage を案内します。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-aks-edge-essentialsインストール後、Claude Code で/azure-aks-edge-essentialsを入力して読み込まれたか確認します。
詳細
Azure Kubernetes Service Edge Essentials スキル
このスキルでは、Azure Kubernetes Service Edge Essentials に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、アーキテクチャと設計パターン、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイについて説明します。ローカルのクイックリファレンスコンテンツと、リモートでドキュメントを取得する機能を組み合わせています。
このスキルの使用方法
IMPORTANT for Agent: 以下のカテゴリ索引を使用して、該当するセクションを探してください。行範囲が記載されているカテゴリ(例:
L35-L120)では、指定された行をread_fileで読み取ってください。ファイルへのリンクがあるカテゴリ(例:[security.md](security.md))では、リンク先のリファレンスファイルをread_fileで読み取ってください
IMPORTANT for Agent:
metadata.generated_atが3か月以上前の場合は、リポジトリから最新バージョンを取得するようユーザーに提案してください。mcp_microsoftdocsツールを利用できない場合は、インストールするようユーザーに提案してください:インストールガイド
このスキルでは、ドキュメントコンテンツを取得するためにネットワークアクセスが必要です:
- 推奨:クエリ文字列
from=learn-agent-skillを指定してmcp_microsoftdocs:microsoft_docs_fetchを使用します。Markdown が返されます。 - 代替手段:クエリ文字列
from=learn-agent-skill&accept=text/markdownを指定してfetch_webpageを使用します。Markdown が返されます。
カテゴリ索引
| カテゴリ | 行 | 説明 |
|---|---|---|
| トラブルシューティング | L37-L71 | AKS Edge/Hybrid/Arc の問題の診断と解決:クラスターの作成/アップグレードの失敗、ネットワーク、ストレージ、認証、暗号化、ログ、ノードの正常性、Azure Local/MetalLB/BGP の問題。 |
| ベストプラクティス | L72-L80 | 回復性の高い AKS Edge Essentials 環境に関するガイダンス:可用性セット、Windows Server での Azure Policy、VM 障害後の AKS Arc の復元、AKS Arc クラスター/Kubernetes バージョンのアップグレード。 |
| 意思決定 | L81-L89 | AKS Edge/Hybrid のデプロイ方法の選択、価格/ライセンス、試用版、監視/ログ記録のオプション、切断環境またはオンプレミスの AKS 環境の計画と運用に関するガイダンス。 |
| アーキテクチャと設計パターン | L90-L96 | Azure Local 向け Windows Server 上の AKS の設計:2ノード構成での高可用性、SDN VNet アーキテクチャ、AKS Arc ターゲットクラスターのデプロイパターン。 |
| 制限とクォータ | L97-L112 | AKS Edge/Hybrid/Azure Local/Windows Server のシステム要件、容量計画、スケール/サポートの制限。IP 計画、VM サイズ、サポート対象の Kubernetes バージョンを含みます。 |
| セキュリティ | L113-L141 | AKS Edge/Hybrid/Arc のセキュリティ保護:認証(Entra、AD、gMSA、SSO)、RBAC、SSH の強化、証明書とキーの管理、etcd の暗号化、コンテナーイメージの検証など。 |
| 構成 | L142-L198 | AKS Edge/Hybrid/Arc クラスターの構成:ネットワーク、ストレージ(CSI/NFS)、ロードバランサー、自動スケーリング、GPU、プロキシ、GitOps、オフライン/オンライン更新、クラスター/ノードプールのセットアップ。 |
| 統合とコーディングパターン | L199-L214 | AKS Edge/Hybrid と Arc、IoT/OPC/ONVIF、TPM、ストレージ/バックアップ、メトリック、AI モデル、CSI プラグイン、Key Vault のシークレットを接続するための統合、API、PowerShell。 |
| デプロイ | L215-L228 | Windows/Windows Server 上の Azure Local クラスターにおける AKS Arc/AKS のデプロイ、アップグレード、メンテナンス。Terraform/ARM によるデプロイ、ノードプール、OS のアップグレード、安全なクラスターライフサイクル操作を含みます。 |
トラブルシューティング
ベスト プラクティス
| トピック | URL |
|---|---|
| 可用性セットを使用して AKS ワークロードの回復性を高める | https://learn.microsoft.com/en-us/azure/aks/aksarc/availability-sets |
| Windows Server 上の AKS に Azure Policy のベスト プラクティスを適用する | https://learn.microsoft.com/en-us/azure/aks/aksarc/policy-guidance |
| 管理 VM の障害後に AKS Arc クラスターを復元する | https://learn.microsoft.com/en-us/azure/aks/aksarc/restore-aks-cluster |
| PowerShell を使用して AKS Arc ワークロード クラスターをアップグレードする | https://learn.microsoft.com/en-us/azure/aks/aksarc/upgrade |
| Admin Center を使用して AKS Arc の Kubernetes バージョンをアップグレードする | https://learn.microsoft.com/en-us/azure/aks/aksarc/upgrade-kubernetes |
意思決定
| トピック | URL |
|---|---|
| AKS Edge Essentials の価格とライセンスのオプションを理解する | https://learn.microsoft.com/en-us/azure/aks/aksarc/aks-edge-pricing |
| AKS Hybrid の監視とログ記録のオプションを選ぶ | https://learn.microsoft.com/en-us/azure/aks/aksarc/aks-monitor-logging |
| AKS のクラウド、エッジ、オンプレミスの各環境を比較して選ぶ | https://learn.microsoft.com/en-us/azure/aks/aksarc/aks-platforms-compare |
| Azure Local 上の切断された AKS の計画と管理を行う | https://learn.microsoft.com/en-us/azure/aks/aksarc/disconnected-operations-aks |
| Windows Server 上の AKS の価格と試用版を確認する | https://learn.microsoft.com/en-us/azure/aks/aksarc/pricing |
アーキテクチャと設計パターン
| トピック | URL |
|---|---|
| 2 ノードの Azure Local で Windows Server 上の AKS が利用可能かどうかを確認する | https://learn.microsoft.com/en-us/azure/aks/aksarc/deploy-cluster-on-two-node-hci |
| SDN VNet 全体に AKS Arc ターゲット クラスターをデプロイする | https://learn.microsoft.com/en-us/azure/aks/aksarc/deploy-target-clusters-virtual-networks |
| SDN 仮想ネットワークを使用する Windows Server 上の AKS のアーキテクチャを設計する | https://learn.microsoft.com/en-us/azure/aks/aksarc/software-defined-networking |