https://github.com/bartekbp/stellar-docker
Dockerized tool for fast database restoration
https://github.com/bartekbp/stellar-docker
docker postgresql stellar
Last synced: 2 months ago
JSON representation
Dockerized tool for fast database restoration
- Host: GitHub
- URL: https://github.com/bartekbp/stellar-docker
- Owner: bartekbp
- License: mit
- Created: 2021-12-29T21:13:41.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2022-01-01T17:52:23.000Z (over 4 years ago)
- Last Synced: 2025-04-13T19:50:23.256Z (about 1 year ago)
- Topics: docker, postgresql, stellar
- Language: Dockerfile
- Homepage:
- Size: 4.88 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Stellar docker - fast database restoration tool in a container
The project aims to simplify using [stellar](https://github.com/fastmonkeys/stellar),
amazing tool accelerating database restoration.
The original project doesn't seem be be maintained anymore, so this projects packages it using docker.
You don't need to worry about incompatible python version dependencies or an interpreter.
### How to use it
1. Create a directory to keep `stellar.yaml` file
2. Run docker image `bartoszpolnik/stellar:latest` with read-write volumen mounted to **/data**
directory inside the container e.g.:
```
docker run -it -v $folderWithStellarYaml:/data bartoszpolnik/stellar:latest init
```
It will prompt `stellar` to create a new configuration. If your database is hosted on `localhost`,
replace hostname with `host.docker.internal`. This will make docker correctly resolve the ip to your host.
4. After the `stellar.yaml` is created, you can execute commands by passing them to the container as follows:
```
docker run -it -v $yourVolumen:/data --sysctl net.ipv4.tcp_keepalive_time=60 bartoszpolnik/stellar:latest $yourCommand$
```
It's important to remember about setting `net.ipv4.tcp_keepalive_time`, otherwise
connection between running in the container `stellar` and database
may be dropped due to inactivity when performing a snapshot.
### Limitations
Image contains only driver for postgresql. Contibutions to add mysql appreciated!
### Special thanks to
- [@fastmonkeys](https://github.com/fastmonkeys/stellar) for creating stellar