How to Migrate From ECS to EKS and the #1 Trick to Make EKS Easier

Migrating from Amazon ECS to EKS is probably the last thing you want to spend your time on.

migrate from ECS to EKS

Yet, you’re here. So, it’s likely that ECS hasn’t been serving you fully. Or perhaps you’re curious if you should start planning the migration and how long will it take.

I’ll try to answer most of your questions, starting from whether you should look at EKS at all to some practical migration and EKS management tips for when you’ve made your decision.

Why migrate from ECS to EKS?

Companies that want to advance in Kubernetes are better off by using EKS. Giants like Amazon, HSBC, JP Morgan Chase, and Delivery Hero all use EKS because of the control and flexibility it offers.

ecs vs eks

1. Portability 

While ECS is AWS-proprietary technology, EKS is basically a Kubernetes-as-a-platform service developed and maintained by AWS. EKS clusters are actually portable, you can recreate a similar experience on local environments, development environments, etc., using vanilla K8s. So, you can probably tell in which scenario you’ll face the risk of cloud vendor lock-in.

​​If you’re building and running applications in ECS, you might encounter vendor lock-in issues in the long run. If you decide to use another provider, you’ll have to define the entire architecture to match it. 

That’s why designing your application to run on EKS leaves you more flexibility. The abstraction layer of EKS helps you to package your containers and move them to another platform quickly. That way, you can run workloads on any other Kubernetes cluster – whether it’s on-prem or the cloud provider offering you the best deal. 

On top of that, you can find solutions on the market that allow you to switch between different managed Kubernetes services seamlessly.

Open source and community are two important points related to this.

With EKS, you have lots of tooling built on top of it and the community itself is growing rapidly. And you know what that means – you get plenty of support as many problems already have their solutions. 

Open source also allows you to choose your tooling, while in ECS, everything is very opinionated and there’s not much flexibility left at the end of the day.

2. Networking limitations

​​Amazon ECS allows users to assign an elastic network interface (ENI) to a task using only one networking mode: awsvpc. Usually, you can get only 8-15 network interfaces per EC2 instance but ECS also supports containers with higher limits (as long as you meet specific prerequisites). In total, you can run up to 120 tasks per EC2 instance.

In EKS, you get to enjoy greater flexibility in networking. You can share an ENI between multiple pods and place more pods per instance.

3. Namespaces

Namespaces come in handy because they isolate workloads running in the same Kubernetes cluster. For example, you can have a dev, staging, and production environment in one cluster. They can all share the resources of the cluster. 

Trouble is, you can’t use namespaces in ECS. The solution just doesn’t include them as a concept. In contrast to that, EKS allows you to use them just as you would in self-managed Kubernetes. 

4. No configuration flexibility

Many people choose ECS because it’s so simple. But there’s a price to pay for this – namely, limited configuration options. For example, you get no access to cluster nodes, which limits your troubleshooting capabilities.

And if you use ECS with Fargate, prepare for even more limitations. For example, you don’t get the option to easily decouple environment-specific config from your container images for portability as you do in EKS.

ECS to EKS glossary

Before migrating from ECS to EKS, you need to become familiar with a few terms that are common to Kubernetes: 

  • ECS vs. K8s building blocks – this is the best place to get started, reviewing the building blocks of ECS and Kubernetes will help you understand the differences between these two.
  • EKS Worker Node – this is the EC2 Instance that is running your workloads (Pods).
  • IaC – Infrastructure as Code – these are tools that allow you to define infrastructure in code that you usually commit into Git repositories. In addition to that, you get Git-like diff output whenever there is a mismatch between your code and the infrastructure in the cloud. Examples include Pulumi, Terraform, and AWS CloudFormation
  • Helm – the most popular packaging solution in the Kubernetes world. 
  • ALB – Application Load Balancer.
  • NLB – Network Load Balancer.
  • Internet Gateway – an internet gateway is a horizontally scaled, redundant, and highly available VPC component that allows communication between your VPC and the internet.
  • VPC – Amazon Virtual Private Cloud (Amazon VPC) enables you to launch AWS resources into a virtual network that you’ve defined. This virtual network closely resembles a traditional network that you’d operate in your own data center, with the benefits of using the scalable infrastructure of AWS. 

ECS comes with its own terminology that you’re probably familiar with. Here’s how different ECS concepts translate into the world of EKS.

  • ECS Task Definition <> EKS Kubernetes Deployment YAML
  • ECS Task <> EKS Kubernetes Pod
  • ECS Cluster <> EKS Cluster

If you need more guidance here, some good sources to check out are the ECS Workshop and EKS Workshop.

What you get with EKS

You might not need pods for every workload you’re running. But you can’t deny that they offer unparalleled control over pod placement and resource sharing. This is really valuable when you’re dealing with most service-based architectures.

EKS offers far more flexibility for managing the underlying resources. You can run your clusters on EC2 instances, Fargate, and even on-premises (via EKS Anywhere).

If you’re familiar with Kubernetes and want to get your hands on the flexibility and features it provides, go for EKS. 

How to migrate from ECS to EKS

ecs architecture
Kubernetes architecture

AWS has some good tips on migrating to EKS

But we found some other things you need to take care of before your ECS to EKS migration.

1. Rewrite ECS Task Definition files to K8s deployment YAMLs

First things first, you need to rewrite your ECS Task Definition files to Kubernetes deployment YAMLs. This part is unavoidable and relates to one of the biggest differences between ECS and EKS (or vanilla Kubernetes).

ECS to EKS migration

2. Spin up your environment

