VS Code の AKS ツールと診断機能
このドキュメントでは、Visual Studio Code から AKS クラスターを直接操作する方法について説明します。Azure Kubernetes Services は、フルマネージドの Kubernetes サービスです。Azure Kubernetes Service (AKS) は、サーバーレス Kubernetes、継続的インテグレーションと継続的デリバリー (CI/CD) エクスペリエンスを、エンタープライズグレードのセキュリティとガバナンスとともに提供します。Azure Kubernetes Service (AKS) は、コンテナ化されたアプリケーションのデプロイ、スケーリング、管理を自動化するためのオープンソースシステムです。
AKS クラスターで診断ヘルスチェックを実行する方法、より詳細なトラブルシューティングのためにAKS Periscopeを起動する方法、Azure Service Operatorをデプロイする方法、またはGitHub Actions スターターワークフローを生成する方法について説明します。
開始する前に
AKS VS Code 拡張機能は、Kubernetes VS Code 拡張機能に親依存関係があります。
Kubernetes VS Code 拡張機能をダウンロードする必要があります。
既存の AKS クラスターでこのガイドに従うことも、AKS クラスターを作成することもできます。
Azure Kubernetes Services 拡張機能のインストール
完全に統合された Azure Kubernetes 診断エクスペリエンスのためには、Azure Kubernetes Services Tools 拡張機能をインストールできます。
この拡張機能を使用すると、VS Code 環境から AKS クラスターを簡単に表示および管理できます。
Azure Kubernetes Services VS Code 拡張機能をインストールするには、拡張機能ビュー (⇧⌘X (Windows、Linux Ctrl+Shift+X)) を開き、「AKS」と検索します。Microsoft の Azure Kubernetes Services 拡張機能を選択します。
インストール
-
VS Code 用の Azure Kubernetes Service 拡張機能をダウンロードしてインストールします。
-
拡張機能のインストールが完了するまで待ち、プロンプトが表示されたら VS Code をリロードします。
-
インストールが完了すると、[Clouds] の下に [Azure] という名前のセクションが表示されます。
-
[Sign in to Azure…] を選択して、Azure アカウントにサインインします。
機能
Azure アカウントで正常にサインインすると、[Azure] という名前のセクションの下に、Azure サブスクリプション内のすべての AKS クラスターを表示できます。AKS クラスターを右クリックし、メニュー項目を選択して次のアクションを実行できます。
クラスターで AKS 診断を実行する
GitHub ワークフローを開始する
Kubectl コマンドを実行する
Kubeconfig にマージする
AKS クラスターを右クリックし、[Merge into Kubeconfig] を選択して、選択した AKS クラスターをアクティブな kubeconfig ファイルに追加します。
Kubeconfig を保存する
AKS クラスターを右クリックし、[Save Kubeconfig] を選択して、選択した AKS クラスターの kubeconfig を新しいファイルとして保存します。
AKS 診断
AKS クラスターを右クリックし、[Run AKS Diagnostics] を選択すると、AKS クラスターのバックエンド テレメトリに基づいた診断情報が表示されます。対象は次のとおりです。
- ベスト プラクティス
- 作成、アップグレード、削除、スケーリングに関する問題
- ID とセキュリティ
- ネットワークと接続の問題
- ノードの正常性
トラブルシューティングを行い、推奨される解決策を得るために AKS クラスターでさらにチェックを実行するには、ページ上部の [AKS Diagnostics] リンクを選択して、選択したクラスターの診断を開きます。AKS 診断の詳細については、AKS 診断の概要を参照してください。
Azure Portal でクラスターに移動する
AKS クラスターを右クリックし、[Show In Azure Portal] を選択すると、Azure portal でクラスターの [概要] ページが開きます。
AKS クラスターのプロパティを表示する
AKS クラスターを右クリックし、[Show Properties] を選択すると、プロビジョニング状態、FQDN、K8s バージョンなどの AKS クラスターとエージェント プールのプロパティ、およびノードのバージョン、VM の種類、VM サイズ、OS の種類、OS ディスク サイズ、ノードのプロビジョニング状態などのノードのプロパティが表示されます。
AKS Periscope
AKS クラスターを右クリックし、[Run AKS Periscope] を選択して、AKS クラスターから詳細な診断情報を抽出し、Azure ストレージアカウントにエクスポートします。このオプションを選択すると、収集されたログのダウンロード可能なリンクと、7日間有効な共有可能なリンクを生成するオプションを提供する Web ビューが読み込まれます。
すべてのノードのログが表示されない場合は、ログがまだアップロード中である可能性があります。[Generate Link] ボタンをもう一度押して、さらにログを読み込みます。
詳細については、AKS Periscope を参照してください。
ストレージアカウントの構成
AKS Periscope を実行するには、AKS クラスターの診断設定に関連付けられたストレージアカウントが必要です。
AKS クラスターの診断設定に関連付けられているストレージアカウントが 1 つしかない場合、収集されたログは既定で関連付けられたストレージアカウントに保存されます。
AKS クラスターの診断設定に関連付けられているストレージアカウントが複数ある場合、拡張機能は収集されたログを保存するためのストレージアカウントを選択するようプロンプトを表示します。
診断設定にストレージアカウントが構成されていない場合は、次の手順に従って有効にすることができます。
-
AKS クラスターを右クリックし、[Show In Azure Portal] を選択します。
-
左側のナビゲーションで [Monitoring] の下の [Diagnostic Settings] を選択します。
-
[Add diagnostic setting] を選択します。
-
myAKSClusterLogs などの名前を入力し、次に [Archive to a storage account] オプションを選択します。
-
任意のストレージアカウントを選択します。
-
利用可能なログの一覧から、有効にするログを選択します。
注: 発生するコストは、ストレージアカウントの使用状況と Azure Storage ポリシーに左右されます。
-
準備ができたら、[Save] を選択して、選択したログの収集を有効にします。
診断設定の詳細については、プラットフォームログとメトリックをさまざまな宛先に送信するための診断設定を作成するを参照してください。
Azure Service Operator のインストール
AKS クラスターを右クリックし、[Install Azure Service Operator] を選択すると、AKS クラスターに Azure Service Operator (ASO) の最新バージョンを簡単にデプロイし、Kubernetes 内で Azure リソースをプロビジョニングできます。このオプションを選択すると、ASO が Azure リソース操作を実行するときに使用するサービスプリンシパルを求められます。このサービスプリンシパルには、適切なアクセス許可 (通常は適切なスコープでの共同作成者) が必要です。サービスプリンシパルの詳細を入力し、[Submit] を選択して Azure Service Operator のインストールを開始します。
Azure Service Operator のインストールは、ASO が以前にインストールされたことのない AKS クラスターでのみ実行できます。手動でインストールを開始している場合は、Azure Service Operator の手順に従って完了してください。
Azure Service Operator の詳細については、Azure Service Operator (Kubernetes 用) を参照してください。Azure Service Operator で問題が発生した場合は、Azure Service Operator (ASO) のトラブルシューティングを参照してください。
GitHub ワークフローの作成
AKS クラスターを右クリックし、[Create GitHub Workflow] を選択すると、ワークフロー スターター テンプレートを簡単に開いて作成できます。これにより、次のリソースグループとクラスター名が事前入力されたワークフローテンプレートをすばやく生成できます。
Azure Portal からクラスターを作成する
AKS サブスクリプションを右クリックし、[Create Cluster From Azure Portal] を選択すると、Azure Portal の AKS クラスター作成ページに簡単に移動できます。
AKS クラスターの開始または停止
AKS クラスターを右クリックし、[Show Properties] を選択すると、AKS クラスターのプロパティが表示されます。ページには、クラスターを開始または停止するための [Stop/Start Cluster] ボタンがあります。
AKS クラスターから Kubectl コマンドを実行する
AKS クラスターを右クリックし、[Run KubectlCommands] を選択して、クラスターで Kubectl コマンドを実行します。現在、次の Kubectl コマンドが利用可能です。
- Describe Services
- Get All Pods
- API Resources
- Get Cluster Info
- Get Node
- Get All Events
おめでとうございます！これで、この VS Code 拡張機能の操作方法がわかりました。
次のステップ
- Azure 拡張機能 - VS Code Marketplace には、Azure およびクラウド向けの何百もの拡張機能があります。
- Azure Kubernetes Service 診断 (プレビュー) の概要
- Azure Service Operator - Azure Service Operator について学びます。
- AKS Periscope
- GitHub AKS スターターワークフロー