Aller au contenu principal

Gokapi sur GKE Autopilot

Gokapi sur GKE Autopilot

Gokapi est un serveur de partage de fichiers léger et auto-hébergé écrit en Go — une alternative auto-hébergée à WeTransfer. Les utilisateurs téléchargent des fichiers et génèrent des liens de téléchargement partageables avec des dates d'expiration, des limites de nombre de téléchargements et une protection par mot de passe facultatives, le tout étant pris en charge par une base de données SQLite interne (aucune base de données externe n'est requise). Ce module déploie Gokapi 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 utilisés par Gokapi 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 à toutes les applications GKE — Workload Identity, ingress, autoscaling, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et 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 Gokapi sur RAD, et comment cela se compare​

L'exécution de Gokapi dans votre propre projet Google Cloud coûte environ 42,08 $ US/mois en frais Google Cloud, en plus d'un coût de module RAD unique de 75 crédits (67,5 crédits — 10 % de moins — dans un projet géré par RAD). Gokapi est un serveur de partage de fichiers léger et auto-hébergé écrit en Go. Si vous le déployez dans un projet géré par RAD, vous pouvez tout mettre en pause gratuitement et le reprendre plus tard — voir "Mettez-le en pause gratuitement" ci-dessous.

Gokapi est également disponible sur Cloud Run — voir le guide Cloud Run pour l'option la moins chère ; ce guide couvre la variante GKE.

Ce que vous payez sur RAD​

Votre propre projetProjet géré par RAD
Frais de module75 crédits (une seule fois)67,5 crédits (une seule fois, 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 Cloud~42,08 $ US/mois, facturé à votre propre compte de facturation Google au prix catalogue~75 crédits/jour (~7,50 $ US/jour), facturé à l'heure au prix catalogue plus la marge de RAD

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).

Coût d'exécution par défaut dans votre propre projet

Ressource$ US/mois (prix catalogue Google, us-central1)
Pod GKE Autopilot, 1x vCPU / 1 Gio36,08 $ US
Cloud NAT et réseau5 $ US
Cloud Storage (modules complémentaires, sauvegardes)1 $ US
Frais de gestion de cluster GKEpartagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73
Total42,08 $ US

Comment cela se compare​

  • Il n'existe pas de version officiellement hébergée/cloud de Gokapi à comparer, la comparaison honnête se fait donc avec une infrastructure auto-gérée, et non avec un SaaS concurrent.
  • Un VPS nu dimensionné à environ 1 vCPU / 1 Gio — un Hetzner CPX22 (2 vCPU/4 Go, ~24 $ US/mois), un DigitalOcean 2 vCPU/4 Go Droplet (24 $ US/mois), ou le Compute Engine e2-standard-2 de GCP (2 vCPU/8 Go, ~49 $ US/mois) — est généralement moins cher que le prix affiché par RAD ; un VPS d'une ou deux tailles inférieures le serait encore plus.
  • Ce prix inférieur n'inclut pas le temps de l'administrateur : patcher le système d'exploitation, faire tourner les sauvegardes de bases de données, renouveler les certificats TLS et surveiller les temps d'arrêt. Les services Cloud SQL, Secret Manager et de surveillance gérés par RAD le font pour vous, ce qui est le véritable compromis, et non le prix affiché.
  • RAD ne prétend pas être moins cher qu'un VPS nu en termes d'argent — ce n'est généralement pas le cas. L'intérêt de RAD est ce qui est géré pour vous.

Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le quand vous en avez besoin​

Si Gokapi est exécuté dans un projet géré par RAD, vous pouvez arrêter de le payer entièrement sans le détruire. La suppression de ce projet délie d'abord sa facturation, puis demande à Google de supprimer le projet purement et simplement — la suppression logique récupérable de 30 jours de Google. Contrairement à la suppression du module Gokapi seul, cela ne détruit pas Cloud SQL, aucune VM ou la ressource de calcul une par une : l'ensemble du projet s'arrête simplement, et rien n'est facturé pendant qu'il attend, car la facturation est déjà déliée.

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 repli consiste à redéployer l'application (voir la section suivante) et à restaurer sa configuration et ses données à partir de ces sauvegardes.

