Update README files.

pull/9/head
Alex MacArthur 5 years ago
parent ede23d180d
commit aa18e0bcef

@ -1,23 +1,33 @@
# Local Docker DB # Local Docker DB
## What? ## What?
A collection of Docker Compose files I've used to quickly spin local databases of various sorts. A collection of Docker Compose files I've used to quickly spin local databases of various sorts.
## Why? ## Why?
Because I've oft needed them, particularly when I just don't wanna deal with the hassle of spinning up a DB on my own system. Because I've oft needed them, particularly when I just don't wanna deal with the hassle of spinning up a DB on my own system.
## How? ## How?
Clone the repo or copy a `docker-compose.yml` file to your system, `cd` into that directory, and turn it on with `docker-compose up`. You may also use a `docker-compose.override.yml` file inside this repository to customize a container. For a full reference on how to use Docker Compose, [go here](https://docs.docker.com/compose/reference/). Clone the repo or copy a `docker-compose.yml` file to your system, `cd` into that directory, and turn it on with `docker-compose up`. You may also use a `docker-compose.override.yml` file inside this repository to customize a container. For a full reference on how to use Docker Compose, [go here](https://docs.docker.com/compose/reference/).
## Explore a Container w/ Bash
In any given container, run the following. Most of the time, the service name will just be `db`, but there may be an exception or two.
```
docker-compose exec --user root SERVICE_NAME /bin/bash
```
## Local Persistence ## Local Persistence
In each setup, a managed volume is created to persist each container's data. This volume can be deleted by passing the `-v` option when deleting the container. In each setup, a managed volume is created to persist each container's data. This volume can be deleted by passing the `-v` option when deleting the container.
``` ```
docker-compose down -v docker-compose down -v
``` ```
## Authentication
For authenticating as super user with each of these examples, `root` is the username and `password` is the password.
## Contributions ## Contributions
If you have a Docker Compose configuration for a database not seen here, please consider making a pull request to add it! If you have a Docker Compose configuration for a database not seen here, please consider making a pull request to add it!

@ -1,4 +1,6 @@
# Enter the Container w/ Bash # MariaDB w/ Docker Compose
## Enter the Container w/ Bash
`docker-compose exec --user root db /bin/bash` `docker-compose exec --user root db /bin/bash`
@ -8,7 +10,13 @@
When prompted, enter `password` as the password. When prompted, enter `password` as the password.
# Create a DB ## Super User Authentication
Username: `root`
Password: `password`
## Create a DB
While inside the shell, run the following: While inside the shell, run the following:

@ -1,12 +1,20 @@
# Enter the Container w/ Bash # MongoDB w/ Docker Compose
## Enter the Container w/ Bash
`docker-compose exec --user root db /bin/bash` `docker-compose exec --user root db /bin/bash`
# Enter the Mongo Shell ## Enter the Mongo Shell
`docker-compose exec --user root db mongo` `docker-compose exec --user root db mongo`
# Create a DB w/ User ## Super User Authentication
Username: `root`
Password: `password`
## Create a DB w/ User
While in the shell, run the following: While in the shell, run the following:

@ -1,14 +1,20 @@
# Enter the Container w/ Bash ## Enter the Container w/ Bash
`docker-compose exec --user root db /bin/bash` `docker-compose exec --user root db /bin/bash`
# Enter the MySQL Shell ## Enter the MySQL Shell
`docker-compose exec --user root db mysql -u root -p` `docker-compose exec --user root db mysql -u root -p`
When prompted, enter `password` as the password. When prompted, enter `password` as the password.
# Create a DB ## Super User Authentication
Username: `root`
Password: `password`
## Create a DB
While inside the shell, run the following: While inside the shell, run the following:

@ -1,12 +1,20 @@
# Enter the Container w/ Bash # Postgres w/ Docker Compose
## Enter the Container w/ Bash
`docker-compose exec --user root db /bin/bash` `docker-compose exec --user root db /bin/bash`
# Enter the Postgres Shell ## Enter the Postgres Shell
`docker-compose exec --user root db psql -h localhost -U root` `docker-compose exec --user root db psql -h localhost -U root`
# Create a DB ## Super User Authentication
Username: `root`
Password: `password`
## Create a DB
While inside the shell, run the following: While inside the shell, run the following:

Loading…
Cancel
Save