215

What is considered a good practice with K8S for managing multiple environments (QA, Staging, Production, Dev, etc)?

As an example, say that a team is working on a product which requires deploying a few APIs, along with a front-end application. Usually, this will require at least 2 environments:

  • Staging: For iterations/testing and validation before releasing to the client
  • Production: This the environment the client has access to. Should contain stable and well-tested features.

So, assuming the team is using Kubernetes, what would be a good practice to host these environments? This far we've considered two options:

  1. Use a K8s cluster for each environment
  2. Use only one K8s cluster and keep them in different namespaces.

(1) Seems the safest options since it minimizes the risks of potential human mistake and machine failures, that could put the production environment in danger. However, this comes with the cost of more master machines and also the cost of more infrastructure management.

(2) Looks like it simplifies infrastructure and deployment management because there is one single cluster but it raises a few questions like:

  • How does one make sure that a human mistake might impact the production environment?
  • How does one make sure that a high load in the staging environment won't cause a loss of performance in the production environment?

There might be some other concerns, so I'm reaching out to the K8s community on StackOverflow to have a better understanding of how people are dealing with these sort of challenges.

4
  • 8
    How did you end up doing this? Please could you let us know... I am also learning and trying to work out the best way. Sounds like setting up separate clusters is probably the right way to go...
    – Piotr Kula
    Nov 27, 2018 at 9:29
  • 8
    We ended up having two clusters, one for staging and another one for production. There is an extra management over head from an infrastructure point of view but in our case the isolation level was worth it.
    – Yoanis Gil
    Nov 30, 2018 at 13:28
  • 1
    @YoanisGil is there an answer here you can mark as accepted?
    – tdensmore
    Dec 10, 2019 at 17:28
  • 4
    @tdensmore most answers are good in their own way. The thing is, there is just not one answer and it depends on the use case in question. I think K8s and its community have matured a lot since I first asked this question (almost 3 years now) and there seems to be at least some minimal best practices that one could apply, regardless of how many clusters are used and for what purpose (I'm thinking namespaces, network policies, node selectors, seccomp, etc).
    – Yoanis Gil
    Dec 11, 2019 at 18:43

9 Answers 9

65

Multiple Clusters Considerations

Take a look at this blog post from Vadim Eisenberg (IBM / Istio): Checklist: pros and cons of using multiple Kubernetes clusters, and how to distribute workloads between them.

I'd like to highlight some of the pros/cons:

Reasons to have multiple clusters

  • Separation of production/development/test: especially for testing a new version of Kubernetes, of a service mesh, of other cluster software
  • Compliance: according to some regulations some applications must run in separate clusters/separate VPNs
  • Better isolation for security
  • Cloud/on-prem: to split the load between on-premise services

Reasons to have a single cluster

  • Reduce setup, maintenance and administration overhead
  • Improve utilization
  • Cost reduction

Considering a not too expensive environment, with average maintenance, and yet still ensuring security isolation for production applications, I would recommend:

  • 1 cluster for DEV and STAGING (separated by namespaces, maybe even isolated, using Network Policies, like in Calico)
  • 1 cluster for PROD

Environment Parity

It's a good practice to keep development, staging, and production as similar as possible:

Differences between backing services mean that tiny incompatibilities crop up, causing code that worked and passed tests in development or staging to fail in production. These types of errors create friction that disincentivizes continuous deployment.

Combine a powerful CI/CD tool with helm. You can use the flexibility of helm values to set default configurations, just overriding the configs that differ from an environment to another.

GitLab CI/CD with AutoDevops has a powerful integration with Kubernetes, which allows you to manage multiple Kubernetes clusters already with helm support.

Managing multiple clusters (kubectl interactions)

When you are working with multiple Kubernetes clusters, it’s easy to mess up with contexts and run kubectl in the wrong cluster. Beyond that, Kubernetes has restrictions for versioning mismatch between the client (kubectl) and server (kubernetes master), so running commands in the right context does not mean running the right client version.

To overcome this:

  • Use asdf to manage multiple kubectl versions
  • Set the KUBECONFIG env var to change between multiple kubeconfig files
  • Use kube-ps1 to keep track of your current context/namespace
  • Use kubectx and kubens to change fast between clusters/namespaces
  • Use aliases to combine them all together

I have an article that exemplifies how to accomplish this: Using different kubectl versions with multiple Kubernetes clusters

I also recommend the following reads:

1
  • 1
    Is it possible to handle multiple configurations without using Helm? kubectl doesn't have a way to compose configuration files (for example to override the differences between dev/prod)?
    – cglacet
    Feb 23, 2021 at 16:31
29

Definitely use a separate cluster for development and creating docker images so that your staging/production clusters can be locked down security wise. Whether you use separate clusters for staging + production is up to you to decide based on risk/cost - certainly keeping them separate will help avoid staging affecting production.

I'd also highly recommend using GitOps to promote versions of your apps between your environments.

To minimise human error I also recommend you look into automating as much as you can for your CI/CD and promotion.

Here's a demo of how to automate CI/CD with multiple environments on Kubernetes using GitOps for promotion between environments and Preview Environments on Pull Requests which was done live on GKE though Jenkins X supports most kubernetes clusters

2
  • 1
    link seems to be broken
    – Tibin
    Apr 20, 2020 at 20:56
  • I believe that this is the talk in question, though I've not edited the original answer in case I'm wrong! youtube.com/watch?v=BF3MhFjvBTU
    – Sean
    Sep 10, 2020 at 20:26
24

It depends on what you want to test in each of the scenarios. In general I would try to avoid running test scenarios on the production cluster to avoid unnecessary side effects (performance impact, etc.).

If your intention is testing with a staging system that exactly mimics the production system I would recommend firing up an exact replica of the complete cluster and shut it down after you're done testing and move the deployments to production.

If your purpose is testing a staging system that allows testing the application to deploy I would run a smaller staging cluster permanently and update the deployments (with also a scaled down version of the deployments) as required for continuous testing.

To control the different clusters I prefer having a separate ci/cd machine that is not part of the cluster but used for firing up and shutting down clusters as well as performing deployment work, initiating tests, etc. This allows to set up and shut down clusters as part of automated testing scenarios.

2
11

It's clear that by keeping the production cluster appart from the staging one, the risk of potential errors impacting the production services is reduced. However this comes at a cost of more infrastructure/configuration management, since it requires at least:

  • at least 3 masters for the production cluster and at least one master for the staging one
  • 2 Kubectl config files to be added to the CI/CD system

Let’s also not forget that there could be more than one environment. For example I've worked at companies where there are at least 3 environments:

  • QA: This where we did daily deploys and where we did our internal QA before releasing to the client)
  • Client QA: This where we deployed before deploying to production so that the client could validate the environment before releasing to production)
  • Production: This where production services are deployed.

I think ephemeral/on-demand clusters makes sense but only for certain use cases (load/performance testing or very « big » integration/end-to-end testing) but for more persistent/sticky environments I see an overhead that might be reduced by running them within a single cluster.

I guess I wanted to reach out to the k8s community to see what patterns are used for such scenarios like the ones I've described.

1
  • why do you need ` at least one master for the staging one`? do you mean to use micro-kubernetes like k3s? I upvoted you Jul 3, 2021 at 7:28
11

Unless compliance or other requirements dictate otherwise, I favor a single cluster for all environments. With this approach, attention points are:

  • Make sure you also group nodes per environment using labels. You can then use the nodeSelector on resources to ensure that they are running on specific nodes. This will reduce the chances of (excess) resource consumption spilling over between environments.

  • Treat your namespaces as subnets and forbid all egress/ingress traffic by default. See https://kubernetes.io/docs/concepts/services-networking/network-policies/.

  • Have a strategy for managing service accounts. ClusterRoleBindings imply something different if a clusters hosts more than one environment.

  • Use scrutiny when using tools like Helm. Some charts blatantly install service accounts with cluster-wide permissions, but permissions to service accounts should be limited to the environment they are in.

1
  • How can you plan for cluster upgradation failure?
    – Tibin
    May 28, 2020 at 9:52
6

I think there is a middle point. I am working with eks and node groups. The master is managed, scaled and maintained by aws. You could then create 3 kinds of node groups (just an example):

1 - General Purpose -> labels: environment=general-purpose

2 - Staging -> labels: environment=staging (taints if necessary)

3 - Prod -> labels: environment=production (taints if necessary)

You can use tolerations and node selectors on the pods so they are placed where they are supposed to be.

This allows you to use more robust or powerful nodes for production's nodegroups, and, for example, SPOT instances for staging, uat, qa, etc... and has a couple of big upsides:

  • Environments are physically separated (and virtually too, in namespaces)
  • You can reduce costs by sharing not only the masters, but also some nodes with pods shared by the two environments and by using spot or cheaper instances in staging/uat/...
  • No cluster-management overheads

You have to pay attention to roles and policies to keep it secure. You can implement network policies using, for example eks+calico.

Update:

I found a doc that may be useful when using EKS. It has some details on how to safely run multi-tenant cluster, and some of this details may be useful to isolate production pods and namespaces from the ones in staging.

https://aws.github.io/aws-eks-best-practices/security/docs/multitenancy/

4

Using multiple clusters is the norm, at the very least to enforce a strong separation between production and "non-production".

In that spirit, do note that GitLab 13.2 (July 2020) now includes:

Multiple Kubernetes cluster deployment in Core

Using GitLab to deploy multiple Kubernetes clusters with GitLab previously required a Premium license.
Our community spoke, and we listened: deploying to multiple clusters is useful even for individual contributors.
Based on your feedback, starting in GitLab 13.2, you can deploy to multiple group and project clusters in Core.

https://about.gitlab.com/images/13_2/MultipleProjectClusters.png

See documentation and issue.

4

A few thoughts here:

  1. Do not trust namespaces to protect the cluster from catastrophe. Having separate production and non-prod (dev,stage,test,etc) clusters is the minimum necessary requirement. Noisy neighbors have been known to bring down entire clusters.

  2. Separate repositories for code and k8s deployments (Helm, Kustomize, etc.) will make best practices like trunk-based development and feature-flagging easier as the teams scale.

  3. Using Environments as a Service (EaaS) will allow each PR to be tested in its own short-lived (ephemeral) environment. Each environment is a high-fidelity copy of production (including custom infrasture like database, buckets, dns, etc.), so devs can remotely code against a trustworthy environment (NOT minikube). This can help reduce configuration drift, improve release cycles, and improve the overall dev experience. (disclaimer: I work for an EaaS company).

1
  • I want to stress the value of this answer, and especially link #2. We were using the traditional dev/test/prod git model until reading this... it was a nightmare. Turns out we were using Helm and Kustomize all wrong! The link in #2 above, as well as its follow on link at the bottom of the article, were tremendously helpful.
    – j7skov
    Feb 3 at 15:49
0

I think running a single cluster make sense because it reduces overhead, monitoring. But, you have to make sure to place network policies, access control in place.

Network policy - to prohibit dev/qa environment workload to interact with prod/staging stores.

Access control - who have access on different environment resources using ClusterRoles, Roles etc..

1
  • Using a single cluster for multiple environments is an anti-pattern. Doing so is a great recipe for big problems (especially if it contains production workloads).
    – tdensmore
    May 9 at 13:15

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.