Aller au contenu principal

Shlink sur Google Cloud Run

Shlink sur Google Cloud Run

Shlink est un raccourcisseur d'URL auto-hébergé et open source avec des analyses de visites détaillées, la génération de codes QR et une API REST complète. Ce module déploie Shlink sur Cloud Run v2 au-dessus de la fondation App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.

Ce guide se concentre sur les services cloud que Shlink 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 Cloud Run — identité de service, ingress et équilibrage de charge, mise à l'échelle et concurrence, 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_CloudRun plutôt que de les répéter ici.


L'exécution de Shlink dans votre propre projet GCP coûte environ 67,80 $/mois en frais Google Cloud ; les frais de module de RAD sont de 75 crédits uniques (ou 67,5 crédits dans un projet géré par RAD), couvrant la configuration et le support — pas la facture cloud continue, que Google vous facture directement dans votre propre projet ou que RAD mesure à l'heure en crédits dans un projet géré par RAD. Ou consultez le guide GKE pour la cible de déploiement alternative ; dans tous les cas, si vous déployez dans un projet géré par RAD, vous pouvez tout mettre en pause gratuitement lorsque vous ne l'utilisez pas — voir Mettre en pause gratuitement ci-dessous.

Ce que vous payez sur RAD​

Votre propre projetProjet géré par RAD
Frais de module75 crédits, une fois67,5 crédits, une 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 pour le temps de build à la minuteIdem
Coût d'exécution Google Cloud~67,80 $/mois, facturé à votre propre compte de facturation au prix catalogue de Google~61 crédits/jour, mesuré à l'heure par RAD au prix catalogue plus marge

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

RessourceUS$/mois (prix catalogue Google, us-central1)
Cloud Run, 1x vCPU / 0,5 GiB (scaleToZero)10,78 $
Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51,02 $
Cloud NAT et réseau5,00 $
Cloud Storage (modules complémentaires, sauvegardes)1,00 $
Total67,80 $

Comparaison​

  • L'empreinte propre de Shlink ici (1x vCPU / 0,5 GiB) est plus petite que cette classe de référence, donc un niveau de VPS encore moins cher ferait tout aussi bien, mais dimensionné à la plus petite classe couramment citée pour comparaison : Hetzner CPX22 (2 vCPU/4 Go) coûte environ 24 $/mois, un Droplet DigitalOcean 2 vCPU/4 Go est également à 24 $/mois, et un GCP Compute Engine e2-standard-2 (2 vCPU/8 Go) est à environ 49 $/mois — plus le temps de l'administrateur pour les sauvegardes, les correctifs de sécurité et les mises à niveau, que Cloud SQL géré, Secret Manager et la surveillance de RAD couvrent pour vous — mais le prix de RAD n'est jamais destiné à battre un VPS, seulement à remplacer le temps d'administration qu'un VPS nécessite encore.
  • Un raccourcisseur d'URL répond à des redirections simples en continu mais à faible coût — la base de données est le principal coût fixe ici, pas le service de raccourcissement lui-même.

Mettre en pause gratuitement : supprimer un projet géré par RAD, le restaurer quand vous en avez besoin​

