Azure Pipelines 工作參考

工作會在管線中執行動作。 例如，工作可以建置應用程式、與 Azure 資源互動、安裝工具或執行測試。 工作是在管線中定義自動化的建置組塊。

本節中的文章描述 Azure Pipelines 的內建工作，並針對每個工作保留特殊意義的屬性指定語意。

如需工作所支援之一般屬性的詳細資訊，請參閱 YAML 參考 steps.task。

如需使用工作撰寫管線的作法和教學課程，包括建立自定義工作、自定義延伸模組和在Visual Studio Marketplace 上尋找工作，請參閱 工作概念 和 Azure Pipelines 檔。

開源

這些工作是 GitHub上的開放原始碼 。 歡迎意見反應和貢獻。 如需工作變更清單，請參閱 管線工作變更記錄，包括工作更新的歷程記錄。

常見問題

什麼是工作輸入別名？

工作的輸入是由 label、name識別，而且可能包含一或多個選擇性 aliases。 下列範例是 原始程式碼 摘錄 已知主機專案InstallSSHKey@0 工作的輸入。

{
    "name": "hostName",
    "aliases": [
        "knownHostsEntry"
    ],
    "label": "Known Hosts Entry"
    ...
}

在 2019 年引進 YAML 管線之前，管線是使用 UI 型管線編輯器來建立和編輯，而且管線作者只會使用 label 來參考工作輸入。

在 2019 年引進 YAML 管線時，使用 YAML 的管線作者開始使用工作輸入 name 來參考工作輸入。 在某些情況下，工作輸入名稱沒有描述性，因此已新增 aliases 以提供工作輸入的其他描述性名稱。

例如，InstallSSHKey@0 工作具有名為 hostName 輸入，其預期有來自 known_hosts 檔案的專案。 傳統管線設計工具中的 已知主機專案 標籤會清楚明瞭，但在 YAML 管線中使用 hostName 名稱時並不明確。 已引進工作輸入別名，讓工作作者為其先前撰寫的工作提供譯碼名稱，以及針對 InstallSSHKey@0 工作，新增了 knownHostsEntry別名，同時保留原始 hostName 名稱，以便與使用該名稱的現有管線相容。

工作輸入 aliases 中的任何專案都可與 YAML 管線中的 name 互換。 下列兩個 YAML 代碼段的功能相同，第一個範例使用 knownHostsEntry 別名，第二個範例則使用 hostName。

- task: InstallSSHKey@0
  inputs:
    # Using knownHostsEntry alias
    knownHostsEntry: 'sample known hosts entry line'
    # Remainder of task inputs omitted

- task: InstallSSHKey@0
  inputs:
    # Using hostName name
    hostName: 'sample known hosts entry line'
    # Remainder of task inputs omitted

從 Azure DevOps Server 2019.1 開始，YAML 管線編輯器引進了，其提供 Intellisense 類型功能。

YAML 管線編輯器會使用 Yamlschema - 取得 REST API 來擷取編輯器中用於驗證的架構。 如果工作輸入有別名，架構會將別名升階為工作輸入的主要 YAML 名稱，而 intellisense 會建議別名。

下列範例是 YAML 架構中 工作的 InstallSSHKey@0 工作輸入，knownHostsEntry 列在 hostName 集合中的名稱位置和 aliases 中。

"properties": {
    "knownHostsEntry": {
      "type": "string",
      "description": "Known Hosts Entry",
      "ignoreCase": "key",
      "aliases": [
        "hostName"
      ]
    },

由於 YAML 管線編輯器中的 Intellisense 會顯示 knownHostsEntry，而 工作助理所產生的 YAML 會在產生的 YAML 中使用 knownHostsEntry，因此工作參考會顯示工作原始程式碼中的 alias 做為工作輸入的 YAML 名稱。 如果工作有多個別名（有幾個別名有兩個別名），則會使用第一個別名作為名稱。

為什麼工作參考會變更？

Azure Pipelines 工作參考文件已移至其目前位置，以支援下列改善。

• 工作發行項是使用來自 Azure Pipelines 工作開放原始碼存放庫的工作原始程式碼產生，。
• 工作輸入名稱和別名是從工作來源產生，因此它們一律為最新狀態。
• YAML 語法區塊是從工作來源產生，因此它們是最新的。
• 支援社群貢獻與整合式用戶內容，例如增強的工作輸入描述、備註和範例。
• 為所有支援的 Azure DevOps 版本提供工作涵蓋範圍。
• 已更新每個短期衝刺，以涵蓋最新的更新。

若要參與，請參閱 參與工作內容。

我可以在哪裡瞭解如何建置我的應用程式？

建置您的應用程式

我可以新增自己的建置工作嗎？

是：新增建置工作

什麼是安裝程式工作？

若要深入瞭解工具安裝程式工作，請參閱 工具安裝程式。