Skip to content

Commit 3738b3a

Browse files
offload: ga updates
Signed-off-by: Craig <[email protected]>
1 parent fc52d9e commit 3738b3a

File tree

10 files changed

+77
-319
lines changed

10 files changed

+77
-319
lines changed

content/manuals/_index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ params:
6060
icon: /icons/dhi.svg
6161
link: /dhi/
6262
- title: Docker Offload
63-
description: Build and run containers in the cloud.
63+
description: Run containers on GPU-accelerated infrastructure in the cloud.
6464
icon: cloud
6565
link: /offload/
6666
- title: Build Cloud

content/manuals/desktop/setup/vm-vdi.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ hosted cloud environment, enabling a seamless hybrid experience.
2626

2727
Docker Offload is useful in virtual desktop environments where nested
2828
virtualization isn't supported. In these environments, Docker Desktop defaults
29-
to using Docker Offload to ensure you can still build and run containers without
29+
to using Docker Offload to ensure you can still run containers without
3030
relying on local virtualization.
3131

3232
Docker Offload decouples the Docker Desktop client from the Docker Engine,

content/manuals/offload/_index.md

Lines changed: 9 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,11 @@
11
---
22
title: Docker Offload
33
weight: 15
4-
description: Find documentation on Docker Offload to help you build and run your container images faster, both locally and in CI
5-
keywords: build, cloud, cloud build, remote builder
4+
description: Find documentation on Docker Offload to help you run your container images faster
5+
keywords: cloud, cloud run, offload
66
params:
77
sidebar:
88
group: Products
9-
badge:
10-
color: blue
11-
text: Beta
129

1310
grid:
1411

@@ -22,21 +19,16 @@ grid:
2219
icon: info
2320
link: /offload/about/
2421

25-
- title: Configure
26-
description: Set up and customize your cloud build environments.
22+
- title: Configuration
23+
description: Configure settings for Docker Offload.
2724
icon: tune
2825
link: /offload/configuration/
2926

30-
- title: Usage
27+
- title: Usage & billing
3128
description: Learn about Docker Offload usage and how to monitor your cloud resources.
3229
icon: monitor_heart
3330
link: /offload/usage/
3431

35-
- title: Optimize
36-
description: Improve performance, caching, and cost efficiency in Docker Offload.
37-
icon: speed
38-
link: /offload/optimize/
39-
4032
- title: Troubleshoot
4133
description: Learn how to troubleshoot issues with Docker Offload.
4234
icon: bug_report
@@ -53,10 +45,10 @@ aliases:
5345

5446
{{< summary-bar feature_name="Docker Offload" >}}
5547

56-
Docker Offload is a fully managed service that lets you offload building and
57-
running containers to the cloud using the Docker tools you already know. It
58-
provides cloud infrastructure for fast, consistent builds and compute-heavy
59-
workloads like running LLMs or machine learning pipelines.
48+
Docker Offload is a fully managed service that lets you offload running
49+
containers to the cloud using the Docker tools you already know. It provides
50+
cloud infrastructure for compute-heavy workloads like running LLMs or machine
51+
learning pipelines.
6052

6153
In the following topics, learn about Docker Offload, how to set it up, use it
6254
for your workflows, and troubleshoot common issues.

content/manuals/offload/about.md

Lines changed: 8 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -3,15 +3,13 @@ title: About Docker Offload
33
linktitle: About
44
weight: 15
55
description: Learn about Docker Offload, its features, and how it works.
6-
keywords: cloud, build, remote builder
6+
keywords: cloud, run, offload
77
---
88

9-
Docker Offload is a fully managed service for building and running containers in
10-
the cloud using the Docker tools you already know, including Docker Desktop, the
11-
Docker CLI, and Docker Compose. It extends your local development workflow into a
12-
scalable, cloud-powered environment, so you can offload compute-heavy tasks,
13-
accelerate builds, and securely manage container workloads across the software
14-
lifecycle.
9+
Docker Offload is a fully managed service for running containers in the cloud
10+
using the Docker tools you already know, including Docker Desktop, the Docker
11+
CLI, and Docker Compose. It extends your local development workflow into a
12+
scalable, cloud-powered environment, so you can offload compute-heavy tasks.
1513

