paserver docker
11.3.0
Selamat datang di panduan untuk menggunakan aplikasi Rad Studio di Linux menggunakan Docker dan Paserver. Repositori ini menawarkan skrip Docker yang dirancang untuk menyederhanakan pengaturan dan pengelolaan lingkungan pengembangan Anda, memungkinkan pengembang studio RAD untuk menggunakan dan menguji aplikasi mereka di lingkungan Linux.
Gambar default untuk menjalankan Paserver di port 64211 dengan kata sandi securepass
Gambar 10.x menggunakan Ubuntu 18.04.6 LTS (Bionic Beaver) sedangkan gambar +11.x menggunakan Ubuntu 22.04.1 LTS (Jammy Jellyfish)
run.sh ] Script [ run.sh ] adalah alat otomatisasi masuk Anda untuk menyiapkan dan menggunakan aplikasi Paserver dengan mudah dan fleksibilitas. Di bawah ini adalah instruksi untuk memanfaatkan skrip ini secara efektif.
Pastikan Docker diinstal pada sistem Anda karena skrip ini menggunakan Docker untuk menjalankan aplikasi Paserver.
Arahkan ke direktori yang berisi [ run.sh ] di terminal Anda. Jalankan skrip dengan opsi pilihan Anda:
./run.sh [OPTIONS]--name atau -n : nama wadah (mis. --name=myPAServer ).--path atau -pa : BIND Path for Volume Mapping (mis. --path=/my/custom/path ).--detach atau -d : Jalankan wadah dalam mode detach (latar belakang).--port atau -p : port untuk paserver (misalnya, --port=64211 ).--production atau -pr : Aktifkan Mode Produksi ( true ).--version atau -v : Versi Paserver (misalnya, --version=latest ).--password atau -pw : Tetapkan kata sandi untuk paserver (mis. --password=securepass ).--help atau -h : menunjukkan bantuan skrip.Jalankan Paserver dalam mode produksi di port 65000 dengan nama dan kata sandi khusus:
./run.sh --name=myPAServer --port=65000 --production --password=mysupersecurepasswordJalankan Paserver dalam mode detach dengan versi, jalur bind, dan kata sandi tertentu:
./run.sh --detach --version=12.1 --path=/my/custom/path --password=mysupersecurepassword Pastikan Anda memiliki izin yang diperlukan untuk mengeksekusi run.sh Gunakan chmod +x run.sh untuk membuatnya dapat dieksekusi jika diperlukan.
docker run Langsung Untuk pengguna yang lebih suka pendekatan yang lebih langsung atau ingin menyesuaikan penyebaran mereka lebih lanjut, Anda dapat langsung menggunakan perintah docker run untuk memulai wadah Paserver Anda. Metode ini memberikan fleksibilitas dan memungkinkan Anda untuk menentukan secara manual setiap opsi.
Struktur dasar perintah untuk menjalankan wadah Paserver Docker adalah sebagai berikut:
docker run [OPTIONS] radstudio/paserver:[VERSION]-e PA_SERVER_PASSWORD=[PASSWORD] : Mengatur kata sandi untuk paserver. Ganti [PASSWORD] dengan kata sandi yang Anda inginkan.--name [NAME] : Menetapkan nama khusus ke wadah Docker Anda. Ganti [NAME] dengan nama kontainer pilihan Anda.-p [PORT]:64211 : Peta port khusus pada host Anda ke port default Paserver (64211). Ganti [PORT] dengan nomor port yang ingin Anda gunakan.[DETACH_ARG] : Gunakan -d untuk menjalankan wadah dalam mode terpisah (di latar belakang).[BIND_PATH_ARG] : gunakan -v [HOST_PATH]:[CONTAINER_PATH] untuk mengikat volume untuk data atau konfigurasi yang persisten. Ganti [HOST_PATH] dan [CONTAINER_PATH] dengan jalur spesifik Anda. Untuk menjalankan Paserver dalam wadah Docker bernama myPAServer , mendengarkan di port 65000, dengan kata sandi mysupersecurepassword , dan berjalan dalam mode terpisah, Anda akan menggunakan perintah berikut:
docker run -d
-e PA_SERVER_PASSWORD=mysupersecurepassword
--name myPAServer
-p 65000:64211 radstudio/paserver:latest Jika Anda ingin mengikat volume untuk data persisten, Anda dapat menambahkan opsi -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 memungkinkan Anda untuk mendefinisikan dan menjalankan aplikasi Docker multi-kontainer. Berikut adalah contoh file docker-compose.yml yang menunjukkan cara menggunakan gambar Docker sebagai bagian dari layanan, menggunakan variabel lingkungan untuk konfigurasi.
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 Konfigurasi ini mendefinisikan satu layanan yang disebut myPAServer . Ia menggunakan gambar Docker radstudio/paserver:latest . Konfigurasi layanan mencakup pemetaan port dari host ke wadah, mengatur variabel lingkungan untuk kata sandi server, dan memasang volume dari host ke wadah. Pengaturan ini dapat disesuaikan melalui variabel lingkungan yang ditentukan dalam file .env yang terletak di direktori yang sama dengan docker-compose.yml Anda.
# .env file
PA_SERVER_PASSWORD=securepass
HOST_PORT=65000
HOST_PATH=/path/on/host
Untuk memulai aplikasi Anda, jalankan perintah berikut di direktori yang berisi docker-compose.yml Anda:
docker-compose up Perintah ini memulai proses Docker Compose, yang membaca file docker-compose.yml dan file .env , menerapkan konfigurasi untuk memulai layanan Anda sebagaimana didefinisikan.
Ini akan menarik gambar yang diperlukan (jika belum tersedia secara lokal), buat volume yang ditentukan, atur variabel lingkungan, dan mulai aplikasi Anda pada port yang ditentukan.
Pastikan Anda mengganti /path/on/host dengan jalur aktual yang ingin Anda gunakan untuk pengikatan volume. Tag latest dapat diganti dengan versi spesifik dari Paserver yang ingin Anda gunakan.
Panduan ini akan membantu Anda menyesuaikan gambar Paserver agar sesuai dengan kebutuhan spesifik Anda, seperti menambahkan file atau folder tambahan, menginstal paket tambahan, dan membuat modifikasi lainnya.
Untuk menambahkan file atau folder ke gambar Docker Anda, gunakan COPY atau ADD Instruksi di DockerFile Anda. COPY lebih disukai untuk menyalin file lokal, sementara ADD dapat menangani URL jarak jauh dan ekstraksi tar.
COPY ./myconfig.conf /etc/myapp/myconfig.conf Perintah ini menyalin myconfig.conf dari direktori proyek Anda ke /etc/myapp/myconfig.conf di dalam gambar Docker.
Untuk menginstal paket tambahan, Anda dapat memodifikasi perintah RUN yang menginstal paket. Yang terbaik adalah menggabungkan perintah instalasi paket ke dalam satu instruksi RUN untuk mengurangi jumlah lapisan pada gambar Docker Anda.
RUN apt-get update && apt-get install -y
git
cmake
&& rm -rf /var/lib/apt/lists/*Berdasarkan setiap proyek, pustaka tertentu mungkin diperlukan. Perintah ini memperbarui daftar paket, menginstal git dan cmake , dan membersihkan sesudahnya untuk menjaga ukuran gambar tetap rendah.
Untuk menghindari pelapisan tambahan pada gambar Docker akhir, ini adalah praktik yang baik untuk memodifikasi perintah RUN apt-get update yang ada untuk memasukkan perpustakaan yang Anda wajib.
Anda dapat menyesuaikan DockerFile untuk mengubah variabel lingkungan, mengunduh berbagai versi perangkat lunak, atau memodifikasi proses instalasi.
ENV MY_CUSTOM_VAR=myvalue Ini menetapkan variabel lingkungan MY_CUSTOM_VAR yang dapat digunakan oleh aplikasi Anda.
Setelah menyesuaikan DockerFile Anda, Anda dapat membangun gambar Docker menggunakan perintah docker build .
docker build -t my-custom-paserver:latest . Perintah ini membangun gambar Docker bernama my-custom-paserver dengan tag latest , menggunakan DockerFile di direktori saat ini.
Untuk nilai-nilai yang mungkin berubah antara build (seperti kata sandi atau nomor versi), Anda dapat menggunakan instruksi ARG di DockerFile dan nilai lulus dengan opsi --build-arg selama build.
ARG password=securepassBangun dengan kata sandi khusus:
docker build --build-arg password=mypassword -t my-custom-paserver:latest .build.sh ] yang dapat digunakan sebagai templat untuk menyederhanakan build khusus.linux/amd64 . Untuk menghindari masalah potensial dalam pengaturan lengan, bangun gambar dengan arg --platform linux/amd64RUN tunggal jika memungkinkan..dockerignore : Tambahkan file .dockerignore ke proyek Anda untuk menghindari menyalin file yang tidak perlu ke gambar Docker Anda.Perangkat lunak ini adalah Hak Cipta © 2024 oleh Embarcadero Technologies, Inc.
Anda hanya dapat menggunakan perangkat lunak ini jika Anda adalah pemegang lisensi resmi dari produk EMBARCADERO Developer Tools. Lihat Perjanjian Lisensi Perangkat Lunak terbaru untuk setiap pembaruan.
