Skip to main content


Cluster is the component of Common in charge of providing a company-wide Kubernetes Cluster.

Public Oath

  1. There is a Kubernetes cluster with name common in the us-east-1 region.
    • It has namespaces called dev and prod_integrates, and a role with the same name can access resources within it.
    • It is able to spawn enough machine instances as you request.


  1. We have one Kubernetes cluster that is shared by all the components.
  2. The cluster is hosted by EKS by Amazon Web Services (AWS).
  3. The cluster is divided into namespaces, which keep resources in isolation from other namespaces.
    • The default namespace is unused, we try to put things into a namespace appropriate to the product.
    • The dev namespace currently holds the ephemeral environments of Integrates.
    • The prod-integrates namespace holds the production deployment of Integrates, and a Celery jobs server.
    • The kube-system namespace holds cluster-wide deployments for New Relic, DNS, the load balancer, and the auto-scaler,
    • Other kube-* namespaces exist, but they are not used for anything at the moment.
  4. Every namespace runs in a specific worker group whose physical machine instances run on EC2 by Amazon Web Services (AWS).
  5. The cluster spawns machine instances on many subnets (prefixed with k8s_) in different availability zones.

You can right-click on the image below to open it in a new tab, or save it to your computer.

Architecture of Common's /cluster


Please read the contributing page first.