Azure Stack Hub で Kubernetes ダッシュボードにアクセスする

[アーティクル]
10/30/2024

Note

Kubernetes Azure Stack Marketplace 項目のみを使用して、概念実証としてクラスターをデプロイします。 Azure Stack でサポートされている Kubernetes クラスターの場合は、AKS エンジンを使用します。

Kubernetes には、基本的な管理操作に使用できる Web ダッシュボードが含まれています。このダッシュボードでは、アプリケーションの基本的な正常性状態とメトリックの表示、サービスの作成とデプロイ、既存のアプリケーションの編集を行うことができます。この記事では、Azure Stack Hub 上で Kubernetes ダッシュボードを設定する方法について説明します。

Kubernetes ダッシュボードの前提条件

Azure Stack Hub Kubernetes クラスター

Kubernetes クラスターが Azure Stack Hub にデプロイされている必要があります。詳細については、「Kubernetes のデプロイ」を参照してください。
SSH クライアント

クラスター内のコントロールプレーンノードに安全に接続するために、SSH クライアントが必要です。 Windows を使用している場合は Putty を使用できます。 Kubernetes クラスターをデプロイしたときに使用した秘密キーが必要です。
FTP (PSCP)

証明書をコントロールプレーンノードから Azure Stack Hub 管理マシンに転送するには、SSH と SSH ファイル転送プロトコルをサポートする FTP クライアントも必要になる場合があります。 FileZilla を使用できます。 Kubernetes クラスターをデプロイしたときに使用した秘密キーが必要です。

ダッシュボードを有効にする手順の概要

クラスター内のコントロールプレーンノードから、Kubernetes の証明書をエクスポートします。
証明書を Azure Stack Hub 管理マシンにインポートします。
Kubernetes Web ダッシュボードを開きます。

マスターからの証明書のエクスポート

クラスター内のコントロールプレーンノードから、ダッシュボードの URL を取得できます。

Azure Stack Hub のダッシュボードから、クラスターのマスターのパブリック IP アドレスとユーザー名を取得します。情報の取得方法は以下のとおりです。
- Azure Stack Hub ポータル https://portal.local.azurestack.external/ にサインインします。
- [すべてのサービス]>[すべてのリソース] の順に選択します。クラスターリソースグループで、マスターを見つけます。マスターの名前は k8s-master-<sequence-of-numbers> です。
ポータルでコントロールプレーンノードを開きます。 パブリック IP アドレスをコピーします。 [接続] をクリックして、[VM ローカルアカウントを使用してログインする] ボックスのユーザー名を取得します。これは、クラスターを作成するときに設定したのと同じユーザー名です。 [接続] ブレードの一覧に表示されたプライベート IP アドレスではなく、パブリック IP アドレスを使用します。
マスターに接続するため、SSH クライアントを開きます。 Windows で作業している場合は、Putty を使用して接続を作成できます。コントロールプレーンノードとユーザー名にはパブリック IP アドレスを使用し、クラスターの作成時に使用した秘密キーを追加します。
ターミナルが接続されたら、「kubectl」と入力して Kubernetes コマンドラインクライアントを開きます。
次のコマンドを実行します。
```
kubectl cluster-info 
```
ダッシュボードの URL を確認します。例: https://k8-1258.local.cloudapp.azurestack.external/api/v1/namespaces/kube-system/services/https:kubernetes-dashboard:/proxy

自己署名証明書を抽出し、PFX 形式に変換します。次のコマンドを実行します。

sudo su 
openssl pkcs12 -export -out /etc/kubernetes/certs/client.pfx -inkey /etc/kubernetes/certs/client.key  -in /etc/kubernetes/certs/client.crt -certfile /etc/kubernetes/certs/ca.crt

kube-system 名前空間のシークレットの一覧を取得します。次のコマンドを実行します。
```
kubectl -n kube-system get secrets
```
kubernetes-dashboard-token-<XXXXX> の値をメモしておきます。
トークンを取得し、保存します。前の手順で取得したシークレット値で kubernetes-dashboard-token-<####> を更新します。
```
kubectl -n kube-system describe secret kubernetes-dashboard-token-<####>| awk '$1=="token:"{print $2}' 
```

証明書のインポート

FileZilla を開き、コントロールプレーンノードに接続します。以下のものが必要になります。
- コントロールプレーンノードのパブリック IP
- ユーザー名
- プライベートシークレット
- SFTP - SSH ファイル転送プロトコルを使用
/etc/kubernetes/certs/client.pfx と /etc/kubernetes/certs/ca.crt を Azure Stack Hub 管理マシンにコピーします。

ファイルの場所を書き留めておきます。その場所でスクリプトを更新してから、管理者特権のプロンプトで PowerShell を開きます。更新されたスクリプトを実行します。

Import-Certificate -Filepath "ca.crt" -CertStoreLocation cert:\LocalMachine\Root 
$pfxpwd = Get-Credential -UserName 'Enter password below' -Message 'Enter password below' 
Import-PfxCertificate -Filepath "client.pfx" -CertStoreLocation cert:\CurrentUser\My -Password $pfxpwd.Password

Kubernetes ダッシュボードを開く

Web ブラウザーのポップアップブロックを無効にします。
ブラウザーで、コマンド kubectl cluster-info の実行時にメモしておいた URL を参照します。例: https://azurestackdomainnamefork8sdashboard/api/v1/namespaces/kube-system/services/https:kubernetes-dashboard:/proxy
クライアント証明書を選択します。
トークンを入力します。
コントロールプレーンノード上の Bash コマンドラインに再接続し、kubernetes-dashboard にアクセス許可を付与します。次のコマンドを実行します。
```
kubectl create clusterrolebinding kubernetes-dashboard --clusterrole=cluster-admin --serviceaccount=kube-system:kubernetes-dashboard 
```
このスクリプトにより、kubernetes-dashboard にクラウド管理者権限が付与されます。詳細については、「RBAC 対応クラスターの場合」を参照してください。

ダッシュボードを使用できます。 Kubernetes ダッシュボードの詳細については、Kubernetes の Web UI ダッシュボードに関するページを参照してください。

Azure Stack Hub Kubernetes ダッシュボード

トラブルシューティング

カスタム仮想ネットワーク

カスタム仮想ネットワークに Kubernetes をデプロイした後に、Kubernetes ダッシュボードにアクセスする際に接続の問題が発生する場合は、ターゲットサブネットが、AKS エンジンによって作成されたルートテーブルとネットワークセキュリティグループのリソースにリンクされていることを確認してください。

ネットワークセキュリティグループの規則で、コントロールプレーンノードと Kubernetes ダッシュボードポッド IP の間の通信が許可されていることを確認します。これは、コントロールプレーンノードから ping コマンドを実行することで検証できます。