Azure DevOps Services から SAP デプロイ自動化フレームワークを使用する

[アーティクル]
11/15/2023

Azure DevOps は、インフラストラクチャのデプロイと、構成および SAP インストールアクティビティを実行するパイプラインを提供することで、デプロイプロセスを効率化します。

Azure Repos を使用して構成ファイルを格納し、Azure Pipelines を使用してインフラストラクチャと SAP アプリケーションをデプロイして構成できます。

Azure DevOps Services を使用するには、Azure DevOps 組織が必要です。組織は、関連するプロジェクトのグループを結合するために使用されます。職場または学校アカウントを使用して、組織を Microsoft Entra ID に自動的に接続します。アカウントを作成するには、Azure DevOps を開き、サインインするか、新しいアカウントを作成します。

SAP デプロイ自動化フレームワーク用に Azure DevOps Services を構成する

次のスクリプトを使用して、SAP デプロイ自動化フレームワーク用の Azure DevOps Services の基本的なインストールを行うことができます。

PowerShell ISE を開き、次のスクリプトをコピーし、環境に合わせてパラメーターを更新します。

    $Env:SDAF_ADO_ORGANIZATION = "https://dev.azure.com/ORGANIZATIONNAME"
    $Env:SDAF_ADO_PROJECT = "SAP Deployment Automation Framework"
    $Env:SDAF_CONTROL_PLANE_CODE = "MGMT"
    $Env:SDAF_WORKLOAD_ZONE_CODE = "DEV"
    $Env:SDAF_ControlPlaneSubscriptionID = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    $Env:SDAF_WorkloadZoneSubscriptionID = "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"
    $Env:ARM_TENANT_ID="zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz"
    
    $UniqueIdentifier = Read-Host "Please provide an identifier that makes the service principal names unique, for instance a project code"
    
    $confirmation = Read-Host "Do you want to create a new Application registration (needed for the Web Application) y/n?"
    if ($confirmation -eq 'y') {
        $Env:SDAF_APP_NAME = $UniqueIdentifier + " SDAF Control Plane"
    }
    
    else {
      $Env:SDAF_APP_NAME = Read-Host "Please provide the Application registration name"
    }
    
    $confirmation = Read-Host "Do you want to create a new Service Principal for the Control plane y/n?"
    if ($confirmation -eq 'y') {
        $Env:SDAF_MGMT_SPN_NAME = $UniqueIdentifier + " SDAF " + $Env:SDAF_CONTROL_PLANE_CODE + " SPN"
    }
        else {
      $Env:SDAF_MGMT_SPN_NAME = Read-Host "Please provide the Control Plane Service Principal Name"
    }
    
    $confirmation = Read-Host "Do you want to create a new Service Principal for the Workload zone y/n?"
    if ($confirmation -eq 'y') {
        $Env:SDAF_WorkloadZone_SPN_NAME = $UniqueIdentifier + " SDAF " + $Env:SDAF_WORKLOAD_ZONE_CODE + " SPN"
    }
        else {
      $Env:SDAF_WorkloadZone_SPN_NAME = Read-Host "Please provide the Workload Zone Service Principal Name"
    }
    
    if ( $PSVersionTable.Platform -eq "Unix") {
        if ( Test-Path "SDAF") {
        }
        else {
            $sdaf_path = New-Item -Path "SDAF" -Type Directory
        }
    }
    else {
        $sdaf_path = Join-Path -Path $Env:HOMEDRIVE -ChildPath "SDAF"
        if ( Test-Path $sdaf_path) {
        }
        else {
            New-Item -Path $sdaf_path -Type Directory
        }
    }
    
    Set-Location -Path $sdaf_path
    
    if ( Test-Path "New-SDAFDevopsProject.ps1") {
        remove-item .\New-SDAFDevopsProject.ps1
    }
    
    Invoke-WebRequest -Uri https://raw.githubusercontent.com/Azure/sap-automation/main/deploy/scripts/New-SDAFDevopsProject.ps1 -OutFile .\New-SDAFDevopsProject.ps1 ; .\New-SDAFDevopsProject.ps1

スクリプトを実行し、手順に従います。このスクリプトを実行すると、認証用と Azure DevOps プロジェクトのタスクを実行するためのブラウザーウィンドウが開きます。

GitHub から直接コードを実行するか、コードのコピーを Azure DevOps プロジェクトにインポートするかを選択できます。

