Skip to main content

Teamspace Setup

Teamspaces are vanilla Kubernetes clusters with Codezero installed. The following guide will step you through registering a Teamspace and certifying it for development use. This should take about 10 minutes to complete.

Create a Codezero Hub Account​

Sign up or log in to the Codezero Hub. The onboarding wizard will guide you through creating an Organization and your first Teamspace.

The Hub allows you to manage your organization, invite and administer members, and register and certify Teamspaces. You can always return to your organization and list of Teamspaces by going to the Profile menu at the top right corner of the screen.

While the Hub provides a graphical user interface equivalent to the czctl command line tool, all services run on your local machine or in the Kubernetes cluster.

Install the Space Agent in your Cluster​

To install Codezero from your terminal, you will need:

  • Access to the cluster (i.e. kubeconfig)
  • helm and kubectl installed, and
  • Your current context set to the correct cluster

On the Profile menu, click Settings and then select the Teamspaces tab. Click Add Teamspace to create the installation command.

Teamspace Create

To use this command copy to your clipboard using the copy button on the right side of the screen. After doing that press the Done button.

This install command contains your organization's API key. Please keep it confidential. It uses Helm to install the Codezero Space Agent. You can find the Helm charts on Codezero's GitHub.

Now paste the command into your terminal and wait for Codezero to be installed and started.

note

Additional annotations may be necessary; refer to our Codezero Helm Chart documentation and the section on Load balancer requirements below.

LoadBalancer requirements​

The Codezero helm chart deploys a Kubernetes service of type LoadBalancer. For Codezero to function properly the provisioned load balancer requires a public ip address and must work on OSI layer 4.

By default AWS EKS uses classic load balancers for a Kubernetes service of type LoadBalancer. In this case no additional setup is required.

However when using AWS Load Balancer Controller additional annotations need to be set on Codezero's load balancer service. This can be done via the helm chart by adding the following values:

lb:
    service:
        annotations:
            service.beta.kubernetes.io/aws-load-balancer-type: "external"
            service.beta.kubernetes.io/aws-load-balancer-nlb-target-type: "ip"
            service.beta.kubernetes.io/aws-load-balancer-scheme: "internet-facing"

TeamSpace Certification​

The Codezero SpaceAgent installs into the codezero namespace and should take less than a minute to start depending on how long it takes to provision a LoadBalancer pod and service. The codezero loadbalancer service will be ready but the cloud loadbalancer may need minutes to be fully available.

info

For example, with AWS, the kubernetes loadbalancer service will show the AWS NLB (Network Load Balancer) hostname and codezero hub will show the space as ready and certified. However, the AWS NLB can still be in a provisioning state and network access will only work once it is fully provisioned, which can take up to 5+ minutes.

You can view the codezero pods and services using the following:

kubectl get pods,svc -n codezero

NAME                                READY   STATUS    RESTARTS   AGE
pod/loadbalancer-556d54fb4-qx6w4    1/1     Running   0          9d
pod/operator-86b9d856cb-ktqcj       1/1     Running   0          9d
pod/spaceagent-5cb47f595b-m8ppw     1/1     Running   0          9d

NAME                   TYPE           CLUSTER-IP     EXTERNAL-IP     PORT(S)                         AGE
service/codezero       LoadBalancer   10.43.95.152   xxx.x.xxx.xxx   8800:31420/TCP                  13d
service/spaceagent     ClusterIP      10.43.9.204    <none>          8800/TCP                        13d

Once the Codezero Loadbalancer pod is ready, you should see the Certification column at hub.codezero.io/settings/spaces change to Certified and shortly thereafter, you should see an IP address (or Host Name) show up under DNS. Your Teamspace is ready for use.

Certification ensures secure communications between the Codezero SpaceAgent in your cluster and the Hub (the Codezero Admin Console).

Teamspace Install

To select your Teamspace you have two options:

  • Desktop App: click on the menu (or tray) icon and then select Teamspaces > your_teamspace. Open the Service Catalog and you should see your list of services in the Teamspace for your cluster.

    Select Teamspace

    Select Teamspace

  • CLI: in the terminal run the following command to select from available Teamspaces

czctl space select

Uninstalling Codezero SpaceAgent​

Codezero's SpaceAgent may be removed from the Kubernetes cluster at any time. It is recommended that you close all Consume and Serve sessions before you begin the uninstallation.

To uninstall, run:

helm -n codezero uninstall codezero

You can then go into the Hub and delete the Teamspace.