Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/holmars/leider
Manages services in Docker for all your local apps
https://github.com/holmars/leider
12-factor-app docker heroku memcached postgresql rabbitmq redis
Last synced: 1 day ago
JSON representation
Manages services in Docker for all your local apps
- Host: GitHub
- URL: https://github.com/holmars/leider
- Owner: holmars
- License: mit
- Created: 2017-03-05T21:42:14.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2020-07-17T16:02:20.000Z (over 4 years ago)
- Last Synced: 2025-01-22T04:39:47.191Z (2 days ago)
- Topics: 12-factor-app, docker, heroku, memcached, postgresql, rabbitmq, redis
- Language: Python
- Homepage:
- Size: 15.6 KB
- Stars: 2
- Watchers: 2
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: HISTORY.txt
- License: LICENSE
Awesome Lists containing this project
README
# Leider
A cli to manage services for apps in `Docker` for local development.
### Services
**PostgreSQL**, **Redis**, **Memcached** and **RabbitMQ**.
### Features
- Manages services in `Docker`.
- Exports connection URLs for your app.
### What is this good for?
- You don't have a Dockerized app (so `docker-compose` is not an option). Think `Heroku`, etc.
- You have some apps that need older versions of `PostgreSQL`, etc.
## Installation
```
$ pip install leider
```
or
```
$ pipx install leider
```
## Usage
Create a `leider.yaml` in your app home. Example:
```
$ cat leider.yaml
db:
image: postgres:9.6-alpine
cache:
image: redis:3.0-alpine
queue:
image: rabbitmq:3-alpine
```
Now you can start using the `Leider` cli.
```
$ leider
Usage: leider [OPTIONS] COMMAND [ARGS]...
Leider manages services in Docker for all your local apps.
Options:
--version Show the version and exit.
--help Show this message and exit.
Commands:
down Stops all or provided services.
reset Reset all or provided services.
status Prints out the status of all services.
up Starts all or provided services.
```
### Examples
```
$ leider up db cache queue
db: postgresql://leider-test:55df62e4e40da94a@localhost:32818/leider-test
cache: redis://localhost:32819/0
queue: amqp://leider-test:a212aa7457bfdcb4@localhost:32821/leider-test
$ leider status
db: running
cache: running
queue: running
$ leider down
db: exited
cache: exited
queue: exited
```
### Advanced
`Leider` keeps track of the `Docker` containers by storing a `yaml` file for each app in `~/.leider`.