From 0552a85f95c7a7960ff8cff7cff166ebe97a634d Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Tue, 3 Dec 2024 11:54:30 +0000 Subject: [PATCH 1/4] Add cf-flatten to cname-flattening, export, and attributes docs --- .../docs/dns/cname-flattening/set-up-cname-flattening.mdx | 2 ++ .../docs/dns/manage-dns-records/how-to/import-and-export.mdx | 4 ++++ .../dns/manage-dns-records/reference/record-attributes.mdx | 2 ++ 3 files changed, 8 insertions(+) diff --git a/src/content/docs/dns/cname-flattening/set-up-cname-flattening.mdx b/src/content/docs/dns/cname-flattening/set-up-cname-flattening.mdx index dd5118943d1fe7..cf28cc75842a23 100644 --- a/src/content/docs/dns/cname-flattening/set-up-cname-flattening.mdx +++ b/src/content/docs/dns/cname-flattening/set-up-cname-flattening.mdx @@ -47,6 +47,8 @@ Make a `PATCH` request to the [Update DNS Settings](/api/operations/dns-settings Paid zones also have the option of flattening specific `CNAME` records. +If you use this option, a special [tag](/dns/manage-dns-records/reference/record-attributes/) `cf-flatten` will be added to your zone file, allowing you to [export and import records](/dns/manage-dns-records/how-to/import-and-export/) without loosing this configuration. + 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login) and select your account and domain. diff --git a/src/content/docs/dns/manage-dns-records/how-to/import-and-export.mdx b/src/content/docs/dns/manage-dns-records/how-to/import-and-export.mdx index 9affc0aa75a40a..94bcde86a58435 100644 --- a/src/content/docs/dns/manage-dns-records/how-to/import-and-export.mdx +++ b/src/content/docs/dns/manage-dns-records/how-to/import-and-export.mdx @@ -90,6 +90,10 @@ f.example.com. 60 IN A 1.1.1.1 ; this is the comment cf_tags=tag1:value1,ta g.example.com. 60 IN A 1.1.1.1 ``` +### cf-flatten tag + +If you are on a paid zone and want to use [CNAME flattening for individual records](/dns/cname-flattening/set-up-cname-flattening/#per-record), use the tag `cf-flatten` for the records in your zone file. On export, this tag is automatically added to reflect the record configuration you have on your zone. + ## DNS zone file directives A DNS zone file can be constructed using directives in addition to resource records (RRs). Directives start with `$` and are standardized - `$ORIGIN` and `$INCLUDE` are defined in [RFC 1035](https://www.rfc-editor.org/rfc/rfc1035#section-5.1), and `$TTL` is defined in [RFC 2308](https://www.rfc-editor.org/rfc/rfc2308). Additionally, BIND provides the [non-standard](https://bind9.readthedocs.io/en/latest/chapter3.html#bind-primary-file-extension-the-generate-directive) `$GENERATE` directive. diff --git a/src/content/docs/dns/manage-dns-records/reference/record-attributes.mdx b/src/content/docs/dns/manage-dns-records/reference/record-attributes.mdx index 12cba52b07bd00..9888f51d3df5b4 100644 --- a/src/content/docs/dns/manage-dns-records/reference/record-attributes.mdx +++ b/src/content/docs/dns/manage-dns-records/reference/record-attributes.mdx @@ -51,6 +51,8 @@ Create or edit record attributes just like any other aspect of DNS records, whet You can also add or edit attributes by [exporting and re-importing](/dns/manage-dns-records/how-to/import-and-export/#dns-record-attributes) your records, or using the [Batch record changes API](/dns/manage-dns-records/how-to/batch-record-changes/#use-the-api). +When exporting and importing, a special tag `cf-flatten` allows you to control [CNAME flattening for individual records](/dns/cname-flattening/set-up-cname-flattening/#per-record). On export, this tag is automatically added to reflect the record configuration you have on your zone. + *** ## Reference From fae718cf1787a00ea36c792ae13a3731d015d87a Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Tue, 3 Dec 2024 15:31:05 +0000 Subject: [PATCH 2/4] Clarify the tag is added to flattened records --- .../docs/dns/cname-flattening/set-up-cname-flattening.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/dns/cname-flattening/set-up-cname-flattening.mdx b/src/content/docs/dns/cname-flattening/set-up-cname-flattening.mdx index cf28cc75842a23..cc8b6a497ee4f8 100644 --- a/src/content/docs/dns/cname-flattening/set-up-cname-flattening.mdx +++ b/src/content/docs/dns/cname-flattening/set-up-cname-flattening.mdx @@ -47,7 +47,7 @@ Make a `PATCH` request to the [Update DNS Settings](/api/operations/dns-settings Paid zones also have the option of flattening specific `CNAME` records. -If you use this option, a special [tag](/dns/manage-dns-records/reference/record-attributes/) `cf-flatten` will be added to your zone file, allowing you to [export and import records](/dns/manage-dns-records/how-to/import-and-export/) without loosing this configuration. +If you use this option, a special [tag](/dns/manage-dns-records/reference/record-attributes/) `cf-flatten` will be added to the respective flattened `CNAME` records in your zone file, allowing you to [export and import records](/dns/manage-dns-records/how-to/import-and-export/) without loosing this configuration. From b94ac5761ec0f8d336ec333a6e27d364b0b4ea4c Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Tue, 3 Dec 2024 15:38:10 +0000 Subject: [PATCH 3/4] Clarify use of tag on import-and-export.mdx --- .../docs/dns/manage-dns-records/how-to/import-and-export.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/dns/manage-dns-records/how-to/import-and-export.mdx b/src/content/docs/dns/manage-dns-records/how-to/import-and-export.mdx index 94bcde86a58435..11dd1751602be9 100644 --- a/src/content/docs/dns/manage-dns-records/how-to/import-and-export.mdx +++ b/src/content/docs/dns/manage-dns-records/how-to/import-and-export.mdx @@ -92,7 +92,7 @@ g.example.com. 60 IN A 1.1.1.1 ### cf-flatten tag -If you are on a paid zone and want to use [CNAME flattening for individual records](/dns/cname-flattening/set-up-cname-flattening/#per-record), use the tag `cf-flatten` for the records in your zone file. On export, this tag is automatically added to reflect the record configuration you have on your zone. +If you are on a paid zone and want to use [Per-record CNAME flattening](/dns/cname-flattening/set-up-cname-flattening/#per-record), use the tag `cf-flatten` next to each flattened CNAME record in your zone file. On export, this tag is automatically added to reflect the record configuration that you have on your zone. ## DNS zone file directives From 2647ff691e4105ca85362696fccffaa6f494b04b Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro <62246989+RebeccaTamachiro@users.noreply.github.com> Date: Tue, 3 Dec 2024 17:58:56 +0000 Subject: [PATCH 4/4] Apply suggestion from code review Co-authored-by: Maddy <130055405+Maddy-Cloudflare@users.noreply.github.com> --- .../docs/dns/cname-flattening/set-up-cname-flattening.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/dns/cname-flattening/set-up-cname-flattening.mdx b/src/content/docs/dns/cname-flattening/set-up-cname-flattening.mdx index cc8b6a497ee4f8..833de113746b0c 100644 --- a/src/content/docs/dns/cname-flattening/set-up-cname-flattening.mdx +++ b/src/content/docs/dns/cname-flattening/set-up-cname-flattening.mdx @@ -47,7 +47,7 @@ Make a `PATCH` request to the [Update DNS Settings](/api/operations/dns-settings Paid zones also have the option of flattening specific `CNAME` records. -If you use this option, a special [tag](/dns/manage-dns-records/reference/record-attributes/) `cf-flatten` will be added to the respective flattened `CNAME` records in your zone file, allowing you to [export and import records](/dns/manage-dns-records/how-to/import-and-export/) without loosing this configuration. +If you use this option, a special [tag](/dns/manage-dns-records/reference/record-attributes/) `cf-flatten` will be added to the respective flattened `CNAME` records in your zone file, allowing you to [export and import records](/dns/manage-dns-records/how-to/import-and-export/) without losing this configuration.