YAML パイプライン エディター

Azure Pipelinesエディターに基づく YAML パイプライン エディターが提供されます。このエディターを使用すると、ポータルからパイプラインを作成および編集Azure DevOpsできます。 エディターには、Intellisense のサポートや、パイプラインを編集するときにガイダンスを提供するタスク アシスタントのようなツールが提供されます。

重要

YAML パイプライン エディターは、2019 Azure DevOps Server 1 で導入されました。 Azure DevOps Server 2019 RTW を使用している場合、この記事で説明されている YAML パイプライン エディターは使用できませんが、選択したテキスト エディターを使用して YAML を編集し、パイプラインのリポジトリにチェックインすることができます。

YAML パイプラインを編集する

YAML パイプライン エディターにアクセスするには、[ビルド] Pipelines 選択し、編集するパイプラインを選択します。

Azure Pipelines 2019 Update 1 Azure DevOps Serverビルドを作成します。

[ 編集] を 選択して、YAML パイプライン エディターでパイプラインを編集します。

Azure PipelinesAzure DevOps Server 2019 Update 1 の YAML 編集ボタン。

Intellisense のキーボード ショートカットとタスク アシスタントを 使用してパイプラインを編集し、 ガイダンス を得る。

2019.1 Azure DevOps Server YAML パイプライン エディター。

YAML パイプライン エディターにアクセスするには、 [Pipelines] を選択し、編集するパイプラインを選択します。 [最近]、[すべて]、**および [**実行] でパイプラインを 参照できます。 詳細については、ランディング ページのPipelinesを参照してください

Azure Pipelinesページを開きます。

[ 編集] を 選択して、YAML パイプライン エディターでパイプラインを編集します。

Azure PipelinesYAML 編集ボタン。

Intellisense とタスク アシスタントを使用してパイプラインを編集し、ガイダンスを得る。

YAML パイプライン エディター。

[保存 ] を 選択してパイプラインを保存します。 ブランチに直接コミットするか、新しいブランチを作成し、必要に応じて新しいブランチをpull request。

YAML パイプライン エディターの保存ウィンドウ。

キーボード ショートカット

YAML パイプライン エディターには、いくつかの種類のキーボード ショートカットがあります。

YAML パイプラインの編集中に、Intellisense サポート用に Ctrl + Space キーを押します。

YAML パイプライン エディターの Intellisense。

F1 キー (Mac では Fn + F1 キー) を押してコマンド パレットを表示し、使用可能なキーボード ショートカットを表示します。

YAML パイプライン エディターのコマンド パレット。

タスク アシスタント

タスク アシスタントは、YAML パイプラインにタスクを追加するメソッドを提供します。

タスク アシスタントを表示するには、YAML パイプラインを編集し、[ アシスタントの表示] を選択します

YAML パイプラインを編集する Ask アシスタントを表示します。

タスク アシスタントを非表示にする場合は、[ アシスタントを非表示にする ] を選択します

YAML パイプラインを編集するタスク アシスタントを非表示にする。

タスク アシスタントを使用するには、[タスク] ウィンドウでタスクを参照または 検索 します。

タスク アシスタントの検索。

目的のタスクを選択し、その入力を構成します。

タスク アシスタントの追加。

[追加 ] を選択して、タスク YAML をパイプラインに挿入します。

2019 年 1 月に追加されたタスク アシスタントAzure DevOps Server。

挿入した YAML を編集して、タスクに追加の構成変更を加えます。

タスク アシスタントが追加されました。

YAML を編集してタスクに追加の構成変更を加えるか、YAML パイプライン エディターでタスクの上にある 設定 を選択して、タスク アシスタントで挿入されたタスクを構成できます。

検証

YAML パイプラインを編集する場合は、[その他のアクション] を選択して変更 検証 できます。 この機能を使用すると、開始を妨げる構文エラーをパイプラインでキャッチできます。

完全な YAML を検証してダウンロードします。

完全な YAML をダウンロードする

パイプラインを コミットまたは実行せずに、 完全に解析された YAML ドキュメントをプレビューするには、[その他のアクション] [完全な YAML のダウンロード] を選択します

完全な YAML を検証してダウンロードします。

完全な YAML をダウンロード すると、Azure DevOps REST APIの Azure Pipelines が呼び出され、レンダリングされた YAML のダウンロードがエディターから開始されます。

パイプライン変数の管理

変数を使用して、リポジトリとは別に値または暗号化されたシークレットを格納します。

パイプライン変数を管理するには、YAML パイプラインを編集し、[変数] を選択します

[パイプライン変数の管理] ボタン。

[ 新しい変数] を 選択して最初の変数を追加し、[追加 ] を選択 して後続の変数を追加します。 変数名を選択して変数を編集し、変数の上にマウス ポインターを置き、[削除] を選択して変数 を削除します。

YAML エディターでパイプライン変数を管理します。

YAML パイプライン エディターから変数を直接管理できるだけでなく、パイプライン設定 UI で変数を管理することもできます。

2019 Azure DevOps Update 1 を使用する場合は、パイプライン設定 UI を使用してパイプライン変数を管理できます。

パイプライン設定 UI で YAML パイプライン変数を管理するには、パイプラインを編集し、[その他のアクション]を選択****します。

パイプライン設定の UI メニュー。

[ 変数] を 選択して、パイプライン変数を管理します。

変数のパイプライン設定 UI。

パイプライン変数の操作の詳細については、「変数の定義 」を参照してください

テンプレートの表示と編集

テンプレートは 、YAML パイプラインで一般的に使用される機能です。 パイプライン スニペットを共有する簡単な方法です。 また、パイプラインを通じてセキュリティとガバナンスを検証または実施する強力 なメカニズムです

Azure Pipelinesは、パイプラインを編集するときに便利な YAML エディターをサポートしています。 以前は、エディターでテンプレートがサポートされていませんでした。 YAML パイプラインの作成者は、テンプレートを使用するときに Intellisense のサポートを受け取る必要が生じません。 このリリースでは、YAML エディターでテンプレートのサポートをプレビューしています。 このプレビューを有効にするには、組織のプレビュー機能に移動Azure DevOps YAML テンプレート エディターを有効にします

YAML ファイルのメイン Azure Pipelines編集する場合は、テンプレート を含 めるか 拡張 することができます。 テンプレートの名前を入力すると、テンプレートの検証を求めるメッセージが表示される場合があります。 検証が完了すると、YAML エディターは、入力パラメーターを含むテンプレートのスキーマを理解します。

YAML テンプレート。

検証後、テンプレートに移動するには、[テンプレートの表示]を選択すると、新しいブラウザー タブにテンプレートが開きます。YAML エディターのすべての機能を使用して、テンプレートを変更できます。

重要

この機能はプレビュー段階にあります。 既知の制限があります。 テンプレートにメイン YAML ファイルの入力として指定されていない必須パラメーターがある場合、検証は失敗し、それらの入力を指定するように求めるメッセージが表示されます。 また、エディターから新しいテンプレートを作成することはできません。 既存のテンプレートのみを使用または編集できます。

次の手順