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 Facturation basée sur les instances afin que le processeur soit alloué en dehors du cycle de requêtes standard.
- 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
Le déploiement source Cloud Run est compatible avec plusieurs environnements d'exécution de langage, chacun disponible via des images de base de conteneur fournies par les buildpacks de Google Cloud. Vous pouvez également utiliser d'autres langages de programmation ou frameworks, à condition que le code source se trouve dans une image conforme à l'OCI.
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 en savoir plus, consultez la section Intégrer le code à un conteneur.
Concevoir des applications Cloud Run avec l'aide de Gemini
Vous pouvez obtenir l'aide de l'assistance par chat Gemini Cloud Assist optimisée par l'IA pour concevoir des applications de manière optimale. Avec Gemini Cloud Assist, vous pouvez découvrir les configurations et les stratégies les plus adaptées pour déployer vos applications sur Cloud Run, ce qui vous garantit une utilisation efficace des ressources et un fonctionnement fluide.
Pour utiliser Gemini Cloud Assist depuis la console Google Cloud , procédez comme suit:
- Assurez-vous que Gemini Cloud Assist est configuré pour votre Google Cloud compte utilisateur et votre projet.
Configurez votre environnement de développement Cloud Run dans votre projet Google Cloud et assurez-vous de disposer des autorisations de déploiement appropriées.
Accédez à la page Cloud Run dans la Google Cloud console.
Dans la barre d'outils de la console, sélectionnez un projet Google Cloud . Utilisez un projet associé à un ID de projet que vous avez envoyé après avoir été autorisé à utiliser Gemini Cloud Assist.
Cliquez sur spark Ouvrir ou fermer le chat Gemini AI.
Le panneau Gemini s'ouvre.
Si nécessaire, cliquez sur Accepter si vous acceptez les conditions.
Si vous avez une question concernant une application spécifique, fournissez du contexte en accédant à la page qui affiche votre ressource avant de poser votre question. Lors de la génération d'une réponse, Gemini inclut des informations sur la page de la console et le projet actuels.
Saisissez une requête dans le panneau Gemini.
Le tableau suivant fournit des exemples d'invites pour utiliser Gemini Cloud Assist avec Cloud Run.
Requête Type de réponse "Je souhaite concevoir une application Node.js sur Cloud Run. Quelle est l'approche recommandée et que dois-je savoir ?" Résumé de la structuration de votre application Node.js et du processus de déploiement. "De quelle autorisation ai-je besoin pour déployer une application Cloud Run ?" Liste des autorisations et des rôles requis. "Je veux déployer une application Web à trois niveaux à l'aide de Cloud Run" Présentation générale des étapes de conception d'une application Web à trois niveaux. "Comment migrer mon application App Engine vers Cloud Run" Présentation générale des principales étapes à suivre pour préparer votre environnement de développement Cloud Run, ainsi que quelques différences clés entre les deux produits. Liens vers un exemple de tutoriel permettant de personnaliser la solution en fonction de vos besoins spécifiques. "Quelle est la commande gcloud CLI pour définir le paramètre d'instance minimale sur 2 pour mon service Cloud Run "example-service" ?" Commande gcloud CLI suggérée pour mettre à jour le paramètre d'instances minimales. "Comment mettre à jour mon compte de service pour mon service Cloud Run hello-world
?"Commande gcloud CLI suggérée pour mettre à jour le compte de service. "Montrez-moi un exemple de création d'une application d'IA générative sur Cloud Run avec LangChain" Étapes à suivre pour créer un exemple d'application à l'aide de Cloud Run avec LangChain. "Générer une configuration Terraform à l'aide de la ressource google_cloud_run_v2_service
pour un service Cloud Run qui définit le paramètre de facturation sur la facturation basée sur les instances"Configuration Terraform suggérée pour mettre à jour le paramètre de facturation.
Pour en savoir plus, consultez les ressources suivantes :
- Découvrez comment rédiger des requêtes plus efficaces.
- Découvrez comment utiliser le panneau Gemini Cloud Assist.
- Consultez Utiliser Gemini pour l'assistance et le développement d'IA.
- Découvrez comment Gemini pour Google Cloud utilise vos données.
É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.