Aller au contenu principal

PeerTube sur Google Cloud Run

PeerTube sur Google Cloud Run

PeerTube est une plateforme d'hébergement vidéo open source fédérée par ActivityPub — une alternative auto-hébergée à YouTube où des instances gérées indépendamment se suivent et fédèrent des vidéos, des commentaires et des chaînes entre elles (et le reste du Fediverse) de la même manière que Mastodon fédère les publications. Ce module déploie PeerTube sur Cloud Run v2 au-dessus du socle App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.

Ce guide se concentre sur les services cloud utilisés par PeerTube 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 du socle App_CloudRun plutôt que de les répéter ici.


Ce que coûte PeerTube sur RAD, et comment cela se compare​

Pour une seule instance, le module Cloud Run de PeerTube sur RAD coûte environ 99 US$ par mois sans licence par utilisateur. PeerTube est géré par des opérateurs indépendants plutôt que vendu comme un SaaS commercial unique ; un serveur autogéré est moins cher en espèces que RAD, mais vous gérez alors vous-même la croissance du stockage, les sauvegardes, les correctifs de sécurité et les mises à niveau. Les chiffres sont à jour au 8 octobre 2026 ; les sources sont listées à la fin de cette section.

Si vous n'en avez besoin qu'occasionnellement — pour préparer une certification, une démo, une activité saisonnière — un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires, de sorte que ces 99 US$ deviennent quelques dollars par mois. Voir Mettez-le en pause gratuitement, ci-dessous.

Ce que vous payez sur RAD​

