|
1 | 1 | ---
|
2 | 2 | title: Configure Docker Offload
|
3 |
| -linktitle: Configure |
| 3 | +linktitle: Configuration |
4 | 4 | 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 |
7 | 7 | ---
|
8 | 8 |
|
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 |
11 | 10 |
|
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. |
15 | 13 |
|
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: |
28 | 15 |
|
29 | 16 | 1. Go to [Docker Home](https://app.docker.com/).
|
30 | 17 | 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**. |
100 | 19 |
|
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 |
104 | 21 |
|
| 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). |
0 commit comments