プロジェクトが作成されたことを確認するには、Azure DevOps ポータルに移動し、プロジェクトを選択します。リポジトリが設定されたこと、およびパイプラインが作成されたことを確認します。

重要

ローカルワークステーションで次の手順を実行します。また、az upgrade コマンドを実行して、最新の Azure CLI がインストールされていることも確認します。

新しいワークロードゾーンの Azure DevOps Services 成果物を構成する

次のスクリプトを使用して、新しいワークロードゾーンをサポートするために必要な成果物をデプロイします。このプロセスにより、変数グループとサービス接続が Azure DevOps に作成され、必要に応じてデプロイサービスプリンシパルが作成されます。

PowerShell ISE を開き、次のスクリプトをコピーし、環境に合わせてパラメーターを更新します。

    $Env:SDAF_ADO_ORGANIZATION = "https://dev.azure.com/ORGANIZATIONNAME"
    $Env:SDAF_ADO_PROJECT = "SAP Deployment Automation Framework"
    $Env:SDAF_WorkloadZoneSubscriptionID = "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"
    $Env:ARM_TENANT_ID="zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz"
    
    if ( $PSVersionTable.Platform -eq "Unix") {
        if ( Test-Path "SDAF") {
        }
        else {
            $sdaf_path = New-Item -Path "SDAF" -Type Directory
        }
    }
    else {
        $sdaf_path = Join-Path -Path $Env:HOMEDRIVE -ChildPath "SDAF"
        if ( Test-Path $sdaf_path) {
        }
        else {
            New-Item -Path $sdaf_path -Type Directory
        }
    }
    
    Set-Location -Path $sdaf_path
    
    if ( Test-Path "New-SDAFDevopsWorkloadZone.ps1") {
        remove-item .\New-SDAFDevopsWorkloadZone.ps1
    }
    
    Invoke-WebRequest -Uri https://raw.githubusercontent.com/Azure/sap-automation/main/deploy/scripts/New-SDAFDevopsWorkloadZone.ps1 -OutFile .\New-SDAFDevopsWorkloadZone.ps1 ; .\New-SDAFDevopsWorkloadZone.ps1

サンプルのコントロールプレーン構成を作成する

Create Sample Deployer Configuration パイプラインを実行して、コントロールプレーンのサンプル構成を作成できます。実行時に、適切な Azure リージョンを選択します。 Azure Firewall と Azure Bastion をデプロイするかどうかを制御することもできます。

SAP デプロイ自動化フレームワーク用の Azure DevOps Services の手動構成

SAP デプロイ自動化フレームワーク用の Azure DevOps Services を手動で構成できます。

新しいプロジェクトの作成

Azure Repos を使用すると、sap-automation GitHub リポジトリのコードと、環境構成ファイルを格納できます。

Azure DevOps を開き、[新しいプロジェクト] を選択してプロジェクトの詳細を入力して、新しいプロジェクトを作成します。プロジェクトには、Azure Repos のソース管理リポジトリと、デプロイアクティビティを実行するための Azure Pipelines が含まれます。

[新しいプロジェクト] が表示されない場合は、組織内で新しいプロジェクトを作成するためのアクセス許可があることを確認します。

プロジェクトの URL を記録します。

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

まず、SAP Deployment Automation Framework Bootstrap GitHub リポジトリを Azure Repos にインポートします。

[リポジトリ] セクションに移動し、[リポジトリをインポートする] を選択します。 https://github.com/Azure/sap-automation-bootstrap.git リポジトリを Azure DevOps にインポートします。詳細については、リポジトリのインポートに関する記事を参照してください。

リポジトリをインポートできない場合は、リポジトリを手動で作成できます。その後、SAP Deployment Automation Framework GitHub Bootstrap リポジトリからコンテンツをインポートできます。

手動インポート用のリポジトリを作成する

リポジトリを直接インポートできない場合にのみ、この手順を実行します。

ワークスペース リポジトリを作成するには、[リポジトリ] セクションの [プロジェクト設定]で、[作成] を選択します。

リポジトリを選択して「Git」と入力し、リポジトリの名前を指定します。たとえば、SAP 構成リポジトリを使用します。

リポジトリの複製

コンテンツのより包括的な編集機能を提供するために、リポジトリをローカルフォルダーにクローンし、そのコンテンツをローカルで編集できます。

