Configurer les services Cloud Run et les services des fonctions Cloud Run

Utilisez les variables d'environnement suivantes pour configurer le comportement de vos services lorsqu'ils sont déployés sur Cloud Run ou sur les fonctions Cloud Run.

Apprenez à définir ces variables d'environnement dans votre image de conteneur.

Pour en savoir plus sur la configuration dans un langage spécifique, consultez les sections suivantes :

Variables d'environnement des fonctions Cloud Run et de Cloud Run

Les configurations suivantes permettent de compiler des services à la fois pour les applications et les fonctions. Consultez également les variables d'environnement supplémentaires des fonctions Cloud Run ci-dessous.

GOOGLE_ENTRYPOINT

Spécifie la commande exécutée lors de l'exécution du conteneur. Cela équivaut à entrypoint dans un fichier Dockerfile.

  • Exemples :
    • Java : java -jar target/myjar.jar
    • PHP : php -S 0.0.0.0:8080 index.php
    • Python : gunicorn -p :8080 main:app

GOOGLE_RUNTIME

Force l'activation de l'environnement d'exécution. Si l'image du buildpack d'exécution apparaît dans plusieurs groupes, l'image du buildpack du premier groupe est utilisée dans tous les groupes.

Exemple Node.js: il est obligatoire de spécifier nodejs pour compiler l'environnement d'exécution Node.js.

GOOGLE_RUNTIME_VERSION

Spécifie la version de l'environnement d'exécution à installer. Pour .NET, spécifie la version du SDK .NET.

Exemples :

  • Go : 1.14.1
  • Java : 8
  • Node.js: 13.7.0
  • .NET : 3.1.301

GOOGLE_BUILDABLE

Pour les environnements d'exécution Go, Java, Dart et .NET: spécifie le chemin d'accès à une unité compilable.

Exemple Go: spécifier ./maindir crée le package en mode root à maindir.

GOOGLE_BUILD_ARGS

Pour les environnements d'exécution Java (Maven et Gradle) et .NET : ajoute des arguments à la commande de compilation.

Exemple Java : spécifier -Pprod exécute mvn clean package ... -Pprod.

GOOGLE_MAVEN_BUILD_ARGS

Pour les environnements d'exécution Java utilisant le plug-in Maven : remplace la commande Maven par défaut par la commande de compilation que vous spécifiez.

Lorsque GOOGLE_MAVEN_BUILD_ARGS n'est pas spécifié, la commande suivante est exécutée par défaut :

mvn clean package --batch-mode -DskipTests -Dhttp.keepAlive=false

Exemple : spécifier GOOGLE_MAVEN_BUILD_ARGS="clean package: exécute la commande mvn clean package.

GOOGLE_GRADLE_BUILD_ARGS

Pour les environnements d'exécution Java utilisant le plug-in Gradle : remplace la commande Gradle par défaut par la commande de compilation que vous spécifiez.

Lorsque GOOGLE_GRADLE_BUILD_ARGS n'est pas spécifié, la commande suivante est exécutée par défaut :

gradle clean assemble -x test --build-cache

Exemple : spécifier GOOGLE_GRADLE_BUILD_ARGS="clean assemble" exécute la commande gradle clean assemble.

GOOGLE_DEVMODE

Pour Skaffold : active les buildpacks en mode de développement. Utilisez le développement local en direct pour déclencher des recompilations automatiques de conteneurs afin de modifier votre code source. Vous devez installer Skaffold et exécuter skaffold dev.

  • Valeurs autorisées : true, True, 1

GOOGLE_CLEAR_SOURCE

Pour les fonctions et les applications Go ou Java : efface la source une fois l'application compilée. Si l'application dépend de fichiers statiques, tels que des modèles Go, la définition de cette variable peut entraîner un dysfonctionnement de l'application.

Valeurs acceptées : true, True ou 1

Variables d'environnement supplémentaires des fonctions Cloud Run

Les configurations suivantes ne sont disponibles que pour le code source compilé en tant que fonctions utilisant le framework des fonctions et les fonctions Cloud Run. Pour en savoir plus sur ces options de configuration, consultez la section contrat.

GOOGLE_FUNCTION_TARGET

  • Spécifie le nom de la fonction exportée à appeler en réponse aux requêtes.
  • Exemple : myFunction oblige le framework des fonctions à appeler la fonction du même nom.

GOOGLE_FUNCTION_SIGNATURE_TYPE

  • Spécifie la signature utilisée par la fonction.
  • Exemple : http, event ou cloudevent.

GOOGLE_FUNCTION_SOURCE

  • Spécifie le nom du répertoire ou du fichier contenant la source de la fonction, en fonction du langage.
  • (Applicable à certains langages uniquement, consultez la documentation spécifique à chaque langage.)
  • Exemple : function.py pour Python.