paserver docker
11.3.0
ยินดีต้อนรับสู่คู่มือสำหรับการปรับใช้แอปพลิเคชัน RAD Studio บน Linux โดยใช้ Docker และ Paserver ที่เก็บนี้มีสคริปต์นักเทียบท่าที่ออกแบบมาเพื่อลดความซับซ้อนของการตั้งค่าและการจัดการสภาพแวดล้อมการพัฒนาของคุณทำให้นักพัฒนา RAD Studio สามารถปรับใช้และทดสอบแอปพลิเคชันของพวกเขาในสภาพแวดล้อม Linux
ภาพเริ่มต้นที่จะเรียกใช้ Paserver บนพอร์ต 64211 ด้วย รหัสผ่าน securepass
ภาพ 10.x ใช้ Ubuntu 18.04.6 LTS (Bionic Beaver) ในขณะที่ภาพ +11.x ใช้ Ubuntu 22.04.1 LTS (แมงกะพรุน Jammy)
run.sh ] สคริปต์ [ run.sh ] เป็นเครื่องมืออัตโนมัติไปสู่การตั้งค่าและปรับใช้แอปพลิเคชัน Paserver ได้อย่างง่ายดายและมีความยืดหยุ่น ด้านล่างนี้เป็นคำแนะนำในการใช้สคริปต์นี้อย่างมีประสิทธิภาพ
ตรวจสอบให้แน่ใจว่ามีการติดตั้ง Docker ในระบบของคุณเนื่องจากสคริปต์นี้ใช้ Docker สำหรับเรียกใช้แอปพลิเคชัน Paserver
นำทางไปยังไดเรกทอรีที่มี [ run.sh ] ในเทอร์มินัลของคุณ ดำเนินการสคริปต์ด้วยตัวเลือกที่คุณต้องการ:
./run.sh [OPTIONS]--name or -n : ชื่อคอนเทนเนอร์ (เช่น --name=myPAServer )--path หรือ -pa : Bind Path สำหรับการแมประดับเสียง (เช่น --path=/my/custom/path )--detach หรือ -d : เรียกใช้คอนเทนเนอร์ในโหมด Detach (พื้นหลัง)--port หรือ -p : พอร์ตสำหรับ Paserver (เช่น --port=64211 )--production หรือ -pr : เปิดใช้งานโหมดการผลิต ( true )--version หรือ -v : Paserver Version (เช่น --version=latest )--password หรือ -pw : ตั้งรหัสผ่านสำหรับ Paserver (เช่น --password=securepass )--help หรือ -h : แสดงความช่วยเหลือของสคริปต์เรียกใช้ Paserver ในโหมดการผลิตบนพอร์ต 65000 ด้วยชื่อและรหัสผ่านที่กำหนดเอง:
./run.sh --name=myPAServer --port=65000 --production --password=mysupersecurepasswordเรียกใช้ Paserver ในโหมด Detach ด้วยเวอร์ชันเฉพาะ, Bind Path และรหัสผ่าน:
./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] ด้วยเส้นทางเฉพาะของคุณ ในการเรียกใช้ Paserver ในคอนเทนเนอร์ Docker ชื่อ myPAServer ฟังบนพอร์ต 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:latest Docker Compose ช่วยให้คุณสามารถกำหนดและเรียกใช้แอปพลิเคชัน Docker หลายตัวต่อ นี่คือตัวอย่างไฟล์ docker-compose.yml ที่แสดงวิธีใช้อิมเมจนักเทียบท่าเป็นส่วนหนึ่งของบริการโดยใช้ตัวแปรสภาพแวดล้อมสำหรับการกำหนดค่า
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 radstudio/paserver:latest การกำหนดค่าบริการรวมถึงการแมปพอร์ตจากโฮสต์ไปยังคอนเทนเนอร์การตั้งค่าตัวแปรสภาพแวดล้อมสำหรับรหัสผ่านเซิร์ฟเวอร์และการติดตั้งระดับเสียงจากโฮสต์ไปยังคอนเทนเนอร์ การตั้งค่าเหล่านี้สามารถปรับแต่งได้ผ่านตัวแปรสภาพแวดล้อมที่กำหนดไว้ในไฟล์ .env ที่อยู่ในไดเรกทอรีเดียวกับ docker-compose.yml ของคุณ
# .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 ให้เหมาะกับความต้องการเฉพาะของคุณเช่นการเพิ่มไฟล์หรือโฟลเดอร์เพิ่มเติมการติดตั้งแพ็คเกจพิเศษและทำการปรับเปลี่ยนอื่น ๆ
ในการเพิ่มไฟล์หรือโฟลเดอร์ลงในอิมเมจนักเทียบท่าของคุณให้ใช้ COPY หรือ ADD คำสั่งใน DockerFile ของคุณ COPY เป็นที่ต้องการสำหรับการคัดลอกไฟล์ท้องถิ่นในขณะที่ ADD สามารถจัดการ URL ระยะไกลและการสกัด TAR
COPY ./myconfig.conf /etc/myapp/myconfig.conf คำสั่งนี้คัดลอก myconfig.conf จากไดเรกทอรีโครงการของคุณไปที่ /etc/myapp/myconfig.conf ภายในอิมเมจนักเทียบท่า
ในการติดตั้งแพ็คเกจเพิ่มเติมคุณสามารถแก้ไขคำสั่ง RUN ที่ติดตั้งแพ็คเกจ เป็นการดีที่สุดที่จะรวมคำสั่งการติดตั้งแพ็คเกจเข้ากับคำสั่ง RUN เดียวเพื่อลดจำนวนเลเยอร์ในอิมเมจนักเทียบท่าของคุณ
RUN apt-get update && apt-get install -y
git
cmake
&& rm -rf /var/lib/apt/lists/*ตามแต่ละโครงการอาจจำเป็นต้องมีห้องสมุดเฉพาะ คำสั่งนี้จะอัปเดตรายการแพ็คเกจติดตั้ง GIT และ CMAKE และทำความสะอาดหลังจากนั้นเพื่อลดขนาดภาพ
เพื่อหลีกเลี่ยงการวางเลเยอร์พิเศษในภาพนักเทียบท่าสุดท้ายมันเป็นวิธีปฏิบัติที่ดีในการปรับเปลี่ยนคำสั่ง RUN apt-get update ที่มีอยู่เพื่อรวมไลบรารีที่คุณต้องการ
คุณสามารถปรับแต่ง DockerFile เพื่อเปลี่ยนตัวแปรสภาพแวดล้อมดาวน์โหลดซอฟต์แวร์เวอร์ชันที่แตกต่างกันหรือแก้ไขกระบวนการติดตั้ง
ENV MY_CUSTOM_VAR=myvalue สิ่งนี้ตั้งค่าตัวแปรสภาพแวดล้อม MY_CUSTOM_VAR ที่แอปพลิเคชันของคุณสามารถใช้งานได้
หลังจากปรับแต่ง DockerFile ของคุณคุณสามารถสร้างอิมเมจนักเทียบท่าของคุณโดยใช้คำสั่ง docker build
docker build -t my-custom-paserver:latest . คำสั่งนี้สร้างอิมเมจนักเทียบท่าชื่อ my-custom-paserver พร้อมแท็ก latest โดยใช้ DockerFile ในไดเรกทอรีปัจจุบัน
สำหรับค่าที่อาจเปลี่ยนแปลงระหว่างการสร้าง (เช่นรหัสผ่านหรือหมายเลขเวอร์ชัน) คุณสามารถใช้คำแนะนำ ARG ใน DockerFile และค่าผ่านด้วยตัวเลือก --build-arg ในระหว่างการสร้าง
ARG password=securepassสร้างด้วยรหัสผ่านที่กำหนดเอง:
docker build --build-arg password=mypassword -t my-custom-paserver:latest .build.sh ] ที่สามารถใช้เป็นเทมเพลตสำหรับการสร้างการสร้างที่กำหนดเองได้ง่ายขึ้นlinux/amd64 เท่านั้น เพื่อหลีกเลี่ยงปัญหาที่อาจเกิดขึ้นในการตั้งค่าแขนให้สร้างภาพด้วย ARG --platform linux/amd64RUN เดียวที่เป็นไปได้.dockerignore : เพิ่มไฟล์ .dockerignore ลงในโครงการของคุณเพื่อหลีกเลี่ยงการคัดลอกไฟล์ที่ไม่จำเป็นลงในอิมเมจนักเทียบท่าของคุณซอฟต์แวร์นี้มีลิขสิทธิ์© 2024 โดย Embarcadero Technologies, Inc.
คุณสามารถใช้ซอฟต์แวร์นี้ได้หากคุณเป็นผู้รับใบอนุญาตที่ได้รับอนุญาตของผลิตภัณฑ์เครื่องมือนักพัฒนา Embarcadero ดูข้อตกลงสิทธิ์การใช้งานซอฟต์แวร์ล่าสุดสำหรับการอัปเดตใด ๆ
