Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/abn/pulpd
Pulp'd: Pulp in a box
https://github.com/abn/pulpd
Last synced: 7 days ago
JSON representation
Pulp'd: Pulp in a box
- Host: GitHub
- URL: https://github.com/abn/pulpd
- Owner: abn
- License: gpl-2.0
- Created: 2015-06-07T10:36:49.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2015-06-08T13:24:16.000Z (over 9 years ago)
- Last Synced: 2024-11-18T07:50:03.641Z (about 1 month ago)
- Language: Shell
- Size: 145 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Pulp'd: Pulp in a box
This project aims to provide an easier way to deploy multi-container [pulp](http://www.pulpproject.org/). This extends on the great work done by the pulp maintainers working on [Pulp Docker Packaging](https://github.com/pulp/pulp_packaging/tree/master/dockerfiles).
```sh
Usage:
pulpd [options]
Options:
-c, --config Config file to source environment from (default: /etc/pulpd.conf)
-d, --droot The docker root directory to use (default: /var/lib/pulpd/data)
-h, --help Show this help message
Commands:
setup Command to trigger initial setup and spit out boiler-plate config
docker dir
start Start all containers
stop Stop all containers except database and qpid
restart Same as executing stop followed by start
status Show docker ps for pulp containers
- Run command (start|stop|status|restart) for container; where cn
is the container name
shutdown Stop everything
show Show pulpd environment
control Internal control command for advanced usage
pull Pull all imaged (triggers an update for any out dated images)
admin Launch an admin-client container
Container names:
db, qpid, beat, resource_manager, worker, pulpapi, crane
The control command usage:
control start | start-
control stop | stop-
control status | status-
If 'workers' is used all running workers will be affected. For specific worker,
use 'worker'.
To affect all containers; use 'all'.
```
## Quickstart
We assume that you already have pulpd in your `PATH`.
```sh
# create a temporary docker data root
# the default is /var/lib/pulpd/data
mkdir -p ~/pulpd/data
# setup
pulpd -d ~/pulpd/data setup
# start
pulpd -d ~/pulpd/data start
# check status
pulpd -d ~/pulpd/data status
```
For a detailed version of what is happening behind the scenes see [Pulp Docker Registry quickstart guide](https://github.com/pulp/pulp_packaging/blob/master/dockerfiles/docker-quickstart.rst).
## Custom containers
All components can be swapped out with customer container implementations so long as they expect to tbe started as the upstream containers. This can be done by configuring the `IMAGE_` variables in the [pulpd config file](pupld.conf).
For example; one could derrive a custom `IMAGE_HTTPD` container by modifying the [upstream dockerfile](https://github.com/pulp/pulp_packaging/blob/master/dockerfiles/centos/apache/Dockerfile) with modified httpd config files and providing the image name.
Once the image is configured you could do the following to just restart the api.
```sh
pulpd restart-pulpapi
```