Dans un projet Google Cloud que vous possédezDans un projet géré par RAD pour vous
Frais de module, une fois par déploiement110 crédits (11 US$ au prix de la recharge)99 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 de fonctionnement Google CloudFacturé par Google à votre propre compte de facturation (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 67 crédits par jour, soit environ 2 010 par mois (environ 201 US$ au prix de la recharge)
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 détenu en réserve

Votre premier déploiement réussi sur RAD est exempt de frais de module, quel que soit le montant des frais : 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. Dans un projet géré par RAD, la base de données, le serveur de fichiers et le réseau sont partagés par toutes les applications du projet, de sorte qu'une deuxième application n'ajoute pas de deuxième base de données.

Coût de fonctionnement par défaut dans votre propre projet (us-central1, prix catalogue Google) :

Ressource (valeur par défaut du module)Par mois
Cloud Run, 2x vCPU / 2 Gio (scaleToZero)28,37 US$
Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51,02 US$
Serveur de fichiers NFS/cache (petite VM)13,43 US$
Cloud NAT et réseau5 US$
Cloud Storage (modules complémentaires, sauvegardes)1 US$
Totalenviron 99 US$
  • Cloud SQL et Cloud Run coûtent le même prix en africa-south1 (Johannesburg) ; la VM coûte environ 10 % de plus.
  • La mise à l'échelle à zéro est la valeur par défaut. La ligne Cloud Run ci-dessus reflète déjà ce coût ; le paramètre min_instance_count = 1 maintient une instance active et augmente cette ligne, en échange de l'absence de démarrages à froid.
  • Évitez Filestore pour un petit déploiement. Le module utilise par défaut une petite VM NFS/cache. La plus petite instance de Filestore est de 1 Tio, ce qui coûte environ 164 US$ par mois à elle seule.

Comment cela se compare​

  • PeerTube est géré par des opérateurs indépendants plutôt que vendu comme un SaaS commercial unique, il n'y a donc pas de prix de fournisseur unique à citer ici ; cette comparaison se fait plutôt avec un serveur nu.
  • Un VPS nu dimensionné proche de l'empreinte de PeerTube — Hetzner CPX22 ou un Droplet DigitalOcean 2 vCPU/4 Go, tous deux à environ 24 US$/mois, ou un GCP Compute Engine e2-standard-2 (2 vCPU/8 Go) à environ 49 US$/mois — est moins cher en espèces que les chiffres RAD ci-dessus, et le stockage/l'exportation vidéo est facturé séparément dans tous les cas.
  • Le stockage d'objets de RAD basé sur Cloud Storage, les sauvegardes Cloud SQL et la file d'attente de jobs Redis sont gérés pour vous ; sur un VPS nu, la croissance du stockage, les sauvegardes et la file d'attente de transcodage sont votre propre travail.
  • Si PeerTube doit rester actif sans mise à l'échelle à zéro, ou fonctionner à côté d'autres charges de travail Kubernetes, consultez plutôt le guide GKE — environ 143 US$ par mois dans votre propre projet, ou 3 240 crédits (environ 259–324 US$) par mois dans un projet géré par RAD.

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

Si PeerTube s'exécute dans un projet géré par RAD pour vous, vous avez une deuxième 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, un environnement de démonstration, une activité saisonnière — que de faire fonctionner PeerTube en continu.

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, sera utilisable après sa restauration, de sorte que la restauration ne peut pas être considérée comme un moyen fiable 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.

  • 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. Google ne supprime pas le projet immédiatement : il le conserve, récupérable, pendant 30 jours. Comme la facturation est déjà déliée, rien n'est facturé pendant cette attente. Contrairement à la suppression d'un module, cela ne supprime pas Cloud SQL, aucune VM ou Cloud Run un par un — l'ensemble du projet, et tout ce qu'il contient, s'arrête simplement.
  • La restauration est une vérification, pas une reconstruction. Dans les 30 jours, 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.
  • Ainsi, un mois d'utilisation occasionnelle peut coûter quelques dollars, et non les 201 US$ par mois pour le maintenir en fonctionnement. Déployez PeerTube, utilisez-le un certain temps, supprimez le projet. Restaurez-le la prochaine fois que vous en avez besoin, confirmez avec Update, et supprimez-le à nouveau lorsque vous avez terminé. Vous ne payez que les frais de module une seule fois et le temps pendant lequel PeerTube a été réellement actif.
  • Ce que cela nécessite. Vous devez être propriétaire du projet (pas un projet que vous apportez et dont RAD ne gère que la facturation), et vous le restaurez vous-même dans les 30 jours — après cela, Google le supprime définitivement. La restauration est admise comme la création d'un nouveau projet : 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 et de démonstration). Google indique que la plupart des services sont de nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.
  • Une lacune réelle : le bucket de sauvegarde ne survit pas. Les sauvegardes de PeerTube sont écrites dans un bucket à l'intérieur du projet, et ce bucket n'est pas protégé par la suppression logicielle de Cloud Storage, 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 apporté des modifications à PeerTube que vous souhaitez conserver, copiez une sauvegarde (vers Google Drive ou un bucket en dehors du projet) avant de supprimer, comme pour le flux de travail de redéploiement ci-dessous. Pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.

Payez uniquement pendant que vous l'utilisez, l'autre méthode : supprimer et redéployer​

Cloud Run se met déjà à l'échelle à zéro entre les requêtes. L'option ci-dessus ne s'applique qu'à un projet géré par RAD ; dans votre propre projet, ou une fois la fenêtre de 30 jours passée, la façon d'arrêter de payer est de supprimer le déploiement et de le redéployer lorsque vous en avez besoin.

  • Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) : 110 crédits (11,00 US$), car RAD recrée le projet et les services partagés avant PeerTube. La suppression ne permet d'économiser de l'argent que si PeerTube devait rester inutilisé pendant environ 4 jours ou plus, à la fois dans votre propre projet (environ 3,29 US$ par jour) et dans un projet géré par RAD (67 crédits par jour).
  • La majeure partie du coût de fonctionnement est généralement la base de données et la VM de fichier/cache partagée. Elles ne s'arrêtent que si rien d'autre dans le projet ne les utilise, donc la suppression de PeerTube alors que quelque chose d'autre partage le projet n'économise que la partie calcul de PeerTube.
  • Conservez d'abord les données. Les sauvegardes sont écrites dans un bucket à l'intérieur du déploiement et sont supprimées avec celui-ci, donc copiez la dernière sauvegarde avant de supprimer si vous voulez la conserver.
  • RAD ne recrée pas un déploiement supprimé pour vous ; vous entrez à nouveau les paramètres lors du déploiement.

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 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 Google Cloud de l'API Cloud Billing Catalog ; radmodules.dev/pricing pour les frais propres à RAD et les estimations de crédits quotidiens ; Supprimer et restaurer des projets pour la fenêtre de pause/restauration et ce qu'elle dit sur les objets Cloud Storage sans suppression logicielle.


1. Vue d'ensemble​