リポジトリをローカルフォルダーに複製するには、ポータルの [リポジトリ] セクションの [ファイル] で、[クローン] を選択します。詳細については、リポジトリのクローンに関する記事を参照してください。

Screenshot that shows how to clone the repository.

ローカルクローンを使用してリポジトリコンテンツを手動でインポートする

SAP デプロイ自動化フレームワークリポジトリからコンテンツを手動でダウンロードして、Azure DevOps リポジトリのローカルクローンに追加することもできます。

https://github.com/Azure/SAP-automation-samples リポジトリに移動し、リポジトリのコンテンツを .zip ファイルとしてダウンロードします。 [コード] を選択し、[ZIP のダウンロード] を選択します。

.zip ファイルからローカルクローンのルートフォルダーにコンテンツをコピーします。

Visual Studio Code でローカルフォルダーを開きます。ここに表示されるソース管理アイコンは、インジケーターによって変更を同期する必要があることを示します。

Screenshot that shows that source code is changed.

ソース管理アイコンを選択し、変更に関するメッセージを入力します。たとえば、「GitHub からインポート」と入力し、Ctrl + Enter キーを押して変更をコミットします。次に、[変更の同期] を選択して、リポジトリに変更を同期します。

Terraform と Ansible コードのソースの選択

SAP デプロイ自動化フレームワークコードは GitHub から直接実行することも、ローカルにインポートすることもできます。

ローカルリポジトリからコードを実行する

ローカルの Azure DevOps プロジェクトから SAP デプロイ自動化フレームワークコードを実行する場合は、Azure DevOps プロジェクトに別のコードリポジトリと構成リポジトリを作成する必要があります。

構成リポジトリの名前: Same as the DevOps Project name ソースは https://github.com/Azure/sap-automation-bootstrap.git です。
コードリポジトリの名前: sap-automation。ソースは https://github.com/Azure/sap-automation.git です。
サンプルリポジトリとテンプレートリポジトリの名前: sap-samples。ソースは https://github.com/Azure/sap-automation-samples.git です。

GitHub からコードを直接実行する

GitHub から直接コードを実行する場合は、GitHub からコンテンツをプルできるように Azure DevOps の資格情報を指定する必要があります。

GitHub サービス接続を作成する

GitHub からコードをプルするには、GitHub サービス接続が必要です。詳細については、「サービス接続の管理」を参照してください。

サービス接続を作成するには、[プロジェクト設定] に移動し、[パイプライン] セクションの [サービス接続] に移動します。

Screenshot that shows how to create a service connection for GitHub.

サービス接続の種類として [GitHub] を選択します。 [OAuth 構成] ドロップダウンで [Azure Pipelines] を選択します。

[承認] を選択して GitHub にサインインします。

サービス接続名 (例: GitHub への SDAF 接続) を入力します。必ず [すべてのパイプラインにアクセス許可を付与する] チェックボックスをオンにしてください。 [Save] (保存) を選択して、サービス接続を保存します。

Web アプリを設定する

自動化フレームワークでは、必要に応じて、コントロールプレーンの一部として Web アプリをプロビジョニングして、SAP ワークロードゾーンとシステムの構成ファイルを支援します。この Web アプリを使用する場合は、最初に認証のためにアプリ登録を作成する必要があります。 Azure Cloud Shell を開き、次のコマンドを実行します。

Linux
Windows

必要に応じて、MGMT をご使用の環境に置き換えます。

echo '[{"resourceAppId":"00000003-0000-0000-c000-000000000000","resourceAccess":[{"id":"e1fe6dd8-ba31-4d61-89e7-88639da4683d","type":"Scope"}]}]' >> manifest.json

TF_VAR_app_registration_app_id=$(az ad app create --display-name MGMT-webapp-registration --enable-id-token-issuance true --sign-in-audience AzureADMyOrg --required-resource-access @manifest.json --query "appId" | tr -d '"')

echo $TF_VAR_app_registration_app_id

az ad app credential reset --id $TF_VAR_app_registration_app_id --append --query "password"

rm manifest.json

必要に応じて、MGMT をご使用の環境に置き換えます。

Add-Content -Path manifest.json -Value '[{"resourceAppId":"00000003-0000-0000-c000-000000000000","resourceAccess":[{"id":"e1fe6dd8-ba31-4d61-89e7-88639da4683d","type":"Scope"}]}]'