You also need to spin up the respective environment versions you have on EKS. People typically choose to use Infrastructure as Code (IaC) for that – using Terraform, CloudFormation, or Pulumi. Good news: the most popular IaC tools support EKS.

Assuming that you’re already familiar with Docker and have application images packaged and available for use:

  • You could use the features of Terraform (or an alternative IaC tool), such as kubernetes provider to ship your Deployment YAMLs as part of the IaC flow. 
  • You could also make use of Helm Provider if your application packages use Helm.
  • Alternatively, you could use CloudFormation which allows deploying workloads to EKS clusters as well, assuming your applications are packaged using Helm.

You can get the above working in many more ways – and each has its pros and cons. But this simple solution is enough for now. 

3. Configure your CI/CD pipelines 

You need to do this to deploy your applications into the EKS cluster.

4. Networking

Both ECS and EKS support similar networking capabilities: ALB & NLB. You can use the basic constructs of networking that you’re currently familiar with in ECS. This article might come in handy if you’re looking for more details about ingress with ALB. 

5. Run some tests

Run your test suite against your new configuration to make sure that everything works properly.

6. Switch your traffic to the EKS cluster

This might vary depending on your configuration, but to give you an idea of what needs to be done:

  • You could switch the IP your domain points to, for it to point to the Load Balancer used by your EKS cluster. This is how you make sure that your application traffic now points to the EKS cluster.
  • For stateful applications, you need to think about other things as well, such as ensuring that the K8s-based application transitions to being the main user of the database (smooth switch from ECS using the database for writing to the EKS app using the database for writing).

Make your EKS journey easier with automation

Configuring and running EKS doesn’t have to be hard. This is what all the managed Kubernetes tools are here for.

For example, CAST AI comes with opinionated Kubernetes implementation that helps you manage all the infrastructure complexities:

  • Focus on high-level work that interests you most. 
  • Creating and managing CAST Al components is easy – you can do it through API and Terraform to automate infrastructure lifecycle management. 
  • You get to streamline autoscaling with a headroom policy to accommodate sudden spikes in demand.
  • And automate spot instance use to cut costs even more. If the spot availability shrinks, your workloads are automatically moved to on-demand instances and never go down. 
  • All in all, you get to benefit from automated cloud cost optimization – the platform chooses the most cost-effective AWS instance types and sizes, and delivers detailed cost reports.

If you’d like to see how this works in real life, here’s how the e-commerce agency Snow Commerce moved to EKS and now rolls out apps seamlessly with a fully automated environment.

See CAST AI in action

End those massive cloud bills! Learn how to cut 50%+ automatically

When to use EKS vs. ECS?

Amazon ECS is a good option for simple container workloads you’re only looking to run in the AWS cloud. ECS is easier to understand for developers and includes certain quick prototype tools, such as Amazon Copilot.

However, if you need to run large microservices architectures, span deployments across multiple infrastructure providers, or require additional automation or flexibility provided by Kubernetes’ diverse toolsets, EKS provides more versatility with a much richer ecosystem of tools and resources.

What are the differences between ECS and EKS?

In terms of pricing, ECS is free and just charges for compute time. EKS costs $0.1 per hour each Kubernetes cluster ($74 per month) plus computation costs.

With ECS, you get easy deployment, no control plane, configuration, and Amazon management console. EKS requires Kubernetes configuration and pod deployment.

While ECS is a propriatory technology wtih limited community, it comes wtih corporate AWS support. EKS has community support and resources.

Finally, there’s networking. ECS offers limited ENIs per instance. This might not be enough to execute all your containers on one instance. EKS allows several pods to share one ENI and more pods per instance.

What are the steps involved in migrating from ECS to EKS?

To migrate from ECS to EKS, you need to follow these steps:
1. Rewrite ECS Task Definition files to K8s deployment YAMLs
2. Spin up your environment
3. Configure your CI/CD pipelines 
4. Networking
5. Run some tests
6. Switch your traffic to the EKS cluster

What challenges should be considered when migrating from ECS to EKS?

When moving from ECS to EKS, you should think about how much Kubernetes knowledge you need to run EKS. There are many configuration and management tasks that you’ll need to take care of on your own once on EKS.

What are the potential benefits of migrating from ECS to EKS?

EKS provides significantly greater flexibility in controlling the underlying resources. You can run your clusters on EC2 instances, Fargate, or even on-premises (via EKS Anywhere). If you’re comfortable with Kubernetes and want to take advantage of the flexibility and functionality it offers, choose EKS.

How can I ensure a successful migration from ECS to EKS?

The best way to make sure that your migration from ECS to EKS is successful is using an automation solution that takes care of many K8s configuration and management tasks. You can automate many processes and make sure that your migration proceeds smoothly once you’re on EKS.

  • Blog
  • How to Migrate From ECS to EKS and the #1 Trick to Make EKS Easier
Subscribe

Leave a reply

Notify of
6 Comments
Oldest
Newest
Inline Feedbacks
View all comments
ARKA
2022-04-26 12:02 AM

Hey Žilvinas Urbonas i liked your post. Could you please tell how we can use existing ECS s3 bucket environment variable in EKS

Ricardo
2022-04-27 10:41 AM

Hey Arka and Žilvinas!
I have the same question regarding that and yes replicate task definition env vars.
More overall Žilvinas: Is there any way (it could be either a tool or something else) to convert or at least map task definitions values to k8s deployments?
Thank you in advance and that you for your article.

Natalie
2022-11-24 2:00 AM

Article with a great value
Thank you so much

Vito Clover
2022-11-24 6:25 AM
Reply to  Natalie

You’re more than welcome! Happy to hear you found this valuable!

Recent posts