github.com/plausible-hosting
1
0
Fork 1
mirror of https://github.com/plausible/hosting.git synced 2024-11-17 13:15:58 -06:00
Code Issues Projects Releases Wiki Activity

simplify upgrade-postgres guide

Browse Source
This commit is contained in:
ruslandoga 2023-10-12 20:34:03 +08:00 committed by ruslandoga
parent ba84dc28d2
commit bb6decee4d
1 changed files with 24 additions and 52 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

76
upgrade/postgres.md
View File

@ -6,57 +6,39 @@ Guide to upgrading PostgreSQL version `>= 12` to version `14` using `pg_dump` an
### Plan ### Plan
1. dump contents of the old version PostgreSQL to a file in a mounted volume 1. dump contents of the old version PostgreSQL to a file
1. copy the dump to the host
1. replace old version PostgreSQL with new version PostgreSQL 1. replace old version PostgreSQL with new version PostgreSQL
1. load dump from the mounted volume into new version PostgreSQL 1. copy and load the dump into new version PostgreSQL
--- ---
### Steps ### Steps
1. Add a backup volume to `plausible_db` in your `docker-compose.yml` 1. Stop `plausible` to avoid writing to old `plausible_db`
```diff
plausible_db:
image: postgres:12
restart: always
volumes:
- db-data:/var/lib/postgresql/data
+ - ./backup:/backup
environment:
- POSTGRES_PASSWORD=postgres
```
2. Stop relevant containers to avoid writing to old `plausible_db`
```console ```console
> docker compose stop plausible plausible_db > docker compose stop plausible
[+] Running 2/2 [+] Running 2/2
⠿ Container hosting-plausible-1 Stopped 6.5s ⠿ Container hosting-plausible-1 Stopped 6.5s
⠿ Container hosting-plausible_db-1 Stopped 0.2s
``` ```
3. Restart `plausible_db` container to attach volume 2. Dump old `plausible_db` contents to a backup file
```console ```console
> docker compose up plausible_db -d > docker compose exec plausible_db sh -c "pg_dump -U postgres plausible_db > plausible_db.bak"
[+] Running 1/1
⠿ Container hosting-plausible_db-1 Started 0.3s
``` ```
4. Dump old `plausible_db` contents to a backup file 3. Copy the backup to the host
```console ```console
> docker compose exec plausible_db sh -c "pg_dump -U postgres plausible_db > /backup/plausible_db.bak" > docker compose cp plausible_db:plausible_db.bak plausible_db.bak
``` ```
5. (Optional) verify backup went OK 4. (Optional) verify backup went OK
```console ```console
> ls backup > head plausible_db.bak
plausible_db.bak
> head backup/plausible_db.bak
-- --
-- PostgreSQL database dump -- PostgreSQL database dump
-- --
@ -69,7 +51,7 @@ SET lock_timeout = 0;
SET idle_in_transaction_session_timeout = 0; SET idle_in_transaction_session_timeout = 0;
``` ```
6. Edit `docker-compose.yml` to use new PostgreSQL version, here we update from `v12` to `v14`, alpine flavour. 5. Edit `docker-compose.yml` to use new PostgreSQL version, here we update from `v12` to `v14`, alpine flavour.
```diff ```diff
plausible_db: plausible_db:
@ -78,12 +60,11 @@ SET idle_in_transaction_session_timeout = 0;
restart: always restart: always
volumes: volumes:
- db-data:/var/lib/postgresql/data - db-data:/var/lib/postgresql/data
- ./backup:/backup
environment: environment:
- POSTGRES_PASSWORD=postgres - POSTGRES_PASSWORD=postgres
``` ```
7. Ensure relevant containers are stopped 6. Ensure relevant containers are stopped
```console ```console
> docker compose stop plausible plausible_db > docker compose stop plausible plausible_db
@ -92,7 +73,7 @@ SET idle_in_transaction_session_timeout = 0;
⠿ Container hosting-plausible_db-1 Stopped 0.2s ⠿ Container hosting-plausible_db-1 Stopped 0.2s
``` ```
8. Remove old `plausible_db` container to be able to nuke its volume in the next step 7. Remove old `plausible_db` container to be able to nuke its volume in the next step
```console ```console
> docker compose rm plausible_db > docker compose rm plausible_db
@ -101,7 +82,7 @@ SET idle_in_transaction_session_timeout = 0;
⠿ Container hosting-plausible_db-1 Removed 0.0s ⠿ Container hosting-plausible_db-1 Removed 0.0s
``` ```
9. Remove old `plausible_db` volume, mine is named `hosting_db-data` 8. Remove old `plausible_db` volume, mine is named `hosting_db-data`
```console ```console
> docker volume ls > docker volume ls
@ -115,7 +96,7 @@ local hosting_event-data
hosting_db-data hosting_db-data
``` ```
10. Start new version `plausible_db` container 9. Start new version `plausible_db` container
```console ```console
> docker compose up plausible_db -d > docker compose up plausible_db -d
@ -134,12 +115,13 @@ hosting_db-data
⠿ Container hosting-plausible_db-1 Started 0.5s ⠿ Container hosting-plausible_db-1 Started 0.5s
``` ```
11. Create new DB and load data into it 10. Create new DB and load data into it
```console ```console
> docker compose exec plausible_db createdb -U postgres plausible_db > docker compose exec plausible_db createdb -U postgres plausible_db
> docker compose cp plausible_db.bak plausible_db:plausible_db.bak
> docker compose exec plausible_db sh -c "psql -U postgres -d plausible_db < /backup/plausible_db.bak" > docker compose exec plausible_db sh -c "psql -U postgres -d plausible_db < plausible_db.bak"
SET SET
SET SET
SET SET
@ -158,7 +140,7 @@ CREATE EXTENSION
<...snip...> <...snip...>
``` ```
12. Start all other containers 11. Start all other containers
```console ```console
> docker compose up -d > docker compose up -d
@ -169,19 +151,9 @@ CREATE EXTENSION
⠿ Container hosting-plausible-1 Started 0.5s ⠿ Container hosting-plausible-1 Started 0.5s
``` ```
13. (Optional) Remove backups from `docker-compose.yml` and your filesystem 12. (Optional) Remove backups from the container and the host
```diff ```console
plausible_db: > rm plausible_db.bak
image: postgres:14-alpine > docker compose exec plausible_db rm plausible_db.bak
restart: always
volumes:
- db-data:/var/lib/postgresql/data
- - ./backup:/backup
environment:
- POSTGRES_PASSWORD=postgres
```
```
> rm -rf ./backup
``` ```