$TF_VAR_app_registration_app_id=(az ad app create --display-name MGMT-webapp-registration --enable-id-token-issuance true --sign-in-audience AzureADMyOrg --required-resource-access .\manifest.json --query "appId").Replace('"',"")

echo $TF_VAR_app_registration_app_id

az ad app credential reset --id $TF_VAR_app_registration_app_id --append --query "password"

del manifest.json

後で使用するために、アプリ登録 ID とパスワードの値を保存します。

Azure Pipelines を作成する

Azure Pipelines は YAML ファイルとして実装されます。これらは、リポジトリ内の deploy/pipelines フォルダーに格納されます。

コントロールプレーンのデプロイパイプライン

コントロールプレーンのデプロイパイプラインを作成します。 [パイプライン] セクションで、[New Pipeline]\(新しいパイプライン\) 選択します。コードのソースとして [Azure Repos Git] を選択します。既存の Azure Pipelines YAML ファイルを使用するようにパイプラインを構成します。次の設定でパイプラインを指定します。

設定	Value
リポジトリ	"ルートリポジトリ" (プロジェクト名と同じ)
分岐	メイン
Path	`pipelines/01-deploy-control-plane.yml`
名前	コントロールプレーンのデプロイ

パイプラインを保存します。 [保存] を表示するには、[実行] の横にあるシェブロンを選択します。 [パイプライン] セクションに移動し、パイプラインを選択します。右側の省略記号メニューから [名前の変更/移動] を選択して、パイプラインの名前を「コントロールプレーンのデプロイ」に変更します。

SAP ワークロードゾーンのデプロイパイプライン

SAP ワークロードゾーンパイプラインを作成します。 [パイプライン] セクションで、[New Pipeline]\(新しいパイプライン\) 選択します。コードのソースとして [Azure Repos Git] を選択します。既存の Azure Pipelines YAML ファイルを使用するようにパイプラインを構成します。次の設定でパイプラインを指定します。

設定	Value
リポジトリ	"ルートリポジトリ" (プロジェクト名と同じ)
分岐	メイン
Path	`pipelines/02-sap-workload-zone.yml`
名前	SAP ワークロードゾーンのデプロイ

パイプラインを保存します。 [保存] を表示するには、[実行] の横にあるシェブロンを選択します。 [パイプライン] セクションに移動し、パイプラインを選択します。右側の省略記号メニューから [名前の変更/移動] を選択して、パイプラインの名前を「SAP ワークロードゾーンのデプロイ」に変更します。

SAP システムのデプロイパイプライン

SAP システムのデプロイパイプラインを作成します。 [パイプライン] セクションで、[New Pipeline]\(新しいパイプライン\) 選択します。コードのソースとして [Azure Repos Git] を選択します。既存の Azure Pipelines YAML ファイルを使用するようにパイプラインを構成します。次の設定でパイプラインを指定します。

設定	Value
リポジトリ	"ルートリポジトリ" (プロジェクト名と同じ)
分岐	メイン
Path	`pipelines/03-sap-system-deployment.yml`
名前	SAP システムのデプロイ (インフラストラクチャ)

パイプラインを保存します。 [保存] を表示するには、[実行] の横にあるシェブロンを選択します。 [パイプライン] セクションに移動し、パイプラインを選択します。右側の省略記号メニューから [名前の変更/移動] を選択して、パイプラインの名前を「SAP システムのデプロイ (インフラストラクチャ)」に変更します。

SAP ソフトウェアの取得パイプライン

SAP ソフトウェアの取得パイプラインを作成します。 [パイプライン] セクションで、[New Pipeline]\(新しいパイプライン\) 選択します。コードのソースとして [Azure Repos Git] を選択します。既存の Azure Pipelines YAML ファイルを使用するようにパイプラインを構成します。次の設定でパイプラインを指定します。

設定	Value
リポジトリ	"ルートリポジトリ" (プロジェクト名と同じ)
分岐	メイン
Path	`deploy/pipelines/04-sap-software-download.yml`
名前	SAP ソフトウェアの取得

パイプラインを保存します。 [保存] を表示するには、[実行] の横にあるシェブロンを選択します。 [パイプライン] セクションに移動し、パイプラインを選択します。右側の省略記号メニューから [名前の変更/移動] を選択して、パイプラインの名前を「SAP ソフトウェアの取得」に変更します。