PeerTube s'exécute en tant que conteneur Node.js personnalisé sur Cloud Run v2, construit à partir d'un Dockerfile superposé à l'image de base officielle chocobozzz/peertube afin qu'un ARG de build PEERTUBE_VERSION dédié puisse épingler une version réelle. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2Serveur Node.js sur le port 9000 ; 2 vCPU / 2 Gio par défaut (conservateur — augmenter pour un transcodage réel) ; cpu_always_allocated = true
Base de donnéesCloud SQL pour PostgreSQL 15Requis — extensions pg_trgm/unaccent pré-créées ; PeerTube migre son propre schéma
Cache et file d'attenteRedisObligatoire, non optionnel — la file d'attente de jobs BullMQ de PeerTube (transcodage, livraison de fédération, notifications) n'a pas de solution de repli en mémoire
Stockage d'objetsCloud StorageUn bucket public videos (compatible S3, identifiants HMAC) pour les fichiers vidéo/listes de lecture en streaming ; un bucket privé data (GCS FUSE) pour l'état local
SecretsSecret ManagerPEERTUBE_SECRET, PT_INITIAL_ROOT_PASSWORD auto-générés, paire de clés d'accès/secrètes S3 HMAC ; mot de passe de la base de données
IngressURL Cloud Run / Équilibrage de charge CloudURL par défaut run.app — publique requise pour la fédération ; équilibreur de charge HTTPS externe facultatif + domaine personnalisé

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

  • Redis est obligatoire. Le transcodage, la livraison de fédération et le pipeline de notifications de PeerTube passent tous par une file d'attente de jobs BullMQ en cours de traitement sans solution de repli en mémoire — contrairement à la plupart des modules de ce catalogue où Redis est un bouton de performance/mise à l'échelle facultatif. enable_redis = true est la valeur par défaut et ne doit jamais être désactivée.
  • cpu_always_allocated = true par défaut. Le traitement des jobs BullMQ n'est lié à aucune requête HTTP entrante unique — sous la facturation basée sur les requêtes, le CPU est limité à près de zéro entre les requêtes et un job de transcodage peut se bloquer ou ne jamais se terminer (même raisonnement que le modèle de travailleur en arrière-plan n8n/Kestra de ce catalogue).
  • Il s'agit d'une variante VOD/transcodage léger, pas d'un déploiement de transcodage de production. cpu_limit = "2000m" / memory_limit = "2Gi" sont des valeurs par défaut délibérément conservatrices pour une utilisation de démonstration/légère. La FAQ de PeerTube elle-même recommande jusqu'à 8 vCPU / 8 Gio lorsque le transcodage s'exécute colocalisé avec le serveur — augmenter substantiellement pour une charge réelle, ou préférer PeerTube_GKE.
  • Le streaming en direct RTMP ne fonctionne pas sur Cloud Run, point final. enable_live_streaming n'a aucun effet quelle que soit sa valeur — les services Cloud Run ne routent qu'un seul port de conteneur HTTP(S), et l'ingestion RTMP (ports 1935/1936) est un protocole TCP brut. Utilisez PeerTube_GKE pour le streaming en direct.
  • Le bucket videos est délibérément public. L'architecture propre de PeerTube exige que les navigateurs récupèrent les fichiers vidéo/listes de lecture en streaming directement depuis le stockage d'objets, et non via un proxy de l'application — le bucket remplace la valeur par défaut sécurisée de la Fondation public_access_prevention = "enforced" par "inherited" afin que l'autorisation requise allUsers:objectViewer puisse s'appliquer. Voir §3 pour l'explication complète.
  • host (le domaine de fédération ActivityPub) est immuable après la première utilisation réelle. Laissé vide par défaut afin que le point d'entrée le dérive de l'URL de service prédite de Cloud Run — fonctionne dès la première utilisation sur un nouveau déploiement. Définissez un domaine personnalisé réel avant l'utilisation en production.
  • Aucun job d'initialisation d'amorçage d'administrateur n'est nécessaire. PT_INITIAL_ROOT_PASSWORD est lu directement depuis process.env par installer.ts de PeerTube lors du premier démarrage lorsqu'aucun utilisateur n'existe encore — le compte root est créé automatiquement.
  • La connexion à la base de données utilise TCP avec chiffrement sans vérification, et non un socket Unix. Le mécanisme db_host_env_var_name de App_CloudRun alias toujours l'IP privée brute de Cloud SQL sous PEERTUBE_DB_HOSTNAME (pas le chemin de socket DB_HOST vers lequel il se résout autrement), donc PeerTube_CloudRun remplace PEERTUBE_DB_SSL=true par reject-unauthorized false — le même modèle déjà prouvé pour GTS_DB_TLS_MODE de GoToSocial.

