Skip to content


This is a reference design and implementation of an environment template to provision self service developer environments within a workspace. This reference design is based on Rafay's Kubernetes Manager and Environment Manager.

Source Code for Template

The Terraform source code and related assets are available in a public Git repo as shown below

Git Repo

Design & Architecture

This design assumes a single, shared cluster with a Rafay workspace that will be created and assigned to the developer for their applications.


Initial Setup

The platform team is expected to provision the Kubernetes cluster in a Rafay project. The cluster will be shared with developers via Rafay Workspaces.

    participant plat as Platform Team 
    participant rafay as Environment Manager 
    participant idp as Identity Provider 

    plat->>rafay: Setup Environment Template
    rafay->>idp: Integrate Env Manager <br> with Corporate IdP  
    rafay-->>plat: Setup Complete 

Request for Environment

When a developer requests a workspace via self service, a series of automated workflows need to be performed to fulfil this request. The sequence diagram below describes the high level steps.


Although the recommended workflow assumes and recommends using an Integration with an Identity Provider (IdP) to provide a Single Sign On (SSO) experience, organizations can also use locally managed users.

    participant dev as Developer
    participant rafay as Rafay
    participant csp as Host <br> Cluster
    participant idp as Identity Provider 

    dev->>rafay: New Workspace <br>based Environment
    rect rgba(0, 0, 255, .1)
    rafay-->>csp: Create Rafay Workspace w/ Resource Quota etc. 
    opt SSO via Identity Provider
        rafay-->>idp: Create Group for the workspace
        rafay-->>idp: Add developer to Group 
    rafay->>rafay: Create Group in Rafay
    rafay->>rafay: Add Workspace Admin <br>Role to Group
    rafay->>dev: Environment Ready
    dev-->>rafay: Access/Use Workspace 


  • You have an existing managed kubernetes cluster in Rafay Kubernetes Manager
  • You have access to a Mac or Linux machine
  • You have a Git client on your machine that is setup for push/pull
  • You have Docker installed on your machine