paserver docker
11.3.0
Bem -vindo ao Guia para implantar aplicativos RAD Studio no Linux usando o Docker e Paserver. Este repositório oferece um script do Docker projetado para simplificar a configuração e o gerenciamento do seu ambiente de desenvolvimento, permitindo que os desenvolvedores de estúdios da RAD implante e testem seus aplicativos em um ambiente Linux.
A imagem é padronizada para a execução do PASERVER na porta 64211 com a senha securepass
As imagens 10.x usam Ubuntu 18.04.6 LTS (Bionic Beaver) Enquanto as imagens +11.x usam o Ubuntu 22.04.1 LTS (Jammy Jellyfish)
run.sh ] O script [ run.sh ] é sua ferramenta de automação preferida para configurar e implantar o aplicativo Paserver com facilidade e flexibilidade. Abaixo estão as instruções para utilizar esse script de maneira eficaz.
Verifique se o docker está instalado no seu sistema, pois este script usa o Docker para executar o aplicativo Paserver.
Navegue até o diretório que contém [ run.sh ] no seu terminal. Execute o script com suas opções preferidas:
./run.sh [OPTIONS]--name ou -n : nome do contêiner (por exemplo, --name=myPAServer ).--path ou -pa : Ligue o caminho para o mapeamento de volume (por exemplo, --path=/my/custom/path ).--detach ou -d : Execute o contêiner no modo de destacar (plano de fundo).--port ou -p : porta para paserver (por exemplo, --port=64211 ).--production ou -pr : Ativar modo de produção ( true ).--version ou -v : Paserver versão (por exemplo, --version=latest ).--password ou -pw : Defina uma senha para Paserver (por exemplo, --password=securepass ).--help ou -h : mostra a ajuda do script.Execute o Paserver no modo de produção na porta 65000 com um nome e senha personalizados:
./run.sh --name=myPAServer --port=65000 --production --password=mysupersecurepasswordExecute o Paserver no modo de destacar com uma versão específica, caminho de ligação e senha:
./run.sh --detach --version=12.1 --path=/my/custom/path --password=mysupersecurepassword Certifique -se de ter as permissões necessárias para executar run.sh . Use chmod +x run.sh para torná -lo executável, se necessário.
docker run diretamente Para usuários que preferem uma abordagem mais prática ou desejam personalizar ainda mais sua implantação, você pode usar diretamente o comando docker run para iniciar seu contêiner Paserver. Este método fornece flexibilidade e permite especificar manualmente cada opção.
A estrutura básica do comando para executar o contêiner Paserver Docker é a seguinte:
docker run [OPTIONS] radstudio/paserver:[VERSION]-e PA_SERVER_PASSWORD=[PASSWORD] : define a senha para o paserver. Substitua [PASSWORD] pela senha desejada.--name [NAME] : Atribui um nome personalizado ao seu contêiner do Docker. Substitua [NAME] pelo nome do contêiner preferido.-p [PORT]:64211 : mapeia uma porta personalizada no seu host para a porta padrão do Paserver (64211). Substitua [PORT] pelo número da porta que você deseja usar.[DETACH_ARG] : Use -d para executar o contêiner no modo desapegado (em segundo plano).[BIND_PATH_ARG] : use -v [HOST_PATH]:[CONTAINER_PATH] para ligar um volume para dados ou configurações persistentes. Substitua [HOST_PATH] e [CONTAINER_PATH] por seus caminhos específicos. Para executar o Paserver em um contêiner do Docker chamado myPAServer , ouvindo na porta 65000, com uma senha do mysupersecurepassword , e executando no modo isolado, você usaria o seguinte comando:
docker run -d
-e PA_SERVER_PASSWORD=mysupersecurepassword
--name myPAServer
-p 65000:64211 radstudio/paserver:latest Se você deseja ligar um volume para dados persistentes, pode adicionar a opção -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 O Docker Compose permite definir e executar aplicativos do Docker multi-container. Aqui está um exemplo de arquivo docker-compose.yml que demonstra como usar uma imagem do Docker como parte de um serviço, utilizando variáveis de ambiente para configuração.
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 Esta configuração define um único serviço chamado myPAServer . Ele usa o Docker Image radstudio/paserver:latest . A configuração do serviço inclui mapear uma porta do host para o contêiner, definir uma variável de ambiente para a senha do servidor e montar um volume do host para o contêiner. Essas configurações são personalizáveis por meio de variáveis de ambiente definidas em um arquivo .env localizado no mesmo diretório que o seu docker-compose.yml .
# .env file
PA_SERVER_PASSWORD=securepass
HOST_PORT=65000
HOST_PATH=/path/on/host
Para iniciar seu aplicativo, execute o seguinte comando no diretório que contém o seu docker-compose.yml :
docker-compose up Este comando inicia o processo de composição do docker, que lê o arquivo docker-compose.yml e o arquivo .env , aplicando as configurações para iniciar seu serviço conforme definido.
Isso puxará a imagem necessária (se ainda não estiver disponível localmente), criará os volumes definidos, defina as variáveis de ambiente e inicie seu aplicativo nas portas especificadas.
Certifique -se de substituir /path/on/host pelo caminho real que você deseja usar para ligação de volume. A tag latest pode ser substituída por qualquer versão específica do Paserver que você deseja implantar.
Este guia o ajudará a personalizar a imagem do Paserver para atender às suas necessidades específicas, como adicionar arquivos ou pastas adicionais, instalar pacotes extras e fazer outras modificações.
Para adicionar arquivos ou pastas à imagem do Docker, use a COPY ou ADD instruções no seu Dockerfile. COPY é preferida para copiar arquivos locais, enquanto ADD pode lidar com URLs remotos e extração de alcatrão.
COPY ./myconfig.conf /etc/myapp/myconfig.conf Este comando copia myconfig.conf do seu diretório de projeto para /etc/myapp/myconfig.conf dentro da imagem do docker.
Para instalar pacotes adicionais, você pode modificar o comando RUN que instala pacotes. É melhor combinar comandos de instalação do pacote em uma única instrução RUN para reduzir o número de camadas na imagem do Docker.
RUN apt-get update && apt-get install -y
git
cmake
&& rm -rf /var/lib/apt/lists/*Com base em cada projeto, bibliotecas específicas podem ser necessárias. Este comando atualiza as listas de pacotes, instala o Git e o CMake e limpa depois para manter o tamanho da imagem baixo.
Para evitar camadas extras na imagem final do Docker, é uma boa prática modificar o comando RUN apt-get update existente para incluir as bibliotecas necessárias.
Você pode personalizar o Dockerfile para alterar variáveis de ambiente, baixar versões diferentes do software ou modificar o processo de instalação.
ENV MY_CUSTOM_VAR=myvalue Isso define uma variável de ambiente MY_CUSTOM_VAR que pode ser usada pelo seu aplicativo.
Depois de personalizar o seu Dockerfile, você pode criar sua imagem do Docker usando o comando docker build .
docker build -t my-custom-paserver:latest . Este comando cria uma imagem do docker chamada my-custom-paserver com a tag latest , usando o Dockerfile no diretório atual.
Para valores que podem mudar entre as compilações (como senhas ou números de versão), você pode usar as instruções ARG no seu Dockerfile e passar valores com a opção --build-arg durante a compilação.
ARG password=securepassConstrua com uma senha personalizada:
docker build --build-arg password=mypassword -t my-custom-paserver:latest .build.sh ] que pode ser usado como modelo para simplificar as compilações personalizadas.linux/amd64 . Para evitar problemas em potencial nas configurações de braço, construa a imagem com o arg --platform linux/amd64RUN única sempre que possível..dockerignore : adicione um arquivo .dockerignore ao seu projeto para evitar copiar arquivos desnecessários na sua imagem do Docker.Este software é Copyright © 2024 da Embarcadero Technologies, Inc.
Você só pode usar este software se for um licenciado autorizado de um produto da Embarcadero Developer Tools. Consulte o contrato de licença de software mais recente para obter atualizações.