2. Services Google Cloud et comment les explorer​

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

A. Cloud Run — le service PeerTube​

  • 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​

PeerTube stocke toutes les données de l'application (comptes, métadonnées vidéo, commentaires, suivis, listes de lecture) dans une instance gérée de Cloud SQL pour PostgreSQL 15. Le service se connecte via TCP chiffré à l'IP privée de l'instance (voir §3 pour savoir pourquoi il ne s'agit pas d'une connexion par socket Unix, contrairement à la plupart des applications Cloud Run de ce catalogue).

  • Console : SQL → sélectionnez l'instance pour les connexions, les sauvegardes, les indicateurs, les métriques.
  • CLI :
    gcloud sql instances list --project "$PROJECT" --filter="name~peertube"
    gcloud sql instances describe <instance-name> --project "$PROJECT"
    gcloud sql connect <instance-name> --user=<db-user> --database=<db-name> --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. Redis — la file d'attente de jobs BullMQ​

Redis soutient la file d'attente de jobs de transcodage, de livraison de fédération et de notification de PeerTube. Lorsque redis_host est laissé vide, l'IP de la VM du serveur NFS partagé est utilisée comme hôte Redis par défaut.

  • CLI :
    redis-cli -h <redis-host> ping
    # Confirm the remapped env vars in the running revision:
    gcloud run services describe <service-name> --region "$REGION" \
    --format='value(spec.template.spec.containers[0].env)' | grep -i redis

D. Cloud Storage — videos (public) et data (privé)​

Deux buckets GCS sont provisionnés :

  • videos — public (public_access_prevention = "inherited", allUsers:objectViewer), compatible CORS, accessible via le client natif S3 de PeerTube (AWS SDK) contre le point de terminaison XML d'interopérabilité S3 de GCS en utilisant des identifiants HMAC d'un compte de service dédié. Contient les cinq classes de stockage d'objets PeerTube (web-videos, streaming-playlists, original-video-files, user-exports, captions) sous des préfixes distincts.

  • data — privé, monté GCS FUSE à /data. Contient l'état local de PeerTube (non-stockage d'objets) : avatars, vignettes, aperçus, storyboards, torrents, plugins, logs et tmp/cache — toujours sur disque local/monté quelle que soit la configuration du stockage d'objets vidéo.

  • Console : Cloud Storage → Buckets.

  • CLI :

    gcloud storage buckets list --project "$PROJECT" --filter="name~peertube"
    gcloud storage ls gs://<videos-bucket>/
    gcloud storage buckets describe gs://<videos-bucket> --format='value(iamConfiguration.publicAccessPrevention)'

Voir App_CloudRun pour les options GCS Fuse et CMEK.

E. Secret Manager​

Le conteneur de PeerTube lit PEERTUBE_SECRET, PT_INITIAL_ROOT_PASSWORD (consultés uniquement au premier démarrage lorsqu'aucun utilisateur n'existe), la paire de clés d'accès/secrètes S3 HMAC, et — lorsque SMTP est configuré — un mot de passe SMTP, le tout sous forme de variables d'environnement basées sur des secrets. Le mot de passe de la base de données est géré séparément par la fondation.

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

Voir App_CloudRun pour les détails d'injection et de rotation, et PeerTube_Common §2 pour la liste complète des secrets.

F. Réseau et ingress​

Le service est accessible par son URL run.app par défaut (ingress_settings = "all", requis pour la fédération ActivityPub publique et la diffusion vidéo). Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN (utile pour la diffusion vidéo) et Cloud Armor peuvent être superposés.

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

G. 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, avec des vérifications de disponibilité et des stratégies d'alerte facultatives.

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

