Impostazione delle build del Docker di ThingWorx
Per creare le immagini Docker di ThingWorx, eseguire entrambe le operazioni descritte di seguito.
• Assicurarsi che i file binari necessari siano pronti e disponibili per il processo di creazione.
• Modificare il file delle variabili build.env con i valori appropriati.
 |
In questo argomento viene utilizzato <n-n-n> per indicare la versione della release come <major-minor-maintenance>.
|
File obbligatori
Per creare il Docker di ThingWorx, sono necessari i file indicati di seguito. I dettagli su come ottenere questi file sono disponibili nella sezione File di staging di questo argomento. Per informazioni sulla compatibilità di Apache Tomcat e Java con la versione di ThingWorx corrente, verificare in Release Advisor.
• File obbligatori per tutte le versioni di piattaforma:
|
Piattaforma
|
File obbligatorio
|
File di esempio
|
|---|---|---|
|
template-processor
|
Uno strumento fornito da PTC sia per analizzare i modelli all'interno del contenitore Docker quando inizia a fornire variabili, sia per formattare i file di configurazione in base all'ambiente in esecuzione.
|
template-processor-12.0.0.9-application.tar.gz
|
|
tomcat
|
Il file di archivio Tomcat fornito da Apache per eseguire ThingWorx Platform.
|
tomcat-9.x.x.tar.gz
|
|
java
|
Il file OpenJDK - Amazon Corretto ottenuto da Amazon Web Services o il file di archivio Java JDK versione 11 ottenuto da Oracle.
|
• amazon-corretto-11.x.x-linux-x64.tar.gz
• jdk-11.x.x-linux-x64_bin.tar.gz
|
• I file di archivio obbligatori per le singole versioni di piattaforma:
|
|
Se si scarica un file dal sito Supporto PTC, il file scaricato viene denominato con un nome simile a MED-12345-CD-084_ThingWorx-Platform-H2-8-4-0.zip. Gli script presuppongono che il nome sia Thingworx-Platform-tipo-versione.zip.
|
|
Piattaforma
|
File di esempio
|
|---|---|
|
ThingWorx Platform H2
|
Thingworx-Platform-H2-<n-n-n>.zip
|
|
ThingWorx Platform PostgreSQL
|
Thingworx-Platform-Postgres-<n-n-n>.zip
|
|
ThingWorx Platform Microsoft SQL Server
|
Thingworx-Platform-Mssql-<n-n-n>.zip
Questa versione richiede anche Microsoft JDBC Driver per SQL Server di Microsoft.
sqljdbc_7.4.1.0_enu.tar.gz
|
|
ThingWorx Platform Azure SQL
|
Thingworx-Platform-Azuresql-<n-n-n>.zip
Questa versione richiede anche Microsoft JDBC Driver per SQL Server di Microsoft.
sqljdbc_7.4.1.0_enu.tar.gz
|
Variabili del file build.env
Il file build.env contiene un elenco di variabili da impostare. È necessario impostare le variabili seguenti:
|
Nome variabile
|
Default
|
Commento
|
|---|---|---|
|
BASE_IMAGE
1. ThingWorx 9.0 - 9.3
2. ThingWorx 9.4 e versioni successive
|
1. ubuntu:20.04
2. ubuntu:22.04
|
Specifica la versione di Ubuntu da utilizzare come immagine di base.
|
|
JAVA_VERSION
|
11.0.10.9.1
|
Specifica la versione dell'OpenJDK Amazon Corretto.
|
|
JAVA_ARCHIVE
|
amazon-corretto-11.0.10.9.1-linux-x64.tar.gz
jdk-11.0.10_linux-x64.tar.gz
|
Specifica il nome del file di archivio Java nella cartella staging.
|
|
TOMCAT_VERSION
|
9.0.43
|
Specifica la versione di Apache Tomcat.
|
|
TEMPLATE_PROCESSOR_VERSION
|
12.1.0.13
|
Specifica la versione del file di archivio template-processor nella cartella staging.
|
|
PLATFORM_SETTINGS_FILE
|
platform-settings.json
|
Specifica il percorso di un file di impostazioni di ThingWorx di base (incluso nella cartella staging).
|
|
BUILD_TEST_DBS
|
true
|
Determina se creare immagini di database per il test, accanto alle immagini della piattaforma. Impostare questa variabile su true per creare le immagini del database.
|
|
PLATFORM_H2_VERSION
|
<n-n-n>
|
Specifica la versione della piattaforma ThingWorx H2 da creare. È obbligatoria solo quando si creano contenitori H2.
|
|
PLATFORM_H2_ARCHIVE
|
Thingworx-Platform-H2-<n-n-n>.zip
|
Specifica il nome del file .zip di ThingWorx H2 nella cartella staging. È obbligatoria solo quando si creano contenitori H2.
|
|
PLATFORM_POSTGRES_VERSION
|
<n-n-n>
|
Specifica la versione della piattaforma ThingWorx PostgreSQL da creare. È obbligatoria solo quando si creano contenitori PostgreSQL.
|
|
PLATFORM_POSTGRES_ARCHIVE
|
Thingworx-Platform-Postgres-<n-n-n>.zip
|
Specifica il nome del file .zip di ThingWorx PostgreSQL nella cartella staging. È obbligatoria solo quando si creano contenitori PostgreSQL.
|
|
PLATFORM_MSSQL_VERSION
|
<n-n-n>
|
Specifica la versione della piattaforma ThingWorx Microsoft SQL Server da creare. È obbligatoria solo quando si creano contenitori Microsoft SQL Server.
|
|
PLATFORM_MSSQL_ARCHIVE
|
Thingworx-Platform-Mssql-<n-n-n>.zip
|
Specifica il nome del file .zip di ThingWorx Microsoft SQL Server nella cartella staging. È obbligatoria solo quando si creano contenitori Microsoft SQL Server.
|
|
SQLDRIVER_VERSION
|
7.4.1.0
|
Specifica la versione da installare di Microsoft JDBC Driver per SQL Server. È obbligatoria solo quando si creano contenitori Microsoft SQL Server.
|
|
PLATFORM_AZURESQL_VERSION
|
<n-n-n>
|
Specifica la versione della piattaforma ThingWorx Azure SQL da creare. È obbligatoria solo quando si creano contenitori Azure SQL.
|
|
PLATFORM_AZURESQL_ARCHIVE
|
Thingworx-Platform-Azuresql-<n-n-n>.zip
|
Specifica il nome del file .zip di ThingWorx Azure SQL Server nella cartella staging. È obbligatoria solo quando si creano contenitori Azure SQL.
|
|
AZURESQL_SQLDRIVER_VERSION
|
7.4.1.0
|
Specifica la versione da installare di Microsoft JDBC Driver per Azure SQL. È obbligatoria solo quando si creano contenitori Azure SQL.
|
È necessario impostare le variabili seguenti solo se i valori di default non corrispondono ai file nella cartella staging:
|
Nome variabile
|
Default
|
Commento
|
|---|---|---|
|
TOMCAT_ARCHIVE
|
tomcat-${TOMCAT_VERSION}.tar.gz
|
Specifica il nome del file di archivio Tomcat nella cartella staging.
|
|
JAVA_ARCHIVE
|
${JAVA_VERSION}-linux-x64.tar.gz
|
Specifica il nome del file di archivio Java nella cartella staging.
|
|
SQLDRIVER_ARCHIVE
|
sqljdbc_${SQLDRIVER_VERSION}_enu.tar.gz
|
Specifica il nome del file di archivio di Microsoft JDBC Driver per SQL Server nella cartella staging. È obbligatoria solo quando si creano contenitori Microsoft SQL Server.
|
|
AZURESQL_SQLDRIVER_ARCHIVE
|
sqljdbc_${AZURESQL_SQLDRIVER_VERSION}_enu.tar.gz
|
Specifica il nome del file di archivio JDBC Microsoft SQL nella cartella staging. È obbligatoria solo quando si creano contenitori Azure SQL.
|
|
TEMPLATE_PROCESSOR_ARCHIVE
|
template-processor-${TEMPLATE_PROCESSOR_VERSION}-application.tar.gz
|
Specifica il nome del file di archivio template-processor nella cartella staging.
|
|
SECURITY_TOOL_ARCHIVE
|
security-common-cli-${SECURITY_TOOL_VERSION}-application.tar.gz
|
Specifica il nome del file di archivio dello strumento di gestione della protezione nella cartella staging.
|
File di staging
È necessario salvare i file obbligatori per la creazione delle immagini Docker nella cartella staging che fa parte di questa release. La cartella staging dovrebbe già contenere un file platform-settings.json di base.
Per facilitare lo staging, è possibile scaricare automaticamente Apache Tomcat e la versione configurata di Microsoft JDBC Driver per SQL Server (versione di default).
Per eseguire il download automatico:
1. Assicurarsi di avere impostato le variabili del file build.env nel modo appropriato.
2. Eseguire il comando ./build.sh stage.
In assenza di errori, i file dovrebbero trovarsi nella cartella staging e corrispondere alle impostazioni del file build.env.
È possibile ottenere gli altri file obbligatori nei modi seguenti:
• Java
Scaricare una versione supportata di Java 11 da una delle posizioni seguenti:
◦ Download di Amazon Corretto 11: eseguire il download del file Linux x64 tar.gz (ad esempio: amazon-corretto-11.x.x-linux-x64.tar.gz).
◦ Download di Java SE Development Kit 11: eseguire il download del file di archivio compresso Linux x64 tar.gz (ad esempio: jdk-11.x.x-linux-x64_bin.tar.gz).
Dopo il download dalla posizione desiderata, salvare il file nella cartella staging e verificare che le variabili JAVA_VERSION e JAVA_ARCHIVE nel file build.env siano corrette.
• File di archivio di ThingWorx Platform
Scaricare i file di archivio di ThingWorx Platform dalla stessa area ThingWorx Platform del sito PTC Software Download che contiene la release del Dockerfile. Assicurarsi di utilizzare la stessa versione ThingWorx dell'insieme di Dockerfile, in quanto potrebbero esservi differenze. File di esempio: Thingworx-Platform-H2-<n-n-n>.zip
Salvare il file nella cartella staging e verificare che le variabili PLATFORM_TYPE_VERSION e PLATFORM_TYPE_ARCHIVE nel file build.env siano corrette.
• File di archivio del Template Processor
Lo strumento template-processor è incluso nella cartella staging di default e dovrebbe essere automaticamente incluso nelle build del Docker. Assicurarsi che le impostazioni TEMPLATE_PROCESSOR_VERSION e TEMPLATE_PROCESSOR_ARCHIVE del file build.env siano corrette.
• Archivio strumento di gestione della protezione
Il programma security-tool è incluso nella cartella staging e dovrebbe essere automaticamente incluso nelle build del Docker. Assicurarsi che i nomi dei file di versione e di archiviazione nella cartella staging corrispondano alle impostazioni di build.env.
• File di archivio Tomcat
Scaricare Tomcat di Apache dal sito Tomcat 9 Software Downloads. Scegliere di scaricare la versione Core e selezionare tar.gz. File di esempio: tomcat-9.0.35.tar.gz
Salvare questo file nella cartella staging e verificare che le variabili TOMCAT_VERSION e TOMCAT_ARCHIVE nel file build.env siano corrette. Il nome di default previsto è tomcat-version.tar.gz a meno che non venga modificato all'interno di build.env.
• Microsoft JDBC Driver per SQL Server
Scaricare Microsoft JDBC Driver dalla pagina Microsoft Supporto per le specifiche Java e JDBC. Dopo aver determinato la versione di JDBC Driver compatibile in Release Advisor, scaricarla dall'elenco delle versioni disponibili. Dalle opzioni visualizzate per For the driver in a tar.gz file:, selezionare la versione English (United States), poiché la struttura del file differisce dalle lingue alternative. Il file sqljdbc_<versione>_enu.tar.gz viene scaricato.
Salvare questo file nella cartella staging e verificare che le variabili SQLDRIVER_VERSION e SQLDRIVER_ARCHIVE nel file build.env siano corrette.
• Microsoft JDBC Driver per Azure SQL
Scaricare Microsoft JDBC Driver dalla pagina Microsoft Supporto per le specifiche Java e JDBC. Dopo aver determinato la versione di JDBC Driver compatibile in Release Advisor, scaricarla dall'elenco delle versioni disponibili. Dalle opzioni visualizzate per For the driver in a tar.gz file:, selezionare la versione English (United States), poiché la struttura del file differisce dalle lingue alternative. Il file sqljdbc_<versione>_enu.tar.gz viene scaricato.
Salvare questo file nella cartella staging e verificare che le variabili AZURE_SQLDRIVER_VERSION e AZURE_SQLDRIVER_ARCHIVE nel file build.env siano corrette.