Bahriya Tersane

Overview

Bahriya Tersane is a catalogue of production Helm charts and operators: databases, caches, identity, a container registry, continuous integration and the workload shapes that applications are deployed with. They are the charts that run the managed services on bahriya.cloud, licensed to your organisation for installation on your own premises: infrastructure your organisation controls, including its own accounts with a cloud provider.

Everything in Tersane is installed and upgraded with Helm. Most charts run the service directly, including the failover and maintenance it needs. Where a service is best run by a Kubernetes operator, its chart installs the operator, and the operator then creates and manages each instance of the service; that chart’s documentation describes the resources you create to request one.

The charts are built for the Bahriya Kubernetes Engine and its defaults, and install on any conformant Kubernetes distribution. On a distribution other than BKE, read Running Tersane without BKE before the first installation.

Getting started

  1. Access and credentials: the two credentials your organisation holds, one for charts and one for images.
  2. Installing a chart: adding the repository and installing a release with a values file you keep.
  3. Upgrading a chart: moving a release to a newer chart version, and what an upgrade cannot change.

The charts

Each chart’s page documents its values, its behaviour and the decisions it makes on your behalf. Further pages cover topics such as backup and recovery.

Data

  • mysql: MySQL, standalone or as a highly available cluster
  • postgresql: PostgreSQL
  • cloudnative-pg: CloudNativePG, the operator that runs the PostgreSQL clusters, installed once per cluster
  • valkey: Valkey, standalone, with Sentinel, or sharded
  • memcached: Memcached
  • couchdb: Apache CouchDB, a document database
  • opensearch: OpenSearch, for search and log analytics

Messaging

  • rabbitmq: RabbitMQ, a message broker
  • kafka: Apache Kafka, for event streaming

Identity

  • keycloak: Keycloak, for identity and single sign-on

Registry and CI

  • harbor: Harbor, a container image and chart registry
  • onedev: OneDev, for Git repositories with code review, issues, and container, npm and Maven registries
  • concourse: Concourse, for continuous integration and delivery

Workloads

  • safeena (ship): Web services, with ingress, TLS and autoscaling
  • khadim (servant): Workers and daemons
  • saat (hour): Scheduled jobs
  • sipar-gateway (shield): The gateway for a cluster, installed once per cluster, with address-based access control for TCP clients and a response cache, each behind a switch
  • sipar-route (shield): A library chart, used inside an application’s own chart and never installed on its own, that renders the application’s entry on the cluster’s Sipar gateway, with its access, rate-limit and cache policies; it needs sipar-gateway

Security

  • clamav: ClamAV, as a shared malware scanner in the cluster
  • openbao: OpenBao, for secrets management
  • secrets-store-csi-driver: The Secrets Store CSI driver, which mounts secrets into Pods as files through a provider
  • kyverno: Kyverno, for admission policy
  • policy-reporter: Policy Reporter, a view in the cluster of Kyverno’s policy reports
  • trivy-operator: Trivy Operator, for scanning the images running in the cluster
  • logging: Cluster logs in OpenSearch, with the Kubernetes audit log, dashboards and alerts

Convoys

A convoy is an optional addition installed on top of Tersane, for one industry or one requirement. The Compliance and Assurance Convoy is available, and its chart is documented at compliance. The Banking Convoy, the on-premises installation and upgrade of digital banking applications from specialist vendors, and the Identity Verification Convoy are coming soon. Each convoy’s documentation is published here with its release.