Skip to content

Commit 8051267

Browse files
authored
Merge pull request #302296 from RoseHJM/mdb-cust-name-changes
MDB - Customizations - title changes and filename changes
2 parents 5c8214f + 08a47f3 commit 8051267

File tree

46 files changed

+123
-91
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

46 files changed

+123
-91
lines changed

articles/dev-box/.openpublishing.redirection.dev-box.json

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -99,6 +99,36 @@
9999
"source_path_from_root": "/articles/dev-box/how-to-write-individual-customization-file.md",
100100
"redirect_url": "/azure/dev-box/how-to-write-user-customization-file",
101101
"redirect_document_id": false
102+
},
103+
{
104+
"source_path_from_root": "/articles/dev-box/concept-what-are-team-customizations.md",
105+
"redirect_url": "/azure/dev-box/concept-what-are-dev-box-customizations",
106+
"redirect_document_id": false
107+
},
108+
{
109+
"source_path_from_root": "/articles/dev-box/how-to-write-image-definition-file.md",
110+
"redirect_url": "/azure/dev-box/how-to-configure-team-customizations",
111+
"redirect_document_id": false
112+
},
113+
{
114+
"source_path_from_root": "/articles/dev-box/how-to-write-user-customization-file.md",
115+
"redirect_url": "/azure/dev-box/how-to-configure-user-customizations",
116+
"redirect_document_id": false
117+
},
118+
{
119+
"source_path_from_root": "/articles/dev-box/how-to-configure-customization-imaging.md",
120+
"redirect_url": "/azure/dev-box/how-to-configure-dev-box-imaging",
121+
"redirect_document_id": false
122+
},
123+
{
124+
"source_path_from_root": "/articles/dev-box/how-to-create-customization-tasks-catalog.md",
125+
"redirect_url": "/azure/dev-box/how-to-configure-customization-tasks",
126+
"redirect_document_id": false
127+
},
128+
{
129+
"source_path_from_root": "/articles/dev-box/how-to-use-secrets-customization-files.md",
130+
"redirect_url": "/azure/dev-box/how-to-customizations-connect-resource-repository",
131+
"redirect_document_id": false
102132
}
103133
]
104134
}