La restauration, dans les 30 jours et uniquement par le propriétaire du projet, demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter la mise à jour 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. Les frais de module de 67,5 crédits ne sont pas facturés à nouveau.

Ce qu'il faut : vous devez être propriétaire du projet (pas un projet que RAD gère uniquement pour la facturation), vous devez le restaurer vous-même dans les 30 jours — après quoi 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 palier (100 crédits pour le palier sandbox que la plupart des utilisations d'étude/démo conviennent). Google affirme que la plupart des services sont à nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.

Un véritable manque : les sauvegardes nocturnes sont écrites dans un bucket à l'intérieur du projet, et ce bucket a la suppression logique de Cloud Storage explicitement désactivée, il est donc très probable qu'il disparaisse dès que vous supprimez le projet — même si le projet lui-même est récupérable pendant 30 jours. Si vous avez personnalisé Gokapi et que vous souhaitez conserver ce travail, copiez 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.

Ne payez que pendant que vous l'utilisez, l'autre façon : supprimer et redéployer​

Si Gokapi se trouve dans votre propre projet (ou si plus de 30 jours se sont écoulés sur un projet géré par RAD), la façon d'arrêter de payer est de supprimer le déploiement et de le redéployer plus tard lorsque vous en aurez à nouveau besoin.

Un redéploiement coûte à nouveau les frais de module (les builds sont inclus) : 75 crédits (7,50 $ US) dans votre propre projet, ou 67,5 crédits sur un projet géré par RAD.

La suppression ne permet d'économiser de l'argent que si Gokapi reste inutilisé assez longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution : environ 6 jours ou plus d'inactivité dans votre propre projet (par rapport à sa facture Google Cloud d'environ 42,08 $ US/mois), ou environ 2 jours ou plus d'inactivité dans un projet géré par RAD (par rapport à ses ~75 crédits/jour).

Conservez d'abord les données : les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec lui, alors copiez la dernière sauvegarde avant de supprimer si vous voulez la conserver.

Sessions de lab et environnements gérés​

  • Sessions de lab, pour la formation : un formateur anime une session pour une classe. Chaque participant obtient l'application 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 cabinets de conseil : un partenaire exécute l'application 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 de l'API Google Cloud Billing Catalog ; radmodules.dev/pricing pour les propres frais de RAD et les estimations de crédits quotidiens ; documentation de Google sur la suppression/restauration de projets pour les mécanismes de pause/restauration.

1. Vue d'ensemble​

Gokapi s'exécute comme une charge de travail binaire Go unique sans base de données externe. Le déploiement relie un petit ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculGKE AutopilotUn pod StatefulSet à conteneur unique sur le port 53842, 1000m CPU / 1Gi mémoire par défaut
Base de données / métadonnéesAucune (SQLite interne)Pas de Cloud SQL — Gokapi écrit sa propre base de données SQLite sous GOKAPI_CONFIG_DIR ; database_type est fixé à NONE
Persistance des fichiersPVC de bloc GKE (StatefulSet)La base de données SQLite et les fichiers téléchargés résident tous deux sous /data, sur une Persistent Volume Claim par pod par défaut
Stockage d'objetsCloud Storage (conditionnel)Un bucket storage est toujours déclaré, mais n'est monté (via GCS FUSE) que lorsque le PVC StatefulSet est désactivé
SecretsSecret ManagerSeule une clé API d'opérateur facultative (GOKAPI_API_KEY) ; aucun secret généré obligatoire
IngressAPI Kubernetes Gatewayenable_custom_domain = true par défaut, donc un point de terminaison Gateway public (et une IP statique réservée) est provisionné dès le départ

