Namespace: Documentation

Getting started

Namespace is the easiest way to develop, test and deploy application servers on Kubernetes.

With a simple to use interface, similar to Docker Compose, get the same set of features that the best development teams in the world have available to them. Including incremental builds, whole system testing, and production-like development.

Quickstart

Get started with ns, Namespace's CLI, and try out one of our examples.

Docker Compose to Namespace

The same simple to use experience of Docker Compose, with the capabilities of Namespace.

Dependencies can be easy

An introduction to resources. Namespace's unique approach to infrastructure dependency management.

Syntax Reference

Definition of most fields that are user-configurable using CUE.

Examples

The example repository contains multiple example applications that use Namespace. Each example includes multiple versions that incrementally demonstrate various features (e.g secret and resource management).

golang

An API server written in Go application that uses Minio to store data in a S3 bucket.

fastify

A Nodejs web server using Fastify, with Namespace-driven e2e tests.

multi-tier

A multi-tier application: a Vite frontend, a Go API backend, and using Postgres as a persistence layer.

nextjs

A Next.js application that persists data in Postgres.

strapi

Example of packaging an existing complex application: a Strapi backend + a Next.js frontend + a Postgres DB (optional).

Concepts

Namespace operates on an high-level set of primitives, which are used to drive a combination of build, and deployment.

Applications and Servers

Servers encompass the essentials of an application: build plan, containers and networking.

Resources

Resources encapsulate infrastructure dependencies in reusable blocks.

Workspace and Packages

Namespace brings a modern package management approach to infrastructure development.

Deployments

Deployments in Namespace.

Docs coming soon

Integrations

Language and frameworks which are supported out of the box.

Node.js

Multi-platform builds, and fast edit-refresh cycles are supported.

Go

Multi-platform builds, and local Go SDK used for faster builds.

Docker builds

Build using any existing Dockerfile, or write new ones.

Shell script

Write tests and simple resource providers as shell scripts.

Java

Python

Ruby / Rails