Configuration des builds ThingWorx Docker
Pour générer des images ThingWorx Docker, effectuez les deux opérations suivantes :
• Assurez-vous de mettre les binaires requis en staging et de les rendre disponibles pour le processus de compilation.
• Modifiez le fichier de variables build.env avec les valeurs appropriées.
 |
Dans cette rubrique, <n-n-n> est utilisé pour indiquer la version, <major-minor-maintenance>.
|
Fichiers requis
Les fichiers suivants sont requis pour générer des images ThingWorx Docker. Pour plus d'informations sur la procédure d'obtention de ces fichiers, consultez la section Mise en staging des fichiers de cette rubrique. Pour obtenir des informations sur la compatibilité d'Apache Tomcat et de Java avec la version actuelle de ThingWorx, consultez Release Advisor.
• Fichiers requis pour toutes les versions de plateforme :
|
Plateforme
|
Fichier requis
|
Exemple de fichier
|
|---|---|---|
|
template-processor
|
Outil fourni par PTC pour analyser les modèles dans le conteneur Docker lorsqu'il commence à fournir des variables et formater les fichiers de configuration en fonction de l'environnement d'exécution.
|
template-processor-12.0.0.9-application.tar.gz
|
|
tomcat
|
Fichier d'archive Tomcat obtenu auprès d'Apache pour exécuter ThingWorx Platform.
|
tomcat-9.x.x.tar.gz
|
|
java
|
Fichier OpenJDK - Amazon Corretto obtenu auprès d'Amazon Web Services ou fichier d'archive Java JDK version 11 obtenu auprès d'Oracle.
|
• amazon-corretto-11.x.x-linux-x64.tar.gz
• jdk-11.x.x-linux-x64_bin.tar.gz
|
• Fichiers d'archive requis en fonction de la version de plateforme :
|
|
Si vous téléchargez un fichier depuis le site de support PTC, le nom du fichier téléchargé sera de la forme MED-12345-CD-084_ThingWorx-Platform-Postgres-8-4-0.zip. Les scripts attendent un nom du type Thingworx-Platform-type-version.zip.
|
|
Plateforme
|
Exemple de fichier
|
|---|---|
|
ThingWorx Platform PostgreSQL
|
Thingworx-Platform-Postgres-<n-n-n>.zip
|
|
ThingWorx Platform Microsoft SQL Server
|
Thingworx-Platform-Mssql-<n-n-n>.zip
Cette version requiert également le pilote Microsoft JDBC pour SQL Server de Microsoft.
sqljdbc_7.4.1.0_enu.tar.gz
|
|
ThingWorx Platform Azure SQL
|
Thingworx-Platform-Azuresql-<n-n-n>.zip
Cette version requiert également le pilote Microsoft JDBC pour SQL Server de Microsoft.
sqljdbc_7.4.1.0_enu.tar.gz
|
Variables build.env
Le fichier build.env contient une liste de variables que vous devez définir. Les variables à définir sont les suivantes :
|
Nom de variable
|
Par défaut
|
Commentaire
|
|---|---|---|
|
BASE_IMAGE
1. ThingWorx 9.0 à 9.3
2. ThingWorx 9.4 et versions ultérieures
|
1. ubuntu:20.04
2. ubuntu:22.04
|
Spécifie la version d'Ubuntu à utiliser comme image de base.
|
|
JAVA_VERSION
|
11.0.10.9.1
|
Spécifie la version d'Amazon Corretto OpenJDK.
|
|
JAVA_ARCHIVE
|
amazon-corretto-11.0.10.9.1-linux-x64.tar.gz
jdk-11.0.10_linux-x64.tar.gz
|
Spécifie le nom du fichier d'archive Java dans le dossier staging.
|
|
TOMCAT_VERSION
|
9.0.43
|
Spécifie la version d'Apache Tomcat.
|
|
TEMPLATE_PROCESSOR_VERSION
|
12.1.0.13
|
Spécifie la version du fichier d'archive template-processor dans le dossier staging.
|
|
PLATFORM_SETTINGS_FILE
|
platform-settings.json
|
Spécifie le chemin d'accès à un fichier de paramètres ThingWorx de base (inclus dans le dossier staging).
|
|
BUILD_TEST_DBS
|
vrai
|
Détermine s'il convient de générer des images de base de données pour le test, parallèlement aux images de la plateforme. Définissez cette variable sur true pour générer des images de la base de données.
|
|
PLATFORM_POSTGRES_VERSION
|
<n-n-n>
|
Spécifie la version de la plateforme ThingWorx PostgreSQL à générer. Obligatoire uniquement pour la génération de conteneurs PostgreSQL.
|
|
PLATFORM_POSTGRES_ARCHIVE
|
Thingworx-Platform-Postgres-<n-n-n>.zip
|
Spécifie le nom de fichier du fichier .zip ThingWorx PostgreSQL dans le dossier staging. Obligatoire uniquement pour la génération de conteneurs PostgreSQL.
|
|
PLATFORM_MSSQL_VERSION
|
<n-n-n>
|
Spécifie la version de la plateforme ThingWorx Microsoft SQL Server à générer. Obligatoire uniquement pour la génération de conteneurs Microsoft SQL Server.
|
|
PLATFORM_MSSQL_ARCHIVE
|
Thingworx-Platform-Mssql-<n-n-n>.zip
|
Spécifie le nom de fichier du fichier .zip ThingWorx Microsoft SQL Server dans le dossier staging. Obligatoire uniquement pour la génération de conteneurs Microsoft SQL Server.
|
|
SQLDRIVER_VERSION
|
7.4.1.0
|
Spécifie la version à installer du pilote Microsoft JDBC pour SQL Server. Obligatoire uniquement pour la génération de conteneurs Microsoft SQL Server.
|
|
PLATFORM_AZURESQL_VERSION
|
<n-n-n>
|
Spécifie la version de la plateforme ThingWorx Azure SQL à générer. Obligatoire uniquement pour la génération de conteneurs Azure SQL.
|
|
PLATFORM_AZURESQL_ARCHIVE
|
Thingworx-Platform-Azuresql-<n-n-n>.zip
|
Spécifie le nom de fichier du fichier .zip ThingWorx Azure SQL Server dans le dossier staging. Obligatoire uniquement pour la génération de conteneurs Azure SQL.
|
|
AZURESQL_SQLDRIVER_VERSION
|
7.4.1.0
|
Spécifie la version à installer du pilote Microsoft JDBC pour Azure SQL. Obligatoire uniquement pour la génération de conteneurs Azure SQL.
|
Les variables suivantes sont uniquement à définir si les valeurs par défaut ne correspondent pas aux fichiers du dossier staging :
|
Nom de variable
|
Par défaut
|
Commentaire
|
|---|---|---|
|
TOMCAT_ARCHIVE
|
tomcat-${TOMCAT_VERSION}.tar.gz
|
Spécifie le nom du fichier d'archive Tomcat dans le dossier staging.
|
|
JAVA_ARCHIVE
|
${JAVA_VERSION}-linux-x64.tar.gz
|
Spécifie le nom du fichier d'archive Java dans le dossier staging.
|
|
SQLDRIVER_ARCHIVE
|
sqljdbc_${SQLDRIVER_VERSION}_enu.tar.gz
|
Spécifie le nom du pilote Microsoft JDBC pour le fichier d'archive SQL Server d'archive dans le dossier staging. Obligatoire uniquement pour la génération de conteneurs Microsoft SQL Server.
|
|
AZURESQL_SQLDRIVER_ARCHIVE
|
sqljdbc_${AZURESQL_SQLDRIVER_VERSION}_enu.tar.gz
|
Spécifie le nom du fichier d'archive JDBC Microsoft SQL dans le dossier staging. Obligatoire uniquement pour la génération de conteneurs Azure SQL.
|
|
TEMPLATE_PROCESSOR_ARCHIVE
|
template-processor-${TEMPLATE_PROCESSOR_VERSION}-application.tar.gz
|
Spécifie le nom du fichier d'archive template-processor dans le dossier staging.
|
|
SECURITY_TOOL_ARCHIVE
|
security-common-cli-${SECURITY_TOOL_VERSION}-application.tar.gz
|
Spécifie le nom du fichier d'archive de l'outil de sécurité dans le dossier staging.
|
Mise en staging des fichiers
Vous devez placer les fichiers requis pour la génération des images Docker dans le dossier staging inclus dans cette version. Le dossier staging doit déjà contenir un fichier platform-settings.json de base.
Pour faciliter le staging, Apache Tomcat et la version configurée du pilote Microsoft JDBC pour SQL Server (version par défaut) peuvent être téléchargées automatiquement.
Pour effectuer le téléchargement automatique :
1. Assurez-vous que vous avez correctement défini les variables du fichier build.env.
2. Exécutez la commande ./build.sh stage.
S'il n'y a pas eu d'erreurs, les fichiers ont normalement été placés dans le dossier staging et ils doivent correspondre à vos paramètres build.env.
Vous pouvez récupérer les autres fichiers requis en procédant comme suit :
• Java
Téléchargez une version prise en charge de Java 11 depuis l'un des emplacements suivants :
◦ Téléchargements pour Amazon Corretto 11 : téléchargez le fichier Linux x64 tar.gz (par exemple : amazon-corretto-11.x.x-linux-x64.tar.gz).
◦ Téléchargements de Java SE Development Kit 11 : téléchargez le fichier Linux x64 Compressed Archive tar.gz (par exemple : jdk-11.x.x-linux-x64_bin.tar.gz).
Une fois le téléchargement effectué depuis l'emplacement voulu, enregistrez le fichier dans le dossier staging et assurez-vous que les variables JAVA_VERSION et JAVA_ARCHIVE du fichier build.env sont correctes.
• Fichiers d'archive ThingWorx Platform
Téléchargez les fichiers d'archive ThingWorx Platform depuis la même section ThingWorx Platform du site des téléchargements de logiciels de PTC que celle contenant cette version des Dockerfiles. Assurez-vous d'utiliser la même version de ThingWorx que pour le jeu de Dockerfiles, car il peut y avoir des différences. Exemple de fichier : Thingworx-Platform-Postgres-<n-n-n>.zip
Enregistrez ce fichier dans le dossier staging et assurez-vous que les variables PLATFORM_TYPE_VERSION et PLATFORM_TYPE_ARCHIVE du fichier build.env sont correctes.
• Fichier d'archive du processeur de modèles
L'outil template-processor est inclus par défaut dans le dossier staging et il est normalement automatiquement intégré dans les builds Docker. Assurez-vous que les paramètres TEMPLATE_PROCESSOR_VERSION et TEMPLATE_PROCESSOR_ARCHIVE du fichier build.env sont corrects.
• Archive de l'outil de sécurité
Le programme security-tool est inclus dans le dossier staging et il est normalement automatiquement intégré dans les builds Docker. Assurez-vous que les noms de version et de fichier d'archive dans le dossier staging correspondent à vos paramètres build.env.
• Fichier d'archive Tomcat
Téléchargez Apache Tomcat sur le site des téléchargements de logiciels Tomcat 9. Choisissez de télécharger la version Core et sélectionnez tar.gz. Exemple de fichier : tomcat-9.0.35.tar.gz
Enregistrez ce fichier dans le dossier staging et assurez-vous que les variables TOMCAT_VERSION et TOMCAT_ARCHIVE du fichier build.env sont correctes. Notez que le nom par défaut attendu est tomcat-version.tar.gz, sauf modification dans build.env.
• Pilote Microsoft JDBC pour SQL Server
Téléchargez le pilote Microsoft JDBC depuis la page Microsoft consacrée à la prise en charge de Java et de la spécification JDBC. Après avoir déterminé la version compatible du pilote JDBC dans Release Advisor, sélectionnez-la dans la liste des versions affichées pour la télécharger. Dans les options proposées pour For the driver in a tar.gz file :, sélectionnez la version English (United States) (car la structure de fichier diffère avec les autres langues). Le fichier sqljdbc_<version>_enu.tar.gz est téléchargé.
Enregistrez ce fichier dans le dossier staging et assurez-vous que les variables SQLDRIVER_VERSION et SQLDRIVER_ARCHIVE du fichier build.env sont correctes.
• Pilote Microsoft JDBC pour Azure SQL
Téléchargez le pilote Microsoft JDBC depuis la page Microsoft consacrée à la prise en charge de Java et de la spécification JDBC. Après avoir déterminé la version compatible du pilote JDBC dans Release Advisor, sélectionnez-la dans la liste des versions affichées pour la télécharger. Dans les options proposées pour For the driver in a tar.gz file :, sélectionnez la version English (United States) (car la structure de fichier diffère avec les autres langues). Le fichier sqljdbc_<version>_enu.tar.gz est téléchargé.
Enregistrez ce fichier dans le dossier staging et assurez-vous que les variables AZURE_SQLDRIVER_VERSION et AZURE_SQLDRIVER_ARCHIVE du fichier build.env sont correctes.