C'est le titre pour un projet géré par RAD. La suppression d'un projet géré par RAD commence par délier sa facturation, puis demande à Google de supprimer le projet purement et simplement — la propre suppression logicielle récupérable de Google de 30 jours. Contrairement à la suppression d'un module, cela ne démantèle 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 invoqué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.

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 palier (100 crédits pour le palier sandbox qui convient à la plupart des utilisations d'étude/démo). Google indique que la plupart des services sont de 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 logicielle 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é l'application 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.

Payer uniquement pendant l'utilisation, l'autre méthode : supprimer et redéployer​

Dans votre propre projet (ou une fois que vous avez dépassé la fenêtre de restauration de 30 jours ci-dessus), l'alternative est de supprimer Shlink purement et simplement et de le redéployer plus tard. Un redéploiement coûte à nouveau les frais de module (les builds sont inclus) — 75 crédits.

La suppression ne permet d'économiser de l'argent que si Shlink reste inutilisé assez longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution quotidien — par rapport au total du projet propre ci-dessus, cela représente environ 4 jours ou plus. La majeure partie du coût d'exécution ici est généralement la base de données ; elle ne s'arrête que si rien d'autre dans le projet ne l'utilise, donc la suppression de cette application alors que quelque chose d'autre partage le projet n'économise que la partie calcul de cette application.

Conserver les données en premier : les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec lui, donc 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 retournent au formateur.
  • Environnements gérés, pour les sociétés 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 frais propres de RAD et les estimations de crédits quotidiens ; https://cloud.google.com/resource-manager/docs/delete-restore-projects pour les mécanismes de pause/restauration.

1. Vue d'ensemble​

Shlink s'exécute comme un conteneur PHP (RoadRunner) sur Cloud Run v2. Le déploiement connecte un ensemble délibérément restreint de services Google Cloud — Shlink conserve tout son état dans PostgreSQL, il n'y a donc pas de partage NFS ou de bucket de stockage d'objets à gérer :

CapacitéService Google CloudNotes
CalculCloud Run v21 vCPU / 512 Mio par défaut, scale-to-zero (min_instance_count = 0)
Base de donnéesCloud SQL pour PostgreSQL 15Requis — contient les URL courtes, les visites, les tags et les clés API
Connectivité DBProxy d'authentification Cloud SQL (socket Unix)enable_cloudsql_volume = true ; socket compatible libpq, pas d'IP publique
SecretsSecret ManagerMot de passe de la base de données + INITIAL_API_KEY auto-généré
Cache / verrousRedis (facultatif)Désactivé par défaut ; utile uniquement pour la mise en cache/verrouillage multi-instances
IngressURL Cloud Run / Équilibrage de charge CloudURL run.app par défaut, LB HTTPS externe facultatif + domaine personnalisé

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

  • PostgreSQL 15 est le moteur pris en charge (database_type = "POSTGRES_15", DB_DRIVER = "postgres"). Shlink se connecte via le socket Unix du proxy d'authentification Cloud SQL — libpq accepte le répertoire du socket comme hôte, donc aucune configuration TCP/SSL n'est nécessaire.
  • DB_USER / DB_NAME sont injectés par la fondation avec des noms limités au locataire et délibérément non définis par le module — le job db-init crée le même utilisateur et la même base de données, de sorte que tout s'aligne automatiquement.
  • INITIAL_API_KEY est auto-généré (32 caractères), stocké dans Secret Manager et injecté comme variable d'environnement secrète. Shlink le lit au premier démarrage pour amorcer sa première clé API REST — vous ne créez jamais de clé à la main.
  • Les migrations s'exécutent automatiquement au démarrage du conteneur. L'image officielle gère l'installation et les mises à niveau du schéma ; il n'existe pas d'étape de migration distincte.
  • Mise à l'échelle à zéro par défaut. Shlink est une application de requête/réponse sans état (redirections + API REST) ; elle ne coûte rien lorsqu'elle est inactive. Le compromis est un démarrage à froid d'environ 5 à 15 s lors de la première requête après l'inactivité.
  • Les sondes de santé ciblent /rest/health — un point de terminaison public, non authentifié, qui renvoie HTTP 200 avec {"status":"pass"}. Shlink n'a pas de page d'accueil web ; / renvoie 404 par conception.
  • DEFAULT_DOMAIN est laissé vide car l'URL run.app n'est pas connue avant le déploiement — définissez-la après le déploiement afin que les URL courtes générées utilisent le bon hôte. IS_HTTPS_ENABLED=true est prédéfini.
  • Le mot de passe de la base de données est généré automatiquement et stocké dans Secret Manager, injecté comme DB_PASSWORD.

2. Services Google Cloud et comment les explorer​

Toutes les commandes supposent que PROJECT et REGION sont définis. Les noms des services et des ressources sont indiqués dans les Sorties du déploiement.

Shlink s'exécute en tant que service Cloud Run v2 qui s'adapte automatiquement en fonction de la charge de requêtes entre le nombre minimum (0) et maximum (3) d'instances. Chaque déploiement crée une révision immuable ; le trafic peut être réparti entre les révisions pour des déploiements sûrs.

  • Console : Cloud Run → sélectionnez le service pour les révisions, le trafic, les logs et les métriques.
  • CLI :
    gcloud run services list --project "$PROJECT" --region "$REGION"
    gcloud run services describe <service-name> --project "$PROJECT" --region "$REGION"
    gcloud run revisions list --service <service-name> --project "$PROJECT" --region "$REGION"

Voir App_CloudRun pour la mise à l'échelle, la concurrence, l'environnement d'exécution et la répartition du trafic.

B. Cloud SQL pour PostgreSQL 15​

Shlink stocke tout — URL courtes, enregistrements de visites, tags, domaines et clés API — dans une instance Cloud SQL pour PostgreSQL 15 gérée. Le service se connecte en privé via le proxy d'authentification Cloud SQL sur un socket Unix (pas d'IP publique). Lors du premier déploiement, un job db-init crée la base de données et l'utilisateur de l'application.

  • Console : SQL → sélectionnez l'instance pour les connexions, les sauvegardes, les indicateurs, les métriques.
  • CLI :
    gcloud sql instances list --project "$PROJECT"
    gcloud sql instances describe <instance-name> --project "$PROJECT"
    gcloud sql connect <instance-name> --user=<db-user> --project "$PROJECT"