SAP の構成とソフトウェアのインストールパイプライン

SAP の構成とソフトウェアのインストールパイプラインを作成します。 [パイプライン] セクションで、[New Pipeline]\(新しいパイプライン\) 選択します。コードのソースとして [Azure Repos Git] を選択します。既存の Azure Pipelines YAML ファイルを使用するようにパイプラインを構成します。次の設定でパイプラインを指定します。

設定	Value
リポジトリ	"ルートリポジトリ" (プロジェクト名と同じ)
分岐	メイン
Path	`pipelines/05-DB-and-SAP-installation.yml`
名前	SAP の構成とインストール

パイプラインを保存します。 [保存] を表示するには、[実行] の横にあるシェブロンを選択します。 [パイプライン] セクションに移動し、パイプラインを選択します。右側の省略記号メニューから [名前の変更/移動] を選択して、パイプラインの名前を「SAP の構成とソフトウェアのインストール」に変更します。

デプロイの削除パイプライン

デプロイの削除パイプラインを作成します。 [パイプライン] セクションで、[New Pipeline]\(新しいパイプライン\) 選択します。コードのソースとして [Azure Repos Git] を選択します。既存の Azure Pipelines YAML ファイルを使用するようにパイプラインを構成します。次の設定でパイプラインを指定します。

設定	Value
リポジトリ	"ルートリポジトリ" (プロジェクト名と同じ)
分岐	メイン
Path	`pipelines/10-remover-terraform.yml`
名前	デプロイの削除

パイプラインを保存します。 [保存] を表示するには、[実行] の横にあるシェブロンを選択します。 [パイプライン] セクションに移動し、パイプラインを選択します。右側の省略記号メニューから [名前の変更/移動] を選択して、パイプラインの名前を「デプロイの削除」に変更します。

コントロールプレーンの削除パイプライン

コントロールプレーンのデプロイの削除パイプラインを作成します。 [パイプライン] セクションで、[New Pipeline]\(新しいパイプライン\) 選択します。コードのソースとして [Azure Repos Git] を選択します。既存の Azure Pipelines YAML ファイルを使用するようにパイプラインを構成します。次の設定でパイプラインを指定します。

設定	Value
リポジトリ	"ルートリポジトリ" (プロジェクト名と同じ)
分岐	メイン
Path	`pipelines/12-remove-control-plane.yml`
名前	コントロールプレーンの削除

パイプラインを保存します。 [保存] を表示するには、[実行] の横にあるシェブロンを選択します。 [パイプライン] セクションに移動し、パイプラインを選択します。右側の省略記号メニューから [名前の変更/移動] を選択して、パイプラインの名前を「コントロールプレーンの削除」に変更します。

Azure Resource Manager を使用したデプロイの削除パイプライン

デプロイの削除 Azure Resource Manager パイプラインを作成します。 [パイプライン] セクションで、[New Pipeline]\(新しいパイプライン\) 選択します。コードのソースとして [Azure Repos Git] を選択します。既存の Azure Pipelines YAML ファイルを使用するようにパイプラインを構成します。次の設定でパイプラインを指定します。

設定	Value
リポジトリ	"ルートリポジトリ" (プロジェクト名と同じ)
分岐	メイン
Path	`pipelines/11-remover-arm-fallback.yml`
名前	Azure Resource Manager を使用したデプロイの削除

パイプラインを保存します。 [保存] を表示するには、[実行] の横にあるシェブロンを選択します。 [パイプライン] セクションに移動し、パイプラインを選択します。右側の省略記号メニューから [名前の変更/移動] を選択して、パイプラインの名前を「ARM プロセッサを使用したデプロイの削除」に変更します。

Note

このパイプラインは、他の方法を利用できない場合のみ使用してください。リソースグループだけを削除すると、残りの部分の再デプロイが複雑になる可能性があります。

リポジトリアップデーターパイプライン

リポジトリアップデーターパイプラインを作成します。 [パイプライン] セクションで、[New Pipeline]\(新しいパイプライン\) 選択します。コードのソースとして [Azure Repos Git] を選択します。既存の Azure Pipelines YAML ファイルを使用するようにパイプラインを構成します。次の設定でパイプラインを指定します。

