Azure DevOpsのビルドパイプラインの例

＜目次＞

Azure DevOpsのビルドパイプラインの例
　やりたいこと／概要
　 STEP0：前提条件
　 STEP1：Gitのリポジトリを用意する
　 STEP2：プロジェクトのビルド＆疎通
　 STEP3：パイプライン作成＆疎通
　 STEP4：ビルドタスクの追加
　 STEP5：Gitへのプッシュ→パイプラインの再実行
　 STEP6：ビルドした資産をAzure Pipeline内に保存

Azure DevOpsのビルドパイプラインの例

やりたいこと／概要

●やりたいこと

・Azure DevOpsのビルドパイプラインについて理解する

・ハンズオンで試してみる

●概要

・ソースコード（例：C#）をビルドしてバイナリ（例：exe）を作る。

・ビルドサーバー不要（ビルドサーバーのパッチやセキュリティアップデートだけでも大変・・）

（図１０１）

（表）

Tasks	・ビルド、テスト、展開の手順がどのように実行されるかを定義するスクリプトのようなものと
Code	・コードの変更があるとパイプラインが実行される。・パイプライン実行は自動／手動の両方が可能・パイプラインをGitHub、Bitbucket、Subversionのようなソースリポジトリに接続します。
Build Agent	・コードのビルドやデプロイを行います。・1つ以上のジョブが実行される・Azure PipelinesならMicrosoftホストエージェントを使用できる →パイプラインを実行する度に「新しくVMが生成される」。 →VMは色んな種類から選べる。Ubuntu 22.04も選択可能。 →VMは自動テストでの使用が完了したら、自動で破棄される・エージェントは「セルフホスト」も使用可能（自身でVM立てて設定＆管理するタイプ）・エージェントを束ねる「エージェントプール」を設定できる。
Artifact	・パイプラインのアウトプット・デプロイできる成果物・（例）Javaなら.jarファイル・（例）JavaScriptのライブラリ・（例）Dockerイメージ

↓

超ざっくり書くと、こんな感じです。

（図１０２）

＞目次にもどる

STEP0：前提条件

・Visual Studio Codeがインストール済

・GitHubのアカウントを保有していること

以降はこちらのトレーニングを実際に手を動かしてやってみました。

（参考）

https://learn.microsoft.com/en-us/training/modules/create-a-build-pipeline/

＞目次にもどる

STEP1：Gitのリポジトリを用意する

今回はMicrosoftが用意したリポジトリをForkします。Fork（コピー）すればで原本に影響なく、編集ができる。

STEP1-1：Microsoftの学習用リポジトリのFork

・①リポジトリにアクセス

https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web

↓

・②「Fork」

（図１１２）

↓

・③「Create Fork」

（図１１３）

STEP1-2：ForkしたリポジトリをCloneする

Cloneはローカルで作業するために、ローカルにコピーする操作のこと。

・①「Code」→HTTPSのURLをコピー

（図１２１）

↓

・②VSCodeのターミナル等で「git clone [①でコピーしたURL]」コマンドを実行

（図１２２）

↓

・③Clone完了

（図１２３）

↓

・④ディレクトリ移動

（図１２４）

＞目次にもどる

STEP2：プロジェクトのビルド＆疎通

STEP2-1：ビルド

（コマンド）

> dotnet build --configuration Release

→疎通目的なのでDebugではなくRelease

（図１３１）

（出力例）

SBuild version 17.3.2+561848881 for .NET
  復元対象のプロジェクトを決定しています...
  C:\Git\Rainbow-Engine\mslearn-tailspin-spacegame-web\Tailspin.SpaceGame.Web\Tailspin.SpaceGame.Web.csproj を復元しました (56 ms)。
  Tailspin.SpaceGame.Web -> C:\Git\Rainbow-Engine\mslearn-tailspin-spacegame-web\Tailspin.SpaceGame.Web\bin\Release\net6.0\Tailspin.SpaceGame.Web.dll
 
ビルドに成功しました。
    0 個の警告
    0 エラー
 
経過時間 00:00:05.16

↓

STEP2-2：疎通

・①実行

（コマンド）

> dotnet run --configuration Release --no-build --project Tailspin.SpaceGame.Web

（図１３２）

↓

（図１３３）

↓

・②ブラウザで確認

https://localhost:5001/

（図１３４）

STEP2-3：SSL設定

・①下記コマンドを実行

（コマンド）

> dotnet dev-certs https --trust

（図１３５）

↓

・②鍵付きになった（自己証明書が有効になった）

（図１３６）

＞目次にもどる

STEP3：パイプライン作成＆疎通

・①「New pipeline」押下

（図２１１）

↓

・②コード管理ツールを選択（例ではGitHubを選択）

（図２１２）

・③リポジトリを選択

（図２１３）

↓

（図２１４①②）

～中略～

↓

・④パイプラインの設定を選択（例では「ASP.NET Core」）

（図２１５）

↓

・⑤「Save & Run」

（図２１６）

# ASP.NET Core (.NET Framework)
# Build and test ASP.NET Core projects targeting the full .NET Framework.
# Add steps that publish symbols, save build artifacts, and more:
# https://docs.microsoft.com/azure/devops/pipelines/languages/dotnet-core
 
trigger:
- main
 
pool:
  vmImage: 'windows-latest'
 
variables:
  solution: '**/*.sln'
  buildPlatform: 'Any CPU'
  buildConfiguration: 'Release'
 
steps:
- task: NuGetToolInstaller@1
 
- task: NuGetCommand@2
  inputs:
    restoreSolution: '$(solution)'
 