Valeurs par défaut judicieuses à connaître d'emblée :

  • Pas de Cloud SQL, jamais. database_type est fixé en dur à NONE par Gokapi_Common — toutes les variables de base de données génériques (db_name, db_user, application_database_name, etc.) sont transmises à la fondation uniquement pour la compatibilité de la mise en miroir des variables et n'ont aucun effet.
  • SQLite + fichiers téléchargés résident sur un véritable PVC de bloc par défaut, pas GCS FUSE. stateful_pvc_enabled = true par défaut, ce qui résout également automatiquement workload_type en StatefulSet (pas besoin de définir les deux). Un PVC standard-rwo de 20 Gio (SSD) est monté à /data ; GOKAPI_CONFIG_DIR=/data/config (config + la base de données SQLite) et GOKAPI_DATA_DIR=/data/data (fichiers téléchargés) résident tous deux sous ce montage, de sorte que les deux survivent aux redémarrages/redéploiements de pods. Cela est important car SQLite n'est pas sûr sur gcsfuse — le module évite explicitement cette combinaison en désactivant le volume GCS chaque fois que le PVC est activé (voir ci-dessous).
  • Le bucket GCS storage est toujours créé par défaut même s'il n'est pas monté. Gokapi_Common déclare toujours un bucket suffixé par storage, et create_cloud_storage = true par défaut le provisionne — mais avec le PVC StatefulSet par défaut en place, enable_gcs_storage_volume est automatiquement défini sur false pour éviter un double montage à /data, de sorte que le bucket reste inutilisé à moins que vous ne désactiviez stateful_pvc_enabled.
  • Réplica unique par conception. min_instance_count = 1, max_instance_count = 1. La base de données SQLite de Gokapi est à écriture unique ; il n'y a pas de mode distribué/clusterisé, donc ne pas dépasser 1 pod.
  • Aucun mot de passe administrateur n'est généré automatiquement. Gokapi n'a pas de secret obligatoire — le compte administrateur est créé interactivement via l'assistant de configuration de première exécution de Gokapi à /setup (la sortie setup_url). Tant qu'il n'est pas terminé, toutes les autres pages — y compris / — répondent "Le serveur est en mode maintenance, veuillez réessayer dans quelques minutes".
  • Clé API d'opérateur facultative. enable_api_key (par défaut false) génère un jeton aléatoire de 32 caractères, le stocke dans Secret Manager et l'injecte en tant que GOKAPI_API_KEY via un Secret Kubernetes natif (explicit_secret_values) plutôt que le chemin Secret Manager → SecretSync. Il s'agit uniquement d'un jeton de commodité — les propres clés API de téléchargement/téléchargement de Gokapi sont normalement générées à partir de l'interface utilisateur d'administration après la configuration.
  • Redis est désactivé de force. La variante code en dur enable_redis = false à la fondation quelle que soit la valeur de la variable enable_redis — Gokapi n'a aucune utilité pour Redis.
  • Un point de terminaison public est provisionné dès le départ. Contrairement à de nombreux modules d'application, enable_custom_domain est par défaut true et reserve_static_ip est par défaut true, même si service_type est par défaut ClusterIP. Cela donne à Gokapi un point de terminaison Gateway public fonctionnel par défaut — approprié pour une application dont le seul but est de générer des liens de téléchargement partageables. Voir App_GKE pour le mécanisme de nom d'hôte <reserved-ip>.nip.io par défaut.

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 signalés dans les Sorties du déploiement.

A. GKE Autopilot — la charge de travail Gokapi​

Gokapi s'exécute en tant que StatefulSet à pod unique par défaut (identité de pod stable, une politique de redémarrage OrderedReady et un PVC par pod). Autopilot facture le CPU et la mémoire que le pod demande réellement.

  • Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail Gokapi pour les pods, les révisions et les événements.
  • CLI :
    kubectl get pods,svc,statefulset -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" statefulset/<service-name> --tail=100
    kubectl describe pod -n "$NAMESPACE" -l app=<service-name>

Voir App_GKE pour la gestion d'Autopilot, de la mise à l'échelle et du type de charge de travail StatefulSet vs Deployment.

B. Stockage persistant — le PVC de bloc (et le bucket GCS inutilisé)​

La base de données de métadonnées SQLite et tous les fichiers téléchargés résident sous /data sur un PVC de bloc par pod (stateful_pvc_enabled = true, 20Gi, standard-rwo/SSD par défaut). Un bucket Cloud Storage storage est également déclaré et — à moins que vous ne désactiviez le PVC — provisionné mais jamais monté.

  • Console : Kubernetes Engine → Stockage pour le PVC ; Cloud Storage → Buckets pour le bucket (probablement inutilisé).
  • CLI :
    kubectl get pvc -n "$NAMESPACE"
    gcloud storage buckets list --project "$PROJECT" --filter="name~storage"

