Zone cache (#77)

* Zone cache

Uniformed bash headers and implemented the zones cache and its unit tests.
Additionally, the existing unit tests for the provider were updated.

The changes were applied both to the cloud driver and the dns one.

* Updated README.md

* Updated copyright notice

* Saving sum

* Renamed zone cache

* Added cache

Author: mconfalonieri

LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2023 Marco Confalonieri
+   Copyright 2026 Marco Confalonieri
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

README.md

@@ -4,7 +4,7 @@
 > **This software is experimental.**
 
 > [!NOTE]
-> The latest version is **v0.9.2**.
+> The latest version is **v0.10.0**.
 
 [ExternalDNS](https://github.com/kubernetes-sigs/external-dns) is a Kubernetes
 add-on for automatically DNS records for Kubernetes services using different
@@ -80,7 +80,7 @@ provider:
   webhook:
     image:
       repository: ghcr.io/mconfalonieri/external-dns-hetzner-webhook
-      tag: v0.9.2
+      tag: v0.10.0
     env:
       - name: HETZNER_API_KEY
         valueFrom:
@@ -140,7 +140,7 @@ extraArgs:
 
 sidecars:
   - name: hetzner-webhook
-    image: ghcr.io/mconfalonieri/external-dns-hetzner-webhook:v0.9.2
+    image: ghcr.io/mconfalonieri/external-dns-hetzner-webhook:v0.10.0
     ports:
       - containerPort: 8888
         name: webhook
@@ -217,6 +217,13 @@ This can be changed using the **SLASH_ESC_SEQ** environment variable.
 
 ## Upgrading from previous versions
 
+### 0.9.x to 0.10.x
+
+The configuration is fully compatible. There is a new configuration parameter
+**ZONE_CACHE_TTL** that controls the TTL of the newly implemented zones
+cache, that is aimed to reduce API calls. The parameter is expressed in
+seconds.
+
 ### 0.8.x to 0.9.x
 
 The configuration is fully compatible. A new configuration parameter
@@ -278,6 +285,7 @@ Hetzner DNS API.
 | USE_CLOUD_API   | Use the new cloud API                  | Default: `false`           |
 | SLASH_ESC_SEQ   | Escape sequence for label annotations  | Default: `--slash--`       |
 | MAX_FAIL_COUNT  | Number of failed calls before shutdown | Default: `-1` (disabled)   |
+| ZONE_CACHE_TTL | TTL for the zone cache in seconds      | Default: `0` (disabled)    |
 
 > [!IMPORTANT]
 > Please notice that when **USE_CLOUD_API** is set to `true`, the token stored 

README.md.gotmpl

@@ -217,6 +217,13 @@ This can be changed using the **SLASH_ESC_SEQ** environment variable.
 
 ## Upgrading from previous versions
 
+### 0.9.x to 0.10.x
+
+The configuration is fully compatible. There is a new configuration parameter
+**ZONE_CACHE_TTL** that controls the TTL of the newly implemented zones
+cache, that is aimed to reduce API calls. The parameter is expressed in
+seconds.
+
 ### 0.8.x to 0.9.x
 
 The configuration is fully compatible. A new configuration parameter
@@ -278,6 +285,7 @@ Hetzner DNS API.
 | USE_CLOUD_API   | Use the new cloud API                  | Default: `false`           |
 | SLASH_ESC_SEQ   | Escape sequence for label annotations  | Default: `--slash--`       |
 | MAX_FAIL_COUNT  | Number of failed calls before shutdown | Default: `-1` (disabled)   |
+| ZONE_CACHE_TTL | TTL for the zone cache in seconds      | Default: `0` (disabled)    |
 
 > [!IMPORTANT]
 > Please notice that when **USE_CLOUD_API** is set to `true`, the token stored 

cmd/webhook/main.go

@@ -1,7 +1,7 @@
 /*
  * Main - webhook program.
  *
- * Copyright 2023 Marco Confalonieri.
+ * Copyright 2026 Marco Confalonieri.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

cmd/webhook/main_test.go

@@ -1,7 +1,7 @@
 /*
  * Main - unit tests
  *
- * Copyright 2023 Marco Confalonieri.
+ * Copyright 2026 Marco Confalonieri.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

go.work.sum

@@ -934,6 +934,7 @@ golang.org/x/crypto v0.43.0/go.mod h1:BFbav4mRNlXJL4wNeejLpWxB7wMbc79PdRGhWKncxR
 golang.org/x/crypto v0.44.0/go.mod h1:013i+Nw79BMiQiMsOPcVCB5ZIJbYkerPrGnOa00tvmc=
 golang.org/x/crypto v0.46.0 h1:cKRW/pmt1pKAfetfu+RCEvjvZkA9RimPbh7bhFjGVBU=
 golang.org/x/crypto v0.46.0/go.mod h1:Evb/oLKmMraqjZ2iQTwDwvCtJkczlDuTmdJXoZVzqU0=
+golang.org/x/crypto v0.47.0 h1:V6e3FRj+n4dbpw86FJ8Fv7XVOql7TEwpHapKoMJ/GO8=
 golang.org/x/crypto v0.47.0/go.mod h1:ff3Y9VzzKbwSSEzWqJsJVBnWmRwRSHt/6Op5n9bQc4A=
 golang.org/x/exp v0.0.0-20200331195152-e8c3332aa8e5/go.mod h1:4M0jN8W1tt0AVLNr8HDosyJCDCDuyL9N9+3m7wDWgKw=
 golang.org/x/exp v0.0.0-20230905200255-921286631fa9/go.mod h1:S2oDrQGGwySpoQPVqRShND87VCbxmc6bL1Yd2oYrm6k=

internal/hetzner/cloud/change_processors.go

@@ -2,7 +2,7 @@
  * Change processors - this file contains the code for processing changes and
  * queue them.
  *
- * Copyright 2023 Marco Confalonieri.
+ * Copyright 2026 Marco Confalonieri.
  * Copyright 2017 The Kubernetes Authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");

internal/hetzner/cloud/change_processors_test.go

@@ -1,7 +1,7 @@
 /*
  * Change processors - unit tests.
  *
- * Copyright 2023 Marco Confalonieri.
+ * Copyright 2026 Marco Confalonieri.
  * Copyright 2017 The Kubernetes Authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");

internal/hetzner/cloud/changes.go

@@ -1,7 +1,7 @@
 /*
  * Changes - Code for storing changes and sending them to the DNS API.
  *
- * Copyright 2024 Marco Confalonieri.
+ * Copyright 2026 Marco Confalonieri.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

internal/hetzner/cloud/changes_internals.go

@@ -1,7 +1,7 @@
 /*
  * Changes Internals - Internal structures for processing changes.
  *
- * Copyright 2024 Marco Confalonieri.
+ * Copyright 2026 Marco Confalonieri.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.