https://github.com/n1215/roadrunner-docker-skeleton
local docker environment skeleton for RoadRunner
https://github.com/n1215/roadrunner-docker-skeleton
docker psr-7 roadrunner
Last synced: about 2 months ago
JSON representation
local docker environment skeleton for RoadRunner
- Host: GitHub
- URL: https://github.com/n1215/roadrunner-docker-skeleton
- Owner: n1215
- Created: 2018-12-26T04:11:54.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-01-14T07:08:37.000Z (over 3 years ago)
- Last Synced: 2026-03-01T19:48:15.361Z (3 months ago)
- Topics: docker, psr-7, roadrunner
- Language: Shell
- Size: 42 KB
- Stars: 92
- Watchers: 4
- Forks: 22
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# roadrunner-docker-skeleton
A local docker environment skeleton for [RoadRunner](https://github.com/roadrunner-server/roadrunner), the PHP application server written in golang.
HTTP Server and PHP Workers are enabled by default.
[](https://packagist.org/packages/n1215/roadrunner-docker-skeleton)
[](https://packagist.org/packages/n1215/roadrunner-docker-skeleton)
[](https://github.com/n1215/roadrunner-docker-skeleton/actions/workflows/build.yml)
## Requirements
- Bash
- Docker Compose
## Install
### via Git
```
git clone https://github.com/n1215/roadrunner-docker-skeleton.git your_app
cd your_app
./task init
```
### via Composer
```
composer create-project --prefer-dist n1215/roadrunner-docker-skeleton your_app
cd your_app
./task init
```
## Commands
### Start the container
```
./task up
# with rebuilding image
# ./task up --build
```
and access http://localhost:8080
### Stop the container
```
./task down
```
### Login into the container
```
./task login
```
### Show container log
```
./task logs
```
### Execute RoadRunner commands
```
./task rr {command}
# ex) ./task rr help
```
## Change RoadRunner version
### 1. change .env file
```
- RR_VERSION=2.x.y
+ RR_VERSION=2.z.w
```
### 2. run the initialization script
rebuild the RoadRunner image and update composer dependencies.
```
./task init
```
## Auto-Reloading
Auto reloading is enabled by default. RoadRunner detects PHP file changes and reload connected services.
To turn off this feature, remove the `reload` section in [.rr.yaml](containers/roadrunner/config/.rr.yaml).
see: [Roadrunner : Auto-Reloading](https://roadrunner.dev/docs/beep-beep-reload)
## Directory structure
- [containers](containers) contains Dockerfile and the config file for RoadRunner.
- [worker.php](worker.php) worker's entry point file