Aller au contenu principal

AdGuard Home sur GKE Autopilot

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=LoadBalancer L4 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édezDans un projet géré par RAD pour vous
Frais de module, une fois par déploiement40 crédits (4 $ US au prix de la recharge)36 crédits (10 % de moins)
BuildsInclus 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 buildIdem
Coût d'exécution Google CloudFacturé 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 quoiVous possédez le projet et sa facturation ; RAD le déploie et le met à jourRAD 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 Gio34,29 $ US
Cloud NAT et réseau5 $ US
Cloud Storage (modules complémentaires, sauvegardes)1 $ US
Frais de gestion du cluster GKE0 $ 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)
Totalenviron 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 CloudNotes
CalculGKE AutopilotPod binaire Go unique, 1 vCPU / 512 Mio par défaut, type de charge de travail Deployment
Base de donnéesAucuneAdGuard Home n'a pas de base de données externe — la configuration est un fichier YAML plat
Stockage d'objetsCloud 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
SecretsSecret ManagerAucun généré — les identifiants d'administrateur sont définis via l'assistant web de première exécution d'AdGuard Home
IngressCloud Load BalancingService 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/conf et work à /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éfinir gcs_volumes vous-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 que AdGuardHome.yaml existe. 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.yaml n'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 renvoie 200 avant 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é​

VariableValeur par défautDescription
project_id(obligatoire)Projet Google Cloud cible.
regionus-central1Région pour la charge de travail et les ressources régionales.

Groupe 2 — Environnement de déploiement​

VariableValeur par défautDescription
tenant_iddemoSuffixe court qui rend les noms de ressources uniques par environnement.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_nameadguardhomeNom de base des ressources. Ne pas modifier après le premier déploiement.
application_versionlatestTag 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​

VariableValeur par défautDescription
deploy_applicationtrueDéfinir false pour provisionner uniquement l'infrastructure.
min_instance_count1Réplicas minimum.
max_instance_count1Réplicas maximum.
container_port3000Le 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_volumefalseNon utilisé — pas de base de données.

Groupe 6 — Backend GKE et cluster​

VariableValeur par défautDescription
service_typeLoadBalancerAccessible au public par défaut — une interface utilisateur, pas un outil de base de données interne uniquement.
workload_typeDeploymentPas de StatefulSet nécessaire ; la persistance est GCS Fuse.

Groupe 10 — IAP et VPC-SC​

VariableValeur par défautDescription
enable_iapfalseRecommandé d'activer — place l'authentification d'identité Google devant la console de stratégie de filtrage DNS.

Groupe 11 — Domaine personnalisé et réseau​

VariableValeur par défautDescription
reserve_static_iptrueIP 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​

VariableValeur par défautDescription
create_cloud_storagetrueCré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​

VariableValeur par défautDescription
database_typeNONEFixe — ne doit pas être modifié.

Groupe 10 — Observabilité et santé​

VariableValeur par défautDescription
startup_probe_config / health_check_configHTTP /Pas de point de terminaison de santé dédié ; la racine renvoie 200 avant et après la configuration.
uptime_check_configdésactivéTest de disponibilité facultatif de Cloud Monitoring.

Groupe 11 — Jobs et tâches planifiées​

VariableValeur par défautDescription
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​

VariableValeur par défautDescription
enable_vpc_scfalseAppliquer 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.

SortieDescription
service_nameNom du service Kubernetes.
namespaceEspace de noms dans lequel la charge de travail s'exécute.
service_cluster_ipClusterIP intra-cluster.
service_external_ipIP externe du LoadBalancer (lorsqu'une IP statique est réservée).
service_urlURL pour atteindre la console d'administration d'AdGuard Home (pas une adresse de résolveur DNS).
storage_bucketsBuckets Cloud Storage créés (conf, work).
network_name / network_exists / regionsRéseau VPC, présence, régions disponibles.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channelsÉtat et canaux de surveillance.
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
kubernetes_readyIndique 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ètreValeur judicieuseRisqueConséquence en cas d'erreur
Attendre une résolution DNS réelle de ce déploiementNe pas s'y fierCritiqueLe 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 configurationMaintenir les deux à 3000CritiqueLe 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_typeNONE (ne pas modifier)CritiqueAdGuard 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_volumesLaisser vide (valeur par défaut du module)CritiqueLe 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 IAPActiver 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 StatefulSetGarder Deployment (valeur par défaut du module)MoyenNon 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 512MiMaintenir à 512MiMoyenUne 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.

Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.