3. Comportement de l'application PeerTube​

  • Configuration de la base de données au premier déploiement. Le job db-init exécute scripts/peertube/db-init.sh en utilisant postgres:15-alpine. Il attend que Cloud SQL accepte les connexions, puis crée de manière idempotente le rôle et la base de données de l'application, accorde les privilèges et crée les extensions pg_trgm et unaccent en tant que superutilisateur postgres — le guide d'installation de PeerTube exige les deux mais ne les crée pas lui-même. Peut être réexécuté en toute sécurité (execute_on_apply = true, max_retries = 3).
  • Pas de job de migration séparé. PeerTube crée et migre son propre schéma Sequelize automatiquement à chaque démarrage du serveur.
  • Le compte administrateur s'initialise automatiquement — aucun déclencheur manuel n'est nécessaire. Contrairement à certaines applications ActivityPub de ce catalogue (GoToSocial nécessite un job CLI manuel), installer.ts de PeerTube lit PT_INITIAL_ROOT_PASSWORD directement depuis process.env (pas node-config, donc pas de préfixe PEERTUBE_) au premier démarrage lorsqu'aucun utilisateur n'existe encore, et crée automatiquement le compte administrateur root avec ce mot de passe. Récupérez-le :
    SECRET=$(gcloud secrets list --project "$PROJECT" --filter="name~root-password" --format="value(name)")
    gcloud secrets versions access latest --secret="$SECRET" --project "$PROJECT"
    Connectez-vous à $SERVICE_URL/login avec le nom d'utilisateur root.
  • Le domaine de fédération (host) est immuable après une utilisation réelle. PEERTUBE_WEBSERVER_HOSTNAME est intégré à chaque URI d'acteur/objet ActivityPub créé localement la première fois que le serveur démarre avec des données réelles. Lorsque host est laissé vide, docker-entrypoint.sh le dérive de l'URL CLOUDRUN_SERVICE_URL de Cloud Run au démarrage du conteneur — une valeur par défaut fédérée fonctionnelle ne nécessitant aucune décision de domaine avant le déploiement. Définissez un domaine personnalisé réel via host avant l'utilisation en production ; le modifier après l'existence de comptes/vidéos réels nécessite le script de maintenance update-host de PeerTube et ne corrige pas rétroactivement les URI déjà fédérés.
  • La surcharge d'accès public du bucket videos est essentielle, pas facultative. App_CloudRun/App_GKE définissent par défaut chaque bucket provisionné sur public_access_prevention = "enforced" sauf si explicitement remplacé. La propre documentation de PeerTube exige un bucket videos public avec CORS configuré (les navigateurs récupèrent les fichiers vidéo/listes de lecture en streaming directement depuis le stockage d'objets). Sans la surcharge, l'autorisation google_storage_bucket_iam_member du module pour allUsers:objectViewer échoue au moment de l'application avec Error 412: ... public access prevention is enforced. La sortie storage_buckets de PeerTube_Common définit public_access_prevention = "inherited" sur le bucket videos spécifiquement (pas le bucket data) pour corriger cela — confirmé en direct le 22/07/2026.
  • Sur un projet en libre-service géré par RAD, une surcharge de stratégie d'organisation au niveau du projet est appliquée en premier, puis attendue. Les projets gérés par RAD héritent d'une stratégie d'organisation de dossier appliquant constraints/storage.publicAccessPrevention, ce qui remplace le paramètre de niveau de bucket ci-dessus et réintroduit le même 412. Lorsque is_self_serve_project = true (injecté par le serveur — ne le définissez jamais manuellement ; c'est false pour un projet ordinaire que vous apportez, où tout ce mécanisme est une opération nulle), le module remplace cette contrainte au niveau du projet via le fournisseur guardrails-admin. La surcharge est liée à l'état propre de ce module, donc la destruction du déploiement ramène le projet à la posture par défaut du dossier. La surcharge a besoin d'environ 90 secondes pour se propager avant que l'octroi du bucket ne réussisse. Terraform signale l'écriture de la stratégie d'organisation comme terminée en 0s, mais l'application de GCP est en retard : l'étape d'application suivante a toujours rencontré le même 412, même après l'épuisement de la nouvelle tentative/du backoff IAM intégré du fournisseur (~30s, Too many conflicts). Un time_sleep.wait_for_org_policy_propagation de 90s se situe entre les deux, et l'octroi du bucket dépend de l'attente plutôt que de la surcharge directement — donc une application sur un projet en libre-service est ~90s plus lente par conception. Confirmé en direct le 06/08/2026.
  • Point délicat : la surcharge est limitée au projet, donc deux variantes de PeerTube dans un même projet entrent en collision. storage.publicAccessPrevention n'a pas de variante limitée au bucket une fois appliquée à un niveau supérieur. Si le même projet exécute à la fois PeerTube_CloudRun et PeerTube_GKE, l'état de chaque module gère indépendamment le même objet de stratégie au niveau du projet, et la destruction de l'un ou l'autre le supprime de l'autre. solutions.yaml ne sélectionne qu'une seule variante de PeerTube par solution, donc c'est rare en pratique et n'est pas résolu dans le module.
  • Les ACL de téléchargement sont intentionnellement laissées non définies. L'interopérabilité XML S3 de GCS sous l'accès uniforme au niveau du bucket ne respecte pas les ACL par objet définies via un client S3 (la même limitation que la propre documentation de PeerTube décrit pour Backblaze B2), donc object_storage.upload_acl.* est laissé non configuré et la lecture publique est accordée au niveau du bucket à la place.
  • Chemin de santé. La sonde de démarrage est TCP sur le port 9000 — les propres migrations DB/Redis de PeerTube et l'amorçage de l'administrateur au premier démarrage peuvent prendre plus de temps qu'une fenêtre de disponibilité HTTP typique ne le permet, et une sonde HTTP contre une API pas encore prête empêcherait la création de la révision. La sonde de vivacité utilise le point de terminaison public et non authentifié GET /api/v1/config.
  • Inspecter le job d'initialisation et la configuration en cours d'exécution :
    gcloud run jobs list --project "$PROJECT" --region "$REGION"
    gcloud run jobs executions list --job <db-init-job-name> --project "$PROJECT" --region "$REGION"
    gcloud run revisions describe <revision-name> --region "$REGION" \
    --format='value(spec.template.spec.containers[0].env)'

