This repository contains runnable examples of Howso Platform installations, in various configurations, predominantly based on the use of Helm charts.
Howso Platform is a Kubernetes-based application that consists of many services, it is available as a Helm chart install, depending on data stores and a message queue that can also be deployed as charts.
The Howso Platform is distributed as a Replicated application. Replicated is a Kubernetes application distribution platform that facilitates self-hosted installation of Kubernetes applications. This documentation will mostly cover accessing the application as Replicated hosted Helm charts.
Helm modularizes Kubernetes manifests into charts, which can be installed, upgraded, and uninstalled as a single entity. It includes a straightforward method for templating out certain values, to make it simple to configure the application.
The Howso Platform relies on data stores, such as Postgres, Redis, an S3-compatible object store (Minio), and a message queue (NATS). These requirements can themselves be deployed as Helm charts. The documentation will use commonly available charts for these dependencies. These public charts are configurable and mature enough to provide a range from simple tests to scaled production configurations.
The Howso Platform chart is designed to work together well with the dependent Helm charts for Redis, PostgreSQL, MinIO, and NATS, in an (almost) default configuration. Except for some small changes (i.e. enabling JetStream in NATS), these charts require minimal setup for a quick start. This interoperability facilitates an easy and efficient initial deployment of the Howso Platform.
In the basic examples, this type of configuration will be demonstrated. It is recommended to start with this configuration before more complex arrangements.
While the default configurations are suitable for a quick start and testing purposes, they are not intended for hardened, production-level deployments. Key aspects such as air-gapping (deploying to environments with no internet access), securing communication tunnels, adhering to OpenShift policies, and scaling, all require additional configuration.
Though not exhaustive, the included air-gap and OpenShift examples will demonstrate how some more complex configurations can be achieved.
Securing the Howso Platform is discussed in the security section. This includes the use of Service Mesh, Network Policies, and other security topics.
The examples should work in any Kubernetes cluster, but for simple local installation demonstrations, k3d has been used. Check out the prereqs for more details.
When running commands, all paths are relative to the root of this repository.
Note: Following the examples directly, you will end up with files (such as
howso.ymlor local platform certs) under the repo root, those have been added to the.gitignorefile, so you won't see those files in your git status.
MinIO is used as the default S3 object store with the Howso Platform. For production deployments ensure you have a valid license for MinIO. MinIO, under the AGPL license, is included with Howso Inc.'s OEM license for commercial Howso Platform deployments, covering usage up to 1 terabyte.