Le nom de l'instance, la base de données, l'utilisateur et le secret du mot de passe se trouvent dans les Sorties. Voir App_CloudRun pour le modèle de connexion, les sauvegardes et la rotation des mots de passe.

C. Secret Manager​

Deux secrets sont gérés automatiquement : le mot de passe de la base de données (créé par la fondation, injecté comme DB_PASSWORD) et la clé API initiale (créée par Shlink_Common, injectée comme INITIAL_API_KEY). Le texte en clair n'apparaît jamais dans la configuration.

  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT" --filter="name~shlink"
    gcloud secrets versions access latest \
    --secret="$(gcloud secrets list --project "$PROJECT" \
    --filter='name~shlink AND name~initial-api-key' --format='value(name)' --limit=1)" \
    --project "$PROJECT"

Voir App_CloudRun pour les détails d'injection et de rotation.

D. Redis (facultatif)​

Shlink peut utiliser Redis pour la mise en cache et les verrous distribués — utile uniquement lors de l'exécution de plusieurs instances simultanément. Il est désactivé par défaut (enable_redis = false) ; un déploiement max_instance_count à un seul chiffre fonctionne très bien sans.

  • Console : Memorystore → Redis (si vous utilisez une instance gérée).
  • CLI :
    redis-cli -h <redis-host> ping

E. Réseau et ingress​

