CloudOps Orchestration Service:Configure an application in a specific programming language

Prérequis pour les applications

Les applications Java doivent répondre aux exigences suivantes :

• Le répertoire racine du dépôt de code doit contenir un fichier pom.xml.

• Générez l'application avec Maven ou Gradle.

• La version du JDK de l'application doit être prise en charge.

Notes de configuration

• Versions OpenJDK

  Les versions majeures 8, 11, 17, 21 et 22 d'OpenJDK sont prises en charge. Les CNB installent la dernière version mineure de la version majeure spécifiée.

  Remarque

  Spécifiez la version majeure d'OpenJDK pour votre application. Si vous omettez cette étape, les CNB installeront la version par défaut actuelle à support à long terme (LTS), qui évolue au fil du temps et peut entraîner des échecs de génération lors de sa mise à jour.

  Pour épingler une version, ajoutez le system.properties fichier de propriétés Java au répertoire racine de l'application. L'exemple suivant épingle l'application sur OpenJDK 21 :

  java.runtime.version=21

• Options Maven

  Utilisez la variable d'environnement MAVEN_OPTS pour appliquer les paramètres Maven. Ajoutez un fichier project.toml au répertoire racine pour définir cette variable.

  Les CNB prennent en charge Maven 3.9 par défaut. Si votre application requiert une version différente de Maven, utilisez plutôt le Maven Wrapper (mvnw). Les CNB détectent et utilisent le fichier mvnw présent dans la racine du projet.

  Exécutez la commande suivante pour configurer le Maven Wrapper :

  mvn wrapper:wrapper # Generate the .mvn directory, the mvnw, and the mvnw.cmd file.
  git add .mvn mvnw mvnw.cmd
  git commit -m "support maven wrapper"
  git push origin # Submit the branch to the code repository.

• Procfile

  Un fichier Procfile déclare le type de processus et la commande de démarrage d'une application. Pour plus d'informations sur la syntaxe du Procfile et les types de processus, consultez la section Présentation des fichiers Procfile de cette rubrique. Pour les applications Spring Boot, un fichier Procfile remplace le processus de démarrage par défaut. L'exemple suivant montre un fichier Procfile typique pour Spring Boot :

  web: java -Dserver.port=$PORT $JAVA_OPTS -jar target/demo-0.0.1-SNAPSHOT.jar

Exemples de projets

• GitHub : github-java-springboot-demo

• Gitee : gitee-java-springboot-demo

Pour plus d'informations, consultez buildpacks-jvm.

Prérequis pour les applications

Le répertoire racine du dépôt de code source doit contenir un fichier requirements.txt ou poetry.lock.

Notes de configuration

• Versions Python

  Les CNB installent la dernière version de Python (actuellement la 3.13) par défaut. Pour utiliser une version différente, ajoutez un fichier .python-version au répertoire racine et spécifiez la version cible :

  $ cat .python-version
  3.13

• Procfile

  Un fichier Procfile est un fichier texte brut situé dans le répertoire racine qui déclare le type de processus et la commande de démarrage. L'exemple suivant montre un Procfile pour une application Python utilisant Gunicorn :

  web: gunicorn --config gunicorn.conf.py gettingstarted.wsgi

  Remarque

  Un Procfile n'est pas obligatoire pour les applications simples, mais il est recommandé d'en ajouter un aux applications Python pour rendre la commande de démarrage explicite et éviter de s'appuyer sur la détection automatique. Pour plus d'informations, consultez la section Présentation des fichiers Procfile.

Exemples de projets

• GitHub : github-python-falcon-demo

• Gitee : gitee-python-falcon-demo

Pour plus d'informations, consultez buildpacks-python.

Prérequis pour les applications

Les applications Go doivent répondre aux exigences suivantes :

• Le répertoire racine du dépôt de code doit contenir un fichier go.mod. Le module name dans le fichier go.mod doit contenir au moins une barre oblique (/).

• Go 1.16 ou une version ultérieure est requis pour la compilation. Les modules Go doivent être utilisés pour la gestion des dépendances.

  Remarque

  Les CNB ne prennent en charge que les modules Go pour la gestion des dépendances. Les gestionnaires de dépendances tiers tels que dep, godep, govendor et glide ne sont pas pris en charge.

