Azure Pipelines を使用して Azure Stack Hub App Service にデプロイする

[アーティクル]
07/20/2023

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

この記事では、Azure Pipelines を使用して Azure Stack Hub インスタンス内のアプリサービスにアプリケーションをデプロイするための CI/CD パイプラインを設定する手順について説明します。

この記事では、以下を作成または検証する方法について説明します。

パイプラインの Azure Stack Hub サービスプリンシパル (SPN) 資格情報。
Azure Stack Hub インスタンス内の Web アプリ。
Azure Stack Hub インスタンスへのサービス接続。
アプリにデプロイするアプリコードを含むリポジトリ

前提条件

App Service RP が有効になっている Azure Stack Hub インスタンスへのアクセス。
Azure Stack Hub テナントに関連付けられている Azure DevOps ソリューション。

SPN を作成または検証する

Azure 外部のプロセスでリソースに接続したり、リソースとやり取りしたりするために、SPN によってロールベースの資格情報が提供されます。 Azure DevOps パイプラインで使用するために、共同作成者アクセス権を含む SPN と、以下の手順で指定される属性が必要になります。

Azure Stack Hub のユーザーには、SPN を作成するアクセス許可はありません。このプリンシパルはクラウドオペレーターに要求する必要があります。ここで提供する説明を使用することで、クラウドオペレーターである場合は SPN を作成できます。あるいは、クラウドオペレーターから提供された SPN をワークフローで使用する開発者である場合は、SPN を検証できます。

クラウドオペレーターは Azure CLI を使用して SPN を作成する必要があります。

次のコードスニペットは、Azure CLI for Azure Stack Hub で PowerShell プロンプトを使用する Windows マシン用に作成されています。 Linux コンピューターと bash で CLI を使用している場合は、行継続を削除するか、\ に置き換えます。

SPN の作成に使用する次のパラメーターの値を準備します。

パラメーター	例	説明
endpoint-resource-manager	"https://management.orlando.azurestack.corp.microsoft.com"	リソース管理エンドポイント。
suffix-storage-endpoint	"orlando.azurestack.corp.microsoft.com"	ストレージアカウントのエンドポイントサフィックス。
suffix-keyvault-dns	".vault.orlando.azurestack.corp.microsoft.com"	Key Vault サービス dns サフィックス。
endpoint-active-directory-graph-resource-id	"https://graph.windows.net/"	Active Directory リソース ID。
endpoint-sql-management	https://notsupported	SQL サーバー管理エンドポイント。これを `https://notsupported`
プロファイル	2019-03-01-hybrid	このクラウドで使用するプロファイル。

Windows PowerShell や Bash などのコマンドラインツールを開き、サインインします。次のコマンドを使用します。
```
az login
```

新しい環境の場合は register コマンドを使用し、既存の環境を使用する場合は update コマンドを使用します。次のコマンドを使用します。

az cloud register `
    -n "AzureStackUser" `
    --endpoint-resource-manager "https://management.<local>.<FQDN>" `
    --suffix-storage-endpoint ".<local>.<FQDN>" `
    --suffix-keyvault-dns ".vault.<local>.<FQDN>" `
    --endpoint-active-directory-graph-resource-id "https://graph.windows.net/" `
    --endpoint-sql-management https://notsupported  `
    --profile 2019-03-01-hybrid

SPN に使用するサブスクリプション ID とリソースグループを取得します。
サブスクリプション ID とリソースグループを使用して、次のコマンドで SPN を作成します。
```
az ad sp create-for-rbac --name "myApp" --role contributor `
    --scopes /subscriptions/{subscription-id}/resourceGroups/{resource-group} `
    --sdk-auth
```
クラウドオペレーターの特権がない場合は、クラウドオペレーターから提供された SPN を使用してサインインすることもできます。クライアント ID、シークレット、およびテナント ID が必要になります。これらの値を使用すると、次の Azure CLI コマンドを使用して、サービス接続を作成するために必要な値を含む JSON オブジェクトを作成できます。
```
az login --service-principal -u "<client-id>" -p "<secret>" --tenant "<tenant-ID>" --allow-no-subscriptions
az account show
```

結果の JSON オブジェクトを確認します。 JSON オブジェクトを使用して、サービス接続を作成します。 JSON オブジェクトには、次の属性が必要です。

