paserver dockerダウンロード-Paserver paserver dockerソースコードのダウンロード

paserver docker

Delphi のソースコード

11.3.0

ダウンロード

Rad Studio Paserver Docker

DockerとPaserverを使用してLinuxにRAD Studioアプリケーションを展開するためのガイドへようこそ。このリポジトリは、開発環境のセットアップと管理を簡素化するために設計されたDockerスクリプトを提供し、RAD Studio開発者がLinux環境でアプリケーションを展開およびテストできるようにします。

Docker Hubで利用可能なコンテナ
ペーザードキュメント
Rad Studioの詳細
その他のコンテナ：インターベースのみ、RADサーバー、およびインターベース付きRADサーバー

画像は、パスワードsecurepassを使用してポート64211でPaserverを実行するデフォルトです

10.x画像はubuntu 18.04.6 LTS（バイオニックビーバー）を使用し、 +11.x画像はubuntu 22.04.1 LTS（ジャミージェラフィッシュ）を使用します

[ `run.sh` ]スクリプトの使用方法

[ run.sh ]スクリプトは、ペーザーアプリケーションを簡単に柔軟に設定して展開するための自動化ツールです。以下は、このスクリプトを効果的に利用するための指示です。

？前提条件

このスクリプトはPaserverアプリケーションを実行するためにDockerを使用しているため、システムにDockerがインストールされていることを確認します。

？特徴

カスタマイズ可能な名前：ペーザーコンテナに一意の名前を割り当てます。
バインドパス：ボリュームマッピング用のカスタムパスを指定します。
デタッチモード：バックグラウンドでコンテナを実行することを選択します。
ポート構成：Paserverが実行されるポートを選択します。
生産モード：展開のために生産モードをアクティブにします。
バージョン制御：展開用の特定のPaserverバージョンを選択します。
パスワード保護：カスタムパスワードで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

特定のバージョン、バインドパス、およびパスワードを使用して、DeTachモードでPaserverを実行します。

./run.sh --detach --version=12.1 --path=/my/custom/path --password=mysupersecurepassword

注記

run.sh実行するために必要なアクセス許可があることを確認してください。 chmod +x run.sh使用して、必要に応じて実行可能にします。

？ `docker run`を直接使用します

より実践的なアプローチを好むか、展開をさらにカスタマイズしたいユーザーの場合、 docker runコマンドを使用してペーザーコンテナを起動することができます。この方法は柔軟性を提供し、各オプションを手動で指定できます。

コマンド構造

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をmyPAServerという名前のDockerコンテナで実行し、 mysupersecurepasswordのパスワードを使用してポート65000で聴き、デタッチされたモードで実行するには、次のコマンドを使用します。

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 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 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-compose.ymlファイルと.envファイルを読み取るDocker Composeプロセスを開始し、構成を適用して定義どおりにサービスを開始します。

これにより、必要な画像（まだローカルで利用可能でない場合）が引かれ、定義されたボリュームを作成し、環境変数を設定し、指定されたポートでアプリケーションを開始します。

注記

ボリュームバインディングに使用したい実際のパスに、 /path/on/hostを交換することを確認してください。 latestタグは、展開するペーザーの特定のバージョンに置き換えることができます。

Docker画像のカスタマイズ

このガイドは、追加のファイルやフォルダーの追加、追加のパッケージのインストール、その他の変更など、特定のニーズに合わせてPaserver画像をカスタマイズするのに役立ちます。

？ファイルまたはフォルダーの追加

Docker画像にファイルまたはフォルダーを追加するには、 COPYを使用するか、DockerFileに命令ADD 。ローカルファイルをコピーするにはCOPYが推奨されますが、 ADDリモートURLとTAR抽出を処理できます。

例：構成ファイルの追加

 COPY ./myconfig.conf /etc/myapp/myconfig.conf

このコマンドは、Project Directoryからmyconfig.conf /etc/myapp/myconfig.confからDocker画像内にコピーします。

？追加のパッケージのインストール

追加のパッケージをインストールするには、パッケージをインストールするRUNコマンドを変更できます。パッケージインストールコマンドを単一のRUN命令に組み合わせて、Docker画像のレイヤー数を減らすのが最善です。

例：gitとcmakeのインストール

 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画像にコピーしないようにします。
安全な秘密：dockerfileのハードコードに敏感な情報を避けてください。ビルドタイムの秘密と環境変数にビルド引数を使用して、ランタイムシークレットにはDockerの秘密を使用します。