自訂儲存庫部署

要自訂您的 GitHub 部署工作流程：

1. 在 GitHub 上，前往你的倉庫，在 .github/workflows 目錄中找到你的工作流程。

   工作流程檔案是以 sentinel-deploy-xxxxx.yml 開頭的 YML 檔案。 打開該檔案，工作流程名稱會出現在第一行，並採用以下預設命名規則： Deploy Content to <workspace-name> [<deployment-id>]。

   例如：name: Deploy Content to repositories-demo [xxxxx-dk5d-3s94-4829-9xvnc7391v83a]

2. 請選擇頁面右上角的鉛筆按鈕以開啟檔案進行編輯，然後依照以下方式修改部署：

   • 要修改部署觸發器，更新 on 程式碼中描述觸發工作流程執行事件的段落。

     預設情況下，此設定設為 on: push，意即在任何推送至連接分支時觸發工作流程，包括對現有內容的修改及新增內容到儲存庫。 例如：

     on:
         push:
             branches: [ main ]
             paths:
             - `**`
             - `!.github/workflows/**` # this filter prevents other workflow changes from triggering this workflow
             - `.github/workflows/sentinel-deploy-<deployment-id>.yml`
     

     例如，更改這些設定，讓工作流程定期執行，或將不同的工作流程事件合併在一起。

     更多資訊請參閱 GitHub 文件中的「設定工作流程事件」。

   • 要停用智慧部署：

     智慧部署行為會與工作流程觸發器分開 on 設定。 前往工作流程中的 jobs 區段。 將smartDeployment預設值從true切換為false。 一旦此變更被提交，智慧部署功能即被關閉，未來所有針對此連線的部署都會將儲存庫中所有相關內容檔案重新部署到連接的工作區。

   • 要修改部署路徑：

     在 on 區段所示的預設組態中，** 區段第一行中的萬用字元 (paths) 表示整個分支皆包含在部署觸發程序的路徑中。

     此預設設定表示每當該內容被推送到連接分支的任何部分時，部署工作流程就會被觸發。

     在該 jobs 區段中，預設配置包含 directory: '${{ github.workspace }}'。 設定顯示directory整個 GitHub 分支都在內容部署的路徑中，且未過濾任何資料夾路徑。

     若要僅從特定資料夾路徑部署內容，請將其加入 paths 和 directory 這兩個設定中。 例如，若要只部署名為 SentinelContent的根資料夾內容，請更新程式碼如下：

     paths:
     - `SentinelContent/**`
     - `!.github/workflows/**` # this filter prevents other workflow changes from triggering this workflow
     - `.github/workflows/sentinel-deploy-<deployment-id>.yml`
     
     ...
         directory: '${{ github.workspace }}/SentinelContent'
     

欲了解更多資訊，請參閱 GitHub Actions 工作流程語法中的路徑篩選器，詳見 GitHub 文件中。

要自訂您的 Azure DevOps 部署流程：

1. 在 Azure DevOps 中，前往你的儲存庫，並在 .sentinel 目錄中找到你的管線定義檔案。

   管線名稱顯示在管線檔案的第一行，預設命名規則如下： Deploy Content to <workspace-name> [<deployment-id>]。

   例如：name: Deploy Content to repositories-demo [xxxxx-dk5d-3s94-4829-9xvnc7391v83a]

2. 請選擇頁面右上角的鉛筆按鈕以開啟檔案進行編輯，然後依照以下方式修改部署：

   • 要修改部署觸發器，更新 trigger 程式碼中描述觸發工作流程執行事件的段落。

     預設情況下，此設定會偵測任何推送至連接分支的行為，包括對現有內容的修改及新增內容到儲存庫。

     將此觸發器修改為任何可用的 Azure DevOps 觸發器，例如排程觸發器或拉取請求觸發器。 欲了解更多資訊，請參閱 Azure DevOps YAML pipeline schema。

   • 要停用智慧部署：智慧部署行為需在本區段與管線觸發器 trigger 分開設定。 瀏覽至管線中的 ScriptArguments 區段。 將smartDeployment預設值從true切換為false。 一旦此變更被提交，智慧部署功能會被關閉，未來所有針對此連線的部署都會將儲存庫中所有相關內容檔案重新部署到連接的工作區。

   • 要修改部署路徑：

     本 trigger 區段的預設配置包含以下代碼，表示該 main 分支位於部署觸發器的路徑中：

     trigger:
         branches:
             include:
             - main
     

     預設 trigger 設定表示每當該內容被推送到分支的任何 main 部分時，部署管線就會被觸發。

     若要只從特定資料夾路徑部署內容，請在觸發器的區段加上資料夾名稱 include ，並將部署路徑加入該 steps 區段。

     例如，若要僅部署您 SentinelContent 分支中名為 main 的根資料夾內容，請按以下方式在程式碼中加入 include 和 workingDirectory 設定：

     paths:
         exclude:
         - .sentinel/*
         include:
         - .sentinel/sentinel-deploy-39d8ekc8-397-5963-49g8-5k63k5953829.yml
         - SentinelContent
     ....
     steps:
     - task: AzurePowerShell@5
       inputs:
         azureSubscription: `Sentinel_Deploy_ServiceConnection_0000000000000000`
         workingDirectory: `SentinelContent`
     

欲了解更多資訊，請參閱 Azure DevOps YAML pipeline schema。