SphinxのCIの続き Azure DevOpsでのビルド結果を、認証付きAzure App Serviceに公開するところまで
- 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
- 5. • コンテナでビルドできたので、CIしてみよう • Azure DevOps(Pipelines)のホストで実行 • ビルド結果をzipでDLしたり、Webサイトで公開したりします 今回の話 5
- 6. コンテナをAzure Container Registryにアップロード ドキュメントをAzure DevOpsのgitリポジトリへpush 6 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'
- 12. • Azureのホストを使ってSphinxドキュメントをビルドできるようになった • pushするたびにビルドするようなCIも可能になった • 次は成果物を取り出せるようにする 前半まとめ 12
- 14. 14 Zipでの成果物ダウンロード - task: PublishBuildArtifacts@1 inputs: pathtoPublish: 'Doc/_build/html' artifactName: SphinxHtmlOutput
- 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