次の方法で共有


Azure DevOps を使用して Stream Analytics ジョブの CI/CD パイプラインを作成する

この記事では、Azure Stream Analytics CI/CD ツールを使用して、Azure DevOps のビルド パイプラインとリリース パイプラインを作成する方法について説明します。

Stream Analytics プロジェクトをコミットする

開始する前に、Stream Analytics プロジェクトをソース ファイルとして Azure DevOps リポジトリにコミットします。 このサンプル リポジトリStream Analytics プロジェクト ソース コードを Azure Pipelines で参照できます。

この記事の手順では、Stream Analytics Visual Studio Code プロジェクトを使用します。 Visual Studio プロジェクトを使用している場合は、「CI/CD ツールを使用して Azure Stream Analytics ジョブのビルド、テスト、デプロイを自動化する」の手順に従ってください。

ビルド パイプラインを作成する

このセクションでは、ビルド パイプラインを作成する方法について説明します。

  1. Web ブラウザーを開き、Azure DevOps で目的のプロジェクトに移動します。

  2. 左側のナビゲーション メニューの [パイプライン] で、[ビルド] を選択します。 [新しいパイプライン] を選択します。

    Create new Azure Pipeline

  3. [従来のエディターを使用する] を選択して、YAML なしでパイプラインを作成します。

  4. ソースの種類、チーム プロジェクト、リポジトリを選択します。 その後、 [続行] を選択します。

    Select Azure Stream Analytics project

  5. [テンプレートの選択] ページで、[空のジョブ] を選択します。

npm パッケージをインストールする

  1. [タスク] ページで、[Agent job 1](エージェントジョブ 1) の横にあるプラス記号を選択します。 タスク検索に「npm」と入力し、 [npm] を選択します。

    Select npm task

  2. タスクに表示名を付けます。 [コマンド] オプションを "カスタム" に変更し、[コマンドと引数] に次のコマンドを入力します。 他の既定のオプションはそのまま使用します。

    install -g azure-streamanalytics-cicd
    

    Enter configurations for npm task

ホストされている Linux エージェントを使用する必要がある場合は、次の手順を使用します。

  1. 該当するエージェントの指定を選択します

    Screenshot of selecting agent specification.

  2. [タスク] ページで、[Agent job 1](エージェントジョブ 1) の横にあるプラス記号を選択します。 タスク検索で「コマンド ライン」と入力し、 [コマンド ライン] を選択します。

    Screenshot of searching commandline task.

  3. タスクに表示名を付けます。 [スクリプト] に次のコマンドを入力します。 他の既定のオプションはそのまま使用します。

    sudo npm install -g azure-streamanalytics-cicd --unsafe-perm=true --allow-root
    

    Screenshot of entering script for cmd task.

ビルド タスクの追加

  1. [変数] ページで、 [パイプライン変数][+ 追加] を選択します。 次の変数を追加します。 次の値を好みに応じて設定します。

    変数名
    projectRootPath <プロジェクト名>
    outputPath Output
    deployPath 配置
  2. [タスク] ページで、[Agent job 1](エージェントジョブ 1) の横にあるプラス記号を選択します。 [コマンド ライン] を探します。

  3. タスクに表示名を指定し、次のスクリプトを入力します。 リポジトリ名とプロジェクト名を使用してスクリプトを変更します。

    Note

    build --v2 を使用してデプロイ用の ARM テンプレートを生成することを強くお勧めします。 新しい ARM テンプレートは、以前のバージョンと同じ機能を維持しながら、パラメーターの数が少なくなっています。

    以前の ARM テンプレートは間もなく非推奨になり、build --v2 を使用して作成されたテンプレートでのみ更新プログラムとバグ修正を受け取ることができます。

    azure-streamanalytics-cicd build --v2 -project $(projectRootPath)/asaproj.json -outputpath $(projectRootPath)/$(outputPath)/$(deployPath)
    

    画像では、Stream Analytics Visual Studio Code プロジェクトを例として使用しています。

    Enter configurations for command-line task visual studio code

テスト タスクを追加する

  1. [変数] ページで、 [パイプライン変数][+ 追加] を選択します。 次の変数を追加します。 値は、実際の出力パスとリポジトリ名に合わせて変更してください。

    変数名
    testPath テスト

    Add pipeline variables

  2. [タスク] ページで、[Agent job 1](エージェントジョブ 1) の横にあるプラス記号を選択します。 [コマンド ライン] を探します。

  3. タスクに表示名を指定し、次のスクリプトを入力します。 スクリプトは、実際のプロジェクト ファイル名とテスト構成ファイルのパスに合わせて変更してください。

    テスト ケースを追加して構成する方法について詳しくは、自動テストの手順を参照してください。

    azure-streamanalytics-cicd test -project $(projectRootPath)/asaproj.json -outputpath $(projectRootPath)/$(outputPath)/$(testPath) -testConfigPath $(projectRootPath)/test/testConfig.json 
    

    Enter configurations for command-line task

ファイルのコピー タスクを追加する

