You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/sentinel/ci-cd-custom-deploy.md
+17-7Lines changed: 17 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,13 +9,13 @@ ms.author: austinmc
9
9
#Customer intent: As a SOC collaborator or MSSP analyst, I want to know how to optimize my source control repositories for continuous integration and continuous delivery (CI/CD). Specifically as an MSSP content manager, I want to know how to deploy one solution to many customer workspaces and still be able to tailor custom content for their environments.
There are two primary ways to customize the deployment of your repository content to Microsoft Sentinel workspaces. Each method uses different files and syntax, so consider these examples to get you started.
15
15
16
-
1.To modify a deployment trigger or only deploy content from a specific folder, customize the GitHub workflow or DevOps pipeline.
16
+
1.Modify the GitHub workflow or DevOps pipeline to customize deployment options such as your connection's deployment trigger, deployment path or usage of smart deployments.
17
17
18
-
1. If you want to prioritize content, *exclude* content, or map parameters, customize the deployment.
18
+
2. Utilize the newly introduced configuration file to control the priortized order of your content deployments, choose to *exclude*specific content files from those deployments, or map parameter files to specific content files.
19
19
20
20
> [!IMPORTANT]
21
21
>
@@ -157,7 +157,7 @@ For more information, see the [Azure DevOps documentation](/azure/devops/pipelin
157
157
>
158
158
159
159
160
-
## Customize the deployment
160
+
## Customize your connection configuration
161
161
162
162
Customization options to map parameters, prioritize content and exclude content are defined here.
163
163
@@ -167,7 +167,7 @@ Customization options to map parameters, prioritize content and exclude content
167
167
168
168
1. Include JSON structured content in three optional sections, `"prioritizedcontentfiles":`, `"excludecontentfiles":`, and `"parameterfilemappings":`. If no sections are included or the .config file is omitted, the deployment process will still run. Invalid or unrecognized sections will be ignored.
169
169
170
-
Here's an example of the entire contents of a valid *sentinel-deployment.config* file. This sample can be found at the [Sentinel CICD repositories sample](https://github.com/SentinelCICD/RepositoriesSampleContent).
170
+
Here's an example of the entire contents of a valid *sentinel-deployment.config* file. This sample can also be found at the [Sentinel CICD repositories sample](https://github.com/SentinelCICD/RepositoriesSampleContent).
171
171
172
172
```json
173
173
{
@@ -198,7 +198,7 @@ Here's an example of the entire contents of a valid *sentinel-deployment.config*
198
198
199
199
- **To prioritize content files**:
200
200
201
-
As the amount of content in your repro grows, deployment times may increase. Add time sensitive content to this section to prioritize its deployment when a trigger occurs.
201
+
As the amount of content in your repository grows, deployment times may increase. Add time sensitive content to this section to prioritize its deployment when a trigger occurs.
202
202
203
203
Add full path names to the `"prioritizedcontentfiles":` section. Wildcard matching is not supported at this time.
204
204
@@ -210,11 +210,21 @@ Here's an example of the entire contents of a valid *sentinel-deployment.config*
210
210
211
211
:::image type="content" source="media/ci-cd-custom-deploy/deploy-parameter-file-precedence.svg" alt-text="A diagram showing the precedence of parameter file mappings.":::
212
212
213
+
<<<<<<< HEAD
213
214
1. Is there a mapping in the sentinel-deployment.config?
214
215
1. Is there a workspace parameter file?
215
216
1. Is there a default parameter file?
217
+
=======
218
+
1. Include a parameter file mapping grouped by workspace ID in the `"parameterfilemappings":` section of the *sentinel-deployment.config* file. See the example above for creating the `ContentFilePath:ParameterFilePath` key value pairs. You can specify a different parameter file for the same content file per workspace.
219
+
220
+
Or
221
+
1. Create a workspace parameter file in the same directory as a content file. If the content file is *azuredeploy.json* then the workspace parameter file naming convention is *azuredeploy.parameters-\<workspaceID\>.json*.
222
+
223
+
Or
224
+
1. Create a default parameter file in the same directory as a content file. If the content file is *azuredeploy.json* then the default parameter file naming convention is *azuredeploy.parameters.json*.
225
+
>>>>>>> a0cb8ecd8349dd3d9630faa417e4466a66a722d1
216
226
217
-
Adding or modifying a *.parameters-\<workspaceID\>.json* file or *.parameters.json* file triggers a deployment of that particular content file. Other content files won't be deployed if the smart deploy feature is still enabled.
227
+
Adding or modifying a *.parameters-\<workspaceID\>.json* file or *.parameters.json* file triggers a deployment of that corresponding content file along with the newly modified parameters. Other content files won't be deployed if the smart deployments feature is still enabled.
0 commit comments