4. Variables de configuration​

Les variables sont regroupées exactement comme elles apparaissent sur la plateforme de déploiement (correspondant à la balise {{UIMeta group=N}} de chaque variable dans variables.tf). Seuls les paramètres spécifiques ou notables pour PeerTube 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[]E-mails auxquels sont accordés l'accès au projet et les alertes de surveillance.
resource_labels{}Étiquettes appliquées à toutes les ressources.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_namepeertubeNom de base des ressources. Ne pas modifier après le premier déploiement.
display_namePeerTubeNom lisible par l'homme affiché dans la console.
descriptionPeerTube - Federated (ActivityPub) Video Hosting PlatformDescription du service.
application_versionlatestSe résout en la balise Docker Hub production maintenue via l'ARG de build PEERTUBE_VERSION dédié — et non la balise générique APP_VERSION de la Fondation (qui gagnerait autrement la fusion et produirait une balise latest irrésoluble).
host""PEERTUBE_WEBSERVER_HOSTNAME — le domaine de fédération public. Immuable après la première utilisation réelle. Laissé vide, il le dérive de l'URL Cloud Run prédite.
admin_emailadmin@example.comE-mail attribué au compte administrateur root auto-créé.
enable_open_registrationfalseAutoriser les nouveaux utilisateurs à s'inscrire eux-mêmes.
enable_live_streamingfalseAucun effet sur cette variante Cloud Run — RTMP nécessite un port TCP brut que les services Cloud Run ne peuvent pas exposer. Utilisez PeerTube_GKE.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner uniquement l'infrastructure.
container_image_sourcecustomConstruit une image basée sur Dockerfile (base chocobozzz/peertube:${PEERTUBE_VERSION}) via Cloud Build.
cpu_limit2000mValeur par défaut conservatrice pour une utilisation démo/VOD. La FAQ de PeerTube recommande jusqu'à 8 vCPU pour une charge de transcodage réelle.
memory_limit2GiValeur par défaut conservatrice. La FAQ de PeerTube recommande jusqu'à 8 Gio pour une charge de transcodage réelle.
container_port9000Valeur par défaut native PEERTUBE_LISTEN_PORT de PeerTube.
cpu_always_allocatedtrueFacturation basée sur l'instance — la file d'attente de jobs BullMQ de PeerTube n'est liée à aucune requête HTTP entrante.
min_instance_count00 active la mise à l'échelle à zéro.
max_instance_count1Plafond de coût.
execution_environmentgen2Requis pour les montages GCS FUSE.
enable_cloudsql_volumetrueInjecte le montage du socket Cloud SQL Auth Proxy ; les propres variables d'environnement PEERTUBE_DB_* de PeerTube sont définies indépendamment via l'alias db_host_env_var_name (voir §3).
enable_image_mirroringtrueMettre en miroir l'image de base dans Artifact Registry.

Groupe 5 — Accès, réseau, SMTP​