{
  "environmentName": "<Environment name>",
  "homeTenantId": "<Tenant ID for the SPN>",
  "id": "<Application ID for the SPN>",
  "isDefault": true,
  "managedByTenants": [],
  "name": "<Tenant name>",
  "state": "Enabled",
  "tenantId": "<Tenant ID for the SPN>",
  "user": {
    "name": "<User email address>",
    "type": "user"
  }
}

Web アプリターゲットを作成する

Azure Stack Hub ポータルにサインインします。
[リソースの作成]>[Web + モバイル]>[Web アプリ] を選択します。
サブスクリプションを選択します。
[リソースグループ] を作成または選択します。
アプリの [名前] を入力します。アプリの名前は、アプリの URL に表示されます (例: yourappname.appservice.<region>.<FQDN>)
アプリの [ランタイムスタック] を選択します。ランタイムは、Web アプリに使用する予定のコードと一致する必要があります。
ランタイムとアプリをホストする [オペレーティングシステム] (OS) を選択します。
Azure Stack Hub インスタンスの [リージョン] を選択または入力します。
Azure Stack Hub のインスタンス、リージョン、およびアプリの OS に基づいてプランを選択します。
[確認および作成] を選択します。
Web アプリを確認します。 ［作成］ を選択します
[リソースに移動] を選択します。
アプリ名を書き留めます。リポジトリ内のパイプラインを定義する yml ドキュメントに名前を追加します。

サービス接続を作成する

サービス接続を作成します。 SPN からの値と Azure Stack Hub サブスクリプションの名前が必要です。

Azure DevOps 組織にサインインしてから、プロジェクトに移動します。
[プロジェクトの設定] を選択し、[サービス接続] を選択します。
[サービス接続]>[新しいサービス接続] を選択します。
[Azure Resource Manager] を選択してから、[次へ] を選択します。
[サービスプリンシパル (手動)] を選択します。
[環境] から [Azure Stack] を選択します。
フォームに入力してから、[確認して保存] を選択します。
サービス接続に名前を付けます。 (yaml パイプラインを作成するには、サービス接続名が必要です)。

リポジトリを作成してパイプラインを追加する

リポジトリに Web アプリコードを追加していない場合は、ここで追加します。
リポジトリを開きます。リポジトリを選択し、[参照] を選択します。
[パイプライン] を選択します
[新しいパイプライン] を選択します。
[Azure Repos Git] を選択します。
リポジトリを選択します。
[スタートパイプライン] を選択します。
リポジトリに戻り、azure-pipelines.yml を開きます。

次の yaml を追加します。

# Starter pipeline
# Start with a minimal pipeline that you can customize to build and deploy your code.
# Add steps that build, run tests, deploy, and more:
# https://aka.ms/yaml
trigger:
- main
variables:
  azureSubscription: '<your connection name>'
  VSTS_ARM_REST_IGNORE_SSL_ERRORS: true
steps:
- task: AzureWebApp@1
  displayName: Azure Web App Deploy
  inputs:
    azureSubscription: $(azureSubscription)
    appName: <your-app-name>
    package: '$(System.DefaultWorkingDirectory)'

注意

SSL エラーを無視するには、次の例のように、ビルドまたはリリースパイプラインで VSTS_ARM_REST_IGNORE_SSL_ERRORS という名前の変数を値 true に設定します。

azureSubscription の値をサービス接続の名前で更新します。
appName をアプリ名で更新します。これで、デプロイする準備が整いました。

Azure Stack Hub での Azure タスクの使用に関する注意事項

Azure Stack Hub では、次の Azure タスクが検証されます。

次の方法で共有

Azure Pipelines を使用して Azure Stack Hub App Service にデプロイする

前提条件

SPN を作成または検証する

Web アプリターゲットを作成する

サービス接続を作成する

リポジトリを作成してパイプラインを追加する

Azure Stack Hub での Azure タスクの使用に関する注意事項

次のステップ

フィードバック

その他のリソース

次の方法で共有

Azure Pipelines を使用して Azure Stack Hub App Service にデプロイする

前提条件

SPN を作成または検証する

Web アプリ ターゲットを作成する

サービス接続を作成する

リポジトリを作成してパイプラインを追加する

Azure Stack Hub での Azure タスクの使用に関する注意事項

次のステップ

フィードバック

その他のリソース

Web アプリターゲットを作成する