1614
Docker Offload also supports GPU-accelerated instances, allowing you to
1715
containerize and run compute-intensive workloads such as Docker Model Runner and
@@ -22,13 +20,10 @@ other machine learning or data processing tasks that benefit from GPU.
2220
Docker Offload includes the following capabilities to support modern container
2321
workflows:
2422

25-
- Cloud-based builds: Execute builds on remote, fully managed BuildKit instances
2623
- GPU acceleration: Use NVIDIA L4 GPU-backed environments for machine learning,
2724
media processing, and other compute-intensive workloads.
2825
- Ephemeral cloud runners: Automatically provision and tear down cloud
2926
environments for each container session.
30-
- Shared build cache: Speed up build times across machines and teammates with a
31-
smart, shared cache layer.
3227
- Hybrid workflows: Seamlessly transition between local and remote execution
3328
using Docker Desktop or CLI.
3429
- Secure communication: Use encrypted tunnels between Docker Desktop and cloud
@@ -43,10 +38,9 @@ workflows:
4338
Docker Offload is designed to support modern development teams working across
4439
local and cloud environments. It helps you:
4540

46-
- Offload heavy builds and runs to fast, scalable infrastructure
4741
- Accelerate feedback loops in development and testing
4842
- Run containers that require more resources than your local setup can provide
49-
- Build and run AI apps with instant access to GPU-powered environments
43+
- Run AI apps with instant access to GPU-powered environments
5044
- Use Docker Compose to manage complex, multi-service apps that need cloud
5145
resources
5246
- Maintain consistent environments without managing custom infrastructure
@@ -58,31 +52,8 @@ local tools.
5852

5953
## How Docker Offload works
6054

61-
Docker Offload replaces the need to build or run containers locally by connecting
62-
Docker Desktop to secure, dedicated cloud resources.
63-
64-
### Building with Docker Offload
65-
66-
When you use Docker Offload for builds, the `docker buildx build` command sends
67-
the build request to a remote BuildKit instance in the cloud, instead of
68-
executing it locally. Your workflow stays the same, only the execution
69-
environment changes.
70-
71-
The build runs on infrastructure provisioned and managed by Docker:
72-
73-
- Each cloud builder is an isolated Amazon EC2 instance with its own EBS volume
74-
- Remote builders use a shared cache to speed up builds across machines and
75-
teammates
76-
- Build results are encrypted in transit and sent to your specified destination
77-
(such as a registry or local image store)
78-
79-
Docker Offload manages the lifecycle of builders automatically. There's no need to
80-
provision or maintain infrastructure.
81-
82-
> [!NOTE]
83-
>
84-
> Docker Offload builders are currently hosted in the United States East region. Users in
85-
> other regions may experience increased latency.
55+
Docker Offload replaces the need to run containers locally by connecting Docker
56+
Desktop to secure, dedicated cloud resources.
8657

8758
### Running containers with Docker Offload
8859

Lines changed: 14 additions & 92 deletions
Original file line numberDiff line numberDiff line change
@@ -1,104 +1,26 @@
11
---
22
title: Configure Docker Offload
3-
linktitle: Configure
3+
linktitle: Configuration
44
weight: 20
5-
description: Learn how to configure build settings for Docker Offload.
6-
keywords: cloud, configuration, settings, cloud builder, GPU, disk allocation, private resources, firewall
5+
description: Learn how to configure settings for Docker Offload.
6+
keywords: cloud, configuration, settings, GPU
77
---
88

9-
To use Docker Offload, you must start it in Docker Desktop. For more details,
10-
see the [Docker Offload quickstart](/offload/quickstart/).
9+
## Run settings
1110

12-
Settings for the cloud builders in Docker Offload can be further configured, in
13-
addition to settings for an entire organization, through **Offload settings** in
14-
the Docker Offload dashboard.
11+
The **Run settings** page in Docker Home lets you configure tenancy and data
12+
settings for Docker Offload in your organization.
1513

