azure-pipelines.md

Azure Pipelines でのビルド

• Azure Pipelines でのビルド
  • Azure Pipelines の利用開始方法
    • 単にサクラエディタ用のプロジェクトに読み取りアクセスする場合
    • Azure Pipelines にアカウントがない場合
    • Azure Pipelines にアカウントがある場合
  • 参考情報
  • 参考サイト
  • Azure Pipelines の設定ファイルの構成
  • Azure Pipelines の template ファイルの命名規則
  • Azure Pipelines のJOB の構成
  • Azure Pipelines の TIPS
    • step または JOB の実行条件
  • CI Buildおよびローカルビルドの環境変数

Azure Pipelines の利用開始方法

Azure Pipelines では Microsoft アカウントでログインします。 public リポジトリに読み取りアクセスするだけではアカウントもログインも不要です。

単にサクラエディタ用のプロジェクトに読み取りアクセスする場合

https://dev.azure.com/sakuraeditor/sakura にアクセスして、Pipelines のリンクをクリックします。

Azure Pipelines にアカウントがない場合

https://azure.microsoft.com/ja-jp/services/devops/pipelines/ にアクセスして Pipelines の使用を無料で開始する のリンクをクリックします。

Azure Pipelines にアカウントがある場合

https://azure.microsoft.com/ja-jp/services/devops/pipelines/ にアクセスして Azure DevOps にサイン のリンクをクリックします。

参考情報

• Wiki: Azure Pipelinesメモ

参考サイト

• What is Azure Pipelines?
• Key concepts for new Azure Pipelines users
• Sign up for Azure Pipelines
• YAML schema reference
• Predefined build variables
• Job and step templates
• Build pipeline triggers

Azure Pipelines の設定ファイルの構成

• azure-pipelines.yml 最上位の設定ファイル
  • ci/azure-pipelines/template.job.build-unittest.yml sakura editor 本体のビルド、HTML ヘルプのビルド、インストーラのビルド、単体テストのビルド、実行
    • ci/azure-pipelines/template.steps.install-python-modules.yml 必要な python モジュールのインストール
  • ci/azure-pipelines/template.job.SonarQube.yml SonarQube での解析
  • ci/azure-pipelines/template.job.checkEncoding.yml 文字コードの確認
  • ci/azure-pipelines/template.job.cppcheck.yml cppcheck の実行
  • ci/azure-pipelines/template.job.doxygen.yml doxygen の実行
    • ci/azure-pipelines/template.steps.install-python-modules.yml 必要な python モジュールのインストール

Azure Pipelines の template ファイルの命名規則

JOB 名	説明	ドキュメント
template.job.***.yml	job を定義する template	Job reuse
template.steps.***.yml	steps を定義する template	Step re-use

Azure Pipelines のJOB の構成

JOB 名	説明	job を定義する template
VS2017	サクラエディタのビルドを行う	ci/azure-pipelines/template.job.build-unittest.yml
SonarQube	SonarQube での解析を行う	ci/azure-pipelines/template.job.SonarQube.yml
cppcheck	cppcheck を行う	ci/azure-pipelines/template.job.cppcheck.yml
doxygen	doxygen を行う	ci/azure-pipelines/template.job.doxygen.yml
checkEncoding	文字コードのチェックを行う	ci/azure-pipelines/template.job.checkEncoding.yml
script_check	python のコンパイルのチェックを行う	ci/azure-pipelines/template.job.python-check.yml

Azure Pipelines の TIPS

step または JOB の実行条件

googletest でテストを実施するにあたって、googletest のテスト結果にかからわず、テスト結果の公開を行いたい。(参考: #837 )

Specify conditions で説明されているように condition を指定することで指定した JOB または step を 実行する条件を指定することができる。

以下の例では succeededOrFailed() を指定しているので、前段の step が成功しても、失敗しても実行される。(ただし JOB がキャンセルされたときには実行しない)

  - task: CopyFiles@1
    condition: succeededOrFailed()
    displayName: Copy to ArtifactStagingDirectory
    inputs:
      contents: '**.zip'
      targetFolder: $(Build.ArtifactStagingDirectory)

CI Buildおよびローカルビルドの環境変数

CI でのビルド を参照