Skip to content

docs: distribution and deployment design doc#176

Closed
henrycgbaker wants to merge 1 commit intomainfrom
docs/distribution-and-deployment
Closed

docs: distribution and deployment design doc#176
henrycgbaker wants to merge 1 commit intomainfrom
docs/distribution-and-deployment

Conversation

@henrycgbaker
Copy link
Copy Markdown
Collaborator

Goal

Add design doc covering how pragmata is distributed and deployed in production. Separated from the annotation stack lifecycle doc (PR #175).

Scope

  • distribution-and-deployment.md — artefact strategy (PyPI primary, container image deferred to v0.2+), per-tool deployment shapes, the case against Docker-outside-of-Docker, persistence/backup, and TLS/reverse-proxy topology for a self-hosted annotation campaign
  • README.md — index entry

Implementation

Design-only PR. No code changes.

Key decisions documented:

  • PyPI package is the primary artefact for v0.1; container image deferred
  • DooD explicitly ruled out - wrong security profile for our deployment shape
  • Escape hatch documented: operators can run the shipped compose file directly without the CLI
  • Argilla port binds to localhost only by default to avoid accidental public exposure

References

Covers artefact strategy (PyPI primary, container deferred to v0.2+),
per-tool deployment shape, the case against DooD, persistence/backup,
and TLS/reverse-proxy topology for a self-hosted annotation campaign.
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.

1 participant