設定	Value
リポジトリ	"ルートリポジトリ" (プロジェクト名と同じ)
分岐	メイン
Path	`pipelines/20-update-ado-repository.yml`
名前	リポジトリアップデーター

パイプラインを保存します。 [保存] を表示するには、[実行] の横にあるシェブロンを選択します。 [パイプライン] セクションに移動し、パイプラインを選択します。右側の省略記号メニューから [名前の変更/移動] を選択して、パイプラインの名前を「リポジトリアップデーター」に変更します。

このパイプラインは、使用する sap-automation リポジトリに更新がある場合に使用する必要があります。

Visual Studio Marketplace からクリーンアップタスクをインポートする

パイプラインでは、カスタムタスクを使用して、デプロイ後にクリーンアップアクティビティを実行します。 Post Build Cleanup からカスタムタスクをインストールできます。これは、パイプラインを実行する前に Azure DevOps 組織にインストールします。

セルフホステッドエージェントの準備

[組織の設定] に移動して、エージェントプールを作成します。 [パイプライン] セクションで、[エージェントプール]>[プールを追加する] 選択します。プールの種類として [セルフホステッド] を選択します。コントロールプレーン環境に合わせて、プールに名前を付けます。たとえば、 MGMT-WEEU-POOLを使用します。 [すべてのパイプラインへのアクセス許可を与える] が選択されていることを確認し、[作成] を選択してプールを作成します。
Azure DevOps 組織で使用する予定のユーザーアカウントでサインインします。
ホームページからユーザー設定を開き、[個人用アクセストークン] を選択します。
以下の設定で個人用アクセストークンを作成します。
- エージェントプール: [読み取り] と [管理] を選択 します。
- ビルド: [読み取り]、[実行] の順に選択 します。
- コード: [読み取りおよび書き込み] を選択します。
- 変数グループ: [読み取り]、[作成]、[管理] の順に選択 します。
  
  作成されたトークン値を書き留めます。

変数の定義

デプロイパイプラインは、変数グループを使用して定義されている事前定義済みのパラメーター値のセットを使用するように構成されます。

共通の変数

共通変数は、すべてのデプロイパイプラインで使用されます。これらは、SDAF-General という変数グループに格納されます。

[パイプライン] セクションの [ライブラリ] ページを使用して、SDAF-General という名前の新しい変数グループを作成します。次の変数を追加します。

変数	値	メモ
Deployment_Configuration_Path	ワークスペース	サンプル構成をテストするには、WORKSPACES ではなく `samples/WORKSPACES` を使用します。
分岐	メイン
S-Username	`<SAP Support user account name>`
S-Password	`<SAP Support user password>`	ロックアイコンを選択して、変数の型をシークレットに変更します。
`tf_version`	1.6.0	使用する Terraform バージョン。 Terraform のダウンロードに関する記事を参照してください。

変数を保存します。

または、Azure DevOps CLI を使用してグループを設定することもできます。

s-user="<SAP Support user account name>"
s-password="<SAP Support user password>"

az devops login

az pipelines variable-group create --name SDAF-General --variables ANSIBLE_HOST_KEY_CHECKING=false Deployment_Configuration_Path=WORKSPACES Branch=main S-Username=$s-user S-Password=$s-password tf_varsion=1.3.0 --output yaml

必ず [パイプラインのアクセス許可] を使用して、すべてのパイプラインにアクセス許可を割り当ててください。

環境固有の変数

各環境には異なるデプロイ資格情報が含まれている場合があるため、環境ごとに変数グループを作成する必要があります。たとえば、SDAF-MGMT、SDAF-DEV、および SDAF-QA を使用します。

コントロールプレーン環境用に SDAF-MGMT という名前の新しい変数グループを作成するには、[パイプライン] セクションの [ライブラリ] ページを使用します。次の変数を追加します。

