演習 - ラボ環境を準備する

完了

この演習では、Azure Arc 対応 Kubernetes クラスターに Azure App Service を実装するためのラボ環境を準備します。 演習は次のタスクで構成されています。

  1. 前提条件となるソフトウェア ツールをインストールします。
  2. Azure サブスクリプションで必要なプレビュー機能を有効にします。
  3. 必要な Azure CLI 拡張機能をインストールします。

この演習は、このモジュールの演習シーケンスの最初のものです。 Azure Arc を使用して Kubernetes に Azure App Service Web アプリを実装するプロセスについて説明します。シーケンスは次の演習で構成されています。

  1. ラボ環境を準備します。
  2. Kubernetes クラスターを設定します。
  3. Kubernetes クラスターを Azure Arc に接続します。
  4. Azure Arc 対応 Kubernetes クラスターに App Service を実装します。
  5. App Service Web アプリを Azure Arc 対応 Kubernetes クラスターにデプロイします。
  6. ラボ環境をクリーンアップします。

Depiction of this module's exercise sequence with additional substeps illustrated for the first exercise (Prepare the lab environment).

タスク 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 を使用していない場合、少なくとも以下のバージョンをシステムにインストールしてください。

タスク 2: Azure サブスクリプションで必要なプレビュー機能を有効にする

Azure Arc を使用する Kubernetes 上の Azure App Service は現在、プレビュー モードで利用できます。 Azure Arc の App Service、Functions、および Logic Apps には、このパブリック プレビュー機能に対するさまざまな制限事項が含まれています。 お使いの Azure サブスクリプションには、これらのすべての機能をテストするために必要なリソース プロバイダーが登録されていない可能性があります。 続行する前に、サブスクリプションでこれらのプロバイダーを明示的に有効にする必要があります。

  1. 任意の Azure Cloud Shell 互換の Web ブラウザーを起動して、Azure Cloud Shell に移動し、メッセージが表示されたら、Azure サブスクリプションの所有者ロールを持つ Microsoft アカウントまたは Microsoft Entra アカウントで認証します。

  2. Bash または PowerShell の選択を求めるメッセージが表示されたら、[Bash] を選択します。

    注意

    Azure Cloud Shell を起動するのが初めてで、ストレージがマウントされませんというメッセージが表示される場合は、このラボで使用しているサブスクリプションを選んでから、[ストレージの作成] を選択します。

  3. 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 分ほどかかります。

  4. 次のコマンドを実行して、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 拡張機能をインストールします。

  1. Azure Cloud Shell ペインの Bash セッションから、次のコマンドを実行し、最新の CLI バージョンと拡張機能があることを確認します。

    az upgrade
    
  2. 次のコマンドを実行し、Azure CLI 拡張機能の connectedk8scustomlocationk8s-extensionappservice-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 を実装するためのラボ環境を準備しました。