Skip to content

Commit 308d7ee

Browse files
committed
Update custom domain docs to align with new UI
1 parent a2c00de commit 308d7ee

File tree

3 files changed

+35
-27
lines changed

3 files changed

+35
-27
lines changed

src/content/docs/r2/buckets/public-buckets.mdx

Lines changed: 31 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Public Bucket is a feature that allows users to expose the contents of their R2
1212
Public buckets can be set up in either one of two ways:
1313

1414
- Expose your bucket as a custom domain under your control.
15-
- Expose your bucket as a Cloudflare-managed subdomain under `https://r2.dev`.
15+
- Expose your bucket using a Cloudflare-managed `https://r2.dev` subdomain for non-production use cases.
1616

1717
To configure WAF custom rules, caching, access controls, or bot management for your bucket, you must do so through a custom domain.
1818
Using a custom domain does not require enabling `r2.dev`.
@@ -46,14 +46,23 @@ To restrict access to your custom domain's bucket, use Cloudflare's existing sec
4646

4747
:::caution
4848

49-
Disable public access to your [`r2.dev` subdomain](#disable-managed-public-access) when using products like WAF or Cloudflare Access. If you do not disable public access, your bucket will remain publicly available through your `r2.dev` subdomain.
49+
Disable public access to your [`r2.dev` subdomain](#disable-public-development-url) when using products like WAF or Cloudflare Access. If you do not disable public access, your bucket will remain publicly available through your `r2.dev` subdomain.
5050

5151
:::
5252

5353
### Minimum TLS Version
5454

5555
To specify the minimum TLS version of a custom hostname of an R2 bucket, you can issue an API call to edit [R2 custom domain settings](/api/resources/r2/subresources/buckets/subresources/domains/subresources/custom/methods/update/).
5656

57+
## Add your domain to Cloudflare
58+
59+
The domain being used must have been added as a [zone](/fundamentals/setup/accounts-and-zones/#zones) in the same account as the R2 bucket.
60+
61+
- If your domain is already managed by Cloudflare, you can proceed to Connect a bucket to a custom domain.
62+
- If your domain is not managed by Cloudflare, you’ll need to set it up using a [partial (CNAME) setup](/dns/zone-setups/partial-setup/) to add it to your account.
63+
64+
Once the domain exists in your Cloudflare account (regardless of setup type), you can link it to your bucket.
65+
5766
## Connect a bucket to a custom domain
5867

5968
<Render file="custom-domain-steps" />
@@ -66,10 +75,6 @@ If the zone is on an Enterprise plan, make sure that you [release the zone hold]
6675

6776
:::
6877

69-
### Restrictions
70-
71-
There is a restriction when using custom domains to access R2 buckets. The domain being used must have been added as a [zone](/fundamentals/setup/accounts-and-zones/#zones) in the same account as the R2 bucket.
72-
7378
## Disable domain access
7479

7580
Disabling a domain will turn off public access to your bucket through that domain. Access through other domains or the managed `r2.dev` subdomain are unaffected.
@@ -78,10 +83,9 @@ The specified domain will also remain connected to R2 until you remove it or del
7883
To disable a domain:
7984

8085
1. In **R2**, select the bucket you want to modify.
81-
2. On the bucket page, Select **Settings**.
82-
3. Under **Public access** > **Custom Domains**, select **Connect Domain**.
83-
4. Next to the domain you want to disable, select **...** and **Disable domain**.
84-
5. The badge under **Access to Bucket** will update to **Not allowed**.
86+
2. On the bucket page, Select **Settings**, go to **Custom Domains**.
87+
3. Next to the domain you want to disable, select **...** and **Disable domain**.
88+
4. The badge under **Access to Bucket** will update to **Not allowed**.
8589

8690
## Remove domain
8791

@@ -90,45 +94,50 @@ Removing a domain will remove custom domain configuration that you have set up o
9094
To remove a domain:
9195

9296
1. In **R2**, select the bucket you want to modify.
93-
2. On the bucket page, select **Settings**.
94-
3. Under **Public access** > **Custom Domains**, select **Connect Domain**.
95-
4. Next to the domain you want to disable, select **...** and **Remove domain**.
96-
5. Select ‘Remove domain’ in the confirmation window. The CNAME record pointing to the domain will also be removed as part of this step. You can always add the domain again.
97+
2. On the bucket page, Select **Settings**, go to **Custom Domains**.
98+
3. Next to the domain you want to disable, select **...** and **Remove domain**.
99+
4. Select ‘Remove domain’ in the confirmation window. The CNAME record pointing to the domain will also be removed as part of this step. You can always add the domain again.
97100

98101
The domain is no longer connected to your bucket and will no longer appear in the connected domains list.
99102

100-
## Enable managed public access
103+
## Public Development URL
101104

102-
When you enable managed public access for your bucket, the content of your bucket is available to the Internet through a Cloudflare-managed `r2.dev` subdomain.
105+
Expose the contents of this R2 bucket to the internet through a Cloudflare-managed r2.dev subdomain.
106+
This is intended for non-production workflows such as development, testing, or demos.
103107

104108
:::note
105109

106110
Public access through `r2.dev` subdomains are rate limited and should only be used for development purposes.
107111

108112
To enable access management, Cache and bot management features, you must set up a custom domain when enabling public access to your bucket.
109113

114+
Do **not** create a CNAME record pointing to the `r2.dev` subdomain. This is an **unsupported access path**, and we cannot guarantee consistent reliability or performance.
115+
For production use, [add your domain to Cloudflare](#add-your-domain-to-cloudflare) instead.
110116
:::
111117

118+
### Enable public development url
119+
120+
When you enable public development URL access for your bucket, its contents become available on the internet through a Cloudflare-managed `r2.dev` subdomain.
121+
112122
To enable access through `r2.dev` for your buckets:
113123

114124
1. In **R2**, select the bucket you want to modify.
115125
2. On the bucket page, select **Settings**.
116-
3. In **Settings**, go to **Public Access**.
117-
4. Under **R2.dev subdomain**, select **Allow Access**.
118-
5. In **Allow Public Access?**, confirm your choice by typing ‘allow’ to confirm and select **Allow**.
119-
6. You can now access the bucket and its objects using the Public Bucket URL.
126+
3. Under **Public Development URL**, select **Enable**.
127+
4. In **Allow Public Access?**, confirm your choice by typing ‘allow’ to confirm and select **Allow**.
128+
5. You can now access the bucket and its objects using the Public Bucket URL.
120129

121130
You can review if your bucket is publicly accessible by going to your bucket and checking that **Public URL Access** states **Allowed**.
122131

123-
## Disable managed public access
132+
### Disable public development url
124133

125134
Your bucket will not be exposed to the Internet as an `r2.dev` subdomain after you disable public access. If you have connected other domains, the bucket will remain accessible on those domains.
126135

127136
To disable public access for your bucket:
128137

129138
1. In **R2**, select the bucket you want to modify.
130139
2. On the bucket page, select **Settings**.
131-
3. Under **Bucket Details** > **R2.dev subdomain**, select **Disallow Access**.
140+
3. Under **Public Development URL**, select **Disable**.
132141
4. In **Disallow Public Access?**, type ‘disallow’ to confirm and select **Disallow**.
133142

134143
Your bucket and its objects can no longer be accessed using the Public Bucket URL.

src/content/docs/r2/data-migration/sippy.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ Before getting started, you will need:
4444

4545
1. From the Cloudflare dashboard, select **R2** from the sidebar.
4646
2. Select the bucket you'd like to migrate objects to.
47-
3. Switch to the **Settings** tab, then scroll down to the **Incremental migration** card.
47+
3. Switch to the **Settings** tab, then scroll down to the **On Demand Migration** card.
4848
4. Select **Enable** and enter details for the AWS / GCS bucket you'd like to migrate objects from. The credentials you enter must have permissions to read from this bucket. Cloudflare also recommends scoping your credentials to only allow reads from this bucket.
4949
5. Select **Enable**.
5050

@@ -122,7 +122,7 @@ You can optionally select a time window to query. This defaults to the last 24 h
122122

123123
1. From the Cloudflare dashboard, select **R2** from the sidebar.
124124
2. Select the bucket you'd like to disable Sippy for.
125-
3. Switch to the **Settings** tab and scroll down to the **Incremental migration** card.
125+
3. Switch to the **Settings** tab and scroll down to the **On Demand Migration** card.
126126
4. Press **Disable**.
127127

128128
### Wrangler
Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,11 @@
11
---
22
{}
3-
43
---
54

65
1. Go to **R2** and select your bucket.
76
2. On the bucket page, select **Settings**.
8-
3. Under **Public access** > **Custom Domains**, select **Connect Domain**.
7+
3. Under **Custom Domains**, select **Add**.
98
4. Enter the domain name you want to connect to and select **Continue**.
109
5. Review the new record that will be added to the DNS table and select **Connect Domain**.
1110

12-
Your domain is now connected. The status takes a few minutes to change from **Initializing** to **Active**, and you may need to refresh to review the status update. If the status has not changed, select the *...* next to your bucket and select **Retry connection**.
11+
Your domain is now connected. The status takes a few minutes to change from **Initializing** to **Active**, and you may need to refresh to review the status update. If the status has not changed, select the _..._ next to your bucket and select **Retry connection**.

0 commit comments

Comments
 (0)