VariableValeur par défautDescription
ingress_settingsallRequis — la fédération et la diffusion vidéo nécessitent toutes deux une accessibilité publique.
vpc_egress_settingPRIVATE_RANGES_ONLYAcheminer uniquement le trafic RFC 1918 via VPC.
enable_iapfalseExiger la connexion Google. Bloque la fédération — ne convient que pour une instance entièrement privée.
smtp_host""Nom d'hôte SMTP. Vide désactive l'e-mail ; une valeur non vide provisionne le secret du mot de passe SMTP.
smtp_port / smtp_user / smtp_password / smtp_secure_enabled / mail_from587 / "" / "" / false / ""Configuration SMTP standard, utilisée uniquement lorsque smtp_host est défini. mail_from prend par défaut la valeur noreply@<host> lorsqu'il est vide.

Groupe 6 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Variables d'environnement en texte clair fusionnées avec les valeurs par défaut de PeerTube_Common.
secret_environment_variables{}Références Secret Manager destinées à l'opérateur.
secret_propagation_delay30Secondes à attendre après la création du secret avant de continuer.
secret_rotation_period2592000sFréquence de notification de rotation de Secret Manager.

Groupe 7 — Sauvegarde et restauration​

Configuration standard de sauvegarde/restauration App_CloudRun — voir App_CloudRun.

Groupe 8 — CI/CD et autorisation binaire​

Intégration standard de Cloud Build / Cloud Deploy App_CloudRun — voir App_CloudRun.

Groupe 9 — Scripts SQL personnalisés​

Exécution standard de scripts SQL personnalisés App_CloudRun — voir App_CloudRun.

Groupe 10 — Équilibreur de charge, CDN et rétention d'images​

VariableValeur par défautDescription
enable_cloud_armorfalseProvisionner un équilibreur de charge HTTPS global + Cloud Armor WAF.
application_domains[]Noms de domaine personnalisés — doivent correspondre à host.
enable_cdnfalseActiver Cloud CDN sur le backend de l'équilibreur de charge HTTPS — utile pour la diffusion vidéo.

Groupe 11 — Stockage et système de fichiers​

VariableValeur par défautDescription
create_cloud_storagetrueCréer des buckets GCS — PeerTube_Common fournit les vrais buckets data/videos, remplaçant la valeur par défaut générique data de cette variable.
enable_nfstrue (ignoré)Codé en dur à false dans main.tf — PeerTube utilise GCS FUSE et le stockage d'objets au lieu de NFS.
enable_gcs_storage_volumetrueMonte le bucket data via FUSE à /data. Conserver true — l'état local de PeerTube y réside toujours quelle que soit la configuration du stockage d'objets vidéo.
gcs_volumes[]Montages de volumes GCS Fuse supplémentaires au-delà de data.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
database_typePOSTGRES_15PeerTube nécessite PostgreSQL.
db_namepeertubeLa base de données réellement créée et injectée en tant que PEERTUBE_DB_NAME. Immuable après le premier déploiement.
db_userpeertubeLe rôle réellement créé et injecté en tant que PEERTUBE_DB_USERNAME ; mot de passe auto-généré dans Secret Manager.
database_password_length32Longueur du mot de passe généré (16–64).
enable_postgres_extensionstrueInstalle postgres_extensions après le provisionnement.
postgres_extensions["pg_trgm", "unaccent"]Requis par le guide d'installation de PeerTube ; non créé par PeerTube lui-même.

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

VariableValeur par défautDescription
initialization_jobs[]Laisser vide pour utiliser le job db-init intégré fourni par PeerTube_Common.
cron_jobs[]Aucune tâche récurrente planifiée par la plateforme n'est définie pour PeerTube.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeTCP, port 9000Confirme que le port est lié ; les propres migrations DB/Redis de PeerTube et l'amorçage de l'administrateur se terminent avant que l'API HTTP ne soit réellement prête.
liveness_probeHTTP /api/v1/config, délai initial de 60sLe point de terminaison de configuration public et non authentifié.
uptime_check_config{ enabled=true, path="/" }Vérification de disponibilité Cloud Monitoring.

Groupe 21 — Redis​

VariableValeur par défautDescription
enable_redistrueObligatoire — ne jamais désactiver. PeerTube n'a pas de solution de repli en mémoire pour BullMQ.
redis_host""Laisser vide pour utiliser l'IP du serveur NFS par défaut.
redis_port6379Port Redis.
redis_auth""Mot de passe d'authentification Redis (sensible).

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).
enable_audit_loggingfalseJournaux d'audit Cloud détaillés.

5. Sorties​

