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-what-are-dev-box-customizations.md
+2-2Lines changed: 2 additions & 2 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
@@ -107,7 +107,7 @@ Then, to learn how to optimize your image definition into a custom image, see [C
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":::
Copy file name to clipboardExpand all lines: articles/dev-box/how-to-configure-dev-box-imaging.md
+7-7Lines changed: 7 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -51,19 +51,19 @@ Configure your project to sync image definitions from the catalog. With this set
51
51
1. Select **Catalogs**.
52
52
1. Select **Sync settings**.
53
53
54
-
:::image type="content" source="./media/how-to-configure-customization-imaging/customizations-project-sync-settings-small.png" alt-text="Screenshot of the Catalogs pane in the Azure portal, with the button for sync settings highlighted." lightbox="./media/how-to-configure-customization-imaging/customizations-project-sync-settings.png":::
54
+
:::image type="content" source="./media/how-to-configure-dev-box-imaging/customizations-project-sync-settings-small.png" alt-text="Screenshot of the Catalogs pane in the Azure portal, with the button for sync settings highlighted." lightbox="./media/how-to-configure-dev-box-imaging/customizations-project-sync-settings.png":::
55
55
56
56
1. On the **Sync settings** pane, select **Image definitions**, and then select **Save**.
57
57
58
-
:::image type="content" source="./media/how-to-configure-customization-imaging/customizations-project-sync-image-definitions.png" alt-text="Screenshot of the pane for sync settings in the Azure portal, with the checkbox for image definitions highlighted." lightbox="./media/how-to-configure-customization-imaging/customizations-project-sync-image-definitions.png":::
58
+
:::image type="content" source="./media/how-to-configure-dev-box-imaging/customizations-project-sync-image-definitions.png" alt-text="Screenshot of the pane for sync settings in the Azure portal, with the checkbox for image definitions highlighted." lightbox="./media/how-to-configure-dev-box-imaging/customizations-project-sync-image-definitions.png":::
59
59
60
60
## Attach a catalog that contains the definition file
61
61
62
62
Before you can use a customization file as an image definition, you must attach a catalog that contains the definition file to your dev center or project. The catalog can be from GitHub or Azure Repos.
63
63
64
64
The **Image definitions** pane lists the image definitions that your project can access.
65
65
66
-
:::image type="content" source="media/how-to-configure-customization-imaging/team-customizations-image-definitions-small.png" alt-text="Screenshot of the Azure portal pane that lists accessible image definitions for a project." lightbox="media/how-to-configure-customization-imaging/team-customizations-image-definitions.png":::
66
+
:::image type="content" source="media/how-to-configure-dev-box-imaging/team-customizations-image-definitions-small.png" alt-text="Screenshot of the Azure portal pane that lists accessible image definitions for a project." lightbox="media/how-to-configure-dev-box-imaging/team-customizations-image-definitions.png":::
67
67
68
68
For more information about attaching catalogs, see [Add and configure a catalog from GitHub or Azure Repos](../deployment-environments/how-to-configure-catalog.md).
69
69
@@ -91,7 +91,7 @@ The following steps show you how to create a dev box pool and specify an image d
91
91
|**Time zone**| Select the time zone that the stop time is in. |
92
92
|**Licensing**| Select this checkbox to confirm that your organization has Azure Hybrid Benefit licenses that you want to apply to the dev boxes in this pool. |
93
93
94
-
:::image type="content" source="./media/how-to-configure-customization-imaging/pool-specify-image-definition.png" alt-text="Screenshot of the pane for creating a dev box pool." lightbox="./media/how-to-configure-customization-imaging/pool-specify-image-definition.png":::
94
+
:::image type="content" source="./media/how-to-configure-dev-box-imaging/pool-specify-image-definition.png" alt-text="Screenshot of the pane for creating a dev box pool." lightbox="./media/how-to-configure-dev-box-imaging/pool-specify-image-definition.png":::
95
95
96
96
1. Select **Create**.
97
97
1. Verify that the new dev box pool appears in the list. You might need to refresh the screen.
@@ -126,15 +126,15 @@ During the process of building an image, Dev Box creates a temporary storage acc
126
126
127
127
1. On the **Image definitions** pane, select the image that you want to build.
128
128
129
-
:::image type="content" source="./media/how-to-configure-customization-imaging/customizations-select-image-small.png" alt-text="Screenshot of the pane that lists image definitions, with one definition selected." lightbox="./media/how-to-configure-customization-imaging/customizations-select-image-small.png":::
129
+
:::image type="content" source="./media/how-to-configure-dev-box-imaging/customizations-select-image-small.png" alt-text="Screenshot of the pane that lists image definitions, with one definition selected." lightbox="./media/how-to-configure-dev-box-imaging/customizations-select-image-small.png":::
130
130
131
131
1. Select **Build**.
132
132
133
-
:::image type="content" source="./media/how-to-configure-customization-imaging/customizations-build-image-small.png" alt-text="Screenshot of the pane that lists image definitions, with the Build button highlighted." lightbox="./media/how-to-configure-customization-imaging/customizations-build-image-small.png":::
133
+
:::image type="content" source="./media/how-to-configure-dev-box-imaging/customizations-build-image-small.png" alt-text="Screenshot of the pane that lists image definitions, with the Build button highlighted." lightbox="./media/how-to-configure-dev-box-imaging/customizations-build-image-small.png":::
134
134
135
135
1. Track the build progress in the **Status** column.
136
136
137
-
:::image type="content" source="./media/how-to-configure-customization-imaging/customizations-image-build-progress-small.png" alt-text="Screenshot of the pane that lists image definitions, with the in-progress status highlighted for a selected image definition." lightbox="./media/how-to-configure-customization-imaging/customizations-image-build-progress.png":::
137
+
:::image type="content" source="./media/how-to-configure-dev-box-imaging/customizations-image-build-progress-small.png" alt-text="Screenshot of the pane that lists image definitions, with the in-progress status highlighted for a selected image definition." lightbox="./media/how-to-configure-dev-box-imaging/customizations-image-build-progress.png":::
138
138
139
139
> [!IMPORTANT]
140
140
> When you're optimizing your image definition into an image, a dev box is created to run your customization file and generate an image. During this process, this dev box is connected to a virtual network that Microsoft manages. Tasks that require access to on-premises resources might fail.
Copy file name to clipboardExpand all lines: articles/dev-box/how-to-configure-team-customizations.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -136,19 +136,19 @@ Configure your project to sync image definitions from the catalog. With this set
136
136
1. Select **Catalogs**.
137
137
1. Select **Sync settings**.
138
138
139
-
:::image type="content" source="./media/how-to-write-image-definition-file/customizations-project-sync-settings-small.png" alt-text="Screenshot that shows the Catalogs pane in the Azure portal, with the button for sync settings highlighted." lightbox="./media/how-to-write-image-definition-file/customizations-project-sync-settings.png":::
139
+
:::image type="content" source="./media/how-to-configure-team-customizations/customizations-project-sync-settings-small.png" alt-text="Screenshot that shows the Catalogs pane in the Azure portal, with the button for sync settings highlighted." lightbox="./media/how-to-configure-team-customizations/customizations-project-sync-settings.png":::
140
140
141
141
1. On the **Sync settings** pane, select **Image definitions**, and then select **Save**.
142
142
143
-
:::image type="content" source="./media/how-to-write-image-definition-file/customizations-project-sync-image-definitions.png" alt-text="Screenshot that shows the pane for sync settings in the Azure portal, with the checkbox for image definitions highlighted." lightbox="./media/how-to-write-image-definition-file/customizations-project-sync-image-definitions.png":::
143
+
:::image type="content" source="./media/how-to-configure-team-customizations/customizations-project-sync-image-definitions.png" alt-text="Screenshot that shows the pane for sync settings in the Azure portal, with the checkbox for image definitions highlighted." lightbox="./media/how-to-configure-team-customizations/customizations-project-sync-image-definitions.png":::
144
144
145
145
## Attach a catalog that contains the definition file
146
146
147
147
Before you can use a customization file as an image definition, you must attach a catalog that contains the definition file to your dev center or project. The catalog can be from GitHub or Azure Repos.
148
148
149
149
The **Image definitions** pane lists the image definitions that your project can access.
150
150
151
-
:::image type="content" source="media/how-to-write-image-definition-file/team-customizations-image-definitions-small.png" alt-text="Screenshot that shows the Azure portal pane that lists accessible image definitions for a project." lightbox="media/how-to-write-image-definition-file/team-customizations-image-definitions.png":::
151
+
:::image type="content" source="media/how-to-configure-team-customizations/team-customizations-image-definitions-small.png" alt-text="Screenshot that shows the Azure portal pane that lists accessible image definitions for a project." lightbox="media/how-to-configure-team-customizations/team-customizations-image-definitions.png":::
152
152
153
153
For more information about how to attach catalogs, see [Add and configure a catalog from GitHub or Azure Repos](../deployment-environments/how-to-configure-catalog.md).
154
154
@@ -176,7 +176,7 @@ The following steps show you how to create a dev box pool and specify an image d
176
176
| **Time zone** | Select the time zone that the stop time is in. |
177
177
| **Licensing** | Select this checkbox to confirm that your organization has Azure Hybrid Benefit licenses that you want to apply to the dev boxes in this pool. |
178
178
179
-
:::image type="content" source="./media/how-to-write-image-definition-file/pool-specify-image-definition.png" alt-text="Screenshot that shows the pane for creating a dev box pool." lightbox="./media/how-to-write-image-definition-file/pool-specify-image-definition.png":::
179
+
:::image type="content" source="./media/how-to-configure-team-customizations/pool-specify-image-definition.png" alt-text="Screenshot that shows the pane for creating a dev box pool." lightbox="./media/how-to-configure-team-customizations/pool-specify-image-definition.png":::
180
180
181
181
1. Select **Create**.
182
182
1. Verify that the new dev box pool appears in the list. You might need to refresh the screen.
Copy file name to clipboardExpand all lines: articles/dev-box/how-to-configure-user-customizations.md
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -57,11 +57,11 @@ You can create and manage customization files by using VS Code. You can use the
57
57
1. Download an [example YAML customization file](https://aka.ms/devbox/usercustomizations/samplefile) from the samples repository and open it in VS Code.
58
58
1. Discover tasks available in the catalog by using the command palette. Select **View** > **Command Palette** > **Dev Box: List Available Tasks For This Dev Box**.
59
59
60
-
:::image type="content" source="media/how-to-write-individual-customization-file/dev-box-command-list-tasks.png" alt-text="Screenshot of the Dev Box command palette in Visual Studio Code, showing the command for listing available tasks.":::
60
+
:::image type="content" source="media/how-to-configure-user-customizations/dev-box-command-list-tasks.png" alt-text="Screenshot of the Dev Box command palette in Visual Studio Code, showing the command for listing available tasks.":::
61
61
62
62
1. Test customization in VS Code by using the command palette. Select **View** > **Command Palette** > **Dev Box: Apply Customizations Tasks**.
63
63
64
-
:::image type="content" source="media/how-to-write-individual-customization-file/dev-box-command-apply-tasks.png" alt-text="Screenshot of the Dev Box command palette in Visual Studio Code, showing the command for applying customization tasks.":::
64
+
:::image type="content" source="media/how-to-configure-user-customizations/dev-box-command-apply-tasks.png" alt-text="Screenshot of the Dev Box command palette in Visual Studio Code, showing the command for applying customization tasks.":::
65
65
66
66
1. The customization file runs and applies the specified tasks to your test dev box. Inspect the changes, and check the VS Code terminal for any errors or warnings generated during the task execution. Review the VS Code terminal for errors or warnings during task execution.
67
67
@@ -92,38 +92,38 @@ Customization files stored in a repository must be called *workload.yaml*. Custo
92
92
1. In the **Add a dev box** pane, add details for you dev box.
93
93
1. Select **Apply customizations**, and then select **Continue**.
94
94
95
-
:::image type="content" source="media/how-to-write-individual-customization-file/add-dev-box-individual-customization.png" alt-text="Screenshot of the Add a dev box pane in the developer portal, showing the option to apply customizations.":::
95
+
:::image type="content" source="media/how-to-configure-user-customizations/add-dev-box-individual-customization.png" alt-text="Screenshot of the Add a dev box pane in the developer portal, showing the option to apply customizations.":::
96
96
97
97
1. Select **Upload a customization file(s)**, select **Add customizations from file**, and then browse to and select your *myfilename.yaml* file.
98
98
99
-
:::image type="content" source="media/how-to-write-individual-customization-file/customize-dev-box-upload.png" alt-text="Screenshot of the Upload a customization file section in the developer portal, showing the option to add customizations from a file.":::
99
+
:::image type="content" source="media/how-to-configure-user-customizations/customize-dev-box-upload.png" alt-text="Screenshot of the Upload a customization file section in the developer portal, showing the option to add customizations from a file.":::
100
100
101
101
1. To verify that the tasks in your customizations file will be applied correctly, you must validate them before you can proceed. Select **Validate**.
102
102
103
-
:::image type="content" source="media/how-to-write-individual-customization-file/customize-dev-box-validate.png" alt-text="Screenshot of the Validate button in the developer portal, showing the option to validate the customization file before proceeding.":::
103
+
:::image type="content" source="media/how-to-configure-user-customizations/customize-dev-box-validate.png" alt-text="Screenshot of the Validate button in the developer portal, showing the option to validate the customization file before proceeding.":::
104
104
105
105
1. Review the dev box creation summary, and then select **Create**.
106
106
107
-
:::image type="content" source="media/how-to-write-individual-customization-file/customized-dev-box-create.png" alt-text="Screenshot of the dev box creation summary page in the developer portal, showing the option to create a customized dev box.":::
107
+
:::image type="content" source="media/how-to-configure-user-customizations/customized-dev-box-create.png" alt-text="Screenshot of the dev box creation summary page in the developer portal, showing the option to create a customized dev box.":::
108
108
109
109
### Get a file from a repository
110
110
1. In the [developer portal](https://aka.ms/devbox-portal), select **New** > **New dev box**.
111
111
1. In the **Add a dev box** pane, add details for you dev box.
112
112
1. Select **Apply customizations**, and then select **Continue**.
113
113
114
-
:::image type="content" source="media/how-to-write-individual-customization-file/add-dev-box-individual-customization.png" alt-text="Screenshot of the Add a dev box pane in the developer portal, showing the option to apply customizations.":::
114
+
:::image type="content" source="media/how-to-configure-user-customizations/add-dev-box-individual-customization.png" alt-text="Screenshot of the Add a dev box pane in the developer portal, showing the option to apply customizations.":::
115
115
116
116
1. Select **Upload a customization file(s)**, select **Choose a customization file from a repository**, and then enter the URL for the repository that stores your *workload.yaml* file.
117
117
118
-
:::image type="content" source="media/how-to-write-individual-customization-file/customize-dev-box-from-repository.png" alt-text="Screenshot of the Choose a customization file from a repository section in the developer portal, showing the option to enter a repository URL.":::
118
+
:::image type="content" source="media/how-to-configure-user-customizations/customize-dev-box-from-repository.png" alt-text="Screenshot of the Choose a customization file from a repository section in the developer portal, showing the option to enter a repository URL.":::
119
119
120
120
1. To verify that the tasks in your customizations file will be applied correctly, you must validate them before you can proceed. Select **Validate**.
121
121
122
-
:::image type="content" source="media/how-to-write-individual-customization-file/customize-dev-box-validate.png" alt-text="Screenshot of the Validate button in the developer portal, showing the option to validate the customization file before proceeding.":::
122
+
:::image type="content" source="media/how-to-configure-user-customizations/customize-dev-box-validate.png" alt-text="Screenshot of the Validate button in the developer portal, showing the option to validate the customization file before proceeding.":::
123
123
124
124
1. Review the dev box creation summary, and then select **Create**.
125
125
126
-
:::image type="content" source="media/how-to-write-individual-customization-file/customized-dev-box-create.png" alt-text="Screenshot of the dev box creation summary page in the developer portal, showing the option to create a customized dev box.":::
126
+
:::image type="content" source="media/how-to-configure-user-customizations/customized-dev-box-create.png" alt-text="Screenshot of the dev box creation summary page in the developer portal, showing the option to create a customized dev box.":::
0 commit comments