mirror of https://github.com/docker/docs.git
				
				
				
			desktop,cloud: add vdi beta (#22696)
<!--Delete sections as needed --> ## Description Added Cloud VDI Beta https://deploy-preview-22696--docsdocker.netlify.app/desktop/setup/vm-vdi/ ## Related issues or tickets ENGDOCS-2649 ## Reviews <!-- Notes for reviewers here --> <!-- List applicable reviews (optionally @tag reviewers) --> - [ ] Technical review - [ ] Editorial review - [ ] Product review --------- Signed-off-by: Craig <craig.osterhout@docker.com> Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
This commit is contained in:
		
							parent
							
								
									643956d16d
								
							
						
					
					
						commit
						347733c276
					
				
										
											Binary file not shown.
										
									
								
							| After Width: | Height: | Size: 457 B | 
|  | @ -9,11 +9,91 @@ aliases: | |||
| weight: 30 | ||||
| --- | ||||
| 
 | ||||
| Docker recommends running Docker Desktop natively on Mac, Linux, or Windows.  However, Docker Desktop for Windows can run inside a virtual desktop provided the virtual desktop is properly configured.  | ||||
| Docker recommends running Docker Desktop natively on Mac, Linux, or Windows. However, Docker Desktop for Windows can run inside a virtual desktop provided the virtual desktop is properly configured. | ||||
| 
 | ||||
| To run Docker Desktop in a virtual desktop environment, it is essential nested virtualization is enabled on the virtual machine that provides the virtual desktop. This is because, under the hood, Docker Desktop is using a Linux VM in which it runs Docker Engine and the containers. | ||||
| To run Docker Desktop in a virtual desktop environment, you have two options, | ||||
| depending on whether nested virtualization is supported: | ||||
| 
 | ||||
| ## Virtual desktop support | ||||
| - If your environment supports nested virtualization, you can run Docker Desktop | ||||
|   with its default local Linux VM. | ||||
| - If nested virtualization is not supported, Docker recommends using Docker | ||||
|   Cloud. To join the beta, contact Docker at `docker-cloud@docker.com`. | ||||
| 
 | ||||
| ## Use Docker Cloud  | ||||
| 
 | ||||
| {{< summary-bar feature_name="Docker Cloud" >}} | ||||
| 
 | ||||
| Docker Cloud lets you offload container workloads to a high-performance, | ||||
| fully hosted cloud environment, enabling a seamless hybrid experience. It | ||||
| includes an insights dashboard that offers performance metrics and environment | ||||
| management to help optimize your development workflow. | ||||
| 
 | ||||
| This mode is useful in virtual desktop environments where nested virtualization | ||||
| isn't supported. In these environments, Docker Desktop defaults to using | ||||
| cloud mode to ensure you can still build and run containers without relying on | ||||
| local virtualization. | ||||
| 
 | ||||
| Docker Cloud decouples the Docker Desktop client from the Docker Engine, | ||||
| allowing the Docker CLI and Docker Desktop Dashboard to interact with | ||||
| cloud-based resources as if they were local. When you run a container, Docker | ||||
| provisions a secure, isolated, and ephemeral cloud environment connected to | ||||
| Docker Desktop via an SSH tunnel. Despite running remotely, features like bind | ||||
| mounts and port forwarding continue to work seamlessly, providing a local-like | ||||
| experience. To use Docker Cloud: | ||||
| 
 | ||||
| 1. Contact Docker at `docker-cloud@docker.com` to activate the feature for your | ||||
|    account. | ||||
| 2. [Install Docker Desktop](/manuals/desktop/setup/install/windows-install.md#install-docker-desktop-on-windows) | ||||
|    version 4.42 or later on your Windows virtual desktop. | ||||
| 3. [Start Docker Desktop](/manuals/desktop/setup/install/windows-install.md#start-docker-desktop). | ||||
| 4. Sign in to Docker Desktop. | ||||
| 
 | ||||
| After you sign in, Docker Cloud is enabled by default and cannot be | ||||
| disabled. When enabled, Docker Desktop's Dashboard header appears purple and the | ||||
| cloud-mode toggle is a cloud icon ({{< inline-image | ||||
| src="./images/cloud-mode.png" alt="Cloud mode icon" >}}). | ||||
| 
 | ||||
| In this mode, Docker Desktop mirrors your cloud environment, providing | ||||
| a seamless view of your containers and resources running on Docker Cloud. You | ||||
| can verify that Docker Cloud is working by running a simple container. In a | ||||
| terminal on your virtual desktop, run the following command: | ||||
| 
 | ||||
| ```console | ||||
| $ docker run hello-world | ||||
| ``` | ||||
| 
 | ||||
| In the terminal, you will see `Hello from Docker!` if everything is working | ||||
| correctly. | ||||
| 
 | ||||
| ### View insights and manage Docker Cloud | ||||
| 
 | ||||
| For insights and management, use the [Docker Cloud | ||||
| Dashboard](https://app.docker.com/cloud). It provides visibility into your | ||||
| builds, runs, and cloud resource usage. Key features include: | ||||
| 
 | ||||
| - Overview: Monitor cloud usage, build cache, and top repositories built. | ||||
| - Build history: Review past builds with filtering and sorting options. | ||||
| - Run history: Track container runs and sort by various options. | ||||
| - Integrations: Learn how to set up cloud builders and runners for your CI | ||||
|   pipeline. | ||||
| - Settings: Manage cloud builders, usage, and account settings. | ||||
| 
 | ||||
| Access the Docker Cloud Dashboard at https://app.docker.com/cloud. | ||||
| 
 | ||||
| ### Limitations | ||||
| 
 | ||||
| The following limitations apply when using Docker Cloud: | ||||
| 
 | ||||
| - Persistence: Containers are launched in a cloud engine that remains available | ||||
|   as long as you interact with and consume the containers' output. After closing | ||||
|   Docker Desktop, or about 30 minutes of inactivity, the engine is shut down and | ||||
|   becomes inaccessible, along with any data stored in it, including images, | ||||
|   containers, and volumes. A new engine is provisioned for any new workloads. | ||||
| - Usage and billing: During beta, no charges are incurred for using Docker Cloud | ||||
|   resources. Docker enforces a usage cap and reserves the right to disable | ||||
|   Docker Cloud access at any time. | ||||
| 
 | ||||
| ## Virtual desktop support when using nested virtualization | ||||
| 
 | ||||
| > [!NOTE] | ||||
| > | ||||
|  | @ -33,7 +113,8 @@ Docker does not support running multiple instances of Docker Desktop on the same | |||
| 
 | ||||
| ## Turn on nested virtualization | ||||
| 
 | ||||
| You must turn on nested virtualization before you install Docker Desktop on a virtual machine. | ||||
| You must turn on nested virtualization before you install Docker Desktop on a | ||||
| virtual machine that will not use Docker Cloud. | ||||
| 
 | ||||
| ### Turn on nested virtualization on VMware ESXi | ||||
| 
 | ||||
|  | @ -55,7 +136,7 @@ If using Windows container mode, confirm that the Nutanix environment supports H | |||
| 
 | ||||
| ### Supported configurations | ||||
| 
 | ||||
| Docker Desktop follows the VDI support definitions outlined [previously](#virtual-desktop-support): | ||||
| Docker Desktop follows the VDI support definitions outlined [previously](#virtual-desktop-support-when-using-nested-virtualization): | ||||
| 
 | ||||
|  - Persistent VDI environments (Supported): You receive the same virtual desktop instance across sessions, preserving installed software and configurations. | ||||
| 
 | ||||
|  |  | |||
|  | @ -135,6 +135,9 @@ Docker Build Cloud: | |||
|   subscription: [Pro, Team, Business] | ||||
| Docker CLI OpenTelemetry: | ||||
|   requires: Docker Engine [26.1.0](/manuals/engine/release-notes/26.1.md#2610) and later | ||||
| Docker Cloud: | ||||
|   availability: Beta | ||||
|   requires: Docker Desktop 4.42 and later | ||||
| docker compose alpha: | ||||
|   availability: Experimental | ||||
| Docker Debug: | ||||
|  |  | |||
		Loading…
	
		Reference in New Issue