Docker 및 Paserver를 사용하여 Linux에 Rad Studio 응용 프로그램을 배포하기위한 가이드에 오신 것을 환영합니다. 이 저장소는 개발 환경의 설정 및 관리를 단순화하도록 설계된 Docker 스크립트를 제공하여 Rad Studio 개발자가 Linux 환경에서 응용 프로그램을 배포하고 테스트 할 수 있습니다.
이미지는 비밀번호 securepass 사용하여 포트 64211 에서 파서버 실행 기본값
10.X 이미지는 우분투 18.04.6 LTS (Bionic Beaver)를 사용하는 반면 +11.x 이미지는 Ubuntu 22.04.1 LTS (jammy jellyfish)를 사용합니다.
run.sh ] 스크립트를 사용하는 방법 [ run.sh ] 스크립트는 쉽고 유연하게 Paserver 응용 프로그램을 설정하고 배포하기위한 자동화 도구입니다. 다음은이 스크립트를 효과적으로 활용하는 지침입니다.
이 스크립트는 Paserver 응용 프로그램을 실행하기 위해 Docker를 사용하므로 Docker가 시스템에 설치되어 있는지 확인하십시오.
터미널에 [ run.sh ]가 포함 된 디렉토리로 이동하십시오. 선호하는 옵션으로 스크립트를 실행하십시오.
./run.sh [OPTIONS]--name 또는 -n : 컨테이너 이름 (예 : --name=myPAServer ).--path 또는 -pa : 볼륨 매핑을위한 바인드 경로 (예 : --path=/my/custom/path ).--detach 또는 -d : 컨테이너를 분리 모드 (배경)로 실행하십시오.--port 또는 -p : Paserver 용 포트 (예 : --port=64211 ).--production 또는 -pr : 활성화 생산 모드 ( true ).--version 또는 -v : paserver 버전 (예 : --version=latest ).--password 또는 -pw : paserver에 대한 비밀번호를 설정합니다 (예 : --password=securepass ).--help 또는 -h : 스크립트의 도움을 보여줍니다.사용자 정의 이름과 비밀번호로 포트 65000의 프로덕션 모드에서 Paserver를 실행하십시오.
./run.sh --name=myPAServer --port=65000 --production --password=mysupersecurepassword특정 버전, 바인드 경로 및 비밀번호로 Detach 모드에서 Paserver를 실행하십시오.
./run.sh --detach --version=12.1 --path=/my/custom/path --password=mysupersecurepassword run.sh 실행하는 데 필요한 권한이 있는지 확인하십시오. chmod +x run.sh 사용하여 필요한 경우 실행 가능하게하십시오.
docker run 보다 실용적인 접근 방식을 선호하거나 배포를 더 사용자 정의하려는 사용자의 경우 docker run 명령을 직접 사용하여 Paserver 컨테이너를 시작할 수 있습니다. 이 방법은 유연성을 제공하며 각 옵션을 수동으로 지정할 수 있습니다.
Paserver Docker 컨테이너를 실행하는 명령의 기본 구조는 다음과 같습니다.
docker run [OPTIONS] radstudio/paserver:[VERSION]-e PA_SERVER_PASSWORD=[PASSWORD] : paserver의 비밀번호를 설정합니다. [PASSWORD] 원하는 비밀번호로 바꾸십시오.--name [NAME] : Docker 컨테이너에 사용자 정의 이름을 할당합니다. [NAME] 선호하는 컨테이너 이름으로 바꾸십시오.-p [PORT]:64211 : 호스트의 사용자 정의 포트를 Paserver의 기본 포트 (64211)에 매핑합니다. [PORT] 사용하려는 포트 번호로 교체하십시오.[DETACH_ARG] : -d 사용하여 컨테이너를 분리 모드 (백그라운드)로 실행합니다.[BIND_PATH_ARG] : -v [HOST_PATH]:[CONTAINER_PATH] 사용하여 영구 데이터 또는 구성에 대한 볼륨을 바인딩합니다. [HOST_PATH] 및 [CONTAINER_PATH] 특정 경로로 바꾸십시오. myPAServer 라는 Docker 컨테이너에서 Paserver를 실행하고 mysupersecurepassword 의 비밀번호로 Port 65000에서 청취하고 분리 모드에서 실행하려면 다음 명령을 사용합니다.
docker run -d
-e PA_SERVER_PASSWORD=mysupersecurepassword
--name myPAServer
-p 65000:64211 radstudio/paserver:latest 영구 데이터의 볼륨을 바인딩하려면 -v 옵션을 추가 할 수 있습니다.
docker run -d
-e PA_SERVER_PASSWORD=securepass
-v /path/on/host:/root/PAServer/scratch-dir
--name myPAServer
-p 65000:64211 radstudio/paserver:latest Docker Compose를 사용하면 멀티 컨테이너 Docker 응용 프로그램을 정의하고 실행할 수 있습니다. 다음은 docker-compose.yml 파일 예입니다. 구성을 위해 환경 변수를 사용하여 Docker Image를 서비스의 일부로 사용하는 방법을 보여줍니다.
version : ' 3.8 '
services :
myPAServer :
image : radstudio/paserver:latest
container_name : myPAServer
environment :
- PA_SERVER_PASSWORD=${PA_SERVER_PASSWORD} # Environment variable for the server password
ports :
- ' ${HOST_PORT}:64211 ' # Environment variable for the host port
volumes :
- ${HOST_PATH}:/root/PAServer/scratch-dir # Environment variable for the host path
restart : unless-stopped 이 구성은 myPAServer 라는 단일 서비스를 정의합니다. Docker Image radstudio/paserver:latest . 서비스 구성에는 호스트에서 컨테이너로 포트를 매핑하고 서버 암호의 환경 변수를 설정하고 호스트에서 컨테이너로 볼륨을 장착하는 것이 포함됩니다. 이 설정은 docker-compose.yml 과 동일한 디렉토리에있는 .env 파일에 정의 된 환경 변수를 통해 사용자 정의 할 수 있습니다.
# .env file
PA_SERVER_PASSWORD=securepass
HOST_PORT=65000
HOST_PATH=/path/on/host
응용 프로그램을 시작하려면 docker-compose.yml 포함 된 디렉토리에서 다음 명령을 실행하십시오.
docker-compose up 이 명령은 docker-compose.yml 파일과 .env 파일을 읽는 Docker Compose 프로세스를 시작하여 정의 된대로 서비스를 시작하기 위해 구성을 적용합니다.
이렇게하면 필요한 이미지를 가져오고 (로컬로 사용 가능한 경우) 정의 된 볼륨을 작성하고 환경 변수를 설정 한 후 지정된 포트에서 응용 프로그램을 시작합니다.
부피 바인딩에 사용하려는 실제 경로로 /path/on/host 교체해야합니다. latest 태그는 배포하려는 특정 버전의 파서버로 교체 할 수 있습니다.
이 안내서는 추가 파일 또는 폴더 추가, 추가 패키지 설치 및 기타 수정과 같은 특정 요구 사항에 맞게 Paserver 이미지를 사용자 정의하는 데 도움이됩니다.
Docker 이미지에 파일이나 폴더를 추가하려면 COPY 사용하거나 Dockerfile에 명령어를 ADD . 로컬 파일 복사에는 COPY 선호되며 ADD 원격 URL 및 TAR 추출을 처리 할 수 있습니다.
COPY ./myconfig.conf /etc/myapp/myconfig.conf 이 명령은 myconfig.conf 프로젝트 디렉토리에서 Docker 이미지 내부의 /etc/myapp/myconfig.conf 로 복사합니다.
추가 패키지를 설치하려면 패키지를 설치하는 RUN 명령을 수정할 수 있습니다. 패키지 설치 명령을 단일 RUN 명령어로 결합하여 Docker 이미지의 레이어 수를 줄이는 것이 가장 좋습니다.
RUN apt-get update && apt-get install -y
git
cmake
&& rm -rf /var/lib/apt/lists/*각 프로젝트를 기반으로 특정 라이브러리가 필요할 수 있습니다. 이 명령은 패키지 목록을 업데이트하고 GIT 및 CMAKE를 설치 한 후 이미지 크기를 낮추기 위해 나중에 정리합니다.
최종 Docker 이미지에서 추가 레이어링을 피하기 위해 필요한 라이브러리를 포함하도록 기존 RUN apt-get update 명령을 수정하는 것이 좋습니다.
DockerFile을 사용자 정의하여 환경 변수를 변경하거나 다른 버전의 소프트웨어를 다운로드하거나 설치 프로세스를 수정할 수 있습니다.
ENV MY_CUSTOM_VAR=myvalue 이로 인해 응용 프로그램에서 사용할 수있는 환경 변수 MY_CUSTOM_VAR 설정됩니다.
DockerFile을 사용자 정의한 후 docker build 명령을 사용하여 Docker 이미지를 빌드 할 수 있습니다.
docker build -t my-custom-paserver:latest . 이 명령은 현재 디렉토리의 dockerfile을 사용하여 latest 태그로 my-custom-paserver 라는 Docker 이미지를 작성합니다.
빌드 (비밀번호 또는 버전 번호와 같은)간에 변경 될 수있는 값의 경우 DockerFile에서 ARG 명령어를 사용하고 빌드 중에 --build-arg 옵션과 함께 값을 전달할 수 있습니다.
ARG password=securepass사용자 정의 비밀번호로 빌드 :
docker build --build-arg password=mypassword -t my-custom-paserver:latest .build.sh ] 스크립트를 제공합니다.linux/amd64 와만 호환됩니다. ARM 설정에서 잠재적 인 문제를 피하려면 Arg --platform linux/amd64 로 이미지를 작성하십시오.RUN 지침으로 결합합니다..dockerignore 사용 : 프로젝트에 .dockerignore 파일을 추가하여 불필요한 파일을 Docker 이미지에 복사하지 않도록하십시오.이 소프트웨어는 Embarcadero Technologies, Inc.의 저작권 © 2024입니다.
Embarcadero 개발자 도구 제품의 공인 라이센스 사용자 인 경우이 소프트웨어 만 사용할 수 있습니다. 업데이트는 최신 소프트웨어 라이센스 계약을 참조하십시오.