paserver docker
11.3.0
Добро пожаловать в руководство по развертыванию приложений Rad Studio на Linux с использованием Docker и Paserver. Этот репозиторий предлагает сценарий Docker, предназначенный для упрощения настройки и управления вашей средой разработки, что позволяет разработчикам RAD Studio развертывать и проверять свои приложения в среде Linux.
Изображение по умолчанию запуска Paserver на порту 64211 с паролем securepass
Изображения 10.x используют Ubuntu 18.04.6 LTS (Bionic Beaver), в то время как изображения +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 : показывает помощь сценария.Запустите Paserver в производственном режиме в порте 65000 с помощью пользовательского имени и пароля:
./run.sh --name=myPAServer --port=65000 --production --password=mysupersecurepasswordЗапустите Paserver в режиме Detach с определенной версией, путем привязки и паролем:
./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 , который демонстрирует, как использовать изображение 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 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 Compose, который считывает файл docker-compose.yml и файл .env , применяя конфигурации для запуска вашей службы в соответствии с определением.
Это вытянет необходимое изображение (если оно еще не доступно локально), создаст определенные объемы, установите переменные среды и запустите ваше приложение на указанных портах.
Убедитесь, что вы замените /path/on/host на фактический путь, который вы хотите использовать для привязки громкости. latest тег можно заменить на любую конкретную версию Paserver, которую вы хотите развернуть.
Это руководство поможет вам настроить изображение Paserver в соответствии с вашими конкретными потребностями, такими как добавление дополнительных файлов или папок, установка дополнительных пакетов и внесение других изменений.
Чтобы добавить файлы или папки в изображение Docker, используйте COPY или ADD инструкцию в свой DockerFile. COPY предпочтительнее копирования локальных файлов, в то время как ADD может обрабатывать удаленные URL -адреса и извлечение из смолы.
COPY ./myconfig.conf /etc/myapp/myconfig.conf Эта команда копирует myconfig.conf из вашего каталога проекта в /etc/myapp/myconfig.conf внутри изображения Docker.
Чтобы установить дополнительные пакеты, вы можете изменить команду 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, используя команду docker build .
docker build -t my-custom-paserver:latest . Эта команда создает изображение Docker с именем 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 в свой проект, чтобы избежать копирования ненужных файлов в образ вашего Docker.Это программное обеспечение Copyright © 2024 от Embarcadero Technologies, Inc.
Вы можете использовать это программное обеспечение только в том случае, если вы являетесь авторизованным лицензиатом продукта Embarcadero Developer Tools. См. Последнее лицензионное соглашение о программном обеспечении для любых обновлений.
