1.2. Jenkins variables d’environnement
Le serveur Jenkins peut être configuré avec les variables d’environnement suivantes:
La variable | Définition | Exemples de valeurs et de paramètres |
---|---|---|
| Détermine si le plugin OpenShift Dedicated Login gère l’authentification lors de la connexion à Jenkins. Activer, définir à true. | Défaut: false |
| Le mot de passe pour l’utilisateur admin lorsque vous utilisez l’authentification standard Jenkins. Il n’est pas applicable lorsque OPENSHIFT_ENABLE_OAUTH est défini sur true. | Défaut: mot de passe |
JAVA_MAX_HEAP_PARAM, CONTAINER_HEAP_PERCENT, JENKINS_MAX_HEAP_UPPER_BOUND_MB | Ces valeurs contrôlent la taille maximale du tas Jenkins JVM. Lorsque JAVA_MAX_HEAP_PARAM est défini, sa valeur prime. Dans le cas contraire, la taille maximale du tas est calculée dynamiquement comme CONTAINER_HEAP_PERCENT de la limite de mémoire du conteneur, éventuellement plafonnée à JENKINS_MAX_HEAP_UPPER_BOUND_MB MiB. La taille maximale du tas de Jenkins JVM est fixée à 50% de la limite de mémoire du conteneur sans capuche. | JAVA_MAX_HEAP_PARAM réglage de l’exemple: -Xmx512m CONTAINER_HEAP_PERCENT par défaut: 0,5, ou 50% JENKINS_MAX_HEAP_UPPER_BOUND_MB paramètres d’exemple: 512 MiB |
JAVA_INITIAL_HEAP_PARAM, CONTAINER_INITIAL_PERCENT | Ces valeurs contrôlent la taille initiale du tas Jenkins JVM. Lorsque JAVA_INITIAL_HEAP_PARAM est défini, sa valeur prime. Dans le cas contraire, la taille initiale du tas est calculée dynamiquement comme CONTAINER_INITIAL_PERCENT de la taille maximale du tas calculée dynamiquement. Le JVM définit par défaut la taille initiale du tas. | JAVA_INITIAL_HEAP_PARAM réglage de l’exemple: -Xms32m Configuration de l’exemple CONTAINER_INITIAL_PERCENT: 0,1, ou 10% |
| Lorsqu’il est défini, spécifie un nombre entier de cœurs utilisés pour la taille des nombres de threads JVM internes. | Exemple de réglage: 2 |
| Indique les options à appliquer à tous les JVM fonctionnant dans ce conteneur. Il n’est pas recommandé de remplacer cette valeur. | Défaut: -XX:+UnlockExperimentalVMOptions -XX:+UseCGroupMemoryLimitForHeap -Dsun.zip.disableMemoryMapping=true |
| Indique les paramètres de collecte des ordures Jenkins JVM. Il n’est pas recommandé de remplacer cette valeur. | Défaut: -XX:+UseParallelGC -XX:MinHeapFreeRatio=5 -XX:MaxHeapFreeRatio=10 -XX:GCTimeRatio=4 -XX:AdaptiveSizePolicyWeight=90 |
| Indique les options supplémentaires pour Jenkins JVM. Ces options sont ajoutées à toutes les autres options, y compris les options Java ci-dessus, et peuvent être utilisées pour remplacer l’une d’entre elles si nécessaire. Séparez chaque option supplémentaire avec un espace; si une option contient des caractères d’espace, échappez-les avec un backslash. | Exemples de paramètres: -Dfoo -Dbar; -Dfoo=first\ valeur -Dbar=second\ valeur. |
| Indique les arguments de Jenkins. | |
| Indique les plugins Jenkins supplémentaires à installer lorsque le conteneur est lancé pour la première fois ou lorsque OVERRIDE_PV_PLUGINS_WITH_IMAGE_PLUGINS est défini sur true. Les plugins sont spécifiés comme une liste délimitée par virgule de paires nom:version. | Exemple de réglage: git:3.7.0,subversion:2.10.2. |
| Indique l’intervalle en millisecondes que le plugin OpenShift Dedicated Login sondage OpenShift Dedicated pour les autorisations associées à chaque utilisateur défini dans Jenkins. | Défaut: 300000 - 5 minutes |
| Lors de l’exécution de cette image avec un OpenShift Dedicated volume persistant (PV) pour le répertoire de configuration Jenkins, le transfert de la configuration de l’image vers le PV n’est effectué que la première fois que l’image démarre parce que le PV est attribué lorsque la revendication de volume persistant (PVC) est créée. Lorsque vous créez une image personnalisée qui étend cette image et met à jour la configuration dans l’image personnalisée après le démarrage initial, la configuration n’est pas copiée à moins que vous n’ayez défini cette variable d’environnement sur true. | Défaut: false |
| Lors de l’exécution de cette image avec un PV dédié OpenShift pour le répertoire de configuration de Jenkins, le transfert de plugins de l’image vers le PV n’est effectué que la première fois que l’image démarre parce que le PV est assigné lorsque le PVC est créé. Lorsque vous créez une image personnalisée qui étend cette image et met à jour les plugins dans l’image personnalisée après le démarrage initial, les plugins ne sont pas copiés à moins que vous n’ayez défini cette variable d’environnement sur true. | Défaut: false |
| Lors de l’exécution de cette image avec un PVC dédié OpenShift pour le répertoire de configuration de Jenkins, cette variable d’environnement permet au fichier journal d’erreur fatal de persister lorsqu’une erreur fatale se produit. Le fichier d’erreur fatale est enregistré dans /var/lib/jenkins/logs. | Défaut: false |
| La définition de cette valeur remplace l’image utilisée pour le conteneur jnlp dans les modèles de pod de plugins Kubernetes fournis avec cette image. Dans le cas contraire, l’image de la balise de flux d’image jenkins-agent-base-rhel8:dernière dans l’espace de noms openshift est utilisée. | Défaut: image-registry.openshift-image-registry.svc:5000/openshift/jenkins-agent-base-rhel8:plus tard |
| La définition de cette valeur remplace l’image utilisée pour le conteneur java-builder dans l’échantillon de java-builder Kubernetes plugin pod modèles fournis avec cette image. Dans le cas contraire, l’image de la balise de flux d’image java:latest dans l’espace de noms openshift est utilisée. | Défaut: image-registry.openshift-image-registry.svc:5000/openshift/java:dernière |
| La définition de cette valeur contrôle le fonctionnement du JVM lors de l’exécution d’un nœud FIPS. Consultez Configurer Red Hat build of OpenJDK 11 en mode FIPS pour plus d’informations. | Défaut: -Dcom.redhat.fips=false |