[DNS] Zone conversions guides #17088
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Deploying cloudflare-docs with
|
| Latest commit: |
101d0d9
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://123c608a.cloudflare-docs-7ou.pages.dev |
| Branch Preview URL: | https://rebecca-dns-zone-setup-conve.cloudflare-docs-7ou.pages.dev |
Contributor
Contributor
|
This PR changes current filenames or deletes current files. Make sure you have redirects set up to cover the following paths:
|
RebeccaTamachiro
requested review from
a team,
GregBrimble,
KianNH,
WalshyDev and
pedrosousa
as code owners
Oxyjun
reviewed
Oct 15, 2024
src/content/docs/dns/zone-setups/conversions/convert-full-to-secondary.mdx
Outdated
Show resolved
Hide resolved
Oxyjun
reviewed
Oct 15, 2024
| 3. Link the peer server you created in the previous steps and select **Save**. | ||
| 4. On **DNS** > **Settings**, select **Initiate zone transfer**. | ||
| 5. Confirm the DNS records are transferring as expected. | ||
| 6. Go to [**DNS** > **Records**](https://dash.cloudflare.com/?to=/:account/:zone/dns/records) and take note of your new **Cloudflare Nameservers**. |
Contributor
There was a problem hiding this comment.
Suggested change
| 6. Go to [**DNS** > **Records**](https://dash.cloudflare.com/?to=/:account/:zone/dns/records) and take note of your new **Cloudflare Nameservers**. | |
| 6. Go to [**DNS** > **Records**](https://dash.cloudflare.com/?to=/:account/:zone/dns/records) and take note of your new **Cloudflare nameservers**. |
I could be wrong on this, but in the same way we say Cloudflare dashboard (lowercase "d"), I thought maybe this should be Cloudflare nameservers, with a lowercase n.
Contributor
Author
There was a problem hiding this comment.
I agree with this reasoning and have used nameservers elsewhere, but have kept it like this in these guides to mirror the card name in the dashboard.
Oxyjun
reviewed
Oct 15, 2024
|
|
||
| ## 2. Prepare for the conversion | ||
|
|
||
| 1. Plan for [DNSSEC settings](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/dnssec-for-secondary/). If you were previously using [Pre-signed DNSSEC](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/dnssec-for-secondary/#set-up-pre-signed-dnssec), consider disabling DNSSEC before starting the conversion. |
Contributor
There was a problem hiding this comment.
Suggested change
| 1. Plan for [DNSSEC settings](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/dnssec-for-secondary/). If you were previously using [Pre-signed DNSSEC](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/dnssec-for-secondary/#set-up-pre-signed-dnssec), consider disabling DNSSEC before starting the conversion. | |
| 1. Plan for [DNSSEC settings](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/dnssec-for-secondary/). If you were previously using [presigned DNSSEC](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/dnssec-for-secondary/#set-up-pre-signed-dnssec), consider disabling DNSSEC before starting the conversion. |
I've seen both presigned and pre-signed being used in the docs. Happy to be overruled here.
Oxyjun
reviewed
Oct 15, 2024
| 1. Plan for [DNSSEC settings](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/dnssec-for-secondary/). If you were previously using [Pre-signed DNSSEC](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/dnssec-for-secondary/#set-up-pre-signed-dnssec), consider disabling DNSSEC before starting the conversion. | ||
| 2. Make sure the [proxy statuses](/dns/manage-dns-records/reference/proxied-dns-records/) of your DNS records are consistently set: | ||
|
|
||
| - If you have [Secondary DNS override](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/proxy-traffic/), confirm each record has the appropriate setting (**Proxied** or **DNS only**). |
Contributor
There was a problem hiding this comment.
Suggested change
| - If you have [Secondary DNS override](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/proxy-traffic/), confirm each record has the appropriate setting (**Proxied** or **DNS only**). | |
| - If you have [secondary DNS override](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/proxy-traffic/), confirm each record has the appropriate setting (**Proxied** or **DNS only**). |
Contributor
Author
There was a problem hiding this comment.
I think we've been consistently using the capitalized form, as this is considered the name of a Cloudflare feature.
Oxyjun
reviewed
Oct 15, 2024
| 2. Make sure the [proxy statuses](/dns/manage-dns-records/reference/proxied-dns-records/) of your DNS records are consistently set: | ||
|
|
||
| - If you have [Secondary DNS override](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/proxy-traffic/), confirm each record has the appropriate setting (**Proxied** or **DNS only**). | ||
| - If [Secondary DNS override](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/proxy-traffic/) is disabled, make sure all of your DNS records are listed as **DNS only**. |
Contributor
There was a problem hiding this comment.
Suggested change
| - If [Secondary DNS override](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/proxy-traffic/) is disabled, make sure all of your DNS records are listed as **DNS only**. | |
| - If [secondary DNS override](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/proxy-traffic/) is disabled, make sure all of your DNS records are listed as **DNS only**. |
Oxyjun
reviewed
Oct 15, 2024
src/content/docs/dns/zone-setups/conversions/convert-secondary-to-full.mdx
Outdated
Show resolved
Hide resolved
Oxyjun
reviewed
Oct 15, 2024
| ## 3. Convert your zone | ||
|
|
||
| 1. Use the [Edit Zone endpoint](/api/operations/zones-0-patch) with `type` set to `full`, to convert the zone type. Existing DNS records will not be affected. | ||
| 2. Go to [**DNS** > **Records**](https://dash.cloudflare.com/?to=/:account/:zone/dns/records) and take note of your new **Cloudflare Nameservers**. |
Contributor
There was a problem hiding this comment.
Suggested change
| 2. Go to [**DNS** > **Records**](https://dash.cloudflare.com/?to=/:account/:zone/dns/records) and take note of your new **Cloudflare Nameservers**. | |
| 2. Go to [**DNS** > **Records**](https://dash.cloudflare.com/?to=/:account/:zone/dns/records) and take note of your new **Cloudflare nameservers**. |
Oxyjun
reviewed
Oct 15, 2024
src/content/docs/dns/zone-setups/conversions/convert-secondary-to-partial.mdx
Outdated
Show resolved
Hide resolved
Oxyjun
reviewed
Oct 15, 2024
src/content/docs/dns/zone-setups/conversions/convert-secondary-to-partial.mdx
Outdated
Show resolved
Hide resolved
Oxyjun
approved these changes
Oct 15, 2024
Co-authored-by: Jun Lee <[email protected]>
![hyperlint-ai[bot]](https://avatars.githubusercontent.com/in/718456?s=60&v=4){kind=small}
| ## 3. Convert your Cloudflare zone | ||
|
|
||
| 1. Back at your Cloudflare zone, confirm that you have all the `A`, `AAAA`, or `CNAME` [DNS records](/dns/manage-dns-records/how-to/create-dns-records/) needed for the hostnames you pointed to `{your-hostname}.cdn.cloudflare.net` in the previous step. You can also delete any DNS records that have a different type, as they will no longer resolve once you convert your zone to a partial setup. | ||
| 2. Use the [Edit Zone endpoint](/api/operations/zones-0-patch) with `type` set to `partial` to convert the zone type. Existing DNS records will not be affected. |
Contributor
There was a problem hiding this comment.
Suggested change
| 2. Use the [Edit Zone endpoint](/api/operations/zones-0-patch) with `type` set to `partial` to convert the zone type. Existing DNS records will not be affected. | |
| 2. Use the [Edit Zone endpoint](/api/operations/zones-0-patch) with `type` set to `partial` convert the zone type. Existing DNS records will not be affected. |
Issues:
- Style Guide - (Repetition-error) 'to' is repeated!
- Style Guide - (cloudflare.Repetition-warning) Warning: Remove this duplicate word: 'to'.
Fix Explanation:
The repetition of the word 'to' is a simple error that can be corrected by removing the second occurrence. The sentence remains clear and retains its intended meaning without the duplicate word.
|
|
||
| ## 3. Convert your zone | ||
|
|
||
| 1. Use the [Edit Zone endpoint](/api/operations/zones-0-patch) with `type` set to `full` to convert the zone type. Existing DNS records will not be affected. |
Contributor
There was a problem hiding this comment.
Suggested change
| 1. Use the [Edit Zone endpoint](/api/operations/zones-0-patch) with `type` set to `full` to convert the zone type. Existing DNS records will not be affected. | |
| 1. Use the [Edit Zone endpoint](/api/operations/zones-0-patch) with `type` set to `full` convert the zone type. Existing DNS records will not be affected. |
Issues:
- Style Guide - (Repetition-error) 'to' is repeated!
- Style Guide - (cloudflare.Repetition-warning) Warning: Remove this duplicate word: 'to'.
Fix Explanation:
The word 'to' is repeated unnecessarily in the sentence. Removing the second 'to' maintains the intended meaning and improves readability. The sentence now reads more smoothly without the repetition.
|
|
||
| ## 3. Convert the zone and initiate zone transfers | ||
|
|
||
| 1. Use the [Edit Zone endpoint](/api/operations/zones-0-patch) with `type` set to `secondary` to convert the zone type. The existing records will remain in place. |
Contributor
There was a problem hiding this comment.
Suggested change
| 1. Use the [Edit Zone endpoint](/api/operations/zones-0-patch) with `type` set to `secondary` to convert the zone type. The existing records will remain in place. | |
| 1. Use the [Edit Zone endpoint](/api/operations/zones-0-patch) with `type` set to `secondary` convert the zone type. The existing records will remain in place. |
Issues:
- Style Guide - (cloudflare.Repetition-warning) Warning: Remove this duplicate word: 'to'.
- Style Guide - (Repetition-error) 'to' is repeated!
Fix Explanation:
The word 'to' is repeated unnecessarily. Removing the duplicate 'to' resolves the issue without altering the meaning of the sentence. The sentence remains clear and concise after the correction.
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
PCX-8015: Document zone setup conversions
Documentation checklist