テスト概要ファイルと Azure Resource Manager テンプレート ファイルを成果物フォルダーにコピーするには、ファイルのコピー タスクを追加する必要があります。

  1. [タスク] ページで、[Agent job 1](エージェント ジョブ 1) の横にある + を選択します。 [ファイルのコピー] を探します。 次の構成を入力します。 [コンテンツ]** を割り当てることにより、テスト結果のすべてのファイルがコピーされます。

    パラメーター 入力
    表示名 ファイルのコピー先: $(build.artifactstagingdirectory)
    [同期元フォルダー] $(system.defaultworkingdirectory)/$(outputPath)/
    内容 **
    ターゲット フォルダー $(build.artifactstagingdirectory)
  2. [管理オプション] を展開します。 [このタスクを実行][前のいずれかのタスクが失敗した場合でも、ビルドがキャンセルされていなければ] を選択します。

    Enter configurations for copy task

ビルド成果物の公開タスクを追加する

  1. [タスク] ページで、[Agent job 1](エージェントジョブ 1) の横にあるプラス記号を選択します。 [ビルド成果物の公開] を探し、黒い矢印アイコン付きオプションを選択します。

  2. [管理オプション] を展開します。 [このタスクを実行][前のいずれかのタスクが失敗した場合でも、ビルドがキャンセルされていなければ] を選択します。

    Enter configurations for publish task

保存と実行

npm パッケージ、コマンド ライン、ファイルのコピー、およびビルド成果物の公開タスクの追加が完了したら、[保存してキューに登録] を選択します。 メッセージが表示されたら、保存コメントを入力し、[保存および実行] を選択します。 テスト結果は、パイプラインの [Summary](概要) ページからダウンロードできます。

ビルドとテストの結果を確認する

テスト概要ファイルと Azure Resource Manager テンプレート ファイルは、 [Published](公開済み) フォルダーにあります。

Check build and test result

Check artifacts

Azure Pipelines を使用したリリース

このセクションでは、リリース パイプラインを作成する方法について説明します。

Web ブラウザーを開き、Azure Stream Analytics Visual Studio Code プロジェクトに移動します。

  1. 左側のナビゲーション メニューの [パイプライン] で、[リリース] を選択します。 [新しいパイプライン] を選択します。

  2. [start with an Empty job](空のジョブを開始する) を選択します。

  3. [Artifacts](成果物) ボックスで、[+ Add an artifact](+ 成果物の追加) を選択します。 [ソース] で、作成したビルド パイプラインを選択し、 [追加] を選択します。

    Enter build pipeline artifact

  4. [Stage 1](ステージ 1) の名前を [Deploy job to test environment](テスト環境にジョブをデプロイ) に変更します。

  5. 新しいステージを追加して、[Deploy job to production environment](運用環境にジョブをデプロイ) という名前を付けます。

デプロイ タスクを追加する

Note

パラメーターはオブジェクトとして渡されるため、Override template parameters は ARM --v2 ビルドには適用できません。 これに対処するには、パイプラインに PowerShell スクリプトを含め、パラメーター ファイルを JSON として読み取り、必要なパラメーター変更を行うことをお勧めします。

PowerShell スクリプトの追加に関するガイダンスについて詳しくは、「ConvertFrom-Json」と JSON ファイルでのオブジェクトの更新に関するページをご覧ください。

  1. タスクのドロップダウンから、[Deploy job to test environment](テスト環境にジョブをデプロイ) を選択します。

  2. [エージェント ジョブ] の横にある + を選択し、ARM テンプレート デプロイを検索します。 次のパラメーターを入力します。

    パラメーター
    表示名 myASAProject をデプロイする
    Azure サブスクリプション サブスクリプションを選択します。
    アクション Create or update resource group (リソース グループを作成または更新)
    Resource group Stream Analytics ジョブを含めるテスト リソース グループの名前を選択します。
    場所 テスト リソース グループの場所を選択します。
    テンプレートの場所 Linked artifact (リンクされた成果物)
    Template $(System.DefaultWorkingDirectory)/_azure-streamanalytics-cicd-demo-CI-Deploy/drop/myASAProject.JobTemplate.json
    テンプレート パラメーター $(System.DefaultWorkingDirectory)/_azure-streamanalytics-cicd-demo-CI-Deploy/drop/myASAProject.JobTemplate.parameters.json
    テンプレート パラメーターのオーバーライド -<arm_template_parameter> "your value". パラメーターは、 [変数] を使用して定義できます。
    展開モード 増分
  3. タスクのドロップダウンから、[Deploy job to production environment](運用環境にジョブをデプロイ) を選択します。

  4. [エージェント ジョブ] の横にある + を選択し、"ARM テンプレート デプロイ" を検索します。 次のパラメーターを入力します。

    パラメーター
    表示名 myASAProject をデプロイする
    Azure サブスクリプション サブスクリプションを選択します。
    アクション Create or update resource group (リソース グループを作成または更新)
    Resource group Stream Analytics ジョブを含める運用リソース グループの名前を選択します。
    場所 運用リソース グループの場所を選びます。
    テンプレートの場所 Linked artifact (リンクされた成果物)
    Template $(System.DefaultWorkingDirectory)/_azure-streamanalytics-cicd-demo-CI-Deploy/drop/myASAProject.JobTemplate.json
    テンプレート パラメーター $(System.DefaultWorkingDirectory)/_azure-streamanalytics-cicd-demo-CI-Deploy/drop/myASAProject.JobTemplate.parameters.json
    テンプレート パラメーターのオーバーライド -<arm_template_parameter> "your value"
    展開モード 増分

リリースを作成する

リリースを作成するには、右上隅にある [リリースの作成] を選択します。

Create a release using Azure Pipelines

次のステップ