ThingWorx Docker 빌드 설정
ThingWorx Docker 이미지를 빌드하려면 다음 작업을 모두 수행하십시오.
• 필요한 바이너리가 준비되었고 빌드 프로세스에 사용할 수 있는지 확인합니다.
• 적절한 값을 사용하여 build.env 변수 파일을 수정합니다.
필요한 파일
ThingWorx Docker를 빌드하려면 다음 파일이 필요합니다.
• 모든 플랫폼 버전에 필요한 파일:
|
플랫폼
|
필수 파일
|
예제 파일
|
|---|---|---|
|
template-processor
|
변수를 제공하기 시작할 때 Docker 컨테이너에 있는 템플릿을 구문 분석하고 실행 중인 환경을 기반으로 구성 파일의 형식을 지정할 수 있도록 PTC에서 제공하는 도구입니다.
|
template-processor-12.0.0.9-application.tar.gz
|
|
tomcat
|
ThingWorx Platform을 실행하기 위해 Apache에서 가져온 Tomcat 아카이브 파일입니다.
|
tomcat-9.0.21.tar.gz
|
|
java
|
Oracle에서 가져온 Java JDK(버전 8) 아카이브 파일입니다.
|
jdk-8u172-linux-x64.tar.gz
|
• 개별 플랫폼 버전의 필수 아카이브 파일:
|
플랫폼
|
예제 파일
|
|---|---|
|
ThingWorx Platform H2
|
Thingworx-Platform-H2-8.4.1-b2126.zip
|
|
ThingWorx Platform PostgreSQL
|
Thingworx-Platform-Postgres-8.4.1-b2126.zip
|
|
ThingWorx Platform Microsoft SQL Server
|
Thingworx-Platform-Mssql-8.4.1-b2126.zip
또한 이 버전에는 Microsoft에서 제공하는 SQL Server용 Microsoft JDBC Driver가 필요합니다.
sqljdbc_6.0.8112.200_enu.tar.gz
|
|
ThingWorx Platform Azure SQL
|
Thingworx-Platform-Azuresql-8.4.1-b2126.zip
또한 이 버전에는 Microsoft에서 제공하는 SQL Server용 Microsoft JDBC Driver가 필요합니다.
sqljdbc_6.0.8112.200_enu.tar.gz
|
 |
