bingo operator

A Juju charm deploying and managing bingo on Kubernetes. bingo is a Go pastebin application that replaces paste.canonical.com.

Like any Juju charm, this charm supports one-line deployment, configuration, integration, scaling, and more. For bingo, this includes:

  • Paste creation and retrieval with configurable expiry

  • Optional OIDC authentication via the Canonical Identity Platform

  • Integration with PostgreSQL for persistent storage

  • Ingress support via Traefik

  • Observability integrations (Prometheus, Grafana, Loki)

The bingo charm allows for deployment on many different Kubernetes platforms, from MicroK8s to Charmed Kubernetes to public cloud Kubernetes offerings.

This charm will make operating bingo straightforward for DevOps or SRE teams through Juju’s clean interface.

In this documentation

Get started

Guided tutorial

Deployment

Set the base URL | Limit paste size | Serve frontend assets

Operations

Configure logging

Security

Overview | Configure OIDC login | Rotate the secret key

How this documentation is organized

This documentation uses the Diátaxis documentation structure.

  • The Tutorial takes you step-by-step through a basic deployment of the bingo charm.

  • How-to guides assume you have basic familiarity with the bingo charm. Learn more about setting up, using, maintaining, and contributing to this charm.

  • Reference provides a guide to actions, configurations, relations, and other technical details.

  • Explanation includes topic overviews, background and context and detailed discussion.

  • Changelog holds all the release history for the charm.

Contributing to this documentation

Documentation is an important part of this project, and we take the same open-source approach to the documentation as the code. As such, we welcome community contributions, suggestions, and constructive feedback on our documentation. See How to contribute for more information.

If there’s a particular area of documentation that you’d like to see that’s missing, please file a bug.

Project and community

The bingo Operator is a member of the Ubuntu family. It’s an open-source project that warmly welcomes community projects, contributions, suggestions, fixes, and constructive feedback.

Governance and policies

Get involved

Thinking about using the bingo Operator for your next project? Get in touch!