変数	値	Notes
エージェント	`Azure Pipelines` またはエージェントプールの名前	このプールは、後の手順で作成します。
CP_ARM_CLIENT_ID	`Service principal application ID`
CP_ARM_OBJECT_ID	`Service principal object ID`
CP_ARM_CLIENT_SECRET	`Service principal password`	ロックアイコンを選択して、変数の型をシークレットに変更します。
CP_ARM_SUBSCRIPTION_ID	`Target subscription ID`
CP_ARM_TENANT_ID	サービスプリンシパルの `Tenant ID`
AZURE_CONNECTION_NAME	以前に作成された接続名
sap_fqdn	SAP 完全修飾ドメイン名 (例: `sap.contoso.net`)	プライベート DNS が使用されていない場合にのみ必要です。
FENCING_SPN_ID	フェンスエージェントの `Service principal application ID`	フェンスエージェントのサービスプリンシパルを使用する高可用性デプロイに必要です。
FENCING_SPN_PWD	フェンスエージェントの `Service principal password`	フェンスエージェントのサービスプリンシパルを使用する高可用性デプロイに必要です。
FENCING_SPN_TENANT	フェンスエージェントの `Service principal tenant ID`	フェンスエージェントのサービスプリンシパルを使用する高可用性デプロイに必要です。
PAT	`<Personal Access Token>`	前の手順で定義した個人用トークンを使用します。
POOL	`<Agent Pool name>`	この環境に使用するエージェントプール。

APP_REGISTRATION_APP_ID	`App registration application ID`	Web アプリをデプロイする場合は必須です。
WEB_APP_CLIENT_SECRET	`App registration password`	Web アプリをデプロイする場合は必須です。

SDAF_GENERAL_GROUP_ID	SDAF-General グループのグループ ID	ID は、ブラウザーを使用して変数グループにアクセスするときに URL パラメーター `variableGroupId` から取得できます。 (例: `variableGroupId=8`)。
WORKLOADZONE_PIPELINE_ID	`SAP workload zone deployment` パイプラインの ID	ID は、Azure DevOps のパイプラインページで URL パラメーター `definitionId` から取得できます。 (例: `definitionId=31`)。
SYSTEM_PIPELINE_ID	`SAP system deployment (infrastructure)` パイプラインの ID	ID は、Azure DevOps のパイプラインページで URL パラメーター `definitionId` から取得できます。 (例: `definitionId=32`)。

変数を保存します。

必ず [パイプラインのアクセス許可] を使用して、すべてのパイプラインにアクセス許可を割り当ててください。

Web アプリを使用する場合は、ビルドサービスに少なくとも投稿アクセス許可があることを確認します。

複製機能を使用して、次の環境変数グループを作成できます。 APP_REGISTRATION_APP_ID、WEB_APP_CLIENT_SECRET、SDAF_GENERAL_GROUP_ID、WORKLOADZONE_PIPELINE_ID、SYSTEM_PIPELINE_ID は、SDAF-MGMT グループにのみ必要です。

サービス接続を作成する

Azure リソースを削除するには、Azure Resource Manager サービス接続が必要です。詳細については、「サービス接続の管理」を参照してください。

サービス接続を作成するには、[プロジェクト設定] に移動します。 [パイプライン] セクションで [サービス接続] を選択します。

Screenshot that shows how to create a service connection.

サービス接続の種類として [Azure Resource Manager] を選択し、認証方法として [サービスプリンシパル (手動)] を選択します。ターゲットサブスクリプション (通常はコントロールプレーンサブスクリプション) を入力します。サービスプリンシパルの詳細を取得します。 [検証] を選択して資格情報を検証します。サービスプリンシパルの作成方法の詳細については、「サービスプリンシパルの作成」を参照してください。

サービス接続名を入力します (例えば Connection to MGMT subscription を使用)。必ず [すべてのパイプラインにアクセス許可を付与する] チェックボックスをオンにしてください。 [Verify and save] (確認して保存) を選択して、サービス接続を保存します。

アクセス許可

ほとんどのパイプラインは Azure Repos にファイルを追加するため、プルアクセス許可が必要です。 [プロジェクト設定] の [リポジトリ] セクションで、ソースコードリポジトリの [セキュリティ] タブを選択して、投稿アクセス許可を Build Service に割り当てます。

Screenshot that shows repository permissions.

コントロールプレーンをデプロイする

新しく作成されたパイプラインは、既定のビューに表示されない場合があります。 [最近表示したもの] タブを選択して、[All tabs]\(すべてのタブ\) に戻り、新しいパイプラインを表示します。

[Control plane deployment]\(コントロールプレーンのデプロイ\) パイプラインを選択し、デプロイ機能と SAP ライブラリの構成名を入力します。 [実行] を選択してコントロールプレーンをデプロイします。構成 Web アプリを設定する場合は、[Deploy the configuration web application]\(構成 Web アプリのデプロイ\) チェックボックスをオンにする必要があります。

