From 84efc5217d00fd76aadc050c372b264f78d6c196 Mon Sep 17 00:00:00 2001 From: aevesdocker Date: Wed, 30 Apr 2025 13:47:31 +0100 Subject: [PATCH 1/3] ENGDOCS-2595 --- content/manuals/desktop/features/dev-box.md | 55 +++++++++++++++++++++ content/manuals/desktop/setup/vm-vdi.md | 4 ++ 2 files changed, 59 insertions(+) create mode 100644 content/manuals/desktop/features/dev-box.md diff --git a/content/manuals/desktop/features/dev-box.md b/content/manuals/desktop/features/dev-box.md new file mode 100644 index 000000000000..41a7eaa35404 --- /dev/null +++ b/content/manuals/desktop/features/dev-box.md @@ -0,0 +1,55 @@ +--- +Title: Docker Desktop in Microsoft Dev Box +description: Learn about the benefits of and how to setup Docker Desktop in Microsoft Dev Box +keywords: desktop, docker, windows, microsoft dev box +--- + +Docker Desktop is available as a pre-configured image in the Microsoft Azure Marketplace for use with Microsoft Dev Box, allowing developers to quickly set up consistent development environments in the cloud. + +Microsoft Dev Box provides cloud-based, pre-configured developer workstations that allow you to code, build, and test applications without configuring a local development environment. The Docker Desktop image for Microsoft Dev Box comes with Docker Desktop and its dependencies pre-installed, giving you a ready-to-use containerized development environment. + +## Key benefits + +- Pre-configured environment: Docker Desktop, WSL2, and other requirements come pre-installed and configured +- Consistent development: Ensure all team members work with the same Docker environment +- Powerful resources: Access more compute power and storage than might be available on local machines +- State persistence: Dev Box maintains your state between sessions, similar to hibernating a local machine +- Seamless licensing: Use your existing Docker subscription or purchase a new one directly through Azure Marketplace + +## Setup + +### Prerequisites + +- An Azure subscription +- Access to Microsoft Dev Box +- A Docker subscription (Pro, Team, or Business). You can use Docker Desktop in Microsoft Dev Box with any of the following subscription options: + - An existing Docker subscription (sign in with your Docker ID) + - A new Docker subscription purchased through Azure Marketplace + - A Docker Business subscription with SSO configured for your organization + +### Setting up Docker Desktop in Dev Box + +1. Navigate to the [Docker Desktop for Microsoft Dev Box](https://azuremarketplace.microsoft.com/en-us/marketplace/apps/dockerinc1694120899427.devbox_azuremachine?tab=Overview) listing in Azure Marketplace. +2. Select **Get It Now** to add the virtual machine image to your subscription +3. Follow the Azure workflow to complete the setup +4. Use the image to create VMs, assign to Dev Centers, or create Dev Box Pools according to your organization's setup + +### Activate Docker Desktop + +Once your Dev Box is provisioned with the Docker Desktop image: + +1. Start your Dev Box instance. +2. Launch Docker Desktop. +3. Sign in with your Docker ID + +## Support + +For issues related to: + +- Docker Desktop configuration, usage, or licensing: Create a support ticket through [Docker Support](https://hub.docker.com/support) +- Dev Box creation, Azure portal configuration, or networking: Contact Azure Support + +## Limitations + +- Microsoft Dev Box is currently only available on Windows 10 & 11 (Linux VMs are not supported) +- Performance may vary based on your Dev Box configuration and network conditions diff --git a/content/manuals/desktop/setup/vm-vdi.md b/content/manuals/desktop/setup/vm-vdi.md index 37333024258e..b51978247761 100644 --- a/content/manuals/desktop/setup/vm-vdi.md +++ b/content/manuals/desktop/setup/vm-vdi.md @@ -64,3 +64,7 @@ Docker Desktop follows the VDI support definitions outlined [previously](#virtua ### Support scope and responsibilities For WSL 2-related issues, contact Nutanix support. For Docker Desktop-specific issues, contact Docker support. + +## Aditional resources + +- [Docker Desktop on Microsoft Dev Box](/manuals/desktop/features/dev-box.md) \ No newline at end of file From 92c5a89f70ca0810f0cf9f09466c7399e1b2d2a0 Mon Sep 17 00:00:00 2001 From: aevesdocker Date: Wed, 30 Apr 2025 14:41:46 +0100 Subject: [PATCH 2/3] ENGDOCS-2595 --- content/manuals/desktop/features/dev-box.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/desktop/features/dev-box.md b/content/manuals/desktop/features/dev-box.md index 41a7eaa35404..0a4f52911c59 100644 --- a/content/manuals/desktop/features/dev-box.md +++ b/content/manuals/desktop/features/dev-box.md @@ -23,7 +23,7 @@ Microsoft Dev Box provides cloud-based, pre-configured developer workstations th - An Azure subscription - Access to Microsoft Dev Box - A Docker subscription (Pro, Team, or Business). You can use Docker Desktop in Microsoft Dev Box with any of the following subscription options: - - An existing Docker subscription (sign in with your Docker ID) + - An existing or new Docker subscription - A new Docker subscription purchased through Azure Marketplace - A Docker Business subscription with SSO configured for your organization From 05b51d107ee0c0661e875eba202ee7e6a45e6e8e Mon Sep 17 00:00:00 2001 From: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> Date: Thu, 1 May 2025 14:14:32 +0100 Subject: [PATCH 3/3] Apply suggestions from code review Co-authored-by: Sarah Sanders --- content/manuals/desktop/features/dev-box.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/content/manuals/desktop/features/dev-box.md b/content/manuals/desktop/features/dev-box.md index 0a4f52911c59..31f7b7822cd9 100644 --- a/content/manuals/desktop/features/dev-box.md +++ b/content/manuals/desktop/features/dev-box.md @@ -27,12 +27,12 @@ Microsoft Dev Box provides cloud-based, pre-configured developer workstations th - A new Docker subscription purchased through Azure Marketplace - A Docker Business subscription with SSO configured for your organization -### Setting up Docker Desktop in Dev Box +### Set up Docker Desktop in Dev Box 1. Navigate to the [Docker Desktop for Microsoft Dev Box](https://azuremarketplace.microsoft.com/en-us/marketplace/apps/dockerinc1694120899427.devbox_azuremachine?tab=Overview) listing in Azure Marketplace. -2. Select **Get It Now** to add the virtual machine image to your subscription -3. Follow the Azure workflow to complete the setup -4. Use the image to create VMs, assign to Dev Centers, or create Dev Box Pools according to your organization's setup +2. Select **Get It Now** to add the virtual machine image to your subscription. +3. Follow the Azure workflow to complete the setup. +4. Use the image to create VMs, assign to Dev Centers, or create Dev Box Pools according to your organization's setup. ### Activate Docker Desktop @@ -40,16 +40,16 @@ Once your Dev Box is provisioned with the Docker Desktop image: 1. Start your Dev Box instance. 2. Launch Docker Desktop. -3. Sign in with your Docker ID +3. Sign in with your Docker ID. ## Support For issues related to: -- Docker Desktop configuration, usage, or licensing: Create a support ticket through [Docker Support](https://hub.docker.com/support) -- Dev Box creation, Azure portal configuration, or networking: Contact Azure Support +- Docker Desktop configuration, usage, or licensing: Create a support ticket through [Docker Support](https://hub.docker.com/support). +- Dev Box creation, Azure portal configuration, or networking: Contact Azure Support. ## Limitations -- Microsoft Dev Box is currently only available on Windows 10 & 11 (Linux VMs are not supported) -- Performance may vary based on your Dev Box configuration and network conditions +- Microsoft Dev Box is currently only available on Windows 10 and 11 (Linux VMs are not supported). +- Performance may vary based on your Dev Box configuration and network conditions.