|
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