hippofish/docs/downgrade.md

# Downgrading to `v20240206`

## systemd

1. Stop the Firefish service
    ```sh
    sudo systemctl stop your-firefish-service.service
    ```
1. Take a backup
1. Revert database migrations
    ```sh
    sudo --user=postgres psql --file=docs/downgrade.sql --dbname=database_name
    ```

    The database name can be found in `.config/default.yml`.
    ```yaml
    db:
      port: 5432
      db: database_name  # this one
      user: firefish
      pass: password
    ```
1. Switch back to the `v20240206` tag
    ```sh
    git switch v20240206
    ```
1. Rebuild Firefish
    ```sh
    pnpm install --frozen-lockfile
    NODE_ENV='production' NODE_OPTIONS='--max_old_space_size=3072' pnpm run rebuild
    ```
1. Start the Firefish service and confirm that Firefish is downgraded
    ```sh
    sudo systemctl start your-firefish-service.service
    ```

## Docker/Podman

1. Stop the container
    ```sh
    docker-compose down
    # or podman-compose down
    ```
1. Take a backup
1. Revert database migrations
    ```sh
    docker-compose exec db psql --command="$(cat docs/downgrade.sql)" --user=user_name --dbname=database_name
    # or podman-compose exec db psql --command="$(cat docs/revert.sql)" --user=user_name --dbname=database_name
    ```

    The user and database name can be found in `.config/docker.env`.
    ```env
    POSTGRES_PASSWORD=password
    POSTGRES_USER=user_name    # user name
    POSTGRES_DB=database_name  # database name
    ```
1. Change Firefish image tag from `latest` to `v20240206`
    ```sh
    vim docker-compose.yml
    ```

    ```yaml
    version: "3"

    services:
      web:
        image: registry.firefish.dev/firefish/firefish:v20240206  # here
    ```
1. Change database image from `docker.io/groonga/pgroonga` to `docker.io/postgres`

    Please make sure to use the same PostgreSQL version. For example, if you are using `docker.io/groonga/pgroonga:3.1.8-alpine-16`, you should change it to `docker.io/postgres:16-alpine`. PGroonga images are tagged as `{PGroonga version}-{alpine or debian}-{PostgreSQL major version}`. PostgreSQL image tags can be found at <https://hub.docker.com/_/postgres/tags>.
1. Start the container and confirm that Firefish is downgraded
    ```sh
    docker-compose up --detach
    # or podman-compose up --detach
    ```