ラボ環境を検証する

ラボの準備として、環境を正しく設定することが重要です。このページでは、すべての前提条件が満たされていることを確かめるセットアッププロセスについて説明します。

このラボには、Microsoft Edge または Azure DevOps 対応ブラウザーが必要です。
Azure サブスクリプションを設定する: Azure サブスクリプションをまだお持ちでない場合は、このページの手順に従って作成するか、https://azure.microsoft.com/free にアクセスして無料でサインアップしてください。
Azure DevOps 組織を設定する: このラボで使用できる Azure DevOps 組織がまだない場合は、組織またはプロジェクトコレクションの作成に関するページの手順に従って作成してください。
Git for Windows ダウンロードページ。このラボでは前提条件の一部としてインストールされます。
Visual Studio Code。このラボでは前提条件の一部としてインストールされます。
Azure CLI。セルフホステッドエージェントのマシンに Azure CLI をインストールします。

Azure DevOps 組織を作成する手順 (これを行う必要があるのは 1 回だけです)

注: 個人の Microsoft アカウントのセットアップとアクティブな Azure サブスクリプションがそのアカウントにリンクされている場合、手順 3 から開始します。

プライベートブラウザーセッションを使用し、https://account.microsoft.com で新しい 個人 Microsoft アカウント (MSA) を取得します。
同じブラウザーセッションを使用して、https://azure.microsoft.com/free で無料の Azure サブスクリプションにサインアップします。
ブラウザーを開き、https://portal.azure.com の Azure portal に移動し、Azure portal 画面の上部で Azure DevOps を検索します。表示されたページで、[Azure DevOps 組織] をクリックします。
次に、My Azure DevOps Organizations というラベルの付いたリンクをクリックするか、https://aex.dev.azure.com に直接移動します。
We need a few more details ページで、 [続行] を選びます。
左側のドロップダウンボックスで、Microsoft アカウントの代わりに [既定のディレクトリ] を選びます。
プロンプト ( We need a few more details ) が表示されたら、名前、メールアドレス、場所を入力して、 [続行] をクリックします。
[既定のディレクトリ] を選択した状態で https://aex.dev.azure.com に戻り、青いボタン [新しい組織の作成] をクリックします。
[続行] をクリックして利用規約に同意します。
プロンプト ( Almost done ) が表示されたら、Azure DevOps 組織の名前を既定のままにし (グローバルに一意の名前である必要があります)、一覧から最寄りのホスティング場所を選びます。
新しく作成した組織が Azure DevOps で開いたら、左下隅にある [組織設定] を選びます。
[組織設定] 画面で、[課金情報] を選びます (この画面を開くには数秒かかります)。
[課金の設定] を選び、画面の右側で [Azure サブスクリプション]、[保存] の順に選んでサブスクリプションを組織にリンクします。
画面の上部にリンクされた Azure サブスクリプション ID が表示されたら、MS Hosted CI/CD の有料並列ジョブの数を 0 から 1 に変更します。次に、下部にある [保存] を選びます。
新しい設定がバックエンドに反映されるように、CI/CD 機能を使用する前に少なくとも 3 時間待ちます。それができなかった場合、 “ホストされた並列処理は購入も許可もされていません” というメッセージが依然として表示されます。

Azure DevOps プロジェクトを作成して構成する手順 (これを行う必要があるのは 1 回だけです)

注: これらの手順を続ける前に、Azure DevOps 組織を作成する手順を完了していることを確認してください。

すべてのラボ手順に従うには、新しい Azure DevOps プロジェクトの設定、eShopOnWeb アプリケーションに基づくリポジトリの作成、Azure サブスクリプションへのサービス接続の作成を行う必要があります。

チームプロジェクトを作成する

最初に、複数のラボで使用される eShopOnWeb Azure DevOps プロジェクトを作成します。

ブラウザーを開き、Azure DevOps 組織に移動します。
[新しいプロジェクト] オプションを選び、次の設定を使用します。
- 名前: eShopOnWeb
- 可視性: プライベート
- 詳細設定: バージョンコントロール: Git
- 詳細設定: 作業項目プロセス: スクラム
［作成］ を選択します

eShopOnWeb Git リポジトリをインポートする

次に、eShopOnWeb を Git リポジトリにインポートします。

