AzureDevOpsで作るHoloLensアプリCI環境

【Azure DevOps で作る】
Microsoft HoloLens アプリ CI 環境
株式会社ネクストスケープ酒井辰也
Global Azure BOOTCAMP 2019

自己紹介
酒井辰也（@saka_it）
株式会社ネクストスケープ
• 2015/07～ネクストスケープ入社
• Web系システムをメインにやっていました
• 2017/05～ xRアプリ開発をやってます
• HoloLensとARアプリ開発をやっています
• Azure もくもく会@新宿開催しています
• 次回は05月15日（水）19:00～
• 平成最後の年おじさんになりました

弊社 HoloLens チームのCI/CD環境
Azure DevOps
Repos
Azure DevOps
Pipelines
Azure VM
(Unity・VS)
Azure
Blob Storage
・Git ソース管理
・ブランチ戦略としてGitLab Flowを採用
・CI/CD全体を管理
・masterブランチをトリガーにビルド開始
・Unity/UWPビルドの都合により、
VMを使用してビルド
・成果物をバージョン毎に管理
・アプリを利用してHoloLensへインストール

やること
• ビルドサーバーを構築する
• Azure DevOps にSelf-Hosted-Agentとして登録する
• Pipeline(YAML)を作成する
• ビルドを確認する

なぜ、ビルドサーバーが必要なのか？
• Azure DevOps Pipeline には二つのAgentsがある
• Microsoft-hosted agents
• 予め用意されているビルド環境
• 一定時間無料＋追加時間課金で利用できる
• 対応していれば、簡単に利用可能
• Self-hosted agents
• 自前で用意したビルド環境を利用する
• ビルド環境の運用コスト＋ Agent 単位の課金（無料枠有）で利用できる
• 環境構築が必要だが、カスタマイズしたビルド環境を利用可能
• Unity 対応のビルド環境はないので、Self-hosted を使用

【VM】ビルドサーバーを作成する
• 今回は Azure 上に VM 作成
• OS は Windows Server 2016
• UWP ビルドの都合
• 地域はどこでも OK
• 今回は、MSDN 利用の都合で
「米国西部 2」を使用
• なお、オンプレサーバーなどを
使うこともできます

【VM】ビルドサーバーにアプリをインストールする
• 通常の HoloLens アプリが
ビルドできるように構築
• Visual Studio
• Unity
• Unity をコマンド実行するため
UnityBuildRunner を導入
• guitarrapc さん作成のツール
• dotnet tool コマンドを使用して
インストール

【DevOps】トークンを作成する
• 右上のユーザーメニューから
「Security」を選択
• 「Personal Access Tokens」の
「New Token」をクリック

【DevOps】トークンを作成する
• Name を入力して、Scopesの
Show all scopes をクリックし、
下記にチェックを入れる
• Agent Pools：Read & manage
• Deployment Groupes：
Read & manage
• 作成後表示されるトークンを
コピーしておく
• 再表示できないので注意！

【DevOps】Agent を作成する
• 「Project settings」から
「Agent pools」を選択
• 「Default」を選択

• 右上の「New agent」をクリック

• 右上の「New agent」をクリック
• 追加手順が表示される
• Download から Agent を
ダウンロードし、zipファイルを
サーバーにコピーする

【VM】Agent をインストールする
• コピーしたファイルを
適当なディレクトリに解凍する
• PowerShell で開き、
下記コマンドを実行する
• 画面の指示通り入力していく
• 設定が完了したら、
下記コマンドで実行する
> .¥config
> .¥run

【VM】Agent をインストールする
https://dev.azure.com/{プロジェクト名}/
トークン文字列
サービス登録・
自動起動をするか？
（今回は手動起動）
Agentを起動

【DevOps】Agent の登録を確認
• Azure DevOps に戻り、
「Default」のAgent pool を開く
• Agents を開く
• 先ほど追加した Agent が
追加されていることを確認する

【DevOps】Pipeline（YAML）を作成する
• Pipeline → Builds を開く
• 「New pipeline」をクリック

• コードのあるサービスを選択
（今回は Repos を使用）

• 対象のリポジトリを選択

• 「Starter pipeline」を選択

• 「Starter pipeline」を選択
• Pipeline YAMLが表示される

【DevOps】Pipeline（YAML）をカスタマイズする（1/5）
pool:
name: 'Default'
trigger:
- master
variables:
UnityPath: 'C:¥Program Files¥Unity¥Editor¥Unity.exe'
UWPSolution: 'UWP¥LAB-HoloLens-CI.sln'
BuildConfiguration: 'release'
UWPAppPackages: 'UWP¥LAB-HoloLens-CI¥AppPackages¥'
使用する Agent pool 名
トリガーとなるブランチ名
ビルド用の変数定義
環境に応じて、
変更する

steps:
- task: DeleteFiles@1
displayName: 'Delete files'
inputs:
Contents: '.¥UWP'
- script: 'UnityBuildRunner -UnityPath "$(UnityPath)" -quit -buildTarget
"WindowsStoreApps" -batchmode -projectPath "$(Build.Repository.LocalPath)" -logfile
"log.log" -executeMethod HoloToolkit.Unity.HoloToolkitCommands.BuildSLN'
displayName: 'Run Unity Build'
Unity ビルド実行部分
（コマンドは1行です）

- task: NuGetToolInstaller@0
displayName: 'Use Nuget'
inputs:
versionSpec: '4.3.0'
- task: NuGetCommand@2
displayName: 'NuGet Restore'
inputs:
restoreSolution: '$(UWPSolution)'
UWP プロジェクトの
NuGet リストア

- task: VSBuild@1
displayName: 'Build solution'
inputs:
solution: '$(UWPSolution)'
msbuildArgs: '/p:AppxBundle=Always;AppxBundlePlatforms="x86"'
platform: 'x86'
configuration: '$(BuildConfiguration)'
clean: true
UWP ビルド実行部分

- task: CopyFiles@2
displayName: 'Copy files'
inputs:
sourceFolder: '$(UWPAppPackages)'
contents: |
**¥*.appxbundle
**¥Dependencies¥x86¥*.appx
targetFolder: '$(Build.BinariesDirectory)'
- task: ArchiveFiles@2
displayName: 'Archive'
inputs:
rootFolderOrFile: '$(Build.BinariesDirectory)'
includeRootFolder: false
archiveFile: '$(Build.ArtifactStagingDirectory)/artifact.zip'
- task: PublishBuildArtifacts@1
displayName: 'Publish Build Artifacts'
inputs:
pathtoPublish: '$(Build.ArtifactStagingDirectory)'
ビルド結果をアーカイブして、
パブリッシュ

【DevOps】Pipeline（YAML）をカスタマイズする（全部）
pool:
name: 'Default'
trigger:
- master
variables:
UnityPath: 'C:¥Program Files¥Unity¥Editor¥Unity.exe'
UWPSolution: 'UWP¥LAB-HoloLens-CI.sln'
BuildConfiguration: 'release'
UWPAppPackages: 'UWP¥LAB-HoloLens-CI¥AppPackages¥'
steps:
- task: DeleteFiles@1
displayName: 'Delete files'
inputs:
Contents: '.¥UWP'
- script: 'UnityBuildRunner -UnityPath "$(UnityPath)" -quit -buildTarget "WindowsStoreApps" -batchmode -projectPath "$(Build.Repository.LocalPath)" -logfile "log.log" -executeMethod HoloToolkit.Unity.HoloToolkitCommands.BuildSLN'
displayName: 'Run Unity Build'
- task: NuGetToolInstaller@0
displayName: 'Use Nuget'
inputs:
versionSpec: '4.3.0'
- task: NuGetCommand@2
displayName: 'NuGet Restore'
inputs:
restoreSolution: '$(UWPSolution)'
- task: VSBuild@1
displayName: 'Build solution'
inputs:
solution: '$(UWPSolution)'
msbuildArgs: '/p:AppxBundle=Always;AppxBundlePlatforms="x86"'
platform: 'x86'
configuration: '$(BuildConfiguration)'
clean: true
- task: CopyFiles@2
displayName: 'Copy files'
inputs:
sourceFolder: '$(UWPAppPackages)'
contents: |
**¥*.appxbundle
**¥Dependencies¥x86¥*.appx
targetFolder: '$(Build.BinariesDirectory)'
- task: ArchiveFiles@2
displayName: 'Archive'
inputs:
rootFolderOrFile: '$(Build.BinariesDirectory)'
includeRootFolder: false
archiveFile: '$(Build.ArtifactStagingDirectory)/artifact.zip'
- task: PublishBuildArtifacts@1
displayName: 'Publish Build Artifacts'
inputs:
pathtoPublish: '$(Build.ArtifactStagingDirectory)'

【DevOps】Pipeline（YAML）を保存する
• 右上の「Save and Run」を
クリックする
• コミットするため、ダイアログが
出てくるので適宜入力
• master ブランチに直接の他
別ブランチを作成することも可能
• 入力したら、「Save and run」
をクリックする

【DevOps】ビルド動作を確認する
• （表示されていなければ）
Pipeline → Builds を開く
• 最新のビルドを選択

• 成功していれば
• 緑チェックが付く

• 成功していれば
• 緑チェックが付く
• 失敗していれば
• 赤バツが付く
• ジョブをクリックで詳細を確認

【DevOps】ビルド結果をダウンロードする
• 成功すれば右上の
「Artifacts」→「drop」から
成果物をダウンロード可能

• 成果物が表示されるので
対象の「Download」を選択

• 成果物が表示されるので
対象の「Download」を選択
• このように成果物を確認可能
• 通常は、この後に Releases で
CD を設定して、適当な場所へ
デプロイします

やったこと
• ビルドサーバーを構築する
• Azure DevOps にSelf-Hosted-Agentとして登録する
• Pipeline(YAML)を作成する
• ビルドを確認する

AzureDevOpsで作るHoloLensアプリCI環境

Recommended

Recommended

More Related Content

What's hot

What's hot (20)

Similar to AzureDevOpsで作るHoloLensアプリCI環境

Similar to AzureDevOpsで作るHoloLensアプリCI環境 (20)

More from Tatsuya Sakai

More from Tatsuya Sakai (13)

Recently uploaded

Recently uploaded (14)

AzureDevOpsで作るHoloLensアプリCI環境