Cette page décrit quelques éléments à connaître pour commencer à développer un service pour Cloud Run.
Exigences relatives au code
Lorsque vous développez un service, vous devez répondre aux exigences suivantes :
- Le service doit écouter les requêtes.
Vous pouvez configurer le port sur lequel sont envoyées les requêtes.
Dans les instances Cloud Run, la valeur de la variable d'environnement
PORT
correspond toujours au port auquel les requêtes sont envoyées. Votre code doit vérifier l'existence de cette variable d'environnementPORT
et, si elle est présente, écouter le port correspondant afin de maximiser la portabilité. - Le service doit être sans état. Il ne peut pas reposer sur un état local persistant.
- Si le service effectue des activités en arrière-plan qui sortent du cadre du traitement des requêtes, il doit utiliser le paramètre Processeur toujours alloué.
- Si votre service utilise un système de fichiers réseau, il doit utiliser l'environnement d'exécution de deuxième génération.
Vous trouverez plus de précisions sur ces contraintes dans le contrat d'exécution du conteneur.
Compatibilité avec les langages de programmation
Cloud Run vous permet d'écrire du code dans le langage de programmation de votre choix.
Les guides de démarrage rapide Créer et déployer fournissent des exemples dans de nombreux langages couramment utilisés.
Utiliser un serveur Web
Vous pouvez utiliser un serveur Web pour écouter le port requis, ainsi que pour traiter et acheminer les requêtes entrantes. Par exemple, les développeurs en Node.js peuvent utiliser Express.js, les développeurs en Python, Flask, les développeurs en Ruby, Sinatra, etc.
Intégrer le code à un conteneur
Pour plus d'informations, consultez la section Conteneuriser le code.
Étapes suivantes
- Une fois que vous avez votre code de service et votre fichier Dockerfile, vous devez créer une image de conteneur, puis continuer à effectuer des tests en local.
- Si vous migrez une application Web existante, consultez la page Migrer un service vers Cloud Run.
- Pour connaître les bonnes pratiques de conception, de mise en œuvre, de test et de déploiement d'un service Cloud Run, consultez les Conseils de développement.