Before you begin

Before getting into the installation process, review the following prerequisites:

  • Kubernetes compatibility

  • DNS entry format

  • PSP requirements

  • Minimum machine requirements

1. Compatible Kubernetes versions

This version of the Saagie installer is compatible with Kubernetes versions 1.19.

2. Determine DNS entry

Your DNS entry must follow this pattern: prefix-suffix[.subdomain].domain.com. The entire entry must respect DNS norms according to RFC-1034.

You will not create your DNS zone until the end of the installation process.
Table 1. DNS entry components
Component Details Example

prefix
Required

12 characters maximum.
Only letters and numbers are allowed (no hyphens or special characters).

We strongly suggest to use your company name or a shortened version of your company name.

dunder

suffix
Required

For Saagie to function properly, your DNS entry must contain a suffix.

workspace

domain
Required

Company’s domain to which your Saagie platform will be connected.

dundermifflin.com

URL: dunder-workspace.dundermifflin.com

subdomain
Optional

Allowed as many subdomains after prefix-suffix as needed or as your company’s policy requires.

paper

URL with subdomain: dunder-workspace.paper.dundermifflin.com

3. PSP requirements

Saagie deployment requires two Pod Security Policies (PSP).

The admission controller can be enabled or disabled:

Table 2. PSP admission controller
Status Details

Disabled

No effect on your cluster.

Enabled now

Saagie will run as expected.

Enabled later

Will not prevent Saagie from running as expected.

PSPs are applied to a Service Account through a ClusterRole and the related ClusterRoleBinding. PSPs and the related ClusterRole and ClusterRoleBinding are provided in the requirements.yml file that will be created later in the installation process.

4. Minimum machine requirements

Regardless of your cloud provider, you must meet these minimum machine requirements:

  • 3 nodes

  • 4 vCPU per node

  • 16 GB RAM per node

  • 300 GB distributed disk storage