ThingWorx Docker 빌드 설정
ThingWorx Docker 이미지를 빌드하려면 다음 작업을 모두 수행하십시오.
• 필요한 바이너리가 준비되었고 빌드 프로세스에 사용할 수 있는지 확인합니다.
• 적절한 값을 사용하여 build.env 변수 파일을 수정합니다.
 |
이 항목에서는 릴리즈 버전을 <major-minor-maintenance>로 표시하는 데 <n-n-n>이 사용됩니다.
|
필요한 파일
ThingWorx Docker를 빌드하려면 다음 파일이 필요합니다. 이러한 파일을 얻는 방법에 대한 자세한 내용은 이 항목의 준비 파일 단원에 나와 있습니다. Apache Tomcat 및 Java와 현재 ThingWorx 버전의 호환성 정보는 Release Advisor를 참조하십시오.
• 모든 플랫폼 버전에 필요한 파일:
|
플랫폼
|
필수 파일
|
예제 파일
|
|---|---|---|
|
template-processor
|
변수를 제공하기 시작할 때 Docker 컨테이너에 있는 템플릿을 구문 분석하고 실행 중인 환경을 기반으로 구성 파일의 형식을 지정할 수 있도록 PTC에서 제공하는 도구입니다.
|
template-processor-12.0.0.9-application.tar.gz
|
|
tomcat
|
ThingWorx Platform을 실행하기 위해 Apache에서 가져온 Tomcat 아카이브 파일입니다.
|
tomcat-9.x.x.tar.gz
|
|
java
|
Amazon Web Services에서 가져온 OpenJDK - Amazon Corretto 파일 또는 Oracle에서 가져온 Java JDK 버전 11 아카이브 파일입니다.
|
• amazon-corretto-11.x.x-linux-x64.tar.gz
• jdk-11.x.x-linux-x64_bin.tar.gz
|
• 개별 플랫폼 버전의 필수 아카이브 파일:
|
|
PTC 지원 사이트에서 파일을 다운로드한 경우 다운로드한 파일의 이름이 MED-12345-CD-084_ThingWorx-Platform-H2-8-4-0.zip과 유사합니다. 스크립트는 Thingworx-Platform-type-version.zip을 가정합니다.
|
|
플랫폼
|
예제 파일
|
|---|---|
|
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
또한 이 버전에는 Microsoft에서 제공하는 SQL Server용 Microsoft JDBC Driver가 필요합니다.
sqljdbc_7.4.1.0_enu.tar.gz
|
|
ThingWorx Platform Azure SQL
|
Thingworx-Platform-Azuresql-<n-n-n>.zip
또한 이 버전에는 Microsoft에서 제공하는 SQL Server용 Microsoft JDBC Driver가 필요합니다.
sqljdbc_7.4.1.0_enu.tar.gz
|
build.env 변수
build.env 파일에는 설정해야 할 변수의 목록이 포함되어 있습니다. 다음 변수를 설정해야 합니다.
|
변수 이름
|
기본값
|
설명
|
|---|---|---|
|
BASE_IMAGE
1. ThingWorx 9.0~9.3
2. ThingWorx 9.4 이상
|
1. ubuntu:20.04
2. ubuntu:22.04
|
기본 이미지로 사용할 Ubuntu 버전을 지정합니다.
|
|
JAVA_VERSION
|
11.0.10.9.1
|
Amazon Corretto OpenJDK의 버전을 지정합니다.
|
|
JAVA_ARCHIVE
|
amazon-corretto-11.0.10.9.1-linux-x64.tar.gz
jdk-11.0.10_linux-x64.tar.gz
|
staging 폴더에 있는 Java 아카이브 파일의 이름을 지정합니다.
|
|
TOMCAT_VERSION
|
9.0.43
|
Apache Tomcat의 버전을 지정합니다.
|
|
TEMPLATE_PROCESSOR_VERSION
|
12.1.0.13
|
staging 폴더에 있는 템플릿-프로세서 아카이브 파일의 버전을 지정합니다.
|
|
PLATFORM_SETTINGS_FILE
|
platform-settings.json
|
기본 ThingWorx 설정 파일(staging 폴더에 포함됨)의 경로를 지정합니다.
|
|
BUILD_TEST_DBS
|
true
|
플랫폼 이미지와 함께 테스트용 데이터베이스 이미지를 빌드할지 여부를 결정합니다. 데이터베이스 이미지를 빌드하려면 true로 설정합니다.
|
|
PLATFORM_H2_VERSION
|
<n-n-n>
|
빌드할 ThingWorx H2 Platform의 버전을 지정합니다. H2 컨테이너를 빌드할 때만 필요합니다.
|
|
PLATFORM_H2_ARCHIVE
|
Thingworx-Platform-H2-<n-n-n>.zip
|
staging 폴더에 있는 ThingWorx H2 .zip 파일의 파일 이름을 지정합니다. H2 컨테이너를 빌드할 때만 필요합니다.
|
|
PLATFORM_POSTGRES_VERSION
|
<n-n-n>
|
빌드할 ThingWorx PostgreSQL Platform의 버전을 지정합니다. PostgreSQL 컨테이너를 빌드할 때만 필요합니다.
|
|
PLATFORM_POSTGRES_ARCHIVE
|
Thingworx-Platform-Postgres-<n-n-n>.zip
|
staging 폴더에 있는 ThingWorx PostgreSQL .zip 파일의 파일 이름을 지정합니다. PostgreSQL 컨테이너를 빌드할 때만 필요합니다.
|
|
PLATFORM_MSSQL_VERSION
|
<n-n-n>
|
빌드할 ThingWorx Microsoft SQL Server Platform의 버전을 지정합니다. Microsoft SQL Server 컨테이너를 빌드할 때만 필요합니다.
|
|
PLATFORM_MSSQL_ARCHIVE
|
Thingworx-Platform-Mssql-<n-n-n>.zip
|
staging 폴더에 있는 ThingWorx Microsoft SQL Server .zip 파일의 파일 이름을 지정합니다. Microsoft SQL Server 컨테이너를 빌드할 때만 필요합니다.
|
|
SQLDRIVER_VERSION
|
7.4.1.0
|
설치할 SQL Server용 Microsoft JDBC Driver의 버전을 지정합니다. Microsoft SQL Server 컨테이너를 빌드할 때만 필요합니다.
|
|
PLATFORM_AZURESQL_VERSION
|
<n-n-n>
|
빌드할 ThingWorx Azure SQL Platform의 버전을 지정합니다. Azure SQL 컨테이너를 빌드할 때만 필요합니다.
|
|
PLATFORM_AZURESQL_ARCHIVE
|
Thingworx-Platform-Azuresql-<n-n-n>.zip
|
staging 폴더에 있는 ThingWorx Azure SQL Server .zip 파일의 파일 이름을 지정합니다. Azure SQL 컨테이너를 빌드할 때만 필요합니다.
|
|
AZURESQL_SQLDRIVER_VERSION
|
7.4.1.0
|
설치할 Azure SQL용 Microsoft JDBC Driver의 버전을 지정합니다. Azure SQL 컨테이너를 빌드할 때만 필요합니다.
|
다음은 기본값이 staging 폴더에 있는 파일과 일치하지 않을 경우에만 설정해야 하는 변수입니다.
|
변수 이름
|
기본값
|
설명
|
|---|---|---|
|
TOMCAT_ARCHIVE
|
tomcat-${TOMCAT_VERSION}.tar.gz
|
staging 폴더에 있는 Tomcat 아카이브 파일의 이름을 지정합니다.
|
|
JAVA_ARCHIVE
|
${JAVA_VERSION}-linux-x64.tar.gz
|
staging 폴더에 있는 Java 아카이브 파일의 이름을 지정합니다.
|
|
SQLDRIVER_ARCHIVE
|
sqljdbc_${SQLDRIVER_VERSION}_enu.tar.gz
|
staging 폴더에 있는 SQL Server용 Microsoft JDBC Driver 아카이브 파일의 이름을 지정합니다. Microsoft SQL Server 컨테이너를 빌드할 때만 필요합니다.
|
|
AZURESQL_SQLDRIVER_ARCHIVE
|
sqljdbc_${AZURESQL_SQLDRIVER_VERSION}_enu.tar.gz
|
staging 폴더에 있는 Microsoft SQL JDBC 아카이브 파일의 이름을 지정합니다. Azure SQL 컨테이너를 빌드할 때만 필요합니다.
|
|
TEMPLATE_PROCESSOR_ARCHIVE
|
template-processor-${TEMPLATE_PROCESSOR_VERSION}-application.tar.gz
|
staging 폴더에 있는 template-processor 아카이브 파일의 이름을 지정합니다.
|
|
SECURITY_TOOL_ARCHIVE
|
security-common-cli-${SECURITY_TOOL_VERSION}-application.tar.gz
|
staging 폴더에 있는 보안 도구 아카이브 파일의 이름을 지정합니다.
|
준비 파일
Docker 이미지를 빌드하는 데 필요한 파일을 이 릴리즈의 일부인 staging 폴더에 배치해야 합니다. staging 폴더에 기본 platform-settings.json 파일이 이미 포함되어 있어야 합니다.
준비 작업을 지원하기 위해 Apache Tomcat과 SQL Server용 Microsoft JDBC Driver의 구성된 버전(기본 버전)이 자동으로 다운로드될 수 있습니다.
자동으로 다운로드하려면 다음을 수행하십시오.
1. build.env 파일 변수를 적절히 설정했는지 확인합니다.
2. 다음 명령을 실행합니다. ./build.sh stage.
오류가 발생하지 않은 경우 파일이 staging 폴더에 있고 build.env 설정과 일치합니다.
다음과 같은 방법으로 다른 필요한 파일을 구할 수 있습니다.
• Java
다음 위치에서 지원되는 Java 11 버전을 다운로드합니다.
◦ Amazon Corretto 11용 다운로드: Linux x64 tar.gz 파일(예: amazon-corretto-11.x.x-linux-x64.tar.gz)을 다운로드합니다.
◦ Java SE Development Kit 11 다운로드: Linux x64 Compressed Archive tar.gz 파일(예: jdk-11.x.x-linux-x64_bin.tar.gz)을 다운로드합니다.
원하는 위치에서 다운로드한 후 이 파일을 staging 폴더에 저장하고 build.env 파일의 JAVA_VERSION 및 JAVA_ARCHIVE 변수가 올바른지 확인합니다.
• ThingWorx Platform 아카이브 파일
PTC 소프트웨어 다운로드 사이트의 동일한 ThingWorx Platform 부분에서 이 Dockerfile 릴리즈가 포함된 ThingWorx Platform 아카이브 파일을 다운로드합니다. 차이가 있을 수 있으므로 Dockerfile 집합에 대한 버전과 동일한 ThingWorx 버전을 사용해야 합니다. 예제 파일: Thingworx-Platform-H2-<n-n-n>.zip
이 파일을 staging 폴더에 저장하고 build.env 파일의 PLATFORM_TYPE_VERSION 및 PLATFORM_TYPE_ARCHIVE 변수가 올바른지 확인합니다.
• 템플릿 프로세서 아카이브 파일
template-processor 도구는 기본적으로 staging 폴더에 포함되어 있으며 Docker 빌드에 자동으로 포함되어야 합니다. TEMPLATE_PROCESSOR_VERSION 및 TEMPLATE_PROCESSOR_ARCHIVE build.env 파일 설정이 올바른지 확인합니다.
• 보안 도구 아카이브
security-tool 프로그램은 staging 폴더에 포함되어 있으며 Docker 빌드에 자동으로 포함되어야 합니다. staging의 버전 및 아카이브 파일 이름이 build.env 설정과 일치하는지 확인합니다.
• Tomcat 아카이브 파일
Tomcat 9 소프트웨어 다운로드 사이트에서 Apache의 Tomcat을 다운로드합니다. Core 버전을 다운로드하도록 선택하고 tar.gz를 선택합니다. 예제 파일: tomcat-9.0.35.tar.gz
이 파일을 staging 폴더에 저장하고 build.env 파일의 TOMCAT_VERSION 및 TOMCAT_ARCHIVE 변수가 올바른지 확인합니다. build.env에서 변경하지 않은 경우 기본 예상 이름은 tomcat-version.tar.gz입니다.
• SQL Server용 Microsoft JDBC Driver
Java 및 JDBC 사양 지원에서 Microsoft의 Microsoft JDBC Driver를 다운로드합니다. Release Advisor에서 호환되는 JDBC 드라이버 버전을 확인했으면 표시된 버전에서 해당 버전을 다운로드합니다. For the driver in a tar.gz file:에 표시된 옵션에서 English (United States) 버전을 선택합니다(파일 구조는 대체 언어에 따라 다름). sqljdbc_<버전>_enu.tar.gz 파일이 다운로드됩니다.
이 파일을 staging 폴더에 저장하고 build.env 파일의 SQLDRIVER_VERSION 및 SQLDRIVER_ARCHIVE 변수가 올바른지 확인합니다.
• Azure SQL용 Microsoft JDBC Driver
Java 및 JDBC 사양 지원에서 Microsoft의 Microsoft JDBC Driver를 다운로드합니다. Release Advisor에서 호환되는 JDBC 드라이버 버전을 확인했으면 표시된 버전에서 해당 버전을 다운로드합니다. For the driver in a tar.gz file:에 표시된 옵션에서 English (United States) 버전을 선택합니다(파일 구조는 대체 언어에 따라 다름). sqljdbc_<버전>_enu.tar.gz 파일이 다운로드됩니다.
이 파일을 staging 폴더에 저장하고 build.env 파일의 AZURE_SQLDRIVER_VERSION 및 AZURE_SQLDRIVER_ARCHIVE 변수가 올바른지 확인합니다.