Welcome to the repository for the Amazon Elastic Kubernetes Services workshop. This contains the source for the website content as well as the accompanying infrastructure-as-code to set up a workshop lab environment in your AWS account. Please review the Introduction chapter of the workshop for more details.
The Amazon EKS Workshop is built to help users learn about Amazon EKS features and integrations with popular open-source projects. The workshop is abstracted into high-level learning modules, including Networking, Security, DevOps Automation, and more. These are further broken down into standalone labs focusing on a particular feature, tool, or use-case. To ensure a consistent and predictable learning experience, the Amazon EKS Workshop closely adheres to the following tenets:
Tenets:
- Modular: The workshop is made up of standalone modules that can be individually completed, allowing you to start at any module and easily switch between them.
- Consistent sample app: The workshop uses the same sample retail store application across all modules: AWS Containers Retail Sample.
- Amazon EKS-focused: Although the workshop covers some Kubernetes basics, it primarily focuses on familiarizing the user with concepts directly related to Amazon EKS.
- Continuously tested: We automatically test the infrastructure provisioning and CLI steps in the workshop, allowing us to keep the workshop updated and tracking the latest versions of Amazon EKS.
The top level repository can be split is to several areas.
The workshop content itself is a docusaurus site. All workshop content is written using Markdown and can be found in website.
To learn how to author content on this repository, read CONTRIBUTING.md and docs/authoring_content.md.
The infrastructure required to run the workshop content (EKS cluster configuration, VPC networking, components like Helm charts) are defined as Terraform infrastructure-as-code configuration in the terraform directory.
There are several tools that are required to run the workshop such as kubectl that need to be installed for a participant to complete the workshop content. This "learner environment" can be setup automatically using the scripts and other artifacts in the environment directory. This includes scripts to install all the pre-requisite tools, as well as container images to easily re-create a consistent environment.
See CONTRIBUTING for more information.
This project is licensed under the Apache-2.0 License.