From 09d51cf838b1eef3ed5e4e3e6c82e2d1588f70eb Mon Sep 17 00:00:00 2001
From: naskya <m@naskya.net>
Date: Tue, 19 Mar 2024 01:21:01 +0900
Subject: [PATCH] container: use fixed PGroonga version

---
 docker-compose.example.yml | 2 +-
 docs/notice-for-admins.md  | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/docker-compose.example.yml b/docker-compose.example.yml
index aaad55a158..fc6c0268a2 100644
--- a/docker-compose.example.yml
+++ b/docker-compose.example.yml
@@ -52,7 +52,7 @@ services:
 
   db:
     restart: unless-stopped
-    image: docker.io/groonga/pgroonga:latest-alpine-16-slim
+    image: docker.io/groonga/pgroonga:3.1.8-alpine-16-slim
     container_name: firefish_db
     networks:
       - calcnet
diff --git a/docs/notice-for-admins.md b/docs/notice-for-admins.md
index f763bf02ae..ff83668779 100644
--- a/docs/notice-for-admins.md
+++ b/docs/notice-for-admins.md
@@ -74,14 +74,14 @@ db:
 
 Please edit your `docker-compose.yml` to replace the database container image from `docker.io/postgres` to `docker.io/groonga/pgroonga`.
 
-Please make sure to use the same PostgreSQL version. If you are using `docker.io/postgres:16-alpine` (PostgreSQL v16), the corresponding image tag is `docker.io/groonga/pgroonga:latest-alpine-16` (or `docker.io/groonga/pgroonga:latest-alpine-16-slim`).
+The list of tags can be found on <https://hub.docker.com/r/groonga/pgroonga/tags>. Tags are named as `{PGroonga version}-{alpine or debian}-{PostgreSQL major version}`.
 
-The list of tags can be found on <https://hub.docker.com/r/groonga/pgroonga/tags>.
+Please make sure to use the same PostgreSQL version. If you are using `docker.io/postgres:16-alpine` (PostgreSQL v16), the corresponding image is `docker.io/groonga/pgroonga:3.1.8-alpine-16` (or `docker.io/groonga/pgroonga:3.1.8-alpine-16-slim`). There are also tags called `latest-alpine-16` and `latest-alpine-16-slim`, but please be careful if you use these tags since [PGroonga may introduce breaking changes](https://pgroonga.github.io/upgrade/), similar to PostgreSQL.
 
 ```yaml
 db:
   restart: unless-stopped
-  image: docker.io/groonga/pgroonga:latest-alpine-16-slim  # change here
+  image: docker.io/groonga/pgroonga:3.1.8-alpine-16-slim  # change here
   container_name: firefish_db
 ```