Azure DevOps Services のセルフホステッドエージェントを手動で構成する

手動構成は、Azure DevOps Services エージェントが自動的に構成されていない場合にのみ必要です。続行する前に、エージェントプールが空であることを確認します。

デプロイ機能に接続するには:

Azure portal にサインインします。
デプロイ機能の仮想マシンを含むリソース・グループに移動します。
Azure Bastion を使用して仮想マシンに接続します。
既定のユーザー名は azureadm です。
[Azure Key Vault から SSH 秘密キー] を選択します。
コントロールプレーンを含むサブスクリプションを選択します。
デプロイ機能キーコンテナーを選択します。
シークレットの一覧から、-sshkey で終わるシークレットを選択します。
仮想マシンへの接続

次のスクリプトを実行して、デプロイ機能を構成します。

mkdir -p ~/Azure_SAP_Automated_Deployment

cd ~/Azure_SAP_Automated_Deployment

git clone https://github.com/Azure/sap-automation.git

cd sap-automation/deploy/scripts

./configure_deployer.sh

デプロイ機能を再起動して再接続し、次のスクリプトを実行して、Azure DevOps エージェントを設定します。

cd ~/Azure_SAP_Automated_Deployment/

$DEPLOYMENT_REPO_PATH/deploy/scripts/setup_ado.sh

ライセンスに同意し、サーバー URL の入力を求められたら、Azure DevOps プロジェクトの作成時に取得した URL を入力します。認証には [PAT] を選択し、前の手順のトークン値を入力します。

プロンプトが表示されたら、前の手順で作成したアプリケーションプール名を入力します。既定のエージェント名と既定の作業フォルダー名をそのまま使用します。これでエージェントが構成され、開始されます。

コントロールプレーン Web アプリケーションをデプロイする

コントロールプレーンのデプロイパイプラインを実行するときに deploy the web app infrastructure パラメーターを選択すると、Web アプリをホストするために必要なインフラストラクチャがプロビジョニングされます。 [Web アプリを配置します] パイプラインにより、アプリケーションのソフトウェアがそのインフラストラクチャに発行されます。

デプロイが完了するのを待機します。 [拡張機能] タブを選択し、指示に従って構成を完了します。アプリ登録の reply-url 値を更新します。

コントロールプレーンパイプラインを実行した結果、必要な Web アプリ URL の一部が、環境固有の変数グループに名前付けされた WEBAPP_URL_BASE 変数に格納されます。登録されているアプリケーション Web アプリの URL は、次のコマンドを使用していつでも更新できます。

Linux
Windows

webapp_url_base=<WEBAPP_URL_BASE>
az ad app update --id $TF_VAR_app_registration_app_id --web-home-page-url https://${webapp_url_base}.azurewebsites.net --web-redirect-uris https://${webapp_url_base}.azurewebsites.net/ https://${webapp_url_base}.azurewebsites.net/.auth/login/aad/callback

$webapp_url_base="<WEBAPP_URL_BASE>"
az ad app update --id $TF_VAR_app_registration_app_id --web-home-page-url https://${webapp_url_base}.azurewebsites.net --web-redirect-uris https://${webapp_url_base}.azurewebsites.net/ https://${webapp_url_base}.azurewebsites.net/.auth/login/aad/callback

また、アプリサービスのシステム割り当てマネージド ID に閲覧者のアクセス許可を付与する必要もあります。アプリサービスリソースに移動します。左側で [ID] を選択します。 [システムが割り当て済み] タブで、[Azure ロールの割り当て]>[ロールの割り当てを追加] を選択します。スコープとして [サブスクリプション] を選択し、ロールとして [閲覧者] を選択します。その後、 [保存] を選びます。この手順を行わないと、Web アプリのドロップダウン機能が動作しません。

これで、Web アプリにアクセスし、それを使用して SAP ワークロードゾーンと SAP システムインフラストラクチャをデプロイできるようになっています。

次のステップ

Azure DevOps ハンズオンラボ

Azure DevOps Services から SAP デプロイ自動化フレームワークを使用する

Azure DevOps Services にサインアップする

SAP デプロイ自動化フレームワーク用に Azure DevOps Services を構成する

新しいワークロード ゾーンの Azure DevOps Services 成果物を構成する

サンプルのコントロール プレーン構成を作成する