mirror of https://github.com/PokeAPI/pokeapi synced 2024-11-10 06:04:18 +00:00

History

Naramsim b51950d60c revert: add back cargo and rust, drop LE		2024-05-04 23:02:06 +02:00
..
Dockerfile	revert: add back cargo and rust, drop LE	2024-05-04 23:02:06 +02:00
README.md	docs: update docker hub page	2023-01-09 16:45:47 +01:00

README.md

Quick reference

Maintained by: the PokeAPI Contributors
Where to get help: PokeAPI Slack.
Where to file issues: https://github.com/PokeAPI/pokeapi/issues
Source of this description: pokeapi repo's Resources/docker/app/ directory

Supported tags and respective `Dockerfile` links

pokeapi uses python:3.10-alpine as base image.

What is PokeAPI?

PokeAPI is a full RESTful API linked to an extensive database detailing everything about the Pokémon main game series.

pokeapi.co

How to use this image

This container connects to a Postgres database via the environment variables POSTGRES_DB, POSTGRES_USER, POSTGRES_PASSWORD, POSTGRES_HOST, POSTGRES_PORT.

The container connects to a Redis cache via the environment variable REDIS_CONNECTION_STRING.

Run the container

The container exposes port 80. It needs a PostgreSQL and a Redis instance to connect to. Refer to the section How to use this image for mapping the environment variables.

It's recommended to use the provided docker-compose.yml to start a container from this image.

Build the data

Pokémon data isn't automatically present in this image. All Pokémon data is persisted in a PostgreSQL database and thus needs to be built.

When the container is up and running, run the following shell commands:

docker exec pokeapi python manage.py migrate --settings=config.docker-compose
docker exec pokeapi sh -c 'echo "from data.v2.build import build_all; build_all()" | python manage.py shell --settings=config.docker-compose'