Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sighupio/fury-kubernetes-aws
Kubernetes Fury Distribution AWS Add-on Module: additional components for EKS-based clusters on AWS
https://github.com/sighupio/fury-kubernetes-aws
eks
Last synced: 25 days ago
JSON representation
Kubernetes Fury Distribution AWS Add-on Module: additional components for EKS-based clusters on AWS
- Host: GitHub
- URL: https://github.com/sighupio/fury-kubernetes-aws
- Owner: sighupio
- License: bsd-3-clause
- Created: 2019-02-01T09:05:14.000Z (almost 6 years ago)
- Default Branch: main
- Last Pushed: 2024-07-31T12:58:45.000Z (4 months ago)
- Last Synced: 2024-11-09T20:37:45.230Z (about 1 month ago)
- Topics: eks
- Language: HCL
- Homepage:
- Size: 852 KB
- Stars: 14
- Watchers: 10
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-repositories - sighupio/fury-kubernetes-aws - Kubernetes Fury Distribution AWS Add-on Module: additional components for EKS-based clusters on AWS (HCL)
README
Kubernetes Fury AWS
**Kubernetes Fury AWS** provides support AWS packages for [Kubernetes Fury Distribution (KFD)][kfd-repo].
If you are new to KFD please refer to the [official documentation][kfd-docs] on how to get started with KFD.
## Overview
**Kubernetes Fury AWS** uses a collection of open source tools to make an EKS cluster on AWS production grade.
## Packages
The following packages are included in Kubernetes Fury AWS:
| Package | Version | Description |
| ------------------------------------------------------------------------------------- | ------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| [cluster-autoscaler](katalog/cluster-autoscaler) | `v1.25.0,v1.26.4,v1.27.2,v1.28.2,v1.29.0` | A component that automatically adjusts the size of a Kubernetes Cluster |
| [IAM role for cluster-autoscaler](modules/iam-for-cluster-autoscaler) | `-` | Terraform module to manage IAM role used by cluster-autoscaler |
| [aws-node-termination-handler](katalog/node-termination-handler) | `v1.20.0` | Automatically manage graceful termination of pods in the event that one node is retired by AWS |
| [aws-load-balancer-controller](katalog/load-balancer-controller) | `v2.7.0` | AWS Load Balancer Controller is a controller to help manage Elastic Load Balancers for a Kubernetes cluster |
| [IAM role for aws-load-balancer-controller](modules/iam-for-load-balancer-controller) | `-` | Terraform module to manage IAM role used by aws-load-balancer-controller |
| [snapshot-controller](katalog/snapshot-controller) | `v6.3.1` | Snapshot controller to enable snapshotting of the Amazon EBS driver. |
| [IAM role for aws-ebs-csi-driver](modules/iam-for-ebs-csi-driver) | `-` | Terraform module to manage IAM role used by EBS CSI driver |
Click on each package to see its full documentation.
## Compatibility
| Kubernetes Version | Compatibility | Notes |
| ------------------ | :----------------: | --------------- |
| `1.25.x` | :white_check_mark: | No known issues |
| `1.26.x` | :white_check_mark: | No known issues |
| `1.27.x` | :white_check_mark: | No known issues |
| `1.28.x` | :white_check_mark: | No known issues |
| `1.29.x` | :white_check_mark: | No known issues |
Check the [compatibility matrix][compatibility-matrix] for additional informations about previous releases of the modules.
## Usage
### Prerequisites
| Tool | Version | Description |
| --------------------------- |------------| -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [furyctl][furyctl-repo] | `>=0.25.0` | The recommended tool to download and manage KFD modules and their packages. To learn more about `furyctl` read the [official documentation][furyctl-repo]. |
| [kustomize][kustomize-repo] | `>=3.5.3` | Packages are customized using `kustomize`. To learn how to create your customization layer with `kustomize`, please refer to the [repository][kustomize-repo]. |
| [terraform][terraform-repo] | `>=1.3.0` | Terraform is used to provision packages using modules. To learn how to use `terraform`, please refer to the [repository][terraform-repo]. |
### Deployment
1. List the packages you want to deploy and their version in a `Furyfile.yml`
```yaml
bases:
- name: aws/cluster-autoscaler
version: "v4.2.1"
- name: aws/node-termination-handler
version: "v4.2.1"
- name: aws/load-balancer-controller
version: "v4.2.1"
- name: aws/snapshot-controller
version: "v4.2.1"
```
> See `furyctl` [documentation][furyctl-repo] for additional details about `Furyfile.yml` format.
2. Execute `furyctl legacy vendor -H` to download the packages
3. Inspect the download packages under `./vendor/katalog/aws`.
4. Define a `kustomization.yaml` that includes the `./vendor/katalog/aws` directory as resource.
```yaml
resources:
- ./vendor/katalog/aws/cluster-autoscaler/{v1.24.x,v1.25.x,v1.26.x,v1.27.x}
- ./vendor/katalog/aws/node-termination-handler
- ./vendor/katalog/aws/load-balancer-controller
- ./vendor/katalog/aws/snapshot-controller
```
> NB: some packages needs additional configurations (IAM roles), they will not work out of the box. Refer to each package documentation for more details.
5. To deploy the packages to your cluster, execute:
```bash
kustomize build . | kubectl apply -f -
```
[kfd-repo]: https://github.com/sighupio/fury-distribution
[furyctl-repo]: https://github.com/sighupio/furyctl
[kustomize-repo]: https://github.com/kubernetes-sigs/kustomize
[terraform-repo]: https://github.com/hashicorp/terraform
[kfd-docs]: https://docs.kubernetesfury.com/docs/distribution/
[compatibility-matrix]: https://github.com/sighupio/fury-kubernetes-aws/blob/master/docs/COMPATIBILITY_MATRIX.md
## Contributing
Before contributing, please read first the [Contributing Guidelines](docs/CONTRIBUTING.md).
### Reporting Issues
In case you experience any problem with the module, please [open a new issue](https://github.com/sighupio/fury-kubernetes-aws/issues/new/choose).
## License
This module is open-source and it's released under the following [LICENSE](LICENSE)