paserver docker
11.3.0
歡迎使用Docker和Paserver在Linux上部署RAD Studio應用程序的指南。該存儲庫提供了一個Docker腳本，旨在簡化開發環境的設置和管理，從而使Rad Studio開發人員可以在Linux環境中部署和測試其應用程序。
圖像默認用於使用密碼securepass在端口64211上運行Paserver
10.x圖像使用Ubuntu 18.04.6 LTS（仿生海狸），而 +11.x圖像使用Ubuntu 22.04.1 LTS（Jammy Jellyfish）
run.sh ]腳本[ run.sh ]腳本是您的首選自動化工具，可輕鬆且靈活地設置和部署Paserver應用程序。以下是有效利用此腳本的說明。
確保將Docker安裝在系統上，因為此腳本使用Docker運行Paserver應用程序。
導航到終端中包含[ 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使用特定版本，綁定路徑和密碼以分離模式運行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，在端口65000上聆聽mysupersecurepassword的密碼，並以獨立模式運行，您將使用以下命令：
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:latestDocker組合允許您定義和運行多容器Docker應用程序。這是一個示例docker-compose.yml文件，它演示瞭如何使用docker映像作為服務的一部分，並利用環境變量進行配置。
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組成的過程，該過程讀取docker-compose.yml文件和.env文件，並應用配置以按定義啟動您的服務。
這將拉出必要的圖像（如果尚未本地可用），創建定義的捲，設置環境變量，然後在指定的端口上啟動應用程序。
確保您要使用要使用的實際路徑來替換/path/on/host 。 latest標籤可以用您希望部署的任何特定版本的Paserver替換。
本指南將幫助您自定義Paserver圖像以適合您的特定需求，例如添加其他文件或文件夾，安裝額外的軟件包以及進行其他修改。
要將文件或文件夾添加到Docker映像中，請使用COPY或在Dockerfile中ADD指令。 COPY是複製本地文件的首選，而ADD可以處理遠程URL和TAR提取。
COPY ./myconfig.conf /etc/myapp/myconfig.conf此命令將myconfig.conf從您的項目目錄複製到Docker Image中的/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兼容。為避免手臂設置中的潛在問題，請使用arg --platform linux/amd64構建圖像RUN指令中。.dockerignore ：在您的項目中添加.dockerignore文件，以避免將不必要的文件複製到Docker映像中。該軟件是版權所有©2024，由Embarcadero Technologies，Inc.。
您只能在您是Embarcadero開發人員工具產品的授權許可方時使用此軟件。有關任何更新，請參見最新的軟件許可協議。