Notes de configuration

• Versions Go

  Les CNB lisent la version de Go à partir de la directive go dans le fichier go.mod. Un identifiant de version majeure tel que go 1.17 résout vers la dernière version de correctif disponible dans cette série au moment de la génération. Pour épingler une version de correctif spécifique, spécifiez la version complète (par exemple, go 1.17.13).

  L'entrée suivante sélectionne la dernière version Go 1.17.x disponible au moment de la génération :

  go 1.17

• Gestion des dépendances

  • Si le répertoire racine contient un fichier vendor/modules.txt, les CNB utilisent les modules Go du répertoire vendor au lieu de les télécharger.

  • Si aucun fichier vendor/modules.txt n'est présent, les CNB téléchargent les modules Go avant la compilation.

• Installation des packages

  Les CNB génèrent tous les packages main détectés dans le projet.

Exemples de projets

• GitHub : github-go-web-demo

• Gitee : gitee-go-web-demo

Pour plus d'informations, consultez buildpacks-go.

Prérequis pour les applications

Les applications Node.js doivent répondre aux exigences suivantes :

• Un fichier package.json valide doit être présent dans le répertoire racine pour que les CNB détectent l'application.

• Un fichier de verrouillage npm, yarn ou pnpm valide doit être présent pour installer les dépendances.

Notes de configuration

Versions Node.js

Définissez le champ engines.node dans le fichier package.json pour épingler la version de Node.js. Si aucune version n'est spécifiée, les CNB installent la dernière version LTS, qui évolue au fil du temps et peut entraîner un comportement de génération inattendu.

L'exemple suivant épingle l'application sur la dernière version Node.js 20.x :

{
  "engines": {
    "node": "20.x"
  }
}

Exemples de projets

• GitHub : github-nodejs-express-demo

• Gitee : gitee-nodejs-express-demo

Pour plus d'informations, consultez buildpacks-nodejs.

Prérequis pour les applications

Les applications PHP doivent répondre aux exigences suivantes :

• Les versions PHP 8.2, 8.3 et 8.4 sont prises en charge.

• Le répertoire racine du dépôt d'application doit contenir à la fois les fichiers composer.json et composer.lock.

Notes de configuration

PHP

Spécifiez la version d'exécution PHP dans le fichier composer.json. L'exemple suivant requiert PHP 8.2.0 ou une version ultérieure :

{
  "require": {
    "php": "^8.2.0"
  }
}

Exemples de projets

• GitHub : github-php-demo

• Gitee : gitee-php-demo

Pour plus d'informations, consultez buildpacks-php et php-support.

Prérequis pour les applications

Le répertoire racine du dépôt de code doit contenir des fichiers Gemfile et Gemfile.lock valides.

Notes de configuration

• Versions Ruby

  Spécifiez la version de Ruby dans le fichier Gemfile et mettez à jour le fichier Gemfile.lock en conséquence :

  1. Spécifiez la version de Ruby dans le fichier Gemfile :

     ruby "3.3.0"

  2. Mettez à jour le fichier Gemfile.lock :

     $ bundle update --ruby

  3. Vérifiez la version de Ruby dans le fichier Gemfile.lock :

     RUBY VERSION
        ruby 3.3.0p0

     Si aucune version de Ruby n'est trouvée dans le fichier Gemfile.lock, les Buildpacks installent la version Ruby par défaut. Spécifiez une version pour éviter les modifications inattendues lorsque la version par défaut est mise à jour.

• Versions Bundler

  Spécifiez la version de Bundler dans le fichier Gemfile.lock pour verrouiller Bundler sur une version stable connue. Exemple :

  BUNDLED WITH
     2.5.6

  Si aucune version de Bundler n'est trouvée dans le fichier Gemfile.lock, les Buildpacks installent la version Bundler par défaut. Spécifiez une version pour éviter les modifications inattendues lorsque la version par défaut est mise à jour.

Exemples de projets

• GitHub :

• Gitee :

Pour plus d'informations, consultez buildpacks-ruby et application-contract.md.