16-
> [!NOTE]
17-
>
18-
> To view usage and configure billing for Docker Offload, see [Docker Offload
19-
> usage and billing](/offload/usage/).
20-
21-
## Offload settings
22-
23-
The **Offload settings** page in Docker Home lets you configure disk
24-
allocation, private resource access, and firewall settings for your cloud
25-
builders in your organization.
26-
27-
To view the **Offload settings** page:
14+
To view the **Run settings** page:
2815

2916
1. Go to [Docker Home](https://app.docker.com/).
3017
2. Select the account for which you want to manage Docker Offload.
31-
3. Select **Offload** > **Offload settings**.
32-
33-
The following sections describe the available settings.
34-
35-
### Disk allocation
36-
37-
The **Disk allocation** setting lets you control how much of the available
38-
storage is dedicated to the build cache. A lower allocation increases storage
39-
available for active builds.
40-
41-
Adjust the **Disk allocation** slider to specify the percentage of storage used
42-
for build caching.
43-
44-
Any changes take effect immediately.
45-
46-
> [!TIP]
47-
>
48-
> If you build very large images, consider allocating less storage for caching.
49-
50-
### Build cache space
51-
52-
Your subscription includes the following Build cache space:
53-
54-
| Subscription | Build cache space |
55-
|--------------|-------------------|
56-
| Personal | N/A |
57-
| Pro | 50GB |
58-
| Team | 100GB |
59-
| Business | 200GB |
60-
61-
To get more Build cache space, [upgrade your subscription](/manuals/subscription/change.md).
62-
63-
### Private resource access
64-
65-
Private resource access lets cloud builders pull images and packages from
66-
private resources. This feature is useful when builds rely on self-hosted
67-
artifact repositories or private OCI registries.
68-
69-
For example, if your organization hosts a private [PyPI](https://pypi.org/)
70-
repository on a private network, Docker Build Cloud would not be able to access
71-
it by default, since the cloud builder is not connected to your private network.
72-
73-
To enable your cloud builders to access your private resources, enter the host
74-
name and port of your private resource and then select **Add**.
75-
76-
#### Authentication
77-
78-
If your internal artifacts require authentication, make sure that you
79-
authenticate with the repository either before or during the build. For internal
80-
package repositories for npm or PyPI, use [build
81-
secrets](/manuals/build/building/secrets.md) to authenticate during the build.
82-
For internal OCI registries, use `docker login` to authenticate before building.
83-
84-
Note that if you use a private registry that requires authentication, you will
85-
need to authenticate with `docker login` twice before building. This is because
86-
the cloud builder needs to authenticate with Docker to use the cloud builder,
87-
and then again to authenticate with the private registry.
88-
89-
```console
90-
$ echo $DOCKER_PAT | docker login docker.io -u <username> --password-stdin
91-
$ echo $REGISTRY_PASSWORD | docker login registry.example.com -u <username> --password-stdin
92-
$ docker build --builder <cloud-builder> --tag registry.example.com/<image> --push .
93-
```
94-
95-
### Firewall
96-
97-
Firewall settings let you restrict cloud builder egress traffic to specific IP
98-
addresses. This helps enhance security by limiting external network egress from
99-
the builder.
18+
3. Select **Offload** > **Run settings**.
10019

101-
1. Select **Enable firewall: Restrict cloud builder egress to specific public IP address**.
102-
2. Enter the IP address you want to allow.
103-
3. Select **Add** to apply the restriction.
20+
## Organization settings
10421

22+
By default, Docker Offload is disabled for all members of an organization. An
23+
organization owner must enable Offload access for the organization. For more
24+
details on how to configure Docker Offload access as well as other
25+
organization-wide settings, see [Manage Docker
26+
products](./../admin/organization/manage-products.md).

content/manuals/offload/optimize.md

Lines changed: 0 additions & 83 deletions
This file was deleted.

0 commit comments

Comments
 (0)