Skip to content

Commit 971b438

Browse files
author
RoseHJM
committed
Added other Preview limitations
1 parent a7dc11b commit 971b438

File tree

3 files changed

+15
-4
lines changed

3 files changed

+15
-4
lines changed

articles/dev-box/how-to-configure-customization-imaging.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -126,6 +126,9 @@ To build an image from a customization file, follow these steps:
126126
1. Track progress
127127

128128
:::image type="content" source="./media/how-to-configure-customization-imaging/customizations-image-build-progress-small.png" alt-text="Screenshot of the Image definition page, with the image status Progressing highlighted." lightbox="./media/how-to-configure-customization-imaging/customizations-image-build-progress.png":::
129+
130+
> [!IMPORTANT]
131+
> When 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 managed by Microsoft, and tasks that require access to on premise resources might fail. Support for specifying a custom network for an image build is coming soon.
129132
130133
When the build completes successfully, the dev box pool automatically uses the image for new dev boxes. You don't need to do any extra configuration to assign the image to the pool. You can now create dev boxes from the pool, and the customizations are applied to each dev box.
131134

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

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,8 @@ To configure your Key Vault secrets for use in your yaml configurations,
6161
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.
6262

6363
1. Grant the Secrets User role for the Key Vault secret to each user or user group who 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 who needs the secret during the customization of a dev box.
64+
65+
For more information on using key vault secrets in a customization file, see [Clone a private repository using a customization file](how-to-write-customization-file.md#clone-a-private-repository-using-a-customization-file).
6466

6567
## Attach a catalog
6668
You can attach a catalog to a project to make tasks accessible to the developer team. To attach a catalog to a project, follow the steps in this article: [Add and configure a catalog from GitHub or Azure Repos](../deployment-environments/how-to-configure-catalog.md).

articles/dev-box/how-to-write-customization-file.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,11 @@ tasks:
5151
directory: C:\Workspaces
5252
```
5353
54-
There are two ways to use a customization file: team customizations which apply to a whole team, and individual customizations which apply to a single dev box.
54+
There are two ways to use a customization file: individual customizations which apply to a single dev box, and team customizations which apply to a whole team.
55+
56+
### Individual Customization files
57+
- Contain tasks that are applied when a dev box is created.
58+
- Uploaded by the developer when they create a dev box.
5559
5660
### Team Customization files
5761
- Contain tasks that are applied when a dev box is created.
@@ -61,9 +65,11 @@ There are two ways to use a customization file: team customizations which apply
6165
- Are uploaded to the repository that hosts your catalog.
6266
- Are automatically used when you create a dev box from a configured pool.
6367
64-
### Individual Customization files
65-
- Contain tasks that are applied when a dev box is created.
66-
- Uploaded by the developer when they create a dev box.
68+
> [!IMPORTANT]
69+
> Image definitions can only use Dev Box marketplace images as base images. To get a list of images that your DevCenter has access to, use this az cli command:
70+
> ```bash
71+
> az devcenter admin image list --dev-center-name CustomizationsImagingHQ --resource-group TeamCustomizationsImagingRG --query "[].name"
72+
> ```
6773

6874
## Create a customization file
6975

0 commit comments

Comments
 (0)