36 Commits

Author SHA1 Message Date
Ivan Ka
2c46340270
docs(aws): tutorial with kind and localstack (#6048)
* docs(aws): tutorial with kind and localstack

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* remove dependencies

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* docs(aws): tutorial with kind and localstack

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* docs(aws): tutorial with kind and localstack

Co-authored-by: Michel Loiseleur <97035654+mloiseleur@users.noreply.github.com>

* docs(aws): tutorial with kind and localstack

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* docs(aws): tutorial with kind and localstack

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* docs(aws): tutorial with kind and localstack

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* docs(aws): tutorial with kind and localstack

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

---------

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>
Co-authored-by: Michel Loiseleur <97035654+mloiseleur@users.noreply.github.com>
2026-03-24 14:12:15 +05:30
Ivan Ka
867fe74145
docs(regexfilter): pitfalls in domain-filter zone partitioning (#6255)
* test(pdns): regex pitfalls in domain-filter zone partitioning

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* test(pdns): regex pitfalls in domain-filter zone partitioning

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* test(pdns): regex pitfalls in domain-filter zone partitioning

I'll enable https://github.com/ldez/usetesting

Co-authored-by: vflaux <38909103+vflaux@users.noreply.github.com>

* test(pdns): regex pitfalls in domain-filter zone partitioning

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* test(pdns): regex pitfalls in domain-filter zone partitioning

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* test(pdns): regex pitfalls in domain-filter zone partitioning

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* test(pdns): regex pitfalls in domain-filter zone partitioning

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* test(pdns): regex pitfalls in domain-filter zone partitioning

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* docs(regexfilter): pitfalls in domain-filter zone partitioning

Co-authored-by: vflaux <38909103+vflaux@users.noreply.github.com>

* docs(regexfilter): pitfalls in domain-filter zone partitioning

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

---------

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>
Co-authored-by: vflaux <38909103+vflaux@users.noreply.github.com>
2026-03-17 02:37:36 +05:30
Mathieu Bruneau
f4f074f965
docs: fix nested list indentation for web rendering (4-spaces) (#6092)
* docs: fix nested list indentation for sane_lists extension

- Fixed nested indentation to use 4-space in README.md, deprecation.md, version-update-playbook.md, coredns-etcd.md, and aws.md

* Revert "docs: fix nested list indentation for sane_lists extension"

This reverts commit 31cab27178e5ade2e9d2405f351dcc43a31b3670.

* Remove sane_lists as this seem to cause issue in our lists rendering

* Use the mdx_truly_sane_lists with nested_indent: 2 to match rendering between platform
2026-01-16 21:43:17 +05:30
Aleksei Sviridkin
5a55b09f48
feat(annotations): add custom annotation prefix support for split horizon DNS (#5889)
* feat(annotations): add custom annotation prefix support for split horizon DNS

Add --annotation-prefix flag to allow customizing the annotation prefix
used by external-dns. This enables split horizon DNS scenarios where
multiple instances process different sets of annotations from the same
Kubernetes resources.

Changes:
- Add AnnotationPrefix field to Config with validation
- Convert annotation constants to variables that can be reconfigured
- Add SetAnnotationPrefix() function to rebuild annotation keys
- Integrate annotation prefix setting in controller startup
- Update Helm chart with annotationPrefix value
- Add comprehensive split horizon DNS documentation
- Update FAQ with annotation prefix examples

This maintains full backward compatibility - the default prefix remains
"external-dns.alpha.kubernetes.io/".

Co-Authored-By: Claude <noreply@anthropic.com>

* docs(advanced): fix markdown formatting in split-horizon guide

Add blank lines before code blocks to improve markdown rendering
and comply with markdownlint rules.

Co-Authored-By: Claude <noreply@anthropic.com>

* docs(advanced): fix markdown formatting in split-horizon guide

Co-Authored-By: Claude <noreply@anthropic.com>

* docs(charts): regenerate Helm chart documentation

Co-Authored-By: Claude <noreply@anthropic.com>

* test: add AnnotationPrefix field to test configs

Add missing AnnotationPrefix field to minimalConfig and overriddenConfig
test configurations to match the new default value set in NewConfig().

Co-Authored-By: Claude <noreply@anthropic.com>

* test(charts): update error pattern in json-schema test

Update expected error message pattern to match current Helm validation
output format.

Co-Authored-By: Claude <noreply@anthropic.com>

* refactor(annotations): remove init() for explicit initialization

- Remove init() function from annotations package
- Add explicit SetAnnotationPrefix() call in controller/execute.go
- Remove annotation key aliases from source/source.go
- Replace all alias usages with annotations.* references (348 changes in 28 files)
- Add TestMain to existing test files (service_test.go, cloudflare_test.go)

This change makes annotation initialization explicit and predictable,
avoiding hidden global state initialization at import time.

Co-Authored-By: Claude <noreply@anthropic.com>

* docs: update changelog and mkdocs to include annotationPrefix and split horizon DNS

Signed-off-by: Aleksei Sviridkin <f@lex.la>

* docs(split-horizon): fix linting

Signed-off-by: Aleksei Sviridkin <f@lex.la>

* refactor(annotations): replace hardcoded annotation prefix with constant

Replace all hardcoded "external-dns.alpha.kubernetes.io/" strings
with annotations.DefaultAnnotationPrefix constant to establish
a single source of truth.

Changes:
- Add DefaultAnnotationPrefix constant in source/annotations/annotations.go
- Replace hardcoded string in controller/execute.go with constant reference
- Replace hardcoded strings in pkg/apis/externaldns/types.go (2 occurrences)
- Add helm unit tests for annotationPrefix value

This eliminates string duplication and makes future changes easier.

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Signed-off-by: Aleksei Sviridkin <f@lex.la>
Co-authored-by: Claude <noreply@anthropic.com>
2025-11-08 03:56:52 -08:00
Ivan Ka
994f4dc24a
docs(release): update release docs (#5893)
* docs(release): update release docs

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* docs(release): update release docs

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* docs(release): update release docs

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* docs(release): update release docs

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* docs(release): update release docs

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* docs(release): update release docs

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* docs(release): update release docs

Co-authored-by: Michel Loiseleur <97035654+mloiseleur@users.noreply.github.com>

* docs(release): update release docs

Co-authored-by: Michel Loiseleur <97035654+mloiseleur@users.noreply.github.com>

---------

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>
Co-authored-by: Michel Loiseleur <97035654+mloiseleur@users.noreply.github.com>
2025-10-24 01:33:40 -07:00
Ivan Ka
85b6a6efae
docs(advanced): configuration precedence (#5871)
* docs(advanced): configuration precedence

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* docs(advanced): configuration precedence

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* docs(advanced): configuration precedence

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* docs(advanced): configuration precedence

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* docs(advanced): configuration precedence

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* docs(advanced): configuration precedence

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* docs(advanced): configuration precedence

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* docs(advanced): configuration precedence

Co-authored-by: Michel Loiseleur <97035654+mloiseleur@users.noreply.github.com>

* docs(advanced): configuration precedence

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

---------

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>
Co-authored-by: Michel Loiseleur <97035654+mloiseleur@users.noreply.github.com>
2025-10-03 09:02:59 -07:00
Naveen Chauhan
bd2f8a47d2
docs(tutorials): import existing DNS records into ExternalDNS (#5811)
* Added steps for importing existing DNS records with ExternalDNS

* fixing lint errors

* fixing lint errors

* retry - fixing lint errors

* retry - fixing lint errors

* review

---------

Co-authored-by: Michel Loiseleur <michel.loiseleur@traefik.io>
2025-09-09 23:51:57 -07:00
Michel Loiseleur
04ef733d48
docs: fix mkdocs build (#5795)
* docs: fix mkdoc build

* Revert "docs: fix mkdoc build"

This reverts commit b3a1aab00f6edbe5cd488147529b5479e9ea8c8a.

* fix mkdocs config
2025-09-02 06:25:15 -07:00
Ivan Ka
57abe1d243
fix(docs): fix documentation (#5560)
Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>
2025-06-24 08:48:29 -07:00
Ivan Ka
84a0c6409f
chore(docs): add mkdocs-macros plugin (#5412)
* chore(docs): add mkdocs-macros plugin

* chore(docs): add mkdocs-macros plugin

Co-authored-by: Michel Loiseleur <97035654+mloiseleur@users.noreply.github.com>

* chore(docs): add mkdocs-macros plugin

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

---------

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>
Co-authored-by: Michel Loiseleur <97035654+mloiseleur@users.noreply.github.com>
2025-05-19 01:33:15 -07:00
Lino Layani
2a1ab538b8
fix(docs): resove broken links, add source description (#5413) 2025-05-19 00:43:23 -07:00
Ivan Ka
51d063ad28
chore(fqdn-template): fqdn templating move to specific folder and update documentation (#5354)
* chore(fqdn): fqdn move to specific folder and update documentation

* chore(fqdn): fqdn move to specific folder and update documentation

Co-authored-by: Michel Loiseleur <97035654+mloiseleur@users.noreply.github.com>

* chore(fqdn): fqdn move to specific folder and update documentation

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* chore(fqdn): fqdn move to specific folder and update documentation

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* chore(fqdn): fqdn move to specific folder and update documentation

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

---------

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>
Co-authored-by: Michel Loiseleur <97035654+mloiseleur@users.noreply.github.com>
2025-05-10 05:53:22 -07:00
Ivan Ka
1e8e5e06c5
chore(docs): generate docs/monitoring/metrics.md file (#5117)
* chore(docs): generate docs/monitoring/metrics.md file

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* chore(docs): generate docs/monitoring/metrics.md file

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* chore(docs): generate docs/monitoring/metrics.md file

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* chore(docs): generate docs/monitoring/metrics.md file

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* chore(docs): generate docs/monitoring/metrics.md file

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* chore(docs): generate docs/monitoring/metrics.md file

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* chore(docs): generate docs/monitoring/metrics.md file

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* chore(docs): generate docs/monitoring/metrics.md file

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* chore(docs): generate docs/monitoring/metrics.md file

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* chore(docs): generate docs/monitoring/metrics.md file

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* chore(docs): generate docs/monitoring/metrics.md file

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* chore(docs): generate docs/monitoring/metrics.md file

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* chore(docs): generate docs/monitoring/metrics.md file

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* chore(docs): generate docs/monitoring/metrics.md file

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* chore(docs): generate docs/monitoring/metrics.md file

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* chore(docs): generate docs/monitoring/metrics.md file

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* chore(docs): generate docs/monitoring/metrics.md file

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* chore(docs): generate docs/monitoring/metrics.md file

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* chore(docs): generate docs/monitoring/metrics.md file

Co-authored-by: Michel Loiseleur <97035654+mloiseleur@users.noreply.github.com>

---------

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>
Co-authored-by: Michel Loiseleur <97035654+mloiseleur@users.noreply.github.com>
2025-03-04 05:05:44 -08:00
Ivan Ka
003d0f56be
docs(proposal): support multiple replicas with leader election (#5051)
* feat(leader-election): support multiple replicas. pre-requisits

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* feat(leader-election): support multiple replicas. pre-requisits

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* feat(leader-election): support multiple replicas. docs

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* Apply suggestions from code review

Co-authored-by: Michel Loiseleur <97035654+mloiseleur@users.noreply.github.com>

* feat(leader-election): support multiple replicas. docs

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* feat(leader-election): support multiple replicas. docs

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* feat(leader-election): support multiple replicas. mermaid diagrams

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* feat(leader-election): support multiple replicas. mermaid diagrams

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* feat(leader-election): support multiple replicas. mermaid diagrams

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* Apply suggestions from code review

Co-authored-by: Michel Loiseleur <97035654+mloiseleur@users.noreply.github.com>

* feat(leader-election): support multiple replicas. remove logs

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* docs(proposal): leader election

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* docs(proposal): support multiple replicas with leader election

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* docs(proposal): support multiple replicas with leader election

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* docs(proposal): support multiple replicas with leader election

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* docs(proposal): support multiple replicas with leader election

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

---------

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>
Co-authored-by: Michel Loiseleur <97035654+mloiseleur@users.noreply.github.com>
2025-02-15 08:08:21 -08:00
Ivan Ka
8eb8ea3a1b
docs: add deprecation policy (#5053)
* feat(deprecation policy): added deprecation policy

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* feat(deprecation policy): added deprecation policy

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* feat(deprecation policy): added deprecation policy

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* feat(deprecation policy): added deprecation policy

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

* Apply suggestions from code review

Co-authored-by: Michel Loiseleur <97035654+mloiseleur@users.noreply.github.com>

* feat(deprecation policy): added deprecation policy

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

---------

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>
Co-authored-by: Michel Loiseleur <97035654+mloiseleur@users.noreply.github.com>
2025-01-31 03:06:56 -08:00
ivan katliarchuk
06333496dd
chore-4260: update mkdocs added about/flags/ section
Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>
2025-01-03 10:16:07 +00:00
Kubernetes Prow Robot
7bdb0f6070
Merge pull request #4726 from mloiseleur/docs/fix-title
docs: refactor title and organisation
2024-09-05 19:03:44 +01:00
Kubernetes Prow Robot
848e309ad4
Merge pull request #4593 from johannwagner/feature/nat64
feat: NAT64 network source
2024-09-05 14:34:29 +01:00
Michel Loiseleur
7ae03cdfc7
docs: refactor title and organisation 2024-09-05 09:09:48 +02:00
Johann Wagner
1b4843aa02 Added documentation for NAT64 prefix rewriting 2024-08-19 08:00:25 +02:00
Thibault Jamet
173604854d
Rename Advanced topics title to match the content 2024-08-14 10:21:00 +02:00
Thibault Jamet
309f34f4f5
Add an advanced topic about rate limits 2024-08-14 10:21:00 +02:00
Michel Loiseleur
233c46e83e mkdocs on root level 2024-06-07 08:16:15 +02:00
Michel Loiseleur
3773411a5a docs: upgrade mkdocs and fix warnings 2024-06-07 08:15:44 +02:00
Maria Salcedo
00910b1cfc docs(footer): Add trademark disclaimer 2024-06-05 10:47:00 +02:00
John Gardiner Myers
6b230c6c44 Document the Gateway sources 2023-09-16 14:18:16 -07:00
John Gardiner Myers
da3fe0463c Document the Service source 2023-09-04 11:44:08 -07:00
John Gardiner Myers
0eb91e358d Document the Ingress source 2023-08-04 04:06:02 -07:00
John Gardiner Myers
7c36154341 Document annotations 2023-06-25 16:58:48 -07:00
John Gardiner Myers
5aae0af68a Add DynamoDB registry implementation 2023-06-18 16:49:58 -07:00
John Gardiner Myers
40ed5e03b6 Improve registry documentation 2023-06-01 21:35:00 -07:00
Raffaele Di Fazio
afe3b09f45
Revert "Revert "Workflow for automatic documentation creation and publishing"" 2022-05-06 10:10:52 +02:00
Raffaele Di Fazio
f271f0ac9a
Revert "Workflow for automatic documentation creation and publishing" 2022-04-29 09:51:16 +02:00
renehernandez
0d36e899fb Update mkdocs to use the right repo and site author 2022-03-17 15:58:24 -04:00
renehernandez
9272b9f578 Add multiple versions support via mike 2022-03-17 15:19:34 -04:00
renehernandez
b4007d289f Mkdocs fixes 2022-03-17 13:12:35 -04:00