Bookstore Guide

Repository: https://github.com/tjkeast/bookstore-microservice-examples

Development

Quick Start

Start all the containers required to run the application.

docker compose up -d

Database

Start the database

docker compose up -d db

Tables

book

Column	Type	Comments
id	int	Primary key
title	varchar(500)
author	varchar(500)
description	text	Nullable
release_date	timestamptz
cover_image_url	varchar(2048)	Nullable

pgAdmin

Start pgAdmin

docker compose up -d pgadmin

Export servers

docker exec -t book-pgadmin /venv/bin/python3 /pgadmin4/setup.py --dump-servers servers.json

Copy exported servers into the project directory

docker cp book-pgadmin:pgadmin4/servers.json ./scripts/pgadmin/servers-export.json

Keycloak

Start Keycloak

docker compose up -d keycloak

Export a realm

docker exec -t book-keycloak sh opt/keycloak/bin/kc.sh export --dir tmp/export --users realm_file --realm local-test

Copy realm export into the project directory

docker cp book-keycloak:tmp/export/local-test-realm.json ./scripts/keycloak/realm-export.json

Kafka

Kafka UI

docker compose up -d kafka-ui

This will start up the kafka-ui client, zookeeper, and one broker.