Skip to content

Adminstration guidelines to migrate to postgresql#103

Merged
sghosh23 merged 8 commits intomainfrom
how-to-migrate-to-postgresql
Apr 8, 2026
Merged

Adminstration guidelines to migrate to postgresql#103
sghosh23 merged 8 commits intomainfrom
how-to-migrate-to-postgresql

Conversation

@sghosh23
Copy link
Copy Markdown
Contributor

Change type

  • Documentation change
  • Build pipeline change
  • Submodule update
  • Deployment change

Basic information

  • THIS CHANGE REQUIRES A WIRE-DOCS RELEASE NOW

Testing

  • I ran/applied the changes myself, in a test environment.

Tracking

  • I mentioned this PR in Jira, OR I mentioned the Jira ticket in this PR.
  • I mentioned this PR in one of the issues attached to one of our repositories.

@sghosh23 sghosh23 requested review from a team as code owners March 13, 2026 13:59
@sghosh23 sghosh23 changed the title add adminstration guidelines to migrate to postgresql Adminstration guidelines to migrate to postgresql Mar 13, 2026
@sghosh23 sghosh23 requested a review from mastaab March 13, 2026 13:59
Comment thread src/how-to/administrate/migrate-to-postgresql.md Outdated
Comment thread src/how-to/administrate/migrate-to-postgresql.md
Comment thread src/how-to/administrate/migrate-to-postgresql.md
Comment thread src/how-to/administrate/migrate-to-postgresql.md
- `error occurred`
- `estimatedRows`

Useful Prometheus metrics:
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We cannot assume they have metrics configured; leave a note pointing to how to pull metrics manually, for those who don't have it (read: everyone!)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Now that you've got a bit more detail here, shouldn't this step be named 'ensuring migration has completed' or somesuch?


After this rollout, the selected domain reads from PostgreSQL only.

## Recommended Domain Order
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

you should recommend the order before giving the instructions.

sghosh23 and others added 2 commits March 31, 2026 16:25
Co-authored-by: Julia Longtin <julia.longtin@gmail.com>
Comment thread src/how-to/administrate/postgresql.md Outdated

`postgresqlPool.size` is a per-pod setting. To estimate how many PostgreSQL connections Wire can open, multiply each service pool size by the number of replicas for that service, then sum the results. In a standard Wire deployment sharing the same PostgreSQL primary, this means at least `brig`, `galley`, and `background-worker`.

Use this formula:
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the english here is a bit.. forceful?

I'd go with something more like <> is set per pod.

@sghosh23 sghosh23 merged commit 2d39e25 into main Apr 8, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants