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 をリロードします。
-
インストールが完了すると、クラウド の下に Azure というセクションが表示されます。
-
Azure にサインイン... を選択して Azure アカウントにサインインします。
機能
Azure アカウントで正常にサインインすると、Azure というセクションの下に Azure サブスクリプション内のすべての AKS クラスターを表示できます。AKS クラスターを右クリックし、メニュー項目を選択して、次のアクションを実行できます。
クラスターで AKS 診断を実行する
GitHub ワークフローを開始する
Kubectl コマンドを実行する
Kubeconfig にマージ
AKS クラスターを右クリックし、Kubeconfig にマージ を選択して、選択した AKS クラスターを アクティブな kubeconfig ファイル に追加します。
Kubeconfig を保存
AKS クラスターを右クリックし、Kubeconfig を保存 を選択して、選択した AKS クラスターの kubeconfig を新しいファイルとして保存します。
AKS 診断
AKS クラスターを右クリックし、AKS 診断の実行 を選択して、AKS クラスターのバックエンド テレメトリに基づく診断情報を表示します。
- ベスト プラクティス
- 作成、アップグレード、削除、スケールに関する問題
- ID とセキュリティ
- ネットワークと接続の問題
- ノードの正常性
AKS クラスターでさらにチェックを実行して、トラブルシューティングを行い、推奨されるソリューションを入手するには、ページの上部にある [AKS 診断] リンクを選択して、選択したクラスターに対して開きます。AKS 診断の詳細については、AKS 診断の概要 を参照してください。
Azure Portal でクラスターに移動する
AKS クラスターを右クリックし、Azure Portal で表示 を選択して、Azure portal でクラスターの [概要] ページを開きます。
AKS クラスターのプロパティを表示する
AKS クラスターを右クリックし、プロパティの表示 を選択して、プロビジョニング状態、fqdn、k8s バージョンなどの AKS クラスターとエージェント プールのプロパティ、およびノード バージョン、vm タイプ、vm サイズ、o/s タイプ、o/s ディスク サイズ、ノード プロビジョニング状態などのノード プロパティを表示します。
AKS Periscope
AKS クラスターを右クリックし、AKS Periscope の実行 を選択して、AKS クラスターから詳細な診断情報を抽出し、Azure ストレージ アカウントにエクスポートします。オプションを選択すると、収集されたログのダウンロード可能なリンクと、7 日間の有効期限付きの共有可能なリンクを生成するオプションを提供する Web ビューが読み込まれます。
すべてのノードのログが表示されない場合は、ログがまだアップロード中である可能性があります。リンクの生成 ボタンをもう一度押して、より多くのログを読み込みます。
詳細については、AKS Periscope を参照してください。
ストレージ アカウントの構成
AKS Periscope を実行するには、AKS クラスターの診断設定に関連付けられたストレージ アカウントが必要です。
AKS クラスターの診断設定に関連付けられているストレージ アカウントが 1 つしかない場合、収集されたログは既定で関連付けられたストレージ アカウントに保存されます。
AKS クラスターの診断設定に関連付けられているストレージ アカウントが複数ある場合は、収集されたログを保存するストレージ アカウントを選択するように拡張機能から求められます。
診断設定でストレージ アカウントが構成されていない場合は、次の手順に従って有効にすることができます。
-
AKS クラスターを右クリックし、Azure Portal で表示 を選択します。
-
左側のナビゲーションの 監視 で 診断設定 を選択します。
-
診断設定の追加 を選択します。
-
myAKSClusterLogs などの名前を入力し、ストレージ アカウントにアーカイブする オプションを選択します。
-
任意のストレージ アカウントを選択します。
-
使用可能なログのリストで、有効にするログを選択します。
注: 発生するコストは、ストレージ アカウントの使用状況と Azure Storage ポリシーによって異なります。
-
準備ができたら、保存 を選択して、選択したログの収集を有効にします。
診断設定の詳細については、プラットフォーム ログとメトリックをさまざまな宛先に送信するための診断設定を作成する を参照してください。
Azure Service Operator をインストールする
AKS クラスターを右クリックし、Azure Service Operator のインストール を選択して、最新バージョンの Azure Service Operator (ASO) を AKS クラスターに簡単にデプロイし、Kubernetes 内で Azure リソースをプロビジョニングします。このオプションを選択すると、Azure リソース操作を実行するときに ASO が使用するサービス プリンシパルを求められます。このサービス プリンシパルには、適切なアクセス許可 (通常は適切なスコープでの共同作成者) が必要です。サービス プリンシパルの詳細を入力し、送信 を選択して、Azure Service Operator のインストールを開始します。
Azure Service Operator のインストールは、ASO が以前にインストールされたことがない AKS クラスターでのみ実行できます。インストールを手動で開始した場合は、Azure Service Operator の手順に従って完了してください。
Azure Service Operator の詳細については、Azure Service Operator (for Kubernetes) を参照してください。Azure Service Operator で問題が発生した場合は、Azure Service Operator (ASO) のトラブルシューティング を参照してください。
GitHub ワークフローを作成する
AKS クラスターを右クリックし、GitHub ワークフローの作成 を選択して、ワークフロー スターター テンプレートを簡単に開いて作成します。これにより、リソース グループとクラスター名が事前に入力されたワークフロー テンプレートをすばやく生成できます。
Azure Portal からクラスターを作成する
AKS サブスクリプションを右クリックし、Azure Portal からクラスターを作成 を選択して、Azure Portal の AKS クラスター作成ページに簡単に移動します。
AKS クラスターを起動または停止する
AKS クラスターを右クリックし、プロパティの表示 を選択して、AKS クラスターのプロパティを表示します。ページには、クラスターを起動または停止するための クラスターの停止/起動 ボタンがあります。
AKS クラスターから Kubectl コマンドを実行する
AKS クラスターを右クリックし、Kubectl コマンドの実行 を選択して、クラスターで Kubectl コマンドを実行します。現在、次の Kubectl コマンドを使用できます。
- サービスの説明
- すべてのポッドを取得
- API リソース
- クラスター情報を取得
- ノードを取得
- すべてのイベントを取得
おめでとうございます。これで、この VS Code 拡張機能の操作方法がわかりました。
次のステップ
- Azure 拡張機能 - VS Code Marketplace には、Azure およびクラウド用の数百の拡張機能があります。
- Azure Kubernetes Service 診断 (プレビュー) の概要
- Azure Service Operator - Azure Service Operator について学習します。
- AKS Periscope
- GitHub AKS スターター ワークフロー