paserver docker
11.3.0
Willkommen zum Leitfaden zum Bereitstellen von RAD -Studio -Anwendungen unter Linux mit Docker und Paserver. Dieses Repository bietet ein Docker -Skript zur Vereinfachung des Setups und der Verwaltung Ihrer Entwicklungsumgebung, mit der Radio -Entwickler ihre Anwendungen in einer Linux -Umgebung bereitstellen und testen können.
Das Bild standardmäßig zum Ausführen von Paserver auf Port 64211 mit dem Passwort securepass
Die 10.x -Bilder verwenden Ubuntu 18.04.6 LTS (Bionic Beaver), während die +11.x -Bilder Ubuntu 22.04.1 LTS (Jammy Quallen) verwenden
run.sh ] Das Skript [ run.sh ] ist Ihr Angestellter-Automatisierungstool zum Einrichten und Bereitstellen der Paserver-Anwendung mit Leichtigkeit und Flexibilität. Nachfolgend finden Sie die Anweisungen, um dieses Skript effektiv zu nutzen.
Stellen Sie sicher, dass Docker in Ihrem System installiert ist, da dieses Skript Docker zum Ausführen der Paserver -Anwendung verwendet.
Navigieren Sie zum Verzeichnis, das [ run.sh ] in Ihrem Terminal enthält. Führen Sie das Skript mit Ihren bevorzugten Optionen aus:
./run.sh [OPTIONS]--name oder -n : Container Name (zB, --name=myPAServer ).--path oder -pa : Binden Sie Pfad für die Volumenzuordnung (z. B. --path=/my/custom/path ).--detach oder -d : Behälter im Abstandsmodus (Hintergrund) ausführen.--port oder -p : Port für Paserver (z. B. --port=64211 ).--production oder -pr : Der Produktionsmodus ( true ) aktivieren.--version oder -v : Paserver -Version (z. B. --version=latest ).--password oder -pw : Setzen Sie ein Kennwort für Paserver (z. B. --password=securepass ).--help oder -h : Zeigt die Hilfe des Skripts an.Führen Sie Paserver im Produktionsmodus auf Port 65000 mit einem benutzerdefinierten Namen und Passwort aus:
./run.sh --name=myPAServer --port=65000 --production --password=mysupersecurepasswordFühren Sie Paserver im Abstandsmodus mit einer bestimmten Version, einer bestimmten Version und einem Kennwort aus:
./run.sh --detach --version=12.1 --path=/my/custom/path --password=mysupersecurepassword Stellen Sie sicher, dass Sie über die erforderlichen Berechtigungen verfügen, um run.sh auszuführen. Verwenden Sie chmod +x run.sh um es bei Bedarf ausführbar zu machen.
docker run direkt ausführen Für Benutzer, die einen praktischeren Ansatz bevorzugen oder ihre Bereitstellung weiter anpassen möchten, können Sie den Befehl docker run direkt verwenden, um Ihren Paserver-Container zu starten. Diese Methode bietet Flexibilität und ermöglicht es Ihnen, jede Option manuell anzugeben.
Die Grundstruktur des Befehls zum Ausführen des Paserver Docker -Containers lautet wie folgt:
docker run [OPTIONS] radstudio/paserver:[VERSION]-e PA_SERVER_PASSWORD=[PASSWORD] : Legt das Kennwort für den Paserver fest. Ersetzen Sie [PASSWORD] durch Ihr gewünschtes Passwort.--name [NAME] : Weisen Sie Ihrem Docker-Container einen benutzerdefinierten Namen zu. Ersetzen Sie [NAME] durch Ihren bevorzugten Containernamen.-p [PORT]:64211 : Karten Sie einen benutzerdefinierten Port auf Ihrem Host zum Standardport des Paserver (64211). Ersetzen Sie [PORT] durch die Portnummer, die Sie verwenden möchten.[DETACH_ARG] : Verwenden Sie -d , um den Container im abgetrennten Modus (im Hintergrund) auszuführen.[BIND_PATH_ARG] : Verwenden Sie -v [HOST_PATH]:[CONTAINER_PATH] um ein Volumen für anhaltende Daten oder Konfigurationen zu binden. Ersetzen Sie [HOST_PATH] und [CONTAINER_PATH] durch Ihre spezifischen Pfade. Um den Paserver in einem Docker -Container namens myPAServer auszuführen, auf Port 65000 zuzuhören, mit einem Passwort von mysupersecurepassword und im abgetrennten Modus auszuführen, verwenden Sie den folgenden Befehl:
docker run -d
-e PA_SERVER_PASSWORD=mysupersecurepassword
--name myPAServer
-p 65000:64211 radstudio/paserver:latest Wenn Sie ein Volumen für anhaltende Daten binden möchten, können Sie die Option -v hinzufügen:
docker run -d
-e PA_SERVER_PASSWORD=securepass
-v /path/on/host:/root/PAServer/scratch-dir
--name myPAServer
-p 65000:64211 radstudio/paserver:latest Mit Docker Compose können Sie Multi-Container-Docker-Anwendungen definieren und ausführen. Hier ist eine Beispiel für docker-compose.yml -Datei, die demonstriert, wie ein Docker-Image als Teil eines Dienstes verwendet wird, wobei Umgebungsvariablen zur Konfiguration verwendet werden.
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 Diese Konfiguration definiert einen einzelnen Dienst namens myPAServer . Es verwendet das Docker Image radstudio/paserver:latest . Die Servicekonfiguration umfasst die Zuordnung eines Ports vom Host zum Container, die Einstellung einer Umgebungsvariablen für das Serverkennwort und die Montage eines Volumens vom Host zum Container. Diese Einstellungen sind durch Umgebungsvariablen anpassbar, die in einer .env Datei im selben Verzeichnis wie Ihre docker-compose.yml definiert sind.
# .env file
PA_SERVER_PASSWORD=securepass
HOST_PORT=65000
HOST_PATH=/path/on/host
Führen Sie den folgenden Befehl im Verzeichnis mit Ihrem docker-compose.yml aus: Um Ihre Bewerbung zu starten:
docker-compose up Dieser Befehl initiiert den Docker Compose-Prozess, der die Datei docker-compose.yml und die .env Datei liest und die Konfigurationen anwendet, um Ihren Dienst wie definiert zu starten.
Dadurch wird das erforderliche Bild (falls es nicht bereits lokal verfügbar ist), die definierten Volumina erstellen, die Umgebungsvariablen festlegen und Ihre Anwendung in den angegebenen Ports starten.
Stellen Sie sicher, dass Sie /path/on/host durch den tatsächlichen Pfad ersetzen, den Sie zur Lautstärkereinbindung verwenden möchten. Das latest Tag kann durch eine bestimmte Version des Paservers ersetzt werden, den Sie bereitstellen möchten.
Mit diesem Handbuch können Sie das Paserver -Bild an Ihre spezifischen Anforderungen anpassen, z. B. zusätzliche Dateien oder Ordner, die Installation von zusätzlichen Paketen und andere Änderungen vornehmen.
Um Ihrem Docker -Bild Dateien oder Ordner hinzuzufügen, verwenden Sie die Anweisung in Ihrer Dockerfile COPY oder ADD . COPY wird für das Kopieren lokaler Dateien bevorzugt, während ADD Remote -URLs und Teer -Extraktion verarbeiten kann.
COPY ./myconfig.conf /etc/myapp/myconfig.conf Dieser Befehl kopiert myconfig.conf aus Ihrem Projektverzeichnis an /etc/myapp/myconfig.conf im Docker -Bild.
Um zusätzliche Pakete zu installieren, können Sie den RUN ausführen, der Pakete installiert. Es ist am besten, die Befehle für Paketinstallation in einen einzigen RUN zu kombinieren, um die Anzahl der Ebenen in Ihrem Docker -Bild zu reduzieren.
RUN apt-get update && apt-get install -y
git
cmake
&& rm -rf /var/lib/apt/lists/*Basierend auf jedem Projekt können bestimmte Bibliotheken erforderlich sein. Dieser Befehl aktualisiert die Paketlisten, installiert Git und CMake und säubert danach, um die Bildgröße niedrig zu halten.
Um zusätzliche Layering im endgültigen Docker-Image zu vermeiden, ist es eine gute Praxis, den vorhandenen Befehl vorhandenen RUN apt-get update zu ändern, um Ihre erforderlichen Bibliotheken einzuschließen.
Sie können die Dockerfile an die Umgebungsvariablen anpassen, verschiedene Versionen von Software herunterladen oder den Installationsprozess ändern.
ENV MY_CUSTOM_VAR=myvalue Dies legt eine Umgebungsvariable MY_CUSTOM_VAR fest, die von Ihrer Anwendung verwendet werden kann.
Nachdem Sie Ihre Dockerfile angepasst haben, können Sie Ihr Docker -Bild mit dem Befehl docker build erstellen.
docker build -t my-custom-paserver:latest . Dieser Befehl erstellt ein Docker-Bild mit dem Namen my-custom-paserver mit dem latest Tag mit der Dockerfile im aktuellen Verzeichnis.
Für Werte, die sich zwischen Builds ändern können (z. B. Passwörter oder Versionsnummern), können Sie ARG Anweisungen in Ihrer DockerFile verwenden und Werte mit der Option --build-arg während des Builds übergeben.
ARG password=securepassErstellen Sie mit einem benutzerdefinierten Passwort:
docker build --build-arg password=mypassword -t my-custom-paserver:latest .build.sh ] -Skript, das als Vorlage zur Vereinfachung benutzerdefinierter Builds verwendet werden kann.linux/amd64 kompatibel. Um potenzielle Probleme bei ARM -Setups zu vermeiden, erstellen Sie das Bild mit dem Arg --platform linux/amd64RUN ..dockerignore : Fügen Sie Ihrem Projekt eine .dockerignore -Datei hinzu, um nicht nötige Dateien in Ihr Docker -Bild zu kopieren.Diese Software ist Copyright © 2024 von Embarcadero Technologies, Inc.
Sie dürfen diese Software nur verwenden, wenn Sie ein autorisierter Lizenznehmer eines Embarcadero -Entwickler -Tools -Produkts sind. In der neuesten Softwarelizenzvereinbarung finden Sie alle Aktualisierungen.