ブラウザーを開き、Azure DevOps 組織に移動します。
前に作成した eShopOnWeb プロジェクトを開きます。
[Repos] > [ファイル] を選び、[リポジトリをインポートする]、[インポート] の順に選びます。
[Git リポジトリをインポートする] ウィンドウで、URL https://github.com/MicrosoftLearning/eShopOnWeb を貼り付けて、[インポート] を選びます。
リポジトリは次のように編成されています。
- .ado フォルダーには、Azure DevOps の YAML パイプラインが含まれています。
- .devcontainer フォルダーには、コンテナーを使って開発するためのセットアップが含まれています (VS Code でローカルに、または GitHub Codespaces で)。
- .azure フォルダーには、Bicep & ARM インフラストラクチャがコードテンプレートとして含まれています。
- .github フォルダーには、YAML GitHub ワークフローの定義が含まれています。
- src フォルダーには、ラボシナリオで使用される .NET 6 Web サイトが含まれています。
Web ブラウザーのウィンドウは開いたままにしておきます。

Azure リソースにアクセスするためのサービスプリンシパルとサービス接続を作成する

次に、Azure CLI を使用してサービスプリンシパルを作成し、Azure DevOps にサービス接続を作成します。これにより、Azure サブスクリプションにリソースをデプロイしてアクセスできるようになります。

Web ブラウザーを起動し、Azure portal (https://portal.azure.com) に移動します。このコースのラボで使用する Azure サブスクリプションの所有者ロールを持っており、このサブスクリプションに関連付けられている Microsoft Entra テナントの全体管理者のロールを持っているユーザーアカウントを使用してサインインします。
Azure portal で、ページ上部の検索テキストボックスのすぐ右側にある Cloud Shell アイコンをクリックします。
Bash または PowerShell の選択を求めるメッセージが表示されたら、[Bash] を選択します。

[!NOTE] Cloud Shell を初めて起動し、”ストレージがマウントされていません” というメッセージが表示された場合は、このラボで使用しているサブスクリプションを選択し、[ストレージの作成] を選択します。
Bash プロンプトの [Cloud Shell] ペインで、次のコマンドを実行して、Azure サブスクリプション ID とサブスクリプション名の属性の値を取得します。
```
subscriptionName=$(az account show --query name --output tsv)
subscriptionId=$(az account show --query id --output tsv)
echo $subscriptionName
echo $subscriptionId
```
[!NOTE] 両方の値をテキストファイルにコピーします。これらは、このコースのラボで必要になります。
[Cloud Shell] ペインのBash プロンプトから、次のコマンドを実行してサービスプリンシパルを作成します。
```
az ad sp create-for-rbac --name sp-eshoponweb-azdo --role contributor --scopes /subscriptions/$subscriptionId
```
[!NOTE] このコマンドは JSON 出力を生成します。出力をテキストファイルにコピーします。それはすぐに必要になります。

[!NOTE] JSON 出力に含まれているセキュリティプリンシパル名、その ID、テナント ID の値を記録します。これらは、このコースのラボで必要になります。
Azure DevOps ポータルが表示されている Web ブラウザーウィンドウに戻り、eShopOnWeb プロジェクトを開いて、ポータルの左下隅にある [プロジェクトの設定] を選択します。
[パイプライン] で [サービス接続] を選択し、[サービス接続の作成] ボタンを選択します。
[新しいサービス接続] ブレードで、 [Azure Resource Manager] と [次へ] を選択します (必要に応じて下にスクロールします)。
[サービスプリンシパル (手動)] を選択し、[次へ] を選択します。
前の手順で収集した情報を使って、空のフィールドに入力します。
- サブスクリプション ID と名前。
- サービスプリンシパル ID (clientId/AppId)、サービスプリンシパルキー (パスワード)、テナント ID。
- [サービス接続名] に「azure subs」と入力します。この名前は、Azure サブスクリプションにアクセスするために、YAML パイプラインで、サービス接続を参照するために使用されます。
[すべてのパイプラインにアクセス許可を付与] をオンにしないでください。 確認して保存する を選択します。

[!NOTE] 運用環境では、[すべてのパイプラインにアクセス許可を付与] オプションは推奨されません。このラボでは、パイプラインの構成を簡略化するためにのみ使用されます。

これで、ラボを続けるために必要な前提条件の手順が完了しました。