演習 - ラボ環境を準備する
この演習では、Azure Arc 対応 Kubernetes クラスターに Azure App Service を実装するためのラボ環境を準備します。 演習は次のタスクで構成されています。
- 前提条件となるソフトウェア ツールをインストールします。
- Azure サブスクリプションで必要なプレビュー機能を有効にします。
- 必要な Azure CLI 拡張機能をインストールします。
この演習は、このモジュールの演習シーケンスの最初のものです。 Azure Arc を使用して Kubernetes に Azure App Service Web アプリを実装するプロセスについて説明します。シーケンスは次の演習で構成されています。
- ラボ環境を準備します。
- Kubernetes クラスターを設定します。
- Kubernetes クラスターを Azure Arc に接続します。
- Azure Arc 対応 Kubernetes クラスターに App Service を実装します。
- App Service Web アプリを Azure Arc 対応 Kubernetes クラスターにデプロイします。
- ラボ環境をクリーンアップします。
タスク 1: 前提条件となるソフトウェア ツールをインストールする
実装プロセスは、Azure CLI、kubectl、および Helm に依存します。 Microsoft Azure portal ベースの実装プロセスも利用できます。 このモジュールでは、実装のさまざまな部分を体験できるよう、Azure CLI ベースの手法を利用します。
重要
Azure Cloud Shell を使用する場合は、このタスクをスキップしてください。 Azure Cloud Shell には便利なラボ環境が用意されています。 最新の前提条件となるソフトウェア ツールが既にインストールされており、Azure サブスクリプションに対する認証が簡略化されます。 Azure Cloud Shell は、Microsoft Edge、Google Chrome、Mozilla Firefox、および Apple Safari の最新バージョンで利用できます。 しかし、プライベート モードの Safari はサポートされていません。
Note
このモジュールの演習では、Azure Cloud Shell を使い、Kubernetes に Azure Arc を使用して Azure App Service を実装します。
Azure Cloud Shell を使用していない場合、少なくとも以下のバージョンをシステムにインストールしてください。
- Azure CLI (バージョン 2.29.x 以降)。 インストール手順については、Azure CLI のインストールに関する記事を参照してください。
- kubectl (バージョン 1.20.x 以降)。 Azure CLI をインストールした後、それを使用して
az aks install-cli
を実行し、kubectl をインストールします。 - Helm (バージョン 3.4.0 以降)。 Helm とインストールに関する詳細については、「Azure Kubernetes Service (AKS) での Helm を使用した既存のアプリケーションのインストール」を参照してください。
タスク 2: Azure サブスクリプションで必要なプレビュー機能を有効にする
Azure Arc を使用する Kubernetes 上の Azure App Service は現在、プレビュー モードで利用できます。 Azure Arc の App Service、Functions、および Logic Apps には、このパブリック プレビュー機能に対するさまざまな制限事項が含まれています。 お使いの Azure サブスクリプションには、これらのすべての機能をテストするために必要なリソース プロバイダーが登録されていない可能性があります。 続行する前に、サブスクリプションでこれらのプロバイダーを明示的に有効にする必要があります。
任意の Azure Cloud Shell 互換の Web ブラウザーを起動して、Azure Cloud Shell に移動し、メッセージが表示されたら、Azure サブスクリプションの所有者ロールを持つ Microsoft アカウント または Azure AD アカウントで認証します。
Bash または PowerShell の選択を求めるメッセージが表示されたら、[Bash] を選択します。
注意
Azure Cloud Shell を起動するのが初めてで、ストレージがマウントされませんというメッセージが表示される場合は、このラボで使用しているサブスクリプションを選んでから、[ストレージの作成] を選択します。
Azure Cloud Shell ペインの Bash セッションから、次のコマンドを実行します。 これらのコマンドを実行すると、必要なすべてのリソース プロバイダーとそれぞれのプレビュー機能が、使用するすべてのリソースと場所に対して有効になります。
az provider register --namespace Microsoft.Kubernetes --wait az provider register --namespace Microsoft.KubernetesConfiguration --wait az provider register --namespace Microsoft.ExtendedLocation --wait az provider register --namespace Microsoft.Web --wait
Note
コマンドが完了するまで待ちます。 これには 2 分ほどかかります。
次のコマンドを実行して、App Service Kubernetes 環境を作成できるかどうかを判断します。
az provider show -n Microsoft.Web --query "resourceTypes[?resourceType=='kubeEnvironments'].locations"
Note
続行する前に、出力に米国東部と西ヨーロッパの場所を表すエントリが含まれていることを確認します。 そうでない場合は、数分待ってからこの手順を繰り返します。
タスク 3: 必要な Azure CLI 拡張機能をインストールする
次の手順を使って、Kubernetes に Azure Arc を使用して Azure App Service を実装するために必要な Azure CLI 拡張機能をインストールします。
Azure Cloud Shell ペインの Bash セッションから、次のコマンドを実行し、最新の CLI バージョンと拡張機能があることを確認します。
az upgrade
次のコマンドを実行し、Azure CLI 拡張機能の connectedk8s、customlocation、k8s-extension、appservice-kube をインストールします。
az extension add --upgrade --yes -n connectedk8s az extension add --upgrade --yes -n customlocation az extension add --upgrade --yes -n k8s-extension az extension add --upgrade --yes -n appservice-kube
Note
インストールが完了するのを待ちます。 これには 1 分ほどかかります。 インストールが正常に完了したことを確認するには、
az -v
コマンドを実行し、その出力を調べます。 出力には、次の形式の Extensions セクションが含まれているはずです (サンプル出力には最低限必要なバージョンが示されていますが、実際のバージョンはこれより新しい可能性があります)。Extensions: customlocation 0.1.3 connectedk8s 1.2.7 appservice-kube 0.1.6
おめでとうございます。 このモジュールの最初の演習を完了しました。 Azure Arc を使用して Kubernetes に Azure App Service を実装するためのラボ環境を準備しました。
ヘルプが必要ですか? Microsoft のトラブルシューティング ガイドをご覧になるか、問題を報告して具体的なフィードバックをお送りください。