自定义存储库部署

若要自定义 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 文档 。

   • 禁用智能部署：智能部署行为与所讨论的部署触发器不同。 导航到 jobs 工作流的 部分。 将 smartDeployment 默认值从 truefalse切换到 。 提交此更改后，智能部署功能将关闭，并且此连接的所有未来部署会将存储库的所有相关内容文件重新部署到连接的工作区。

   • 修改部署路径：

     在部分显示on的默认配置中，第一行paths中的通配符 (**) 指示整个分支位于部署触发器的路径中。

     此默认配置意味着，每当将内容推送到分支的任何部分时，就会触发部署工作流。

     稍后在 文件中， jobs 节包括以下默认配置： directory: '${{ github.workspace }}'。 此行指示整个 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 工作流的 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 触发器文档。

   • 禁用智能部署：智能部署行为与所讨论的部署触发器不同。 导航到 ScriptArguments 管道的 部分。 将 smartDeployment 默认值从 truefalse切换到 。 提交此更改后，智能部署功能将关闭，并且此连接的所有未来部署会将存储库的所有相关内容文件重新部署到连接的工作区。

   • 修改部署路径：

     节的默认配置 trigger 具有以下代码，指示 main 分支位于部署触发器的路径中：

     trigger:
         branches:
             include:
             - main
     

     此默认配置意味着，每当将内容推送到分支的任何部分 main 时，就会触发部署管道。

     若要仅从特定文件夹路径部署内容，请将文件夹名称添加到 include 触发器的 节，并将部署路径添加到 steps 节。

     例如，若要仅从分支中名为 的SentinelContent根文件夹部署内容，请将 和 workingDirectory 设置添加到include代码，main如下所示：

     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 架构的 Azure DevOps 文档。