Skip to content

aws-samples/eks-gitops-crossplane-flux

Amazon EKS cluser management with Crossplane and Flux

This Git repository contains software artifacts to deploy Crossplane server and Flux to an existing Amazon EKS cluster and then leverage the GitOps workflow to manage both provisioning a remote EKS cluster with Crossplane and subsequently manage application deployments to it using Flux. Please refer to the accompanying blog post for details about how this works. Please also refer to the earlier blog in this series for additional context.

Deployment architecture

Solution overview

Here’s the high level overview of the solution architecture.

  • Start off with an Amazon EKS cluster that was created using any one of the approaches outlined here.
  • Install and bootstrap Flux on this cluster to manage all deployment tasks, pointing to a Git repository containing the deployment artifacts.
  • Deploy Crossplane components needed to manage the lifecycle of AWS managed service resources.
  • Deploy Crossplane composite resource to provision an Amazon EKS cluster
  • Deploy a set of workloads to the new cluster

The goal is to manage all of these tasks in a declarative style based on the GitOps approach.

Deployment overview

Imperative approach

The script crossplane.sh outlines the CLI commands to install Crossplane to a management EKS cluster and then provision a workload EKS cluster. The implementation uses Crossplane's Composition and CompositeResourceDefinition to create a Crossplane Configuration package that will provision the complete infrastructure for setting up an EKS cluster - VPC, subnets, internet gateway, NAT gateways, route tables, and the EKS cluster with a managed node group. The figure below shows the relationship between various Crossplane custom resources used in this Configuration package and the set of AWS managed resources that they provision.

Component Relationship

Declarative approach

The script flux.sh outlines the steps involved in installing and bootstrapping Flux on the management EKS cluster and then leveraging the GitOps workflow in Flux to manage both provisioning and management of a remote workload cluster.

Security

See CONTRIBUTING for more information.

License

This library is licensed under the MIT-0 License. See the LICENSE file.

About

No description, website, or topics provided.

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages