勉強会で発表した資料。 https://sciencepark.connpass.com/event/140913/

1. SphinxのCI：Azure DevOpsでのビルド結果を、認証付きAzure App Service
に公開するところまで
サイエンスパーク株式会社 須藤圭太
1

2. • ID：suusanex（ connpass・Twitter・GitHub共通）
• 名前：須藤圭太
• サイエンスパーク株式会社という独立系ソフトウェアベンダーに所属
• 4年ほど受託開発で、上流から下流まで全部を回す
• ここ6年ほどは、自社製品開発を担当
勉強会、今後も開いていきます。
https://sciencepark.connpass.com/
自己紹介
2

3. • Sphinx＋PlantUMLで、UML図入りの仕様書がテキストで書ける
• とても便利なので、皆で使おう！
• ところが・・・
• 環境構築で結構躓くので、対策を考えてみました
• 構築済みのコンテナを用意し、各自がDockerでビルド
前回の話
3

4. Sphinx(md + PlantUML)の簡単な例
4

5. • コンテナでビルドできたので、CIしてみよう
• Azure DevOps(Pipelines)のホストで実行
• ビルド結果をzipでDLしたり、Webサイトで公開したりします
今回の話
5

6. コンテナをAzure Container Registryにアップロード
ドキュメントをAzure DevOpsのgitリポジトリへpush
6
Azure

7. Azure Pipelinesで実行
Hosted Agent(Linux)
コンテナを使ったビルドが成功
7
Azure

8. Pipelinesのスクリプトはこんな感じ
8
Azure
pool:
vmImage: 'ubuntu-16.04'
container:
image: sphinxtest1.azurecr.io/sphinx:mpecustom
endpoint: sphinxtest1.azurecr.io
steps:
- script: |
cd Doc
make html
displayName: 'sphinx build html'

9. Azure PipelinesからContainer Registryにアクセスできるように、認証情報を追加する必要が
ある
9
ポイント1

10. Azure PipelinesからContainer Registryにアクセスできるように、認証情報を追加する必要が
ある
10
ポイント1

11. • ビルドしたドキュメントが取り残さ
れている・・・
• オンプレのAgentなら良いが、
Hostedを使うなら成果物を取り出す
処理が必要
11
ポイント2

12. • Azureのホストを使ってSphinxドキュメントをビルドできるようになった
• pushするたびにビルドするようなCIも可能になった
• 次は成果物を取り出せるようにする
前半まとめ
12

13. とりあえずzipでDLできるようにする
Artifactにアップロードして、Web画面から
DL
13
Zipでの成果物ダウンロード

14. 14
Zipでの成果物ダウンロード
- task: PublishBuildArtifacts@1
inputs:
pathtoPublish: 'Doc/_build/html'
artifactName: SphinxHtmlOutput

15. • HTMLなので、zipではなくWebから直接
見れるようにする
• しかし、インターネットに全公開は避
けたいので、認証を付けたい
15
Webサイトで直接見れるようにする

16. • Azure AppServicesのEasyAuthで手軽に行
けた
• 簡易と詳細がある
• 通常は簡易で十分
• 詳細の場合は、Azure ADの設定で「ID
トークン」をONにしないと、認証失
敗する（静的HTMLだから？）
16
Webサイトで直接見れるようにする

17. 17
Webサイトで直接見れるようにする
- task: AzureRMWebAppDeployment@4
displayName: Azure App Service Deploy
inputs:
appType: webApp
ConnectedServiceName: '＜Azureとの接続
の名前＞'
WebAppName: 'azureappserviceauthtest1'
Package: 'Doc/_build/html/'

18. • 常に最新版を、認証付きのWeb公開までできるようになった
• zipでとりあえずDLといった運用も可能
• Sphinxのビルド問題がだいぶ片付いた
• 便利！
まとめ
18

19. SP1909-E07-01