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/dev-box/concept-dev-box-concepts.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -38,7 +38,7 @@ A dev center is a collection of [Projects](#project) that require similar settin
38
38
39
39
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.
40
40
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).
Copy file name to clipboardExpand all lines: articles/dev-box/concept-what-are-dev-box-customizations.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -73,7 +73,7 @@ Team customizations also offer a built-in way to optimize your team's Dev Box cu
73
73
74
74
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.
75
75
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":::
77
77
78
78
#### Configure Dev Box for team customizations
79
79
@@ -98,16 +98,16 @@ To set up Dev Box to support team customizations, follow these steps:
98
98
- Optimize your image definition into a custom image.
99
99
1. Create your dev box from the configured pool by using the developer portal.
100
100
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).
103
103
104
104
# [User customizations](#tab/user-customizations)
105
105
106
106
### How do user customizations work?
107
107
108
108
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.
109
109
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":::
111
111
112
112
#### Configure Dev Box for user customizations
113
113
@@ -127,12 +127,12 @@ To set up Dev Box to support user customizations, follow these steps:
127
127
128
128
The dev box is created with customizations.
129
129
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).
131
131
132
132
---
133
133
134
134
## Related content
135
135
136
136
-[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)
Copy file name to clipboardExpand all lines: articles/dev-box/how-to-configure-customization-tasks.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,5 @@
1
1
---
2
-
title: Create Tasks for Dev Box Team Customizations
2
+
title: Configure Customization Tasks
3
3
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.
4
4
author: RoseHJM
5
5
ms.author: rosemalcolm
@@ -12,9 +12,9 @@ ms.date: 11/05/2024
12
12
#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.
13
13
---
14
14
15
-
# Create tasks for Dev Box team customizations
15
+
# Configure tasks for Dev Box customizations
16
16
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.
@@ -33,7 +33,7 @@ To complete the steps in this article, you must have:
33
33
34
34
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.
35
35
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.
37
37
38
38
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.
39
39
@@ -71,7 +71,7 @@ To configure your key vault secrets for use in your YAML configurations:
71
71
72
72
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.
73
73
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.
75
75
76
76
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).
77
77
@@ -81,5 +81,5 @@ You can attach a catalog to a project to make tasks accessible to the developer
81
81
82
82
## Related content
83
83
84
-
-[Microsoft Dev Box team customizations](concept-what-are-team-customizations.md)
84
+
-[Microsoft Dev Box customizations](concept-what-are-dev-box-customizations.md)
85
85
-[Write a customization file for a dev box](./how-to-write-customization-file.md)
0 commit comments