Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aa8y/docker-dataset
Docker database images with pre-populated data for testing and/or practice.
https://github.com/aa8y/docker-dataset
alpine databases-populated dataset docker-image dummy lightweight postgresql thin
Last synced: 2 months ago
JSON representation
Docker database images with pre-populated data for testing and/or practice.
- Host: GitHub
- URL: https://github.com/aa8y/docker-dataset
- Owner: aa8y
- Created: 2017-07-19T01:19:24.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-01-22T04:22:40.000Z (almost 6 years ago)
- Last Synced: 2024-06-22T08:35:03.316Z (5 months ago)
- Topics: alpine, databases-populated, dataset, docker-image, dummy, lightweight, postgresql, thin
- Language: Dockerfile
- Homepage: https://hub.docker.com/r/aa8y/postgres-dataset/
- Size: 14.6 KB
- Stars: 36
- Watchers: 3
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Docker Dataset
[](https://travis-ci.org/aa8y/docker-dataset)
Have you ever wanted to access pre-populated databases with dummy but valid data? It can be for something as simple as practicing writing SQL queries to running tests on databases. Under such circumstances, you have to either have to create dummy data or utilize some internet-searching skills to find data to populate your database. I think this is a common enough problem/requirement that solution can be Dockerized for reuse. So here is a Docker image for [PostgreSQL](https://www.postgresql.org/) with databases populated with sample data.
## Datasets
So far we have the following datasets which are being used in the images.
* [Postgres Sample Databases](https://wiki.postgresql.org/wiki/Sample_Databases): The datasets being used from here are `dellstore2` (tagged `dellstore`), `iso3166`, `sportsdb`, `usda` and `world`. pgFoundry has been down for a few days now. Therefore we have switched the URLs to their FTP sources [here](https://www.postgresql.org/ftp/projects/pgFoundry/dbsamples/).
## Databases
The only database supported so far is [PostgreSQL](https://www.postgresql.org/). We use the `alpine` version of the official image as the base image to keep our image slim.
## Tags
Available tags are `dellstore`, `iso3166`, `sportsdb`, `usda`, `world`, `all` and `latest`. `all` and `latest` are the same image with all the datasets in one image. Each of them has been loaded into their own database in the image. The rest of the tags belong to images single datasets.
### `pagila` has been removed
The `pagila` tag has been removed due to the fact that it was broken for a while and it also broke the `all` and `latest` tags. This is because the Pagila dataset we were using had a change which was not compatible with any version of Postgres (See [#1](https://github.com/aa8y/docker-dataset/issues/1) and [this issue](https://github.com/devrimgunduz/pagila/issues/6) for context.
## Usage
You can start the container by running:
```
docker run -d --name pg-ds- aa8y/postgres-dataset:
```
and access it by:
```
docker exec -it pg-ds- psql -d
```
where `` is one of the tags mentioned [here](#tags) and `` is the database name which is one of the dataset names mentioned [here](#datasets). You can also use them with `docker-compose`. See [this example](https://github.com/aa8y/data-dude/blob/master/docker-compose.yml) for information on how to use them.
## Custom images
If you want to build a custom image with not one or all the datasets, but some, then you can do that using:
```
docker build -t aa8y/postgres-dataset:some --build-arg DATASETS=dellstore,world .
```
and then following the same [aforementioned](#usage) steps for using your custom image.
## Future Work
* Images for other popular databases like [MySQL](https://www.mysql.com/).
* Add `french-towns-communes-francais` datasets from [Postgres Sample Databases](https://wiki.postgresql.org/wiki/Sample_Databases).
* Find and add more free data sources.