Voir App_GKE pour les mécanismes StatefulSet/PVC (Groupe 7) et la considération du quota SSD SSD_TOTAL_GB sur les projets à quota limité.

C. Secret Manager​

Gokapi ne crée aucun secret obligatoire. Le seul secret que ce module peut créer est le jeton de commodité d'opérateur GOKAPI_API_KEY facultatif, contrôlé par enable_api_key (par défaut false).

  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT" --filter="name~api-key"
    gcloud secrets versions access latest --secret=<api-key-secret-name> --project "$PROJECT"

Voir App_GKE pour le modèle d'injection de Secret Store CSI / secret natif et la rotation.

D. Réseau et ingress​

enable_custom_domain = true et reserve_static_ip = true sont tous deux des valeurs par défaut, de sorte qu'une ressource Kubernetes Gateway API avec une IP externe statique réservée est provisionnée automatiquement, même si le Service Kubernetes sous-jacent lui-même est par défaut ClusterIP.

  • Console : Services réseau → Équilibrage de charge ; Réseau VPC → Adresses IP.
  • CLI :
    kubectl get svc,gateway,httproute -n "$NAMESPACE"
    gcloud compute addresses list --project "$PROJECT"

Voir App_GKE pour le nom d'hôte <reserved-ip>.nip.io par défaut, les domaines personnalisés, Cloud CDN et les détails de l'IP statique.

E. Cloud Logging et Monitoring​

Les sorties stdout/stderr des pods sont acheminées vers Cloud Logging ; les métriques GKE sont acheminées vers Cloud Monitoring. Des tests de disponibilité et des stratégies d'alerte facultatifs sont disponibles (uptime_check_config est désactivé par défaut).

  • 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

