1. はじめに
1-1 ご挨拶
初めまして、井村と申します。
Azure Pipelinesを用いてストレージアカウントを自動デプロイしてみました。
Azure PipelinesはAzure DevOpsのCI/CDサービス、ストレージアカウントはオブジェクト、ファイル等の各種ストレージを管理するサービスです。
実際に触って色々と気づいた部分がありましたので備忘録として残します。
参考記事はこちらになりますので興味がある方は是非チェックしてみてください。
1-2 対象読者
- Azureに興味がある
- Bicepに興味がある
- Azure Pipelinesに興味がる
1-3 ローカル環境について
私はWindows端末に以下をインストールました。
初回はAzure、AzureDevOpsそれぞれでサインアップが必要になります。
2. 各サービスおよび検証の流れ
2-1 全体像
今回作成する環境は以下になります。
- Azure ReposとはAzureDevOpsの1つサービスでリポジトリの役目をします。
- Azure PipelinesとはAzureDevOpsの1つサービスでCI/CDの役目をします。
- Storage AccountとはAzureの1つサービスで各ストレージをまとめるサービスです。
- blob storageとはオブジェクトストレージを格納するサービスです。
- file sharesとはファイル共有サービスです。
2-2 検証の流れ
ローカル環境で2ファイル作成します。1つ目がStorage Accountを作成するためのBicepファイルです。2つ目はAzure Pipelinesの定義を記載するYAMLファイルです。
2ファイルを格納するためリポジトリはAzure Reposを利用します。Azure PipelinesはAzure Repos上のBicepファイルを読み込んで、Azure上にStorage Accountを作成します。
まずは上記方法でStorage Accountとblob storageを作成します。
次に同様の流れでローカル環境でfile shareの記述をBicepファイルに追記、Azure Reposにプッシュします。Azure PipelinesがAzure Reposが更新されたタイミングでBicepファイルを読み込み自動デプロイするか確認します。
3. 構築
3-1 Azure DevOpsの組織、プロジェクトの作成
Azure DevOpsを利用するには組織を作成します。会社名や部署名等わかりやすい名前を記入します。今回は「test20230221」です。
組織を作成後、プロジェクトを作成します。組織内で複数のプロジェクトを作成すると思いますのでわかりやすい名前を記入します。今回は「test-project」です。
3-2 Azure Repos、Git環境の作成
今回の作業用フォルダとしてデスクトップ上に「AzureDevOps」フォルダを作成します。
左ペインにAzureDevOpsの各種サービスが並んでいます。Azure Repos → Fileです。
「Clone in VS Code」を選択します。
ポップアップが表示されたら「Open Visual Studio Code」をクリックします。
Visual Studio Codeが開いたらポップアップが表示されます。「開く」をクリックします。
作業用フォルダを「リポジトリの宛先として選択」をクリックします。
下記ポップアップが表示されたら「開く」をクリックします。
下記画面のようにgit環境がクローンされました。
3-3 Azure環境の作成
Azure上にリソースグループを作成するため、下記コマンドを実行します。
az login
az group create --name rg-hawk --location japaneast
以下画像のようにAzure上にリソースグループが作成されます。
3-4 Azure Pipelinesのサービス接続の作成
Azure Pipelines でサービス接続を作成するとAzure上にサービス プリンシパルが自動的に作成されます。また、リソースグループの共同作成者権限がサービス プリンシパルに付与されます。よってストレージアカウントを作成できるようになります。
Azure DevOpsの「Project settings」からPipelines → Service connectiosです。
「Create service connection」をクリックします。
Azure Resource Managerを選んで「Next」をクリックします。
Service principal(automatic)を選んで「Next」をクリックします。
下記画面ではマスクしていますがSubscriptionはご自身のAzureのサブスクリプションを選択します。作成したリソースグループを選択します。Service connection nameもわかりやすい値を入力します。Securityにチェックを入れて「Save」をクリックします。
Azure Pipelines上にサービス接続が作成されました。
Azure上にサービスプリンシパルが作成されました。
リソースグループの権限設定を確認すると作成したサービスプリンシパルが共同作成者権限を付与されています。
3-5 Bicepファイル、YAMLファイルの作成
ローカルリポジトリ内に「deploy」フォルダを作成し、今回利用するBicepファイル、YAMLファイルを格納します。
AzureDevOps
└── test-project
└── deploy
├── main.bicep
└── azure-pipelines.yml
今回利用するYAMLファイルは以下になります。
azure-pipelines.yml
1 trigger:
2 batch: true
3 branches:
4 include:
5 - main
6
7 pool:
8 vmImage: ubuntu-latest
9
10 variables:
11 - name: deploymentDefaultLocation
12 value: japaneast
13
14 jobs:
15 - job:
16 steps:
17 - task: AzureResourceManagerTemplateDeployment@3
18 inputs:
19 connectedServiceName: $(ServiceConnectionName)
20 location: $(DeploymentDefaultLocation)
21 resourceGroupName: $(ResourceGroupName)
22 csmFile: deploy/main.bicep
1行目のtriggerはAzure Pipelinesを実行するタイミングを指示するために利用します。手動、スケジュール起動等あります。今回はブランチトリガーを利用します。3行目でブランチトリガーを指定し5行目のmainブランチに変更があるとパイプラインが起動する処理となります。
7行目のpoolとはAzure Pipelinesの実行環境になります。今回はMSが提供する"Microsoft ホステッドエージェント"を使用します。このエージェントはAzure Pipelinesが実行されると自動起動され完了するとエージェントは自動的に削除されます。今回はUbuntuを利用していますが他にも色々な実行環境があり、自前で準備した実行環境である"セルフホステッドエージェント"も利用できます。
10行目のvariablesはYAMLファイルで利用する変数になります。後述説明するlocationで利用します。
14行目のjobsは各jobをグループ化します。
15行目のjobは1つのエージェントで実行されます。
16行目のstepsは17行目taskまたは今回利用はしませんがscriptからなるパイプラインの最小の構成要素です。
パイプラインのコンポーネントはこちらに詳しく説明があります。
17行目のtaskはパイプラインで自動化を定義するための構成要素です。taskは様々な種類がありますが"AzureResourceManagerTemplateDeployment@3"はARMテンプレートをデプロイするために利用します。
19行目のconnectedServiceNameはサービス接続を指定します。後述でブラウザから値を入力します。
20行目のlocationはリソースグループ作成に利用される必須の変数になります。事前に作成しているので今回は利用されません。
21行目のresourceGroupNameはリソースグループ名を指定します。後述でブラウザから値を入力します。
22行目のcsmFileは今回利用するBicepファイルを指定します。
今回利用するBicepファイルは以下になります。
main.bicep
1 @description('Storage Account type')
2 @allowed([
3 'Premium_LRS'
4 'Premium_ZRS'
5 'Standard_GRS'
6 'Standard_GZRS'
7 'Standard_LRS'
8 'Standard_RAGRS'
9 'Standard_RAGZRS'
10 'Standard_ZRS'
11 ])
12 param storageAccountType string = 'Standard_LRS'
13
14 @description('The storage account location.')
15 param location string = resourceGroup().location
16
17 @description('system code')
18 param systemCode string = 'hawk'
19
20 // create storage account
21 resource sa 'Microsoft.Storage/storageAccounts@2022-09-01' = {
22 name: 'st${systemCode}${uniqueString(resourceGroup().id)}'
23 location: location
24 sku: {
25 name: storageAccountType
26 }
27 kind: 'StorageV2'
28 properties: {}
29 }
30
31 // create blob container
32 resource container 'Microsoft.Storage/storageAccounts/blobServices/containers@2022-05-01' = {
33 name: '${sa.name}/default/blob-${systemCode}'
34 }
35
36 // create file share
37 // resource share 'Microsoft.Storage/storageAccounts/fileServices/shares@2022-09-01' = {
38 // name: '${sa.name}/default/share-${systemCode}'
39 // }
1～19行目まではパラメーターを格納しています。
21行目のresourceはストレージアカウントを作成します。
32行目のresourceはblobストレージを作成します。
37行目のresourceはfile shareを作成します。現在はコメントアウトしています。
3-6 Azure Reposへプッシュ
それでは各ファイルをプッシュします。
git add .
git commit -m "initial commit"
git push
Azure Repos → Fileを確認するとdeployフォルダ内に各ファイルがプッシュされていることが確認できます。
3-7 Azure Piplelinesの構築
それではAzure Pipelinesを構築します。Pipelines → Pipelinesから「Create Pipeline」をクリックします。
Connectタブでは「Azure Repos Git」をクリックします。
Selectタブでは「test-project」をクリックします。
Configureタブでは「Existing Azure Pipelines YAML file」をクリックします。
Pathは先ほどプッシュしたYAMLファイルを選択し「Continue」をクリックします。
変数の値を入力するため「Variables」をクリックします。
「New variable」をクリックします。
NameをYAMLファイルで記述した「ServiceConnectionName」にします。Valueは3-4 Azure Pipelinesのサービス接続の作成で作成した値を入力します。「OK」をクリックします。
同様にNameを「ResourceGroupName」、Valueをリソースグループ名を記述します。
変数を設定したら「Save」をクリックします。
それではAzure Pipelinesを実行します。「Run」をクリックします。
想定通りエラーがでました。公式ドキュメントには以下の記載があります。
Azure DevOps 組織でパイプラインを初めて使用する場合は、次のエラーが表示されることがあります。
No hosted parallelism has been purchased or granted. (ホステッド並列処理が購入も許可もされていません。)
誤用を防ぐために、Azure DevOps では、新しい組織が Microsoft ホステッド パイプライン エージェントを無料で使用する前に、承認される必要があります。
パイプラインエージェントが利用できるようこちらのフォームに依頼をします。
数日後以下メールが届きますので、再度実行を試します。
3-8 Azure Piplelinesの実行
それではAzure Pipelinesを実行します。「Run pipeline」をクリックします。
「Run」をクリックします。
デプロイが完了しました。StatusがSuccessになっています。
Storage Accountおよびblob storageが作成されました。
file sharesはまだないですね。それでは次章の自動デプロイ検証を行いましょう。
4. 検証
4-1 Bicepファイルの更新
それではAzure Pipelinesが自動デプロイするか検証します。3-5 Bicepファイル、YAMLファイルの作成にて作成したBicepファイルのコメントアウトを外し保存します。
main.bicep
1 @description('Storage Account type')
// 省略
35
36 // create file share
37 resource share 'Microsoft.Storage/storageAccounts/fileServices/shares@2022-09-01' = {
38 name: '${sa.name}/default/share-${systemCode}'
39 }
4-2 Azure Reposへプッシュ
3-6 Azure Reposへプッシュと同様にプッシュします。
git add .
git commit -m "add file shares"
git push
4-3 Azure Pipelinesの確認
プッシュ後しばらくすると更新があります。
確認するとAzure Pipelinesが実行されています。
完了しました。
Storage Account内にてfile shareが作成されていることが確認できます。
以上で検証は終わりです。
5. 終わりに
本記事を最後まで読んで頂きましてありがとうございます。
DevOpsの資格勉強をしていたのですが、実際に触らないとわからないので触ってみました。他にもAzure DevOpsサービスはありますので引き続き試したいと思います。