Le service est accessible par son URL run.app par défaut. Un équilibreur de charge HTTPS externe avec un domaine personnalisé (l'option naturelle pour un domaine court de marque tel que s.example.com), Cloud CDN et Cloud Armor peuvent être superposés ; les paramètres d'ingress et de contrôle d'egress VPC contrôlent la connectivité.

  • Console : Cloud Run (URL du service) ; Services réseau → Équilibrage de charge.
  • CLI :
    gcloud run services describe <service-name> --region "$REGION" --format='value(status.url)'
    gcloud compute addresses list --project "$PROJECT"

Voir App_CloudRun.

F. Cloud Logging et Monitoring​

Les logs des conteneurs sont envoyés à Cloud Logging ; les métriques Cloud Run et Cloud SQL sont envoyées à Cloud Monitoring. Un test de disponibilité sur /rest/health est provisionné par défaut, avec une alerte de défaillance du test connectée à support_users.

  • Console : Logging → Explorateur de logs ; Monitoring → Tests de disponibilité / Alertes.
  • CLI :
    gcloud run services logs read <service-name> --project "$PROJECT" --region "$REGION" --limit 50

  • Configuration de la base de données au premier déploiement. Un job db-init (image postgres:15-alpine) se connecte à Cloud SQL via le socket du proxy d'authentification et crée de manière idempotente l'utilisateur et la base de données de l'application, accorde les privilèges (y compris GRANT <user> TO postgres afin que la propriété puisse être définie), et signale au sidecar du proxy de s'arrêter pour que le job se termine. Le job s'exécute à chaque apply et peut être réexécuté en toute sécurité.
  • Migrations au démarrage. L'image officielle de Shlink exécute ses migrations de base de données automatiquement à chaque démarrage de conteneur — le premier démarrage installe le schéma, les mises à niveau appliquent les modifications de schéma sans étape manuelle. La sonde de démarrage autorise jusqu'à ~300 s (failure_threshold = 30 × 10 s) pour les migrations du premier démarrage.
  • API-first — pas de page d'accueil. Shlink est un serveur sans tête : / renvoie 404 par conception. Tout est piloté via l'API REST (/rest/v3/...) en utilisant l'en-tête X-Api-Key, ou via une interface utilisateur shlink-web-client hébergée séparément et pointant vers ce serveur.
  • Accès à la première exécution. Récupérez la clé API d'amorçage de Secret Manager (voir §2C) et utilisez-la immédiatement :
    API_KEY=$(gcloud secrets versions access latest --secret=<initial-api-key-secret> --project "$PROJECT")
    curl -s -X POST "<service-url>/rest/v3/short-urls" \
    -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
    -d '{"longUrl": "https://cloud.google.com/run"}'
  • DEFAULT_DOMAIN après le déploiement. Shlink intègre son hôte public dans chaque URL courte générée. L'URL du service est inconnue au moment de la planification, donc DEFAULT_DOMAIN est vide — définissez-le (via l'entrée environment_variables lors d'une mise à jour) sur le nom d'hôte run.app ou votre domaine court personnalisé une fois connu.
  • La géolocalisation est optionnelle. La géolocalisation des visites nécessite une licence MaxMind GeoLite2 : définissez GEOLITE_LICENSE_KEY dans environment_variables. Sans cela, les visites sont toujours enregistrées — mais pas géolocalisées.
  • Contraintes de mise à l'échelle. Les instances sont sans état (tout l'état est dans PostgreSQL), donc la mise à l'échelle horizontale est sûre. Si vous augmentez max_instance_count bien au-delà de la valeur par défaut de 3 et que vous comptez sur les compteurs/verrous mis en cache de Shlink, activez Redis (enable_redis = true).
  • Vérification de la santé :
    curl -s "<service-url>/rest/health"
    # {"status":"pass","version":"...","links":{...}}

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 Shlink sont listés ; toutes les autres entrées sont héritées de App_CloudRun avec son comportement standard.

Groupe 1 — Projet et identité​

