Architecture
Overview
Codezero is made up of components that run locally on your developer workstation, in the Kubernetes cluster and a central cloud hosted Hub. The following color code identifies where the sub-components identified below run.
- HUB (orange) is hosted by Codezero.
- TEAMSPACE is the System and Operator (pink) components installed in your cluster.
- The CLI, Desktop App and Daemon are installed and run on your LOCAL development machine.
This diagram defines all the components that make up Codezero:
HUB
The Hub is Codezero's Admin Console, and our central authority that manages Organizations, Users, Roles, Policies and Teamspaces. The Hub is managed by Codezero and is available at https://hub.codezero.io. If you would like to run a self-hosted Hub, for a specific application, please connect: [email protected]
TEAMSPACE
A Teamspace is a vanilla Kubernetes cluster with Codezero installed. A Teamspace consists of a System and an Operator.
System
The System is a Kubernetes controller that manages in-cluster resources that are added or altered depending on developer actions. It gives visibility into all activities happening in the cluster and co-ordinates between Local and In-cluster tunnels.
The System has a single, secure tunnel that is used for Consume and Serve traffic between Local and In-cluster services.
Operator
The Operator manages Serve resources in the Kubernetes cluster.
LOCAL
The local agent is composed of:
- A CLI and Daemon (aka
czctl) - A Desktop App (Codezero.app)
Daemon / CLI
The Daemon runs with root privileges and is:
- A tunnel to the current selected Teamspace
- A secure proxy for client applications (
czctl, Desktop App) to communicate with the current Teamspace
The Daemon executable is generally located at /usr/local/bin/czctl or /opt/homebrew/czctl (depending on install method)
The Daemon is started when you run czctl start or when you start the Codezero Desktop app
Desktop App
The Desktop app provides a GUI for the Service Catalog, Serve and Control sessions, and easy access to Logs. It is a single binary that also contains the CLI and Daemon. It requires root/admin privileges to start the Daemon.