An open API service indexing awesome lists of open source software.

https://github.com/hbontempo-br/docker-postgres-hll

Development PostgreSQL images with the HyperLogLog extension
https://github.com/hbontempo-br/docker-postgres-hll

docker hll postgres postgresql

Last synced: about 1 year ago
JSON representation

Development PostgreSQL images with the HyperLogLog extension

Awesome Lists containing this project

README

          

# Docker images with PostgreSQL with HLL extension

Collection of PostgreSQL docker images with the [HLL plugin](https://github.com/citusdata/postgresql-hll) already installed.

:warning: This images is meant for development use :warning:

> **_Images repository_**: https://hub.docker.com/r/hbontempo/postgres-hll

> **_Source code:_** https://github.com/hbontempo-br/docker-postgres-hll

## Tag convention

Pretty simple: `{POSTGRES_IMAGE_VERSION}-v{HLL_VERSION}`, so, for example, if you need a image based postgres:13.8 with HLL version 2.16 installed you should use the `hbontempo/postgres-hll:13.8-v2.16` image.
To use the lastest Postgres and HLL version use the `latest` version.

## How to use this image

Since the image is based on the [official PostgreSQL image](https://hub.docker.com/_/postgres) you can use the exactly same configuration you would you in it. In it's [documentation](https://hub.docker.com/_/postgres) you will find many ways to configure it accordinly to your necesities.

Here is the basic configuration:

### Directly using the `docker` CLI

```shell
$ docker run --name your_name -p 5432:5432 -e POSTGRES_PASSWORD=mysecretpassword -d hbontempo/postgres-hll
```

### Using `docker-compose` or `docker stack deploy`

File `stack.yml`:

```yaml
version: '3.1'

services:

db:
image: hbontempo/postgres-hll
restart: always
environment:
POSTGRES_PASSWORD: mysecretpassword
ports:
- 5432:5432

```

Command:

```shell
$ docker stack deploy -c stack.yml postgres
# OR
$ docker-compose -f stack.yml up
```

## Contributing

Want to contribute? Awesome! You can find information about contributing to this project in the [CONTRIBUTING.md](https://github.com/hbontempo-br/docker-postgres-hll/blob/main/CONTRIBUTING.md)

## Needs help

Just open an [issue](https://github.com/hbontempo-br/docker-postgres-hll/issues) :)