Skip to content
Self-hosted CDN based on Kubernetes
Branch: master
Clone or download
Latest commit e8deb29 Mar 26, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
externalDNS Fix typo and clarify sentence Mar 11, 2019
images Add kubeCDN logo Feb 10, 2019
monitoring Add note about future automation of step Feb 27, 2019
route53 Add route53 dir and readme Feb 27, 2019
terraform Add new region example snippet to file header Mar 4, 2019
video-server Add descriptions for reference items Feb 27, 2019
LICENSE Create LICENSE Feb 8, 2019 Add link to blog post Mar 27, 2019


A self-hosted content delivery network based on Kubernetes. Easily setup Kubernetes clusters in multiple AWS regions and deploy resilient and reliable services to a global user base within minutes.

This project was developed by Ilhaan Rasheed during his tenure as a DevOps Engineering Fellow at Insight. The capabilities of this project have been demonstrated using video streaming as an example. Ilhaan's presentation slides with a short demo is available here.

Here is a detailed blog post about kubeCDN.


Getting Started

Before deploying your self-hosted CDN using kubeCDN, you will need the following:

  • AWS account and credentials with appropriate permissions to setup EC2 instances, VPCs and EKS clusters. All documentation and software components of this project assumes that awscli is being used to manage AWS credentials.
  • Install Terraform. This project was developed using Terraform v0.11.11.
  • Install kubectl v1.13.2 or higher.
  • Install helm v2.12.3 or higher. On macOS, you can install helm using brew install kubernetes-helm.
  • Install aws-iam-authenticator

After the components above have been installed, clone this repo and proceed to the next section.

Deploy Clusters & Service

  1. Deploy Clusters
    • To deploy EKS clusters in multiple regions, follow instructions from here.
  2. Setup Route53
    • Instructions to setup Route53 can be found here.
  3. Install ExternalDNS
    • Follow instructions here.
  4. Install Monitoring tools
    • Install Prometheus and Grafana by following instructions here.
  5. Deploy Demo Video Server
    • To demonstrate kubeCDN, a simple Nginx based RTMP streaming server was created. Follow instructions here for more information on this server and for deploy instructions.


Follow these instructions to teardown all deployed services and infrastructure.

  1. First, all services that have been deployed need to be removed. There is a script in the root directory of this repo that performs this task. Run it using:
  1. The second teardown step is to remove all infrastructure that was setup in step 1 of the section above. This can be done by navigating to the terraform directory and running the following:
terraform destroy -auto-approve 

This process takes about 10 minutes to complete with two regions.

  1. After successful run of the previous step, all infrastructure associated with kubeCDN should have been torn down. Verify this on AWS Console in order to avoid accidental charges on your account.
You can’t perform that action at this time.