3. Comportement de l'application Gokapi​

  • Aucun job d'initialisation ne s'exécute par défaut. Gokapi_Common ne fournit aucune entrée initialization_jobs par défaut — Gokapi gère son propre stockage et n'a pas besoin de base de données pour démarrer. Seuls les jobs fournis par l'utilisateur (pour le chargement ou la migration de données personnalisées) apparaîtront sous Kubernetes Jobs.
  • La configuration au premier démarrage est entièrement interactive. Il n'y a pas de drapeau d'auto-installation et pas de mot de passe administrateur généré. Ouvrez /setup sur l'URL du service (la sortie setup_url) et l'assistant de Gokapi crée le compte administrateur ; / n'affiche que "Le serveur est en mode maintenance" jusque-là.
  • Où les données persistent physiquement. Avec le stateful_pvc_enabled = true par défaut, GOKAPI_CONFIG_DIR=/data/config (la base de données de métadonnées SQLite et la configuration de l'application) et GOKAPI_DATA_DIR=/data/data (fichiers téléchargés) se trouvent sur le même PVC de bloc par pod monté à /data. Si vous définissez plutôt stateful_pvc_enabled = false, le module réactive automatiquement le montage GCS FUSE du bucket storage au même chemin — acceptable pour une utilisation légère, mais avec une latence plus élevée pour les charges de travail gourmandes en SQLite que le PVC de bloc.
  • Écriture unique, pod unique. min_instance_count = 1 / max_instance_count = 1 par défaut. La base de données SQLite de Gokapi n'a pas de mécanisme de clustering/réplication, donc ne pas augmenter max_instance_count au-dessus de 1.
  • Les sondes de santé atteignent la racine publique, aucune authentification requise. Les sondes de démarrage et de vivacité sont toutes deux HTTP GET / (la racine publique de Gokapi, 200, non authentifiée — avant la configuration, c'est l'avis de maintenance, toujours 200) — démarrage : initial_delay=15s, timeout=5s, period=10s, failure_threshold=10 ; vivacité : initial_delay=30s, timeout=5s, period=30s, failure_threshold=3.
  • Le port du conteneur est fixé à 53842. C'est le port natif de Gokapi, câblé via GOKAPI_PORT=53842 et le container_port du module ; il n'est pas configurable via la variable générique container_port (qui est documentée comme n'ayant aucun effet sur ce module).
  • Vérifiez le pod déployé et son état persistant :
    kubectl get pods,pvc -n "$NAMESPACE"
    kubectl exec -n "$NAMESPACE" statefulset/<service-name> -- ls -la /data/config /data/data
    kubectl logs -n "$NAMESPACE" statefulset/<service-name> --tail=50

4. Variables de configuration​

Les variables sont regroupées exactement telles qu'elles apparaissent sur la plateforme de déploiement. Seuls les paramètres spécifiques ou notables pour Gokapi 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 3 — Identité de l'application​

VariableValeur par défautDescription
application_namegokapiNom de base des ressources. Ne pas modifier après le premier déploiement.
application_versionlatestTag d'image f0rc3/gokapi utilisé comme base de build personnalisé ; latest est épinglé à un tag connu et fonctionnel (v1.9.6) au moment du build via l'argument de build GOKAPI_VERSION spécifique à l'application.
enable_api_keyfalseGénère une clé API aléatoire dans Secret Manager et l'injecte en tant que GOKAPI_API_KEY, un jeton de commodité d'opérateur uniquement.

Groupe 4 — Exécution et mise à l'échelle​

VariableValeur par défautDescription
cpu_limit1000mLimite de CPU pour le conteneur Gokapi.
memory_limit1GiLimite de mémoire ; Gokapi est un binaire Go léger et nécessite peu de mémoire.
min_instance_count1Maintenu à 1 pour éviter les démarrages à froid.
max_instance_count1Maintenir à 1 — la base de données SQLite de Gokapi est à écriture unique sans mode distribué.
container_port53842Non transmis à la fondation ; le port de Gokapi est fixé à 53842 via Gokapi_Common.
enable_cloudsql_volumefalseDoit rester false — Gokapi n'a pas de base de données Cloud SQL.

Groupe 6 — Backend GKE et cluster​

VariableValeur par défautDescription
service_typeLoadBalancerAccessible de l'extérieur par défaut. Définissez ClusterIP pour rendre le service interne uniquement et acheminer le point d'entrée public via la passerelle du groupe 19 à la place (enable_custom_domain, ci-dessous).
workload_typenull → StatefulSetSe résout automatiquement en StatefulSet car stateful_pvc_enabled = true par défaut.
session_affinityNoneLa persistance est largement discutable avec un seul réplica.

Groupe 7 — StatefulSet / PVC​

VariableValeur par défautDescription
stateful_pvc_enabledtrueProvisionne un PVC de bloc par pod pour la base de données SQLite + les téléchargements ; fortement recommandé par rapport à GCS FUSE pour Gokapi.
stateful_pvc_size20GiTaille pour contenir la base de données SQLite et tous les fichiers téléchargés.
stateful_pvc_mount_path/dataGOKAPI_CONFIG_DIR (/data/config) et GOKAPI_DATA_DIR (/data/data) résident tous deux sous ce montage.
stateful_pvc_storage_classstandard-rwoPD équilibré (SSD) par défaut sur GKE Autopilot ; utilise le quota SSD_TOTAL_GB.
stateful_fs_group3000Correspond à l'UID 1000 / GID 2000 de Gokapi afin que le PVC soit inscriptible par le groupe.

Groupe 13 — Système de fichiers (NFS)​

VariableValeur par défautDescription
enable_nfsfalseDésactivé par défaut — Gokapi persiste via le PVC StatefulSet, pas le NFS partagé.

Groupe 16 — Backend de base de données​

VariableValeur par défautDescription
database_typeNONEFixe — Gokapi n'a pas de base de données SQL ; toutes les autres variables de base de données de ce groupe sont transmises uniquement pour la compatibilité de la mise en miroir des variables et n'ont aucun effet.

Groupe 19 — Domaine personnalisé, IP statique et réseau​

VariableValeur par défautDescription
enable_custom_domaintrueActivé par défaut (inhabituel parmi les modules d'application) afin qu'un point de terminaison Gateway public existe dès le départ, correspondant à l'objectif de Gokapi de générer des liens partageables.
reserve_static_iptrueIP externe stable entre les redéploiements, alimentant le nom d'hôte <ip>.nip.io par défaut.
application_domains[]Noms d'hôtes personnalisés + certificat géré ; couche sur le point de terminaison Gateway par défaut.

Toutes les autres entrées suivent le comportement standard de App_GKE.


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.
stage_service_cluster_ipsCarte des ClusterIP pour les services spécifiques à l'étape.
service_external_ipIP externe de l'équilibreur de charge (lorsqu'une IP statique est réservée).
service_urlURL pour atteindre Gokapi.
gokapi_api_key_secret_idID du secret Secret Manager pour la clé API d'opérateur facultative ; vide lorsque enable_api_key est false.
storage_bucketsBuckets Cloud Storage créés (le bucket storage, monté uniquement si le PVC StatefulSet est désactivé).
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.
initialization_jobsNoms des jobs d'initialisation fournis par l'utilisateur (aucun par défaut).
statefulset_nameNom du StatefulSet.
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / cicd_configurationÉtat et détails CI/CD (dépôt, déclencheur, registre).
github_repository_url / github_repository_owner / github_repository_nameDétails GitHub CI/CD.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
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 VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledJournalisation d'audit et état CMEK.

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 via le moteur de fondation App_GKE, qui valide les valeurs et les combinaisons au moment de la planification — un StatefulSet forcé à côté d'un paramètre sans état, IAP sans identités autorisées, quota_memory_* donné comme des entiers bruts, un container_port/backup_retention_days hors de portée. Une configuration invalide fait échouer le plan avec une erreur claire et nommée avant la création de toute ressource, de sorte que la plupart des erreurs ci-dessous sont détectées en amont plutôt qu'à l'application ou à l'exécution.

ParamètreValeur judicieuseRisqueConséquence en cas d'erreur
stateful_pvc_enabledtrueCritiqueLe désactiver revient à utiliser un montage GCS FUSE pour la base de données SQLite — les sémantiques d'écriture de gcsfuse sont dangereuses pour SQLite et risquent une corruption des métadonnées en utilisation réelle.
stateful_pvc_mount_path/data (laisser par défaut)CritiqueGOKAPI_CONFIG_DIR et GOKAPI_DATA_DIR sont tous deux calculés par rapport à ce chemin ; le modifier sans faire correspondre environment_variables écrase la base de données SQLite et les téléchargements existants.
max_instance_count1CritiqueLa base de données SQLite de Gokapi est à écriture unique sans clustering ; l'exécution de plus d'un réplica risque la corruption de la base de données et des téléchargements incohérents.
stateful_pvc_storage_classstandard-rwo (SSD)MoyenConvient pour une utilisation typique ; sur un projet à quota limité (par exemple, un SSD_TOTAL_GB serré), remplacez par HDD standard selon App_GKE si le quota est rare — le modèle d'E/S de Gokapi ne nécessite pas d'IOPS de niveau SSD.
create_cloud_storagetrue (par défaut) avec stateful_pvc_enabled = trueMoyenCrée un bucket GCS storage inutilisé qui n'est jamais monté tant que le PVC est actif — définissez create_cloud_storage = false pour éviter le bucket inutile, ou laissez-le si vous pourriez désactiver le PVC plus tard.
enable_api_key (secret auto-généré)Laissez false à moins que vous n'ayez besoin d'une clé pré-provisionnéeFaibleLe jeton n'est qu'une commodité ; les véritables clés API de téléchargement/téléchargement de Gokapi sont générées à partir de l'interface utilisateur d'administration, quel que soit ce paramètre.
quota_memory_requests / _limitsunités binaires (4Gi, 8192Mi)CritiqueLes entiers bruts sont traités comme des octets et bloquent toute planification de pod dans l'espace de noms.
enable_custom_domain / reserve_static_iptrue / true (par défaut)MoyenLa désactivation des deux rend Gokapi accessible uniquement via ClusterIP interne, sans URL publique pour les liens de téléchargement qu'il génère — cela va à l'encontre du but de l'application pour le partage externe.
enable_cloudsql_volumefalseFaibleLe définir sur true injecte un sidecar Cloud SQL Auth Proxy inutile ; Gokapi ne l'utilise jamais.
enable_nfsfalseFaibleGokapi persiste via le PVC StatefulSet par défaut ; l'activation de NFS ajoute une instance Filestore inutilisée à moins que vous ne désactiviez délibérément le PVC et que vous ne souhaitiez un stockage partagé à la place.

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, sauvegardes et mise en miroir d'images — voir App_GKE. La configuration d'application spécifique à Gokapi partagée avec la variante Cloud Run est décrite dans Gokapi_Common.

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