articles/dev-box/concept-dev-box-concepts.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ A dev center is a collection of [Projects](#project) that require similar settin
3838

3939
The Dev Box quick start catalog contains tasks and scripts that you can use to configure your dev box during the final stage of the creation process. Microsoft provides a [*quick start catalog*](https://github.com/microsoft/devcenter-catalog) that contains a set of sample tasks. You can attach the quick start catalog to a dev center to make these tasks available to all the projects associated with the dev center. You can modify the sample tasks to suit your needs, and you can create your own catalog of tasks.
4040

41-
To learn how to create Dev Box customizations, see [Microsoft Dev Box team customizations](concept-what-are-team-customizations.md).
41+
To learn how to create Dev Box customizations, see [Microsoft Dev Box customizations](concept-what-are-dev-box-customizations.md).
4242

4343
## Project
4444

articles/dev-box/concept-what-are-team-customizations.md renamed to articles/dev-box/concept-what-are-dev-box-customizations.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,7 @@ Team customizations also offer a built-in way to optimize your team's Dev Box cu
7373

7474
Configuring Dev Box team customizations for your organization requires careful planning and informed decision-making. The following diagram provides an overview of the process and highlights key decision points.
7575

76-
:::image type="content" source="media/concept-what-are-team-customizations/dev-box-customizations-workflow.svg" alt-text="Diagram that shows the workflow for Dev Box team customizations, including steps for planning, configuring, and deploying customizations." lightbox="media/concept-what-are-team-customizations/dev-box-customizations-workflow.svg":::
76+
:::image type="content" source="media/concept-what-are-dev-box-customizations/dev-box-customizations-workflow.svg" alt-text="Diagram that shows the workflow for Dev Box team customizations, including steps for planning, configuring, and deploying customizations." lightbox="media/concept-what-are-dev-box-customizations/dev-box-customizations-workflow.svg":::
7777

7878
#### Configure Dev Box for team customizations
7979

@@ -98,16 +98,16 @@ To set up Dev Box to support team customizations, follow these steps:
9898
- Optimize your image definition into a custom image.
9999
1. Create your dev box from the configured pool by using the developer portal.
100100

101-
To learn more about team customization and writing image definitions, see [Write an image definition file for Dev Box team customizations](how-to-write-image-definition-file.md).
102-
Then, to learn how to optimize your image definition into a custom image, see [Configure imaging for Dev Box team customizations](how-to-configure-customization-imaging.md).
101+
To learn more about team customization and writing image definitions, see [Configure team customizations](how-to-configure-team-customizations.md).
102+
Then, to learn how to optimize your image definition into a custom image, see [Configure Dev Box imaging](how-to-configure-dev-box-imaging.md).
103103

104104
# [User customizations](#tab/user-customizations)
105105

106106
### How do user customizations work?
107107

108108
Individual developers can attach a YAML-based customization file when they create their dev box to control the development environment. Developers use user customizations only for personal settings and apps.
109109

110-
:::image type="content" source="media/concept-what-are-team-customizations/dev-box-user-customizations-workflow.svg" alt-text="Diagram that shows the workflow for Dev Box user customizations, including steps for planning, configuring, and deploying customizations." lightbox="media/concept-what-are-team-customizations/dev-box-user-customizations-workflow.svg":::
110+
:::image type="content" source="media/concept-what-are-dev-box-customizations/dev-box-user-customizations-workflow.svg" alt-text="Diagram that shows the workflow for Dev Box user customizations, including steps for planning, configuring, and deploying customizations." lightbox="media/concept-what-are-dev-box-customizations/dev-box-user-customizations-workflow.svg":::
111111

112112
#### Configure Dev Box for user customizations
113113

@@ -127,12 +127,12 @@ To set up Dev Box to support user customizations, follow these steps:
127127

128128
The dev box is created with customizations.
129129

130-
To learn more about user customizations, see [Write a user customization file for a dev box](how-to-write-user-customization-file.md).
130+
To learn more about user customizations, see [Configure user customizations for dev boxes](how-to-configure-user-customizations.md).
131131

132132
---
133133

134134
## Related content
135135

136136
- [Quickstart: Create a dev box by using team customizations](quickstart-team-customizations.md)
137-
- [Configure imaging for dev box team customizations](how-to-configure-customization-imaging.md)
137+
- [Configure Dev Box imaging](how-to-configure-dev-box-imaging.md)
138138

articles/dev-box/how-to-create-customization-tasks-catalog.md renamed to articles/dev-box/how-to-configure-customization-tasks.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Create Tasks for Dev Box Team Customizations
2+
title: Configure Customization Tasks
33
description: Learn how to create and manage tasks in a catalog for Dev Box team customizations, including adding tasks and attaching the catalog to a project.
44
author: RoseHJM
55
ms.author: rosemalcolm
@@ -12,9 +12,9 @@ ms.date: 11/05/2024
1212
#customer intent: As a Dev Center Admin or Project Admin, I want to create additional tasks in a catalog so that I can create a specific customization in a customization or image definition file.
1313
---
1414

15-
# Create tasks for Dev Box team customizations
15+
# Configure tasks for Dev Box customizations
1616

17-
When you create tasks for Microsoft Dev Box team customizations, you can define specific actions for your dev boxes to help ensure a consistent and efficient development environment. Creating new tasks in a catalog allows you to define reusable components tailored to your development teams and add guardrails around the configurations that are possible. This article guides you through creating a catalog for customization tasks, adding tasks, and attaching the catalog to a dev center or project.
17+
When you create tasks for Microsoft Dev Box customizations, you can define specific actions for your dev boxes to help ensure a consistent and efficient development environment. Creating new tasks in a catalog allows you to define reusable components tailored to your development teams and add guardrails around the configurations that are possible. This article guides you through creating a catalog for customization tasks, adding tasks, and attaching the catalog to a dev center or project.
1818

1919
[!INCLUDE [customizations-preview-text](includes/customizations-preview-text.md)]
2020

@@ -33,7 +33,7 @@ To complete the steps in this article, you must have:
3333

3434
A task performs a specific action, like installing software. Each task consists of one or more PowerShell scripts, along with a task.yaml file that provides parameters and defines how the scripts run. You can also include a PowerShell command in the task.yaml file.
3535

36-
You can store a collection of curated tasks in a catalog that's attached to your dev center, with each task in a separate folder. Dev Box supports using a GitHub repository or an Azure Repos repository as a catalog. Dev Box scans a specified folder of the catalog recursively to find task definitions.
36+
You can store a collection of curated tasks in a catalog attached to your dev center, with each task in a separate folder. Dev Box supports using a GitHub repository or an Azure Repos repository as a catalog. Dev Box scans a specified folder of the catalog recursively to find task definitions.
3737

3838
WinGet and PowerShell are available from any dev center without requiring a catalog. If your customizations use only WinGet or PowerShell, you can create tasks that use them in a customization file. If you need to use other tools or scripts, you can create tasks in a catalog.
3939

@@ -71,7 +71,7 @@ To configure your key vault secrets for use in your YAML configurations:
7171

7272
1. Ensure that your dev center project's managed identity has the Key Vault Reader role and Key Vault Secrets User role on your key vault.
7373

74-
1. Grant the Key Vault Secrets User role for the key vault secret to each user or user group that should be able to consume the secret during the customization of a dev box. The user or group that's granted the role must include the managed identity for the dev center, your own user account, and any user or group that needs the secret during the customization of a dev box.
74+
1. Grant the Key Vault Secrets User role for the key vault secret to each user or user group that should be able to consume the secret during the customization of a dev box. The user or group granted the role must include the managed identity for the dev center, your own user account, and any user or group that needs the secret during the customization of a dev box.
7575

7676
For more information on using key vault secrets in a customization file, see [Clone a private repository by using a customization file](how-to-write-customization-file.md#clone-a-private-repository-by-using-a-customization-file).
7777

@@ -81,5 +81,5 @@ You can attach a catalog to a project to make tasks accessible to the developer
8181

8282
## Related content
8383

84-
- [Microsoft Dev Box team customizations](concept-what-are-team-customizations.md)
84+
- [Microsoft Dev Box customizations](concept-what-are-dev-box-customizations.md)
8585
- [Write a customization file for a dev box](./how-to-write-customization-file.md)

0 commit comments

Comments
 (0)