- task: VSBuild@1
  inputs:
    solution: '$(solution)'
    msbuildArgs: '/p:DeployOnBuild=true /p:WebPublishMethod=Package /p:PackageAsSingleFile=true /p:SkipInvalidConfigurations=true /p:DesktopBuildPackageLocation="$(build.artifactStagingDirectory)\WebApp.zip" /p:DeployIisAppPath="Default Web Site"'
    platform: '$(buildPlatform)'
    configuration: '$(buildConfiguration)'
 
- task: VSTest@2
  inputs:
    platform: '$(buildPlatform)'
    configuration: '$(buildConfiguration)'

↓

・⑥「Save & Run」

（図２１７）

↓

・⑦結果確認

（図２１８）

＞目次にもどる

STEP4：ビルドタスクの追加

STEP4-1：ブランチ作成

・①最新の変更を取得

（コマンド）

> git pull origin main

（図３１１）

↓

・②YAMLファイルなど追加されている

（図３１２）

STEP4-2：azure-pipelines.yml修正

・①ブランチ変更

（コマンド）

> git checkout -B build-pipeline

（図３２１）

・②「azure-pipelines.yml」を修正

（サンプルプログラム）

trigger:
- '*'
 
pool:
  vmImage: ubuntu-latest
 
variables:
  buildConfiguration: 'Release'
 
steps:
- task: UseDotNet@2
  displayName: 'Use .NET SDK 6.x'
  inputs:
    packageType: sdk
    version: '6.x'
 
- task: Npm@1
  displayName: 'Run npm install'
  inputs:
    verbose: false
 
- script: './node_modules/.bin/node-sass Tailspin.SpaceGame.Web/wwwroot --output Tailspin.SpaceGame.Web/wwwroot'
  displayName: 'Compile Sass assets'
 
- task: gulp@1
  displayName: 'Run gulp tasks'
 
- script: 'echo "$(Build.DefinitionName), $(Build.BuildId), $(Build.BuildNumber)" > buildinfo.txt'
  displayName: 'Write build info'
  workingDirectory: Tailspin.SpaceGame.Web/wwwroot
 
- task: DotNetCoreCLI@2
  displayName: 'Restore project dependencies'
  inputs:
    command: 'restore'
    projects: '**/*.csproj'
 
- task: DotNetCoreCLI@2
  displayName: 'Build the project - Release'
  inputs:
    command: 'build'
    arguments: '--no-restore --configuration Release'
    projects: '**/*.csproj'

（図３２２）コンパイルなど追記している

（図３２３）

＞目次にもどる

STEP5：Gitへのプッシュ→パイプラインの再実行

・①修正をプッシュ

（図４１１）

↓

・②パイプラインが実行された

（図４１２）

↓

・③先ほどと処理内容が変わっている（gulp@1でJavaScript圧縮したり）

（図４１３）

＞目次にもどる

STEP6：ビルドした資産をAzure Pipeline内に保存

・ここまで来たら、Space Game Webプロジェクトをパイプライン経由でビルドできる。

・ただ、現状ビルドした資産は一時サーバーに残るのみ。

→他の方が利用できるよう、資産をデプロイするor固めて共有するなど必要。

STEP6-1：「.zip」形式で固めるよう「.yml」を修正

（サンプルプログラム）

trigger:
- '*'
 
pool:
  vmImage: ubuntu-latest
 
steps:
- task: UseDotNet@2
  displayName: 'Use .NET SDK 6.x'
  inputs:
    version: '6.x'
 
- task: Npm@1
  displayName: 'Run npm install'
  inputs:
    verbose: false
 
- script: './node_modules/.bin/node-sass Tailspin.SpaceGame.Web/wwwroot --output Tailspin.SpaceGame.Web/wwwroot'
  displayName: 'Compile Sass assets'
 
- task: gulp@1
  displayName: 'Run gulp tasks'
 
- script: 'echo "$(Build.DefinitionName), $(Build.BuildId), $(Build.BuildNumber)" > buildinfo.txt'
  displayName: 'Write build info'
  workingDirectory: Tailspin.SpaceGame.Web/wwwroot
 
- task: DotNetCoreCLI@2
  displayName: 'Restore project dependencies'
  inputs:
    command: 'restore'
    projects: '**/*.csproj'
 
- task: DotNetCoreCLI@2
  displayName: 'Build the project - Release'
  inputs:
    command: 'build'
    arguments: '--no-restore --configuration Release'
    projects: '**/*.csproj'
 
- task: DotNetCoreCLI@2 displayName: 'Publish the project - Release' inputs: command: 'publish' projects: '**/*.csproj' publishWebProjects: false arguments: '--no-build --configuration Release --output $(Build.ArtifactStagingDirectory)/Release' zipAfterPublish: true - task: PublishBuildArtifacts@1 displayName: 'Publish Artifact: drop' condition: succeeded()

（図５１１）

（図５１２）

追加処理概要

・アプリのビルド結果をパッケージ化（zipファイル化）

・Azure Pipeline上にビルド結果を配置する

STEP6-2：Gitへのプッシュ

・①Gitへのコミット→プッシュ

> git add azure-pipelines.yml
> git commit -m "Add publish tasks"
> git push origin build-pipeline

（図５１３）

↓

・②パイプラインが再び自動実行される

（図５１４）

STEP6-3：結果確認

・①「1 published」になっているはず

（図５１５）

↓

・②ビルド資産と依存関係を含むzipが格納されている

（図５１６）

↓

（図５１７）

＞目次にもどる