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.
Coût de Shlink sur RAD et comparaison
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 projet | Projet géré par RAD | |
|---|---|---|
| Frais de module | 75 crédits, une fois | 67,5 crédits, une fois (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 pour le temps de build à la minute | Idem |
| 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
| Ressource | US$/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 SSD | 51,02 $ |
| Cloud NAT et réseau | 5,00 $ |
| Cloud Storage (modules complémentaires, sauvegardes) | 1,00 $ |
| Total | 67,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 Cloud | Notes |
|---|---|---|
| Calcul | Cloud Run v2 | 1 vCPU / 512 Mio par défaut, scale-to-zero (min_instance_count = 0) |
| Base de données | Cloud SQL pour PostgreSQL 15 | Requis — contient les URL courtes, les visites, les tags et les clés API |
| Connectivité DB | Proxy d'authentification Cloud SQL (socket Unix) | enable_cloudsql_volume = true ; socket compatible libpq, pas d'IP publique |
| Secrets | Secret Manager | Mot de passe de la base de données + INITIAL_API_KEY auto-généré |
| Cache / verrous | Redis (facultatif) | Désactivé par défaut ; utile uniquement pour la mise en cache/verrouillage multi-instances |
| Ingress | URL Cloud Run / Équilibrage de charge Cloud | URL 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_NAMEsont injectés par la fondation avec des noms limités au locataire et délibérément non définis par le module — le jobdb-initcrée le même utilisateur et la même base de données, de sorte que tout s'aligne automatiquement.INITIAL_API_KEYest 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_DOMAINest laissé vide car l'URLrun.appn'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=trueest 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.
A. Cloud Run — le service Shlink
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
3. Comportement de l'application Shlink
- Configuration de la base de données au premier déploiement. Un job
db-init(imagepostgres: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 comprisGRANT <user> TO postgresafin 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êteX-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_DOMAINaprè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, doncDEFAULT_DOMAINest vide — définissez-le (via l'entréeenvironment_variableslors d'une mise à jour) sur le nom d'hôterun.appou 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_KEYdansenvironment_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_countbien 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é
| Variable | Valeur par défaut | Description |
|---|---|---|
project_id | (requis) | Projet Google Cloud cible. |
region | us-central1 | Région pour le service 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. |
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
| Variable | Valeur par défaut | Description |
|---|---|---|
application_name | shlink | Nom de base des ressources. Ne pas modifier après le premier déploiement. |
display_name | Shlink | Nom convivial affiché dans la console. |
application_version | stable | Tag de version de l'image Shlink (par exemple 4.4.0) ; incrémenter pour déclencher un nouveau build. |
admin_username | shlink | Non 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
| Variable | Valeur par défaut | Description |
|---|---|---|
deploy_application | true | Définir false pour provisionner uniquement l'infrastructure. |
cpu_limit | 1000m | CPU par instance — 1 vCPU gère confortablement les redirections et les appels API. |
memory_limit | 512Mi | Mémoire par instance (minimum gen2). |
min_instance_count | 0 | Mise à 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_count | 3 | Nombre maximal d'instances. Activer Redis avant d'augmenter significativement cette valeur. |
container_port | 8080 | Port HTTP natif de Shlink. |
enable_cloudsql_volume | true | Socket Unix du proxy d'authentification Cloud SQL — la connexion compatible libpq que Shlink attend. |
enable_image_mirroring | true | Met en miroir l'image dans Artifact Registry pour éviter les limites de débit de Docker Hub. |
execution_environment | gen2 | Cloud Run gen2 (recommandé). |
Toutes les autres entrées suivent le comportement standard d'App_CloudRun.
Groupe 5 — Variables d'environnement et secrets
| Variable | Valeur par défaut | Description |
|---|---|---|
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
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_nfs | false | Shlink stocke toutes les données dans PostgreSQL — aucun système de fichiers partagé n'est nécessaire. |
create_cloud_storage / gcs_volumes | off / [] | 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
| Variable | Valeur par défaut | Description |
|---|---|---|
database_type | POSTGRES_15 | Moteur Cloud SQL pris en charge par Shlink ici — ne pas modifier. |
db_name | shlink | Nom de base de données (préfixé par le locataire par la fondation). Immuable après le premier déploiement. |
db_user | shlink | Utilisateur de base de l'application (préfixé par le locataire). Immuable après le premier déploiement. |
database_password_length | 32 | Longueur du mot de passe généré (16–64). |
db_password_env_var_name | DB_PASSWORD | Pré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
| Variable | Valeur par défaut | Description |
|---|---|---|
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é
| Variable | Valeur par défaut | Description |
|---|---|---|
startup_probe | HTTP /rest/health, délai initial de 30 s, failure_threshold = 30 | Permet jusqu'à ~300 s pour les migrations du premier démarrage. |
liveness_probe | HTTP /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_config | désactivé, chemin /rest/health | Test de disponibilité Cloud Monitoring + alerte de défaillance. |
Toutes les autres entrées suivent le comportement standard d'App_CloudRun.
Groupe 21 — Cache Redis
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_redis | false | Mise 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.
| Sortie | Description |
|---|---|
service_name | Nom du service Cloud Run. |
api_url | URL 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_location | Région dans laquelle le service s'exécute. |
stage_services | URL de service spécifiques à l'étape (Cloud Deploy). |
load_balancer_ip / load_balancer_url | IP / URL de l'équilibreur de charge HTTPS externe (lorsqu'il est activé). |
database_instance_name | Nom de l'instance Cloud SQL. |
database_name / database_user | Nom / utilisateur de la base de données de l'application (étendue au locataire). |
database_password_secret | Secret Manager contenant le mot de passe de la base de données. |
database_host / database_port | Point de terminaison / port de la base de données. |
storage_buckets | Buckets Cloud Storage créés (vides — Shlink n'en a pas besoin). |
network_name / network_exists / regions | Réseau VPC, présence, régions. |
container_image / container_registry | Image 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_jobs | Noms des jobs de configuration (db-init). |
deployment_id / tenant_id / resource_prefix | Identifiants de nommage. |
project_id / project_number | Identifiants 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_id | Registre 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_enabled | Journalisation 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ètre | Valeur judicieuse | Risque | Conséquence si incorrect |
|---|---|---|---|
database_type | POSTGRES_15 | Critique | Shlink est configuré pour PostgreSQL ici (DB_DRIVER=postgres) ; un autre moteur interrompt le démarrage. |
db_name / db_user | défini une fois | Critique | Immuable 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_NAME | jamais défini manuellement | Critique | Remplace les noms du locataire de la fondation → password authentication failed for user "shlink". Laissez-les non définis. |
container_port | 8080 | Critique | Port natif de Shlink ; une incompatibilité échoue toutes les sondes de santé. |
enable_cloudsql_volume | true | Critique | Shlink 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_threshold | 30 | Élevé | Le réduire peut tuer le conteneur avant la fin des migrations du premier démarrage. |
DEFAULT_DOMAIN | dé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_iap | false pour les liens publics | Élevé | IAP devant Shlink protège chaque redirection de lien court derrière la connexion Google. |
max_instance_count sans Redis | 3 | Moyen | De nombreuses instances sans Redis perdent la mise en cache/verrouillage partagé ; activez enable_redis avant de mettre à l'échelle. |
min_instance_count | 0 (par défaut) ou 1 | Moyen | 0 est presque gratuit mais ajoute un démarrage à froid d'environ 5 à 15 s à la première redirection après l'inactivité. |
GEOLITE_LICENSE_KEY | définir si l'analyse est importante | Faible | Sans cela, les visites sont enregistrées mais non géolocalisées. |
enable_nfs / create_cloud_storage | false / off | Faible | Coû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.
Guides associés
- Lab pratique : Shlink sur Cloud Run — déployez-le étape par étape, avec les écrans de la console et les commandes à chaque étape.
- Shlink sur GKE Autopilot — la même application sur Kubernetes, lorsque vous avez besoin de l'autre cible de déploiement.
- Shlink Common — Configuration d'application partagée — la configuration partagée par les deux cibles de déploiement.
- Déployé aux côtés de Mautic sur Google Cloud Run, Listmonk sur Google Cloud Run, Matomo sur Google Cloud Run, Mixpost sur Google Cloud Run dans la solution Marketing Automation Suite.
Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.