VariableValeur par défautDescription
project_id(requis)Projet Google Cloud cible.
regionus-central1Région pour le service 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.
support_users[]Adresses e-mail ayant accès au projet et aux alertes de surveillance.
resource_labels{}Libellés appliqués à toutes les ressources.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_nameshlinkNom de base des ressources. Ne pas modifier après le premier déploiement.
display_nameShlinkNom convivial affiché dans la console.
application_versionstableTag de version de l'image Shlink (par exemple 4.4.0) ; incrémenter pour déclencher un nouveau build.
admin_usernameshlinkNon utilisé par Shlink (il s'authentifie avec des clés API, pas des comptes administrateur). Conservé pour la parité de l'interface.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinir false pour provisionner uniquement l'infrastructure.
cpu_limit1000mCPU par instance — 1 vCPU gère confortablement les redirections et les appels API.
memory_limit512MiMémoire par instance (minimum gen2).
min_instance_count0Mise à l'échelle à zéro. Ne coûte rien à l'arrêt ; la première requête après l'arrêt prend un démarrage à froid d'environ 5 à 15 s. Définir 1 pour les liens sensibles à la latence.
max_instance_count3Nombre maximal d'instances. Activer Redis avant d'augmenter significativement cette valeur.
container_port8080Port HTTP natif de Shlink.
enable_cloudsql_volumetrueSocket Unix du proxy d'authentification Cloud SQL — la connexion compatible libpq que Shlink attend.
enable_image_mirroringtrueMet en miroir l'image dans Artifact Registry pour éviter les limites de débit de Docker Hub.
execution_environmentgen2Cloud Run gen2 (recommandé).

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 5 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Variables d'environnement en texte clair. Options Shlink notables : DEFAULT_DOMAIN (hôte public d'URL courte — à définir après le déploiement), GEOLITE_LICENSE_KEY (clé MaxMind pour la géolocalisation des visites). DB_DRIVER=postgres, DB_PORT=5432, IS_HTTPS_ENABLED=true sont injectées automatiquement.
secret_environment_variables{}Références Secret Manager supplémentaires. DB_PASSWORD et INITIAL_API_KEY sont câblées automatiquement.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 6 — Contrôle d'accès et d'ingress​

Entrées IAP / ingress / egress VPC standard (enable_iap, ingress_settings, vpc_egress_setting). Notez que les points de terminaison de redirection d'un raccourcisseur doivent rester accessibles publiquement — IAP devant Shlink protège également chaque lien court. Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupes 7 à 10 — Sauvegarde, CI/CD, SQL personnalisé, Domaine et CDN​

Comportement standard d'App_CloudRun (backup_schedule, enable_cicd_trigger, enable_binary_authorization, enable_custom_sql_scripts, application_domains, enable_cdn, enable_cloud_armor, entrées de rétention d'image). application_domains est l'endroit où un domaine court de marque est attaché. Toutes les entrées suivent le comportement standard d'App_CloudRun.

Groupe 11 — Stockage et système de fichiers​

VariableValeur par défautDescription
enable_nfsfalseShlink stocke toutes les données dans PostgreSQL — aucun système de fichiers partagé n'est nécessaire.
create_cloud_storage / gcs_volumesoff / []Aucun bucket n'est provisionné ; Shlink n'en a pas besoin.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
database_typePOSTGRES_15Moteur Cloud SQL pris en charge par Shlink ici — ne pas modifier.
db_nameshlinkNom de base de données (préfixé par le locataire par la fondation). Immuable après le premier déploiement.
db_usershlinkUtilisateur de base de l'application (préfixé par le locataire). Immuable après le premier déploiement.
database_password_length32Longueur du mot de passe généré (16–64).
db_password_env_var_nameDB_PASSWORDPrédéfini — Shlink lit DB_PASSWORD directement.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

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

VariableValeur par défautDescription
initialization_jobs[]Laisser vide pour utiliser le job db-init intégré (postgres:15-alpine).
cron_jobs[]Jobs récurrents déclenchés par Cloud Scheduler.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeHTTP /rest/health, délai initial de 30 s, failure_threshold = 30Permet jusqu'à ~300 s pour les migrations du premier démarrage.
liveness_probeHTTP /rest/health, délai de 30 s, période de 30 s/rest/health n'est pas authentifié, donc la vivacité reste activée.
uptime_check_configdésactivé, chemin /rest/healthTest de disponibilité Cloud Monitoring + alerte de défaillance.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 21 — Cache Redis​

VariableValeur par défautDescription
enable_redisfalseMise en cache/verrouillage facultatif pour les configurations multi-instances ; inutile à l'échelle par défaut.
redis_host / redis_port / redis_auth"" / 6379 / ""Détails du point de terminaison Redis lorsqu'il est activé.

Groupe 22 — VPC Service Controls et journalisation d'audit​

