Dans les chaînes, une "bibliothèque partagée" est une bibliothèque externe ou une dépendance nécessaire au bon fonctionnement d'un connecteur. These shared libraries are maintained, updated, and distributed by Workiva directly (with a few exceptions, noted below). À l’heure actuelle, Java 21 est notre seule bibliothèque partagée, mais d’autres dépendances peuvent être ajoutées si nécessaire.
To disable shared libraries and substitute your own self-installed library, add a new configuration option to your GroundRunner.config file:
SHARED_LIBRARY_OVERRIDES=java-21=/path/to/java21/home,java-24=/path/to/java24/homeThe path provided in this override must be valid, and it must contain a folder named "bin" that contains the relevant executables. However, the path itself should not include the bin directory.
Exemple
Consider the folder structure of a sample Java installation: ~/.asdf/installs/java/corretto-21.0.6.10.1 ❯ tree -L 1
This structure will look like this:
. ├── ADDITIONAL_LICENSE_INFO ├── ASSEMBLY_EXCEPTION ├── LICENSE ├── README.md ├── bin ├── commitId.txt ├── conf ├── include ├── jmods ├── legal ├── lib ├── man ├── release └─── version.txtYou'll notice the bin folder in this file structure. This folder is not included in our provided path.
Instead, the override in the GroundRunner.config file looks like this on a Mac: SHARED_LIBRARY_OVERRIDES=java-21=/Users/username/.asdf/installs/java/corretto-21.0.6.10.1
On a Windows machine, it would look something like this: SHARED_LIBRARY_OVERRIDES=java-21=C:\Program Files\Java\jre-21
Note: Make sure your Windows install uses backslashes (\) in the provided path.
JRE installation
Un environnement d’exécution Java (JRE) n’est pas installé avec le GroundRunner lors de l’installation initiale du GroundRunner. Une fois l’installation terminée et le GroundRunner en marche, il téléchargera automatiquement un JRE si nécessaire pour exécuter les commandes qui dépendent de Java. Aucune installation ou intervention de l’administrateur n’est nécessaire, et le JRE récupéré n’affectera pas les installations JRE existantes si elles existent sur l’hôte.
Learn more about GroundRunner requirements.
Connecteurs exclus
The following connectors are not compatible with Workiva's shared libraries and must use the GroundRunner's system Java installation, as these connectors still use custom certificates that are read from the cacerts file.