build.env 변수
build.env 파일에는 설정해야 할 변수의 목록이 포함되어 있습니다. 다음 변수를 설정해야 합니다.
|
변수 이름
|
기본값
|
설명
|
|---|---|---|
|
PLATFORM_VERSION
|
8.4.1–b2126
|
플랫폼 버전을 지정합니다.
|
|
JAVA_VERSION
|
8u172
|
Oracle Java JDK의 버전을 지정합니다.
|
|
TOMCAT_VERSION
|
9.0.21
|
Apache Tomcat의 버전을 지정합니다.
|
|
TEMPLATE_PROCESSOR_VERSION
|
12.0.0.12
|
staging 폴더에 있는 템플릿-프로세서 아카이브 파일의 버전을 지정합니다.
|
|
PLATFORM_SETTINGS_FILE
|
platform-settings.json
|
기본 ThingWorx 설정 파일(staging 폴더에 포함됨)의 경로를 지정합니다.
|
|
BUILD_TEST_DBS
|
true
|
플랫폼 이미지와 함께 테스트용 데이터베이스 이미지를 빌드할지 여부를 결정합니다. 데이터베이스 이미지를 빌드하려면 true로 설정합니다.
|
|
PLATFORM_H2_VERSION
|
8.4.1-b2126
|
빌드할 ThingWorx H2 Platform의 버전을 지정합니다. H2 컨테이너를 빌드할 때만 필요합니다.
|
|
PLATFORM_H2_ARCHIVE
|
Thingworx-Platform-H2-8.4.1-b2126.zip
|
staging 폴더에 있는 ThingWorx H2 .zip 파일의 파일 이름을 지정합니다. H2 컨테이너를 빌드할 때만 필요합니다.
|
|
PLATFORM_POSTGRES_VERSION
|
8.4.1-b2126
|
빌드할 ThingWorx PostgreSQL Platform의 버전을 지정합니다. PostgreSQL 컨테이너를 빌드할 때만 필요합니다.
|
|
PLATFORM_POSTGRES_ARCHIVE
|
Thingworx-Platform-Postgres-8.4.1-b2126.zip
|
staging 폴더에 있는 ThingWorx PostgreSQL .zip 파일의 파일 이름을 지정합니다. PostgreSQL 컨테이너를 빌드할 때만 필요합니다.
|
|
PLATFORM_MSSQL_VERSION
|
8.4.1-b2126
|
빌드할 ThingWorx Microsoft SQL Server Platform의 버전을 지정합니다. Microsoft SQL Server 컨테이너를 빌드할 때만 필요합니다.
|
|
PLATFORM_MSSQL_ARCHIVE
|
Thingworx-Platform-Mssql-8.4.1-b2126.zip
|
staging 폴더에 있는 ThingWorx Microsoft SQL Server .zip 파일의 파일 이름을 지정합니다. Microsoft SQL Server 컨테이너를 빌드할 때만 필요합니다.
|
|
SQLDRIVER_VERSION
|
6.0.8112.200
|
설치할 SQL Server용 Microsoft JDBC Driver의 버전을 지정합니다. Microsoft SQL Server 컨테이너를 빌드할 때만 필요합니다.
|
|
MSSQL_DB_TWX_DATABASE_PASSWORD
|
기본값 없음 - 수동으로 설정해야 함
|
Microsoft SQL Server 데이터베이스 사용자의 암호를 지정합니다. BUILD_TEST_DBS가 활성화되어 있고 Microsoft SQL Server 이미지를 빌드 중인 경우 이미지 빌드 프로세스에 사용되도록 설정해야 합니다.
암호는 8자 이상이어야 하며 다음 네 집합 즉, 대문자, 소문자, base 10 숫자 및 기호 중 세 개를 포함해야 합니다.
|
|
MSSQL_DB_TWX_DATABASE_USERNAME
|
기본값 없음 - 수동으로 설정해야 함
|
Microsoft SQL Server 데이터베이스 사용자의 사용자 이름을 지정합니다. BUILD_TEST_DBS가 활성화되어 있고 Microsoft SQL Server 이미지를 빌드 중인 경우 이미지 빌드 프로세스에 사용되도록 설정해야 합니다.
|
|
MSSQL_DB_TWX_DATABASE_SCHEMA
|
기본값 없음 - 수동으로 설정해야 함
|
이 스키마가 Microsoft SQL Server 데이터베이스의 데이터베이스 스키마임을 지정합니다. BUILD_TEST_DBS가 활성화되어 있고 Microsoft SQL Server 이미지를 빌드 중인 경우 이미지 빌드 프로세스에 사용되도록 설정해야 합니다.
|
|
MSSQL_DB_SA_PASSWORD
|
기본값 없음 - 수동으로 설정해야 함
|
Microsoft SQL Server sa 사용자의 암호를 지정합니다. BUILD_TEST_DBS가 활성화되어 있고 Microsoft SQL Server 이미지를 빌드 중인 경우 이미지 빌드 프로세스에 사용되도록 설정해야 합니다.
암호는 8자 이상이어야 하며 다음 네 집합 즉, 대문자, 소문자, base 10 숫자 및 기호 중 세 개를 포함해야 합니다.
|
|
PLATFORM_AZURESQL_VERSION
|
8.4.1-b2126
|
빌드할 ThingWorx Azure SQL Platform의 버전을 지정합니다. Azure SQL 컨테이너를 빌드할 때만 필요합니다.
|
|
PLATFORM_AZURESQL_ARCHIVE
|
Thingworx-Platform-Azuresql-8.4.1-b2126.zip
|
staging 폴더에 있는 ThingWorx Azure SQL Server .zip 파일의 파일 이름을 지정합니다. Azure SQL 컨테이너를 빌드할 때만 필요합니다.
|
|
AZURESQL_SQLDRIVER_VERSION
|
6.0.8112.200
|
설치할 Azure SQL용 Microsoft JDBC Driver의 버전을 지정합니다. Azure SQL 컨테이너를 빌드할 때만 필요합니다.
|
다음은 기본값이 staging 폴더에 있는 파일과 일치하지 않을 경우에만 설정해야 하는 변수입니다.
|
변수 이름
|
기본값
|
설명
|
|---|---|---|
|
TOMCAT_ARCHIVE
|
tomcat-9.0.21.tar.gz
|
staging 폴더에 있는 Tomcat 아카이브 파일의 이름을 지정합니다.
|
|
JAVA_ARCHIVE
|
jdk-8u172-linux-x64.tar.gz
|
staging 폴더에 있는 Java 아카이브 파일의 이름을 지정합니다.
|
|
SQLDRIVER_ARCHIVE
|
sqljdbc_6.0.8112.200_enu.tar.gz
|
staging 폴더에 있는 SQL Server용 Microsoft JDBC Driver 아카이브 파일의 이름을 지정합니다. Microsoft SQL Server 컨테이너를 빌드할 때만 필요합니다.
|
|
TEMPLATE_PROCESSOR_ARCHIVE
|
template-processor-12.0.0.10-application.tar.gz
|
staging 폴더에 있는 template-processor 아카이브 파일의 이름을 지정합니다.
|
준비 파일
Docker 이미지를 빌드하는 데 필요한 파일을 이 릴리즈의 일부인 staging 폴더에 배치해야 합니다. staging 폴더에 기본 platform-settings.json 파일이 이미 포함되어 있어야 합니다.
준비 작업을 지원하기 위해 Apache Tomcat과 SQL Server용 Microsoft JDBC Driver의 구성된 버전(기본 버전)이 자동으로 다운로드될 수 있습니다.
자동으로 다운로드하려면 다음을 수행하십시오.
1. build.env 파일 변수를 적절히 설정했는지 확인합니다.
2. 다음 명령을 실행합니다. ./build.sh stage.
오류가 발생하지 않은 경우 파일이 staging 폴더에 있고 build.env 설정과 일치합니다.
다음과 같은 방법으로 다른 필요한 파일을 구할 수 있습니다.
• Java
Oracle 라이선스 계약 동의 요구사항으로 인해 Oracle에서 수동으로 Java를 다운로드합니다. Java는
Java SE Development Kit 8 다운로드 페이지에서 사용할 수 있습니다. 페이지에서 라이선스 협약에 동의한 후 Linux x64 tar.gz 파일(예: jdk-8u172-linux-x64.tar.gz)을 다운로드합니다.
이 파일을 staging 폴더에 저장하고 build.env 파일의 JAVA_VERSION 및 JAVA_ARCHIVE 변수가 올바른지 확인합니다.
• ThingWorx Platform 아카이브 파일
PTC 소프트웨어 다운로드 사이트의 동일한 ThingWorx Platform 부분에서 이 Dockerfile 릴리즈가 포함된 ThingWorx Platform 아카이브 파일을 다운로드합니다. 차이가 있을 수 있으므로 Dockerfile 집합에 대한 버전과 동일한 ThingWorx 버전을 사용해야 합니다. 예제 파일: Thingworx-Platform-H2-8.4.1-b2126.zip
이 파일을 staging 폴더에 저장하고 build.env 파일의 PLATFORM_TYPE_VERSION 및 PLATFORM_TYPE_ARCHIVE 변수가 올바른지 확인합니다.
• 템플릿 프로세서 아카이브 파일
template-processor 도구는 기본적으로 staging 폴더에 포함되어 있으며 Docker 빌드에 자동으로 포함되어야 합니다. TEMPLATE_PROCESSOR_VERSION 및 TEMPLATE_PROCESSOR_ARCHIVE build.env 파일 설정이 올바른지 확인합니다.
• Tomcat 아카이브 파일
Tomcat을 자동으로 다운로드할 수 없는 경우 Apache(
Tomcat 9 소프트웨어 다운로드 사이트)에서 직접 다운로드합니다. Core 버전을 다운로드하도록 선택하고 tar.gz를 선택합니다. 예제 파일: apache-tomcat-9.0.21.tar.gz
이 파일을 staging 폴더에 저장하고 build.env 파일의 TOMCAT_VERSION 및 TOMCAT_ARCHIVE 변수가 올바른지 확인합니다. build.env에서 변경하지 않은 경우 기본 예상 이름은 tomcat-version.tar.gz입니다.
• SQL Server용 Microsoft JDBC Driver
Microsoft JDBC Driver를 직접 다운로드할 수 없거나 대체 버전을 사용하려는 경우 Microsoft(
SQL Server용 Microsoft JDBC Driver 6.0)에서 직접 다운로드합니다. 영어 버전(대체 언어에서는 파일 구조가 다름)을 선택합니다. 다음 페이지에서 sqljdbc_version_enu.tar.gz를 선택하고 다음을 클릭합니다.
이 파일을 staging 폴더에 저장하고 build.env 파일의 SQLDRIVER_VERSION 및 SQLDRIVER_ARCHIVE 변수가 올바른지 확인합니다.
• Azure SQL용 Microsoft JDBC Driver
Microsoft JDBC Driver를 직접 다운로드할 수 없거나 대체 버전을 사용하려는 경우 Microsoft(
SQL Server용 Microsoft JDBC Driver 6.0)에서 직접 다운로드합니다. 영어 버전(대체 언어에서는 파일 구조가 다름)을 선택합니다. 다음 페이지에서 sqljdbc_version_enu.tar.gz를 선택하고 다음을 클릭합니다.
이 파일을 staging 폴더에 저장하고 build.env 파일의 AZURE_SQLDRIVER_VERSION 및 AZURE_SQLDRIVER_ARCHIVE 변수가 올바른지 확인합니다.