Comportement standard d'App_CloudRun (enable_vpc_sc, vpc_cidr_ranges, vpc_sc_dry_run, organization_id, enable_audit_logging).


5. Sorties​

Retournées lors d'un déploiement réussi — le moyen le plus rapide de localiser et d'explorer les ressources en cours d'exécution.

SortieDescription
service_nameNom du service Cloud Run.
api_urlURL run.app par défaut du service.
health_check_url<api_url>/rest/health — utilisez curl pour confirmer que le déploiement est actif (Shlink n'a pas de page d'accueil ; / renvoie 404).
service_locationRégion dans laquelle le service s'exécute.
stage_servicesURL de service spécifiques à l'étape (Cloud Deploy).
load_balancer_ip / load_balancer_urlIP / URL de l'équilibreur de charge HTTPS externe (lorsqu'il est activé).
database_instance_nameNom de l'instance Cloud SQL.
database_name / database_userNom / utilisateur de la base de données de l'application (étendue au locataire).
database_password_secretSecret Manager contenant le mot de passe de la base de données.
database_host / database_portPoint de terminaison / port de la base de données.
storage_bucketsBuckets Cloud Storage créés (vides — Shlink n'en a pas besoin).
network_name / network_exists / regionsRéseau VPC, présence, régions.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channels / uptime_check_namesÉtat de la surveillance, canaux, tests de disponibilité.
initialization_jobsNoms des jobs de configuration (db-init).
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / github_repository_url / github_repository_owner / github_repository_name / cicd_configurationÉtat et détails CI/CD.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
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).

ParamètreValeur judicieuseRisqueConséquence si incorrect
database_typePOSTGRES_15CritiqueShlink est configuré pour PostgreSQL ici (DB_DRIVER=postgres) ; un autre moteur interrompt le démarrage.
db_name / db_userdéfini une foisCritiqueImmuable après le premier déploiement ; le renommage recrée la base de données/l'utilisateur et détruit toutes les URL courtes et les données de visite.
environment_variables DB_USER / DB_NAMEjamais défini manuellementCritiqueRemplace les noms du locataire de la fondation → password authentication failed for user "shlink". Laissez-les non définis.
container_port8080CritiquePort natif de Shlink ; une incompatibilité échoue toutes les sondes de santé.
enable_cloudsql_volumetrueCritiqueShlink attend le socket Unix du proxy d'authentification ; le désactiver interrompt le chemin de connexion à la base de données.
sonde / uptime path/rest/healthÉlevé/ renvoie 404 par conception — le sonder tue les révisions saines.
startup_probe failure_threshold30ÉlevéLe réduire peut tuer le conteneur avant la fin des migrations du premier démarrage.
DEFAULT_DOMAINdéfini après le déploiementÉlevéLaissé vide, les URL courtes générées peuvent avoir le mauvais hôte ; définissez-le sur le run.app ou le domaine personnalisé.
enable_iapfalse pour les liens publicsÉlevéIAP devant Shlink protège chaque redirection de lien court derrière la connexion Google.
max_instance_count sans Redis3MoyenDe nombreuses instances sans Redis perdent la mise en cache/verrouillage partagé ; activez enable_redis avant de mettre à l'échelle.
min_instance_count0 (par défaut) ou 1Moyen0 est presque gratuit mais ajoute un démarrage à froid d'environ 5 à 15 s à la première redirection après l'inactivité.
GEOLITE_LICENSE_KEYdéfinir si l'analyse est importanteFaibleSans cela, les visites sont enregistrées mais non géolocalisées.
enable_nfs / create_cloud_storagefalse / offFaibleCoût gaspillé — Shlink conserve tout l'état dans PostgreSQL.

Pour le comportement de la fondation référencé tout au long — identité de service, mise à l'échelle et concurrence, ingress et équilibrage de charge, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC, sauvegardes et mise en miroir d'images — voir App_CloudRun. La configuration d'application spécifique à Shlink partagée avec la variante GKE est décrite dans Shlink_Common.

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