AdGuard Home sur GKE Autopilot
⚠️ CRITIQUE — à lire avant de déployer. La valeur principale d'AdGuard Home est le blocage des publicités/traqueurs DNS à l'échelle du réseau, ce qui nécessite que les clients l'interrogent via DNS sur le port 53 (TCP+UDP). Ce module utilise le modèle de passerelle HTTP(S) standard de GKE, qui ne peut pas exposer le port 53 brut. (Un
Service type=LoadBalancerL4 brut secondaire pour le port 53 est possible en principe sur GKE — contrairement à Cloud Run, qui ne peut pas le faire quelle que soit la configuration — mais est explicitement hors de portée pour la première version de ce module.) Ce module déploie uniquement la console d'administration web d'AdGuard Home (port 3000) pour la gestion des listes de filtres, des règles personnalisées et des paramètres clients. L'instance déployée n'est PAS accessible en tant que résolveur DNS public. Voir la §6 Pièges de configuration pour l'explication complète.
AdGuard Home est un serveur DNS open-source, sous licence GPL-3.0, à l'échelle du réseau qui bloque les publicités et les traqueurs au niveau DNS et inclut des contrôles parentaux. C'est un binaire statique Go sans base de données externe — toute la configuration se trouve dans un fichier YAML plat écrit par son propre assistant de configuration initial. Ce module déploie la console d'administration web d'AdGuard Home sur GKE Autopilot au-dessus de la fondation App_GKE, qui provisionne et gère l'infrastructure partagée de Google Cloud et Kubernetes.
Ce guide se concentre sur les services cloud qu'AdGuard Home utilise et sur la manière de les explorer et de les exploiter depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à chaque application GKE — Workload Identity, ingress, autoscaling, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls et le cycle de vie du déploiement — reportez-vous au guide de la fondation App_GKE plutôt que de les répéter ici.
Ce que coûte AdGuard Home sur RAD, et comment cela se compare
Le module GKE Autopilot d'AdGuard Home sur RAD coûte environ 40 $ US par mois dans un projet que vous possédez, sans frais de licence pour le logiciel lui-même. RAD facture des frais de module uniques de 40 crédits (4 $ US au prix de la recharge) dans un projet que vous possédez, et 36 crédits (10 % de moins) dans un projet géré par RAD. GKE convient à AdGuard Home qui doit rester actif en permanence ou s'adapter à plusieurs pods ; pour le coût le plus bas, le module Cloud Run exécute le même AdGuard Home pour environ 17 $ US par mois. Les chiffres sont valables au 8 octobre 2026 ; les sources sont listées à la fin de cette section.
Si vous n'en avez besoin qu'occasionnellement — pour étudier en vue d'une certification, une démo, un besoin saisonnier — un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires, de sorte que les quelque 40 $ US par mois deviennent presque rien. Voir Mettre en pause gratuitement, ci-dessous.
Ce que vous payez sur RAD
Vous payez pour trois choses :
| Dans un projet Google Cloud que vous possédez | Dans un projet géré par RAD pour vous | |
|---|---|---|
| Frais de module, une fois par déploiement | 40 crédits (4 $ US au prix de la recharge) | 36 crédits (10 % de moins) |
| Builds | Inclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites puis 2 crédits chacune, et rien pour la suppression ou pour un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients sont l'exception : ils sont toujours facturés à la minute pour le temps de build | Idem |
| Coût d'exécution Google Cloud | Facturé par Google à votre propre compte de facturation, environ 40 $ US par mois pour la configuration par défaut (tableau ci-dessous) | Mesuré à l'heure en crédits ; RAD publie 70 crédits par jour, environ 2 100 par mois (environ 210 $ US au prix de la recharge ; estimé à partir des prix catalogue Google, et incluant les frais de cluster) |
| Qui possède quoi | Vous possédez le projet et sa facturation ; RAD le déploie et le met à jour | RAD possède le projet, avec des garde-fous, des quotas et des alertes budgétaires ; vous avez accès à la console, et un solde minimum acheté est conservé en réserve |
Pourquoi les deux colonnes diffèrent. Le chiffre géré par RAD inclut les frais de gestion du cluster GKE (environ 73 $ US par mois) et la fondation partagée du projet. Dans votre propre projet, le niveau gratuit de Google couvre les frais de gestion d'un cluster par compte de facturation, ce que le chiffre du projet propre suppose. Il est estimé à partir des prix catalogue de Google, car il n'y a pas encore suffisamment d'historique GKE géré par RAD pour le mesurer, donc la confirmation de déploiement ne le cite pas. Une deuxième application GKE dans le même projet géré par RAD partage le cluster et n'ajoute que ses propres pods.
Votre premier déploiement réussi sur RAD est exempt de frais de module, quel que soit le montant : une fois par compte, pour un module que vous déployez et payez vous-même (dans une solution, les frais d'une application : la première à réussir ; jamais une session de lab ou un projet client).
10 crédits coûtent 1 $ US pour une recharge ponctuelle, et moins pour un plan mensuel.
Coût d'exécution par défaut dans votre propre projet (us-central1, prix catalogue Google) :
| Ressource (module par défaut) | Par mois |
|---|---|
| Pod GKE Autopilot, 1x vCPU / 0,5 Gio | 34,29 $ US |
| Cloud NAT et réseau | 5 $ US |
| Cloud Storage (modules complémentaires, sauvegardes) | 1 $ US |
| Frais de gestion du cluster GKE | 0 $ US si c'est votre seul cluster Autopilot/zonal sur le compte de facturation, sinon environ 73 $ US (partagés entre toutes les applications GKE du projet) |
| Total | environ 40 $ US |
Comment cela se compare
- Le plan Pro de NextDNS — requêtes et appareils illimités, résolvant réellement le DNS pour votre réseau, ce que le déploiement de la console web uniquement de ce module ne fait pas — coûte 1,79 £/mois (environ 2,30 $). Cela achète un service de résolution clé en main ; cela ne vous achète pas la console de listes de filtres et de paramètres clients auto-hébergée que ce module exécute.
- RAD exécute le projet open-source lui-même, pas une location hébergée par un fournisseur. Vous obtenez le même logiciel, sur votre propre infrastructure (ou celle de RAD), au lieu d'un abonnement par siège ou par utilisation qui augmente indépendamment de ce que vous utilisez réellement.
- Par rapport à un serveur auto-géré nu : C'est une charge de travail plus petite qu'un VPS standard de 2 vCPU, donc l'exécuter vous-même sur une classe moins chère et plus petite qu'un Hetzner CPX22 ou un DigitalOcean 2 vCPU/4 Go Droplet (tous deux environ 24 $/mois) ferait l'affaire, pour nettement moins que cela. RAD n'est pas moins cher que cela en termes d'argent — la différence est la base de données gérée, Secret Manager et la surveillance qui viennent avec le module au lieu d'être votre propre travail.
Mettre en pause gratuitement : supprimer un projet géré par RAD, le restaurer quand vous en avez besoin
Si AdGuard Home s'exécute dans un projet géré par RAD pour vous, vous avez une option qui va bien au-delà de la mise à l'échelle à zéro : supprimez l'ensemble du projet et restaurez-le dans les 30 jours pour presque rien. Cela convient bien mieux à une utilisation occasionnelle — étudier pour une certification, une démo, un besoin saisonnier — que l'exécution continue d'AdGuard Home.
Une restauration n'est pas garantie — conservez vos propres sauvegardes. Les conditions de Google Cloud ne garantissent pas qu'un projet restauré, ou les ressources qu'il contient, seront utilisables après sa restauration, de sorte que la restauration ne peut pas être considérée comme un moyen de récupérer un projet supprimé. Avant de supprimer, assurez-vous d'avoir effectué des sauvegardes appropriées des données et de la configuration de l'application et de les avoir stockées en dehors du projet. Si une restauration échoue, ou si le projet restauré ne fonctionne pas, la solution de secours consiste à redéployer l'application (voir la section suivante) et à restaurer sa configuration et ses données à partir de ces sauvegardes.
- Comment ça marche. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet purement et simplement. Google ne le supprime pas immédiatement : il conserve le projet, récupérable, pendant 30 jours, et comme la facturation est déjà déliée, rien n'est facturé pendant qu'il attend. Contrairement à la suppression d'un module, cela ne détruit pas la base de données, aucune VM ou la ressource de calcul une par une — l'ensemble du projet s'arrête simplement, et rien n'est facturé entre-temps.
- La restauration est une vérification, pas une reconstruction. Dans les 30 jours, seul le propriétaire du projet peut le restaurer. RAD demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter Update sur chaque déploiement pour confirmer que tout est revenu. Comme rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes — c'est une vérification, pas une reconstruction, et une mise à jour ne facture jamais les frais de module à nouveau. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit.
- Ce que cela nécessite. Vous devez être propriétaire du projet (pas un projet dont RAD gère uniquement la facturation), vous devez le restaurer vous-même dans les 30 jours — après cela, Google le supprime définitivement — et la restauration est admise comme la création d'un nouveau projet, de sorte que votre solde de crédits achetés doit toujours dépasser le seuil du niveau (100 crédits pour le niveau sandbox que la plupart des utilisations d'étude et de démo conviennent). Google indique que la plupart des services sont à nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.
- Un véritable manque : les sauvegardes ne survivent pas. Tout ce qu'AdGuard Home écrit dans un bucket de sauvegarde à l'intérieur du projet est très probablement perdu dès que vous supprimez le projet, même si le projet lui-même est récupérable pendant 30 jours — la suppression logicielle de Cloud Storage est explicitement désactivée pour ce bucket. Toute personne ayant personnalisé le déploiement et souhaitant conserver ce travail doit copier une sauvegarde (vers Google Drive ou un bucket en dehors du projet) avant de supprimer. Pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.
Payer uniquement pendant l'utilisation, l'autre méthode : supprimer et redéployer
C'est la solution de secours pour un projet que vous possédez, ou une fois que la fenêtre de restauration de 30 jours ci-dessus est passée : supprimez le déploiement et redéployez-le lorsque vous en aurez à nouveau besoin.
- Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) : 40 crédits (4,00 $ US) dans votre propre projet, ou 36 crédits dans un projet géré par RAD, car RAD reconstruit les ressources à partir de zéro. La suppression permet d'économiser de l'argent une fois qu'AdGuard Home resterait inutilisé assez longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution — environ 3 jours ou plus dans votre propre projet (1,34 $ US/jour) ou 1 jour ou plus dans un projet géré par RAD (70 crédits/jour).
- Le cluster GKE lui-même est une infrastructure partagée. Si une autre application utilise le même cluster Autopilot, la suppression d'AdGuard Home seule ne sauve que son propre pod ; les frais de gestion du cluster ne diminuent que lorsque rien d'autre dans le projet n'en a besoin.
- Conservez d'abord vos données. Tout ce qu'AdGuard Home écrit dans un bucket de sauvegarde à l'intérieur du déploiement est supprimé avec lui — copiez la dernière sauvegarde (vers Google Drive, ou un bucket que vous conservez) avant de supprimer si vous voulez la conserver.
- RAD ne recrée pas un déploiement supprimé pour vous. Vous saisissez à nouveau les paramètres lorsque vous redéployez.
Sessions de lab et environnements gérés
- Sessions de lab, pour la formation. Un formateur anime une session pour une classe. Chaque participant dispose d'AdGuard Home dans son propre projet Google Cloud pendant 15 minutes à 24 heures, dans la limite d'une allocation définie par le formateur. Le formateur peut aussi créer un seul environnement partagé pour toute la classe, et chacun utilise alors la même application et ses données. Soit le formateur finance toutes les places, soit chaque participant paie la sienne. Tout est supprimé à la fin de la session et les crédits inutilisés sont reversés au formateur.
- Environnements gérés, pour les sociétés de conseil. Un partenaire exécute AdGuard Home pour un client à partir d'un portefeuille cloisonné qu'il finance, et règle directement avec le client. Si le portefeuille est faible, la facturation est suspendue et les données sont conservées, de sorte que personne ne reçoit de frais inattendus. À la fin, le partenaire transfère le projet et les déploiements deviennent la propriété du client.
Les crédits peuvent être achetés dans plus de 20 devises, y compris XAF, XOF, NGN, GHS, KES et ZAR, par carte, virement bancaire ou argent mobile.
Sources (8 octobre 2026) : Prix catalogue Google Cloud de l'API Cloud Billing Catalog ; frais de RAD et estimation des crédits quotidiens de radmodules.dev/pricing ; Supprimer et restaurer des projets pour les mécanismes de pause/restauration ; Tarifs NextDNS. Les prix changent ; vérifiez chaque source avant de vous fier à un chiffre.
1. Vue d'ensemble
AdGuard Home s'exécute en tant que pod binaire statique Go unique sur GKE Autopilot. Le déploiement relie un ensemble ciblé de services Google Cloud :
| Capacité | Service Google Cloud | Notes |
|---|---|---|
| Calcul | GKE Autopilot | Pod binaire Go unique, 1 vCPU / 512 Mio par défaut, type de charge de travail Deployment |
| Base de données | Aucune | AdGuard Home n'a pas de base de données externe — la configuration est un fichier YAML plat |
| Stockage d'objets | Cloud Storage (×2, GCS Fuse CSI) | Bucket conf (config) et bucket work (journal de requêtes/statistiques), tous deux montés comme volumes de système de fichiers |
| Secrets | Secret Manager | Aucun généré — les identifiants d'administrateur sont définis via l'assistant web de première exécution d'AdGuard Home |
| Ingress | Cloud Load Balancing | Service LoadBalancer externe par défaut ; domaine personnalisé facultatif + certificat géré (pour la console web — voir la note CRITIQUE ci-dessus) |
Valeurs par défaut judicieuses à connaître d'emblée :
- Ce déploiement est une console de gestion de configuration, pas un résolveur DNS. Le modèle de passerelle HTTP(S) standard de GKE utilisé ici ne peut pas exposer le DNS brut (port 53 TCP/UDP). Ne dirigez pas de vrais clients DNS vers l'IP ou le nom d'hôte de ce déploiement.
- Pas de base de données externe.
database_type = "NONE"et ne doit pas être modifié. - Deux volumes GCS Fuse sont pré-câblés et provisionnés automatiquement —
confà/opt/adguardhome/confetworkà/opt/adguardhome/work— de sorte que la configuration et le journal de requêtes/statistiques persistent après les redémarrages de pod. Vous n'avez pas besoin de définirgcs_volumesvous-même, et aucun StatefulSet/PVC de bloc n'est requis (workload_type = "Deployment"). container_port = 3000— L'assistant de configuration d'AdGuard Home est codé en dur pour écouter sur le port 3000 jusqu'à ce queAdGuardHome.yamlexiste. Si vous modifiez le port de l'interface utilisateur web pendant l'assistant de configuration, maintenez-le à 3000 ou la sonde de santé de la plateforme et l'URL publique ne correspondront plus à ce que le pod écoute réellement.service_type = "LoadBalancer"par défaut. La console d'administration est une interface utilisateur, elle est donc accessible au public comme toute autre application web de ce catalogue — contrairement à un outil d'administration de base de données interne uniquement.- Aucun identifiant d'administrateur pré-rempli. L'assistant de configuration initial d'AdGuard Home, servi à l'URL de déploiement, est l'endroit où vous définissez le nom d'utilisateur/mot de passe de l'administrateur — rien n'est injecté par la plateforme.
2. Services Google Cloud et comment les explorer
Toutes les commandes supposent que vous avez exécuté
gcloud container clusters get-credentials <cluster> --region <region> --project <project>
et que PROJECT, REGION et NAMESPACE sont définis. L'espace de noms et les autres identifiants sont rapportés dans les Sorties du déploiement.
A. GKE Autopilot — la console d'administration web d'AdGuard Home
AdGuard Home s'exécute en tant que Deployment à réplica unique sur Autopilot.
- Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail AdGuard Home pour voir les pods, les révisions et les événements. Kubernetes Engine → Services et Ingress affiche l'IP externe.
- CLI :
kubectl get pods,svc -n "$NAMESPACE"
kubectl logs -n "$NAMESPACE" deploy/<service-name> --tail=100
Voir App_GKE pour savoir comment Autopilot, la mise à l'échelle et le type de charge de travail (Deployment vs StatefulSet) sont gérés.
B. Cloud Storage (GCS Fuse) — configuration et journaux de requêtes/statistiques
AdGuard Home stocke l'intégralité de sa configuration dans un fichier YAML plat (AdGuardHome.yaml) et sa base de données de journaux de requêtes/statistiques dans un répertoire séparé. Les deux sont sauvegardés par des buckets Cloud Storage dédiés montés via le pilote CSI GCS Fuse — conf et work — provisionnés automatiquement.
- Console : Cloud Storage → Buckets.
- CLI :
gcloud storage buckets list --project "$PROJECT" --filter="name~adguardhome"
gcloud storage ls gs://<conf-bucket>/ # bucket names are in the Outputs
gcloud storage cat gs://<conf-bucket>/AdGuardHome.yaml # inspect the live config
Voir App_GKE pour les options CMEK et les détails de montage du CSI GCS Fuse.
C. Réseau et ingress
Par défaut, la charge de travail est exposée via une IP externe de Cloud Load Balancing. Il s'agit uniquement de l'URL de la console d'administration web — ce n'est pas une adresse de serveur DNS. Un domaine personnalisé avec un certificat géré par Google peut être activé, et une IP statique peut être réservée afin que l'adresse survive aux redéploiements.
- Console : Services réseau → Équilibrage de charge ; Réseau VPC → Adresses IP.
- CLI :
kubectl get svc -n "$NAMESPACE"
gcloud compute addresses list --project "$PROJECT"
Voir App_GKE pour les domaines personnalisés, Cloud CDN et les détails de l'IP statique.
D. Cloud Logging et Monitoring
Les sorties standard/erreur des pods sont acheminées vers Cloud Logging ; les métriques GKE sont acheminées vers Cloud Monitoring. Des tests de disponibilité et des règles d'alerte facultatifs sont disponibles.
- Console : Logging → Explorateur de journaux ; Monitoring → Tableaux de bord / Alertes.
- CLI :
gcloud logging read 'resource.type="k8s_container" AND resource.labels.namespace_name="'"$NAMESPACE"'"' \
--project "$PROJECT" --limit 50
Le point d'entrée enregistre une bannière de rappel de la portée DNS à chaque démarrage — visible dans les premières lignes du journal d'un nouveau pod.
3. Comportement de l'application AdGuard Home
- Pas de bootstrap de base de données. AdGuard Home n'a pas de base de données externe, il n'y a donc pas de valeur par défaut
initialization_jobs— la liste est disponible uniquement pour les jobs personnalisés fournis par l'opérateur. - Assistant de configuration initial. Lors de la première visite à l'IP externe (avant que
AdGuardHome.yamln'existe), AdGuard Home sert son propre assistant de configuration sur le port 3000 : choisissez le port de l'interface utilisateur web d'administration (gardez-le à 3000), définissez le nom d'utilisateur/mot de passe de l'administrateur et sélectionnez les serveurs DNS en amont. Rien ici n'est pré-rempli par la plateforme. - Chemin de santé. Les sondes de démarrage et de vivacité ciblent
/— il n'y a pas de point de terminaison de santé dédié ; la racine renvoie200avant et après la configuration initiale. - La résolution DNS n'est pas accessible. L'écouteur DNS interne du pod peut démarrer, mais rien en dehors du pod/Service ne peut atteindre le port 53 via la passerelle HTTP(S) standard de GKE. Seule la console d'administration web est accessible.
4. Variables de configuration
Les variables sont regroupées exactement comme elles apparaissent sur la plateforme de déploiement. Seuls les paramètres spécifiques ou notables pour AdGuard Home sont listés ; toutes les autres entrées sont héritées de App_GKE avec son comportement et ses valeurs par défaut standard.
Groupe 1 — Projet et identité
| Variable | Valeur par défaut | Description |
|---|---|---|
project_id | (obligatoire) | Projet Google Cloud cible. |
region | us-central1 | Région pour la charge de travail et les ressources régionales. |
Groupe 2 — Environnement de déploiement
| Variable | Valeur par défaut | Description |
|---|---|---|
tenant_id | demo | Suffixe court qui rend les noms de ressources uniques par environnement. |
Groupe 3 — Identité de l'application
| Variable | Valeur par défaut | Description |
|---|---|---|
application_name | adguardhome | Nom de base des ressources. Ne pas modifier après le premier déploiement. |
application_version | latest | Tag de suivi du déploiement. Correspond à l'ARG de build ADGUARDHOME_VERSION spécifique à l'application dans le Dockerfile (pas au générique APP_VERSION). |
Groupe 4 — Exécution et mise à l'échelle
| Variable | Valeur par défaut | Description |
|---|---|---|
deploy_application | true | Définir false pour provisionner uniquement l'infrastructure. |
min_instance_count | 1 | Réplicas minimum. |
max_instance_count | 1 | Réplicas maximum. |
container_port | 3000 | Le port fixe de l'assistant de configuration. Pas le port DNS 53. |
container_resources | {cpu_limit="1000m", memory_limit="512Mi"} | Limites de ressources du pod. |
enable_cloudsql_volume | false | Non utilisé — pas de base de données. |
Groupe 6 — Backend GKE et cluster
| Variable | Valeur par défaut | Description |
|---|---|---|
service_type | LoadBalancer | Accessible au public par défaut — une interface utilisateur, pas un outil de base de données interne uniquement. |
workload_type | Deployment | Pas de StatefulSet nécessaire ; la persistance est GCS Fuse. |
Groupe 10 — IAP et VPC-SC
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_iap | false | Recommandé d'activer — place l'authentification d'identité Google devant la console de stratégie de filtrage DNS. |
Groupe 11 — Domaine personnalisé et réseau
| Variable | Valeur par défaut | Description |
|---|---|---|
reserve_static_ip | true | IP externe stable sur les redéploiements. |
enable_custom_domain | (valeur par défaut de la fondation) | Provisionner l'Ingress pour les noms d'hôte personnalisés + certificat géré. |
Groupe 14 — Cloud Storage
| Variable | Valeur par défaut | Description |
|---|---|---|
create_cloud_storage | true | Crée les buckets conf/work toujours provisionnés ainsi que ceux de storage_buckets. |
gcs_volumes | [] | Laisser vide pour utiliser les montages conf/work du module. |
Groupe 16 — Configuration de la base de données
| Variable | Valeur par défaut | Description |
|---|---|---|
database_type | NONE | Fixe — ne doit pas être modifié. |
Groupe 10 — Observabilité et santé
| Variable | Valeur par défaut | Description |
|---|---|---|
startup_probe_config / health_check_config | HTTP / | Pas de point de terminaison de santé dédié ; la racine renvoie 200 avant et après la configuration. |
uptime_check_config | désactivé | Test de disponibilité facultatif de Cloud Monitoring. |
Groupe 11 — Jobs et tâches planifiées
| Variable | Valeur par défaut | Description |
|---|---|---|
initialization_jobs | [] | Pas de job par défaut — AdGuard Home n'a pas besoin de bootstrap de base de données. |
Groupe 22 — VPC Service Controls et journalisation d'audit
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_vpc_sc | false | Appliquer un périmètre VPC-SC (nécessite organization_id). |
Groupe 7 — StatefulSet
Non utilisé par défaut — la persistance se fait via des volumes GCS Fuse, et non un PVC de bloc. stateful_pvc_enabled par défaut null (désactivé).
5. Sorties
Ces valeurs sont renvoyées lors d'un déploiement réussi et constituent le moyen le plus rapide de localiser et d'explorer les ressources en cours d'exécution.
| Sortie | Description |
|---|---|
service_name | Nom du service Kubernetes. |
namespace | Espace de noms dans lequel la charge de travail s'exécute. |
service_cluster_ip | ClusterIP intra-cluster. |
service_external_ip | IP externe du LoadBalancer (lorsqu'une IP statique est réservée). |
service_url | URL pour atteindre la console d'administration d'AdGuard Home (pas une adresse de résolveur DNS). |
storage_buckets | Buckets Cloud Storage créés (conf, work). |
network_name / network_exists / regions | Réseau VPC, présence, régions disponibles. |
container_image / container_registry | Image déployée et dépôt Artifact Registry. |
monitoring_enabled / monitoring_notification_channels | État et canaux de surveillance. |
deployment_id / tenant_id / resource_prefix | Identifiants de nommage. |
project_id / project_number | Identifiants de projet. |
kubernetes_ready | Indique si le cluster/la charge de travail est prêt. |
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_mode | État de VPC-SC. |
6. Pièges de configuration et valeurs par défaut judicieuses
Risque : Critique (perte de données / panne / sécurité) — Élevé (service dégradé) — Moyen (coût ou dégradation partielle) — Faible (mineur).
Validation héritée au moment de la planification. Ce module transmet sa configuration au moteur de fondation App_GKE, qui valide les valeurs et les combinaisons au moment de la planification. Une configuration invalide fait échouer le plan avec une erreur claire et nommée avant la création de toute ressource.
| Paramètre | Valeur judicieuse | Risque | Conséquence en cas d'erreur |
|---|---|---|---|
| Attendre une résolution DNS réelle de ce déploiement | Ne pas s'y fier | Critique | Le modèle de passerelle HTTP(S) standard de GKE utilisé par ce module ne peut pas exposer le port 53 TCP/UDP brut — les clients dirigés vers l'IP/le nom d'hôte de ce déploiement pour le DNS n'obtiendront aucune réponse. Un Service type=LoadBalancer L4 brut secondaire pour le port 53 est possible en principe sur GKE (contrairement à Cloud Run) mais est explicitement hors de portée pour la première version de ce module. |
container_port modifié sans modifier également le port de l'interface utilisateur web de l'assistant de configuration | Maintenir les deux à 3000 | Critique | Le port de l'interface utilisateur web d'exécution d'AdGuard Home provient de AdGuardHome.yaml (défini lors de la configuration) — s'il diverge de container_port, la sonde de santé de la plateforme et l'URL publique ne correspondent plus à ce que le pod écoute réellement, et le pod ne devient jamais Prêt après le premier redémarrage. |
database_type | NONE (ne pas modifier) | Critique | AdGuard Home n'a pas d'intégration de base de données ; définir un moteur réel ici n'a aucun effet mais signale une mauvaise compréhension du module. |
gcs_volumes | Laisser vide (valeur par défaut du module) | Critique | Le remplacer sans monter également conf/work entraîne la perte de la configuration et de l'historique des requêtes d'AdGuard Home à chaque redémarrage du pod. |
| Console d'administration laissée sans IAP | Activer enable_iap | Élevé | La console d'administration contrôle la politique de filtrage DNS ; une console ouverte et non authentifiée permet à quiconque ayant l'IP du LoadBalancer de reconfigurer le filtrage ou de lire les journaux de requêtes. |
workload_type changé en StatefulSet | Garder Deployment (valeur par défaut du module) | Moyen | Non nécessaire — la persistance est GCS Fuse, pas un PVC de bloc ; un StatefulSet ajoute de la complexité sans avantage ici. |
memory_limit en dessous de 512Mi | Maintenir à 512Mi | Moyen | Une mémoire sous-dimensionnée risque des arrêts OOM sous le bin-packing d'Autopilot. |
Pour le comportement de la fondation référencé tout au long — IAM et Workload Identity, autoscaling, ingress et certificats, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC et mise en miroir d'images — voir App_GKE. La configuration d'application spécifique à AdGuard Home partagée avec la variante Cloud Run est décrite dans AdGuardHome_Common.
Guides associés
- Lab pratique : AdGuardHome sur GKE Autopilot — déployez-le étape par étape, avec les écrans de console et les commandes à chaque étape.
- AdGuard Home sur Google Cloud Run — la même application sur Cloud Run, lorsque vous avez besoin de l'autre cible de déploiement.
- AdGuardHome Common — Configuration d'application partagée — la configuration partagée par les deux cibles de déploiement.
- Déployé aux côtés de Headscale sur GKE Autopilot, TechnitiumDNS sur GKE Autopilot, Gatus sur GKE Autopilot dans la solution Réseau Zero-trust et DNS.
Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.