Retournées après 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.
service_urlURL par défaut run.app du service.
service_locationRégion dans laquelle le service s'exécute.
load_balancer_ip / load_balancer_urlIP / URL du 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.
database_password_secretSecret Manager qui contient le mot de passe de la base de données.
database_host / database_portPoint de terminaison de la base de données (IP privée Cloud SQL sur Cloud Run) / port.
storage_bucketsBuckets Cloud Storage créés (data, videos).
network_nameNom du réseau VPC.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / uptime_check_namesÉtat de la surveillance, tests de disponibilité.
initialization_jobsNoms des jobs de configuration (db-init).
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_idIdentifiant du projet.
cicd_enabled / artifact_registry_repositoryÉtat CI/CD et dépôt Artifact Registry.
vpc_sc_enabled / audit_logging_enabledÉtat VPC-SC et journalisation d'audit.

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
host (PEERTUBE_WEBSERVER_HOSTNAME)Définissez votre vrai domaine avant la première utilisation réelleCritiqueIntégré à chaque URI d'acteur/objet ActivityPub au moment de la création ; le modifier après l'existence de comptes/vidéos réels interrompt la fédération pour tout ce qui a été créé avec l'ancienne valeur.
enable_redistrue (ne jamais désactiver)CritiquePeerTube n'a pas de solution de secours en mémoire pour BullMQ — le transcodage, la livraison de la fédération et les notifications cessent tous de fonctionner sans Redis.
videos bucket public_access_prevention"inherited" (défini par PeerTube_Common, ne pas remplacer par "enforced")CritiqueL'architecture de PeerTube exige que les navigateurs récupèrent les fichiers vidéo directement depuis le stockage d'objets ; "enforced" bloque l'octroi allUsers:objectViewer requis avec une erreur 412 au moment de l'apply.
enable_live_streamingLaissez false, ou déplacez vers PeerTube_GKEÉlevéN'a aucun effet sur Cloud Run quelle que soit la valeur — l'ingestion RTMP nécessite un port TCP brut que les services Cloud Run ne peuvent pas exposer. L'activer ici crée une fausse attente, pas une fonctionnalité opérationnelle.
PEERTUBE_DB_SSL / remplacement reject-unauthorizedLaissez tel quel (true / false, défini automatiquement)CritiqueL'alias db_host_env_var_name de Cloud Run est l'IP privée brute de Cloud SQL, qui nécessite un chiffrement ; la simple "désactivation" qui serait correcte sur GKE échoue ici avec "pas de chiffrement", et la vérification complète du certificat échoue contre le certificat de Cloud SQL (pas d'IP SAN).
cpu_limit / memory_limitAugmentez considérablement pour une charge de transcodage réelleÉlevéLes valeurs par défaut 2000m/2Gi sont délibérément conservatrices pour une utilisation de démonstration/VOD ; la FAQ de PeerTube recommande jusqu'à 8 vCPU/8 Gio pour un transcodage de production réel — des ressources sous-dimensionnées bloquent ou échouent les jobs de transcodage.
cpu_always_allocatedtrue (par défaut, ne pas désactiver)ÉlevéLe traitement BullMQ de PeerTube n'est lié à aucune requête HTTP entrante ; avec la facturation basée sur les requêtes, le CPU est limité à presque zéro entre les requêtes et les jobs en arrière-plan peuvent rester bloqués indéfiniment.
database_typePOSTGRES_15CritiquePeerTube nécessite PostgreSQL ; les extensions pg_trgm/unaccent et le schéma Sequelize sont spécifiques à Postgres.
startup_probeLaissez type = "TCP"ÉlevéLes migrations DB/Redis et le démarrage de l'administration de PeerTube prennent plus de temps qu'une fenêtre de disponibilité HTTP typique ne le permet ; une sonde HTTP contre une API pas encore prête peut empêcher la révision de devenir prête.
enable_open_registrationfalse pour la plupart des déploiementsMoyenLaisser l'inscription ouverte sur une instance publique permet à toute personne ayant l'URL de créer un compte et de télécharger du contenu vidéo.
enable_iapfalse pour une instance publiqueMoyenIAP bloque le trafic de fédération ActivityPub non authentifié et la visualisation publique de vidéos — ne convient que pour une instance entièrement privée/de test.
PT_INITIAL_ROOT_PASSWORD secretRécupérez et stockez en toute sécurité après le premier déploiementMoyenC'est la seule information d'identification pour le compte administrateur root ; elle n'est pas régénérée ou réappliquée après que le compte existe déjà.

Pour le comportement de base référencé partout — 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 à PeerTube est définie dans PeerTube_Common (source du module : modules/PeerTube_Common).

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