Airplane has been acquired by Airtable. Learn more →
How to use Kubernetes ReplicaSets

How to use Kubernetes ReplicaSets

Feb 6, 2022
6 min read

One of the biggest pain points when running an application in production isn’t making sure that it’s always running but ensuring that when something goes wrong it is automatically fixed. Kubernetes as a platform has a variety of built-in tools that can help developers accomplish this, the primary one being its error detection feature.

Kubernetes is quick at knowing when an application running in a container has made an error, which it can then report to either you or other parts of the system. This is where ReplicaSets come into play. When you create a ReplicaSet, you are essentially telling Kubernetes that you want a specific pod replicated x amount of times. For example, if you want to have four pods running at all times and one of them suddenly crashes, a ReplicaSet will ensure that the crashed one is removed and will spin up a new, hopefully healthy, one.

In this article, we will expand on that idea to provide more insight into this process; how a ReplicaSet knows which pods it owns; and how you can generally use them in your deployments.

The anatomy of a ReplicaSet manifest

Before diving into the use cases of a ReplicaSet and best practices for working with them, it’s important to first understand how they work.

The first thing to note is that they are very much like any other resource in Kubernetes, meaning you have to state the apiVersion, kind, metadata, and spec. You can see an example below of what a ReplicaSet manifest looks like:


First of all, this ReplicaSet is creating a scenario where you have three pods in your environment, all running a frontend demo application. If you’ve ever made a manifest file for a simple pod or a deployment, you’ll recognize a lot of the fields. Let’s take a closer look at the first part:


The two very first fields are simple and static, and they will always be the same. Specifying the apiVersion and kind just tells Kubernetes what it has to work with, and they should never be anything different. Moving further down to the definition of the metadata, you are specifying the name and labels. This will help you maintain a better overview of the resources you have in your environment.

Moving on in the manifest, you get to the spec field, where the first part is:


Here the replicas field is set to 3, but you can set it to whatever fits your application. Officially, there is no limit to how high this can be set but, of course, you have to keep in mind the underlying resources of your Kubernetes cluster.

The next part in the manifest is the selector field. This is where you specify how the ReplicaSet should recognize the pods it needs to control. In this case, it should match any pods with the label tier: frontend.

Lastly, you need to define the actual template of the pods:


This is much like any other pod you would define. First, you specify the metadata field, which in this case is given the label of tier: frontend. As you saw earlier, this is what we specified the ReplicaSet would look for when finding which pods it needs to own. So make sure that it matches with what you wrote earlier in the manifest.

Lastly, you specify the container(s) inside the pod. In this example scenario, we’re using a simple demo frontend developed by Google. If you want to try out this example, you can apply it by running:


After a while, you should be able to see the ReplicaSet successfully deployed by running:

$ kubectl get rs


What exactly is a ReplicaSet?

At this point, you know exactly what a manifest for a ReplicaSet looks like, but you may still be wondering exactly what it is.

On the surface, a ReplicaSet is simply a resource in Kubernetes that maintains a set number of pods, nothing more. In the previous example, you perhaps noticed how much of the manifest file is standard Kubernetes boilerplate. Without the boilerplate, it can quickly be boiled down to “Create this amount of pods, and configure them in this way.” This makes ReplicaSets a very simple resource to work with, and they are great when you have a simple use case.

However, there are some pitfalls you should be aware of. The most common misunderstanding about ReplicaSets is that they will keep a certain amount of actual replicas, but this is not true. A ReplicaSet focuses on the labels of pods, not the contents of pods. A ReplicaSet looks for the labels that you’ve specified in the selector field, and nothing more. This can cause issues if you already have pods in your environment with the given selector criteria.

Let’s say you want to deploy the example ReplicaSet above, but you already have a pod in your environment with the label tier: frontend. In this case, the ReplicaSet will acquire ownership over that existing pod and create two new ones according to its own spec. This leaves you with three pods that aren’t the same and can lead to confusion.

Conversely, you can also be trying to create bare pods with the same labels as those that the ReplicaSet has specified. If you’ve deployed the example above and then deployed individual pods with the label tier: frontend, the new pods will immediately be terminated. The ReplicaSet will acquire ownership, determine that there are now too many pods, and delete them.

Working with ReplicaSets

Now that you have more insight into what a ReplicaSet actually is, it’s time to understand some ways to work with them. This isn’t too complex, as there aren’t many things that can be done with a ReplicaSet.

Scaling ReplicaSets

Getting a ReplicaSet scaled is fairly easy, as it’s a simple matter of updating the replicas field. You can do it either by modifying your manifest file and re-applying it, or by running the following command to scale your ReplicaSet down to two:


If you want to scale your ReplicaSet up, simply add more pods. If you want to scale it down, the ReplicaSet has a set of rules it follows to determine which pods should be deleted, which you can read more about in the documentation.

Removing ReplicaSets

The process for deleting a ReplicaSet is fairly straightforward. Deleting the ReplicaSet itself will remove both the ReplicaSet and its pods.


It is also possible to remove a ReplicaSet and leave the pods as orphans by adding --cascade=orphan to the delete command.

When to use a ReplicaSet?

ReplicaSets should not be used for tasks for which there are more appropriate resources. Some other Kubernetes resources with similar functions work better in certain circumstances.

Kubernetes also has a deployment resource, which is very much like a ReplicaSet in the way that you set a specific number of replicas, and it will maintain it. The biggest difference between these two resources is that deployments take care of upgrading pods. That means you should choose ReplicaSets when either you don’t want to have any automatic upgrading of pods or you want to implement your own custom upgrading logic.

People also use ReplicaSets to execute any batch jobs where they need many nodes to run the same task. However, best practice suggests that you use a job, instead, to create batch workloads, as the resource has been specifically designed with this purpose in mind, for example, not treating a pod that’s exited as a failure.

The last main alternative to ReplicaSets are DaemonSets. DaemonSets are a feature that get pods to run on each node and allow those pods to have access to machine-level functions. Use a DaemonSet when you need to have a given pod run on each node in your cluster. It’s possible to configure that scenario with a ReplicaSet, but DaemonSets are built for it.

Final thoughts

A ReplicaSet is a great way to quickly get a set number of pods running in your environment. It isn’t complicated to set up. Generally, it functions very simply by replacing containers that are affected by errors.

However, you should always consider whether a ReplicaSet is the right choice. In many scenarios, it won’t be, and more often you should be opting for a deployment instead. Now that you know the capabilities of a ReplicaSet, you can determine for yourself whether it’s needed in your environment. Whether you decide to go with a ReplicaSet, a deployment, or something else, make sure you’re notified of any errors happening in your environment.

If you're looking to build a dashboard to help with error detection, you should consider using Airplane. Airplane is the developer infrastructure for building custom internal tools. The basic building blocks of Airplane are Tasks, which are single or multi-step operations that anyone can use. Airplane also offers Views, a React-based platform for building custom UIs. You can use Airplane's pre-built component library and template library to get started.

To build your first error detection dashboard using Airplane, sign up for a free account or book a demo.

Share this article:
Kasper Siig
As a DevOps engineer, Kasper Siig is accustomed to working with a variety of exciting technologies, from automating simple tasks to CI/CD to Docker.

Subscribe to new blog posts from Airplane.