Skip to content

Commit

Permalink
Improvements to docs homepage and overview content
Browse files Browse the repository at this point in the history
  • Loading branch information
csplinter committed Feb 24, 2024
1 parent 7bf3382 commit 889902c
Show file tree
Hide file tree
Showing 12 changed files with 81 additions and 39 deletions.
17 changes: 17 additions & 0 deletions docs/assets/scss/_styles_project.scss
Original file line number Diff line number Diff line change
Expand Up @@ -72,4 +72,21 @@
margin-top: 0
}
}
}

.benefits {
.card-shadow {
padding: 20px 20px 20px;
border-radius: 10px;
box-shadow: 0 10px 10px rgba(41,26,204,.12);
border: none;
height: 100%;
text-align: left;

h4 {
font-weight: 550;
font-size: 1.1em;
line-height: 1.2;
}
}
}
47 changes: 25 additions & 22 deletions docs/content/en/_index.html
Original file line number Diff line number Diff line change
@@ -1,31 +1,34 @@
+++
title = "EKS Anywhere"
linkTitle = "EKS-A"

+++
---
title: "EKS Anywhere"
linkTitle: "EKS-A"
benefits:
- title: Simplify Kubernetes Management
image: /images/line-server-rack.svg
description: >
Amazon EKS Anywhere simplifies the creation and operation of on-premises Kubernetes clusters with default component configurations and cluster lifecycle automation based on open source standards.
- title: Streamline Support
image: /images/line-container-cloud.svg
description: >
AWS supports all Amazon EKS Anywhere components including the integrated 3rd-party software, enabling customers to reduce support costs and avoid maintenance of redundant open-source and third-party tools.
- title: Consistent and Reliable
image: /images/line-toolbox.svg
description: >
Amazon EKS Anywhere builds on the strengths of Amazon EKS Distro and provides open-source software that’s up-to-date and patched with optional integrations with other AWS services for capabilities such as authentication, observability, and key encryption.
---

{{< blocks/header >}}
<!-- This needs to be passed in as content because we can't use `relref` outside of the content dir -->
<a class="btn rounded-sm btn-warning" href="{{< relref `docs/getting-started/` >}}">
<a class="btn rounded-sm btn-warning" href="{{< relref `docs/getting-started/overview` >}}">
Get Started with EKS Anywhere
</a>
{{< /blocks/header >}}

{{< blocks/section color="white" class="w-75 mx-auto" >}}
{{< blocks/feature title="" class="text-xl text-center mb-5" >}}
Amazon EKS Anywhere is an open-source deployment option for Amazon EKS that allows customers to create and operate Kubernetes clusters on-premises, with optional support offered by AWS.
EKS Anywhere supports Bare Metal, CloudStack and VMware vSphere as deployment targets.
{{< /blocks/feature >}}

{{< blocks/feature title="Simplify On-Premises Kubernetes Management" image="/images/line-server-rack.svg" order="left" >}}
Amazon EKS Anywhere helps simplify the creation and operation of on-premises Kubernetes clusters with default component configurations while providing tools for automating cluster management.
{{< /blocks/feature >}}
<br>
<div class="text-md-left p-2 w-75 align-items-center justify-content-center mx-auto" style="max-width:1000px;">
<p>Amazon EKS Anywhere is container management software built by AWS that makes it easier to run and manage Kubernetes on-premises and at the edge. Amazon EKS Anywhere is built on <a href="https://distro.eks.amazonaws.com/">Amazon EKS Distro</a>, which is the same reliable and secure Kubernetes distribution used by <a href="https://docs.aws.amazon.com/eks/latest/userguide/what-is-eks.html">Amazon Elastic Kubernetes Service (EKS)</a> in AWS Cloud.</p>

{{< blocks/feature title="One Stop Support" image="/images/line-container-cloud.svg" order="right" >}}
AWS supports all Amazon EKS Anywhere components including the integrated 3rd-party software, so that customers can reduce their support costs and avoid maintenance of redundant open-source and third-party tools.
{{< /blocks/feature >}}
{{< /blocks/section >}}
<p> Amazon EKS Anywhere simplifies Kubernetes cluster management through the automation of undifferentiated heavy lifting such as infrastructure setup and Kubernetes cluster lifecycle operations. EKS Anywhere supports many different types of infrastructure including VMWare vSphere, bare metal, Nutanix, Apache CloudStack, and AWS Snow.</p>
</div>
</br>

{{< blocks/feature title="Consistent and Reliable" image="/images/line-toolbox.svg" order="left" >}}
Amazon EKS Anywhere gives you on-premises Kubernetes operational tooling that’s consistent with Amazon EKS. It builds on the strengths of Amazon EKS Distro and provides open-source software that’s up-to-date and patched, so you can have a Kubernetes environment on-premises that is more reliable than self-managed Kubernetes offerings.
{{< /blocks/feature >}}
{{< benefits >}}
8 changes: 5 additions & 3 deletions docs/content/en/docs/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,11 +24,13 @@ menu:
main:
weight: 20
description: >
EKS Anywhere provides a means of managing Kubernetes clusters using the same operational excellence and practices that Amazon Web Services uses for its Amazon Elastic Kubernetes Service (Amazon EKS).
Based on [EKS Distro](https://github.com/aws/eks-distro), EKS Anywhere adds methods for deploying, using, and managing Kubernetes clusters that run in your own data centers.
Its goal is to include full lifecycle management of multiple Kubernetes clusters that are capable of operating completely independently of any AWS services.
EKS Anywhere documentation homepage
---

EKS Anywhere is container management software built by AWS that makes it easier to run and manage Kubernetes clusters on-premises and at the edge. EKS Anywhere is built on [EKS Distro](https://distro.eks.amazonaws.com/), which is the same reliable and secure Kubernetes distribution used by [Amazon Elastic Kubernetes Service (EKS)](https://docs.aws.amazon.com/eks/latest/userguide/what-is-eks.html) in AWS Cloud. EKS Anywhere simplifies Kubernetes cluster management through the automation of undifferentiated heavy lifting such as infrastructure setup and Kubernetes cluster lifecycle operations.

Unlike Amazon EKS in AWS Cloud, EKS Anywhere is a user-managed product that runs on user-managed infrastructure. You are responsible for cluster lifecycle operations and maintenance of your EKS Anywhere clusters.

The tenets of the EKS Anywhere project are:

- **Simple**: Make using a Kubernetes distribution simple and boring (reliable and secure).
Expand Down
2 changes: 1 addition & 1 deletion docs/content/en/docs/clustermgmt/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,5 +6,5 @@ aliases:
/docs/tasks/
/docs/tasks/cluster/
description: >
Common tasks for managing clusters.
Common tasks for managing EKS Anywhere clusters
---
4 changes: 2 additions & 2 deletions docs/content/en/docs/concepts/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,10 @@ title: "Concepts"
linkTitle: "Concepts"
weight: 20
description: >
The Concepts section will describe the components and overall architecture of EKS Anywhere.
The Concepts section contains an overview of the EKS Anywhere architecture, components, versioning, and support.
---

{{% pageinfo %}}
Most of the content of this section will cover how EKS Anywhere deploys, upgrades and otherwise manages Kubernetes clusters. It will point to Kubernetes documentation for specifics on how Kubernetes itself works.
Most of the content in the EKS Anywhere documentation is specific to how EKS Anywhere deploys and manages Kuberentes clusters. For information on Kubernetes itself, reference the [Kubernetes documentation.](https://kubernetes.io/docs/home/)
{{% /pageinfo %}}

6 changes: 3 additions & 3 deletions docs/content/en/docs/concepts/packages.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
title: "EKS Anywhere curated packages"
linkTitle: "Curated packages"
title: "EKS Anywhere Curated Packages"
linkTitle: "Curated Packages"
weight: 60
date: 2022-05-09
description: >
All information you may need for EKS Anywhere curated packages
Overview of EKS Anywhere Curated Packages
---

{{% alert title="Note" color="primary" %}}
Expand Down
2 changes: 1 addition & 1 deletion docs/content/en/docs/overview/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ EKS Anywhere is container management software built by AWS that makes it easier

Unlike Amazon EKS in AWS Cloud, EKS Anywhere is a user-managed product that runs on user-managed infrastructure. You are responsible for cluster lifecycle operations and maintenance of your EKS Anywhere clusters. EKS Anywhere is open source and free to use at no cost. To receive support for your EKS Anywhere clusters, you can optionally purchase [EKS Anywhere Enterprise Subscriptions]({{< relref "../concepts/support-scope/">}}) for 24/7 support from AWS subject matter experts and access to [EKS Anywhere Curated Packages]({{< relref "../concepts/packages/">}}). EKS Anywhere Curated Packages are software packages that are built, tested, and supported by AWS and extend the core functionalities of Kubernetes on your EKS Anywhere clusters.

EKS Anywhere supports many different types of infrastructure including VMWare vSphere, bare metal, Snow, Nutanix, and Apache CloudStack. You can run EKS Anywhere without a connection to AWS Cloud and in air-gapped environments, or you can optionally connect to AWS Cloud to integrate with other AWS services. You can use the [EKS Connector](https://docs.aws.amazon.com/eks/latest/userguide/eks-connector.html) to view your EKS Anywhere clusters in the Amazon EKS console, AWS IAM to authenticate to your EKS Anywhere clusters, IAM Roles for Service Accounts (IRSA) to authenticate Pods with other AWS services, and AWS Distro for OpenTelemetry to send metrics to Amazon Managed Prometheus for monitoring cluster resources.
EKS Anywhere supports many different types of infrastructure including VMWare vSphere, bare metal, Nutanix, Apache CloudStack, and AWS Snow. You can run EKS Anywhere without a connection to AWS Cloud and in air-gapped environments, or you can optionally connect to AWS Cloud to integrate with other AWS services. You can use the [EKS Connector](https://docs.aws.amazon.com/eks/latest/userguide/eks-connector.html) to view your EKS Anywhere clusters in the Amazon EKS console, AWS IAM to authenticate to your EKS Anywhere clusters, IAM Roles for Service Accounts (IRSA) to authenticate Pods with other AWS services, and AWS Distro for OpenTelemetry to send metrics to Amazon Managed Prometheus for monitoring cluster resources.

EKS Anywhere is built on the Kubernetes sub-project called [Cluster API](https://cluster-api.sigs.k8s.io/) (CAPI), which is focused on providing declarative APIs and tooling to simplify the provisioning, upgrading, and operating of multiple Kubernetes clusters. While EKS Anywhere simplifies and abstracts the CAPI primitives, it is useful to understand the basics of CAPI when using EKS Anywhere.

Expand Down
6 changes: 3 additions & 3 deletions docs/content/en/docs/packages/_index.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
---
title: "EKS Anywhere curated package management"
title: "Curated Package management"
linkTitle: "Package management"
date: 2022-04-12
weight: 50
aliases:
/docs/reference/packagespec/
/docs/tasks/packages/
description: >
Managing curated packages
Managing EKS Anywhere Curated Packages
---

The main goal of EKS Anywhere curated packages is to make it easy to install, configure and maintain operational components in an EKS Anywhere cluster. EKS Anywhere curated packages offers to run secure and tested operational components on EKS Anywhere clusters.
EKS Anywhere Curated Packages make it easy to install, configure, and maintain operational components in EKS Anywhere clusters. EKS Anywhere Curated packages are built, tested, and distributed by AWS to use with EKS Anywhere clusters as part of EKS Anywhere Enterprise Subscriptions

See [Prerequisites]({{< relref "./prereq/" >}}) to get started.
Check out [EKS Anywhere curated packages concepts]({{< relref "../concepts/packages/" >}}) for more details.
Expand Down
2 changes: 1 addition & 1 deletion docs/content/en/docs/whatsnew/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,6 @@ title: "What's New"
linkTitle: "What's New"
weight: 15
description: >
New EKS Anywhere features
New EKS Anywhere releases, features, and fixes
---

20 changes: 20 additions & 0 deletions docs/layouts/shortcodes/benefits.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
{{ $benefits := $.Page.Params.benefits -}}

<div class="body-container benefits">
<div class="container">
<div class="row mb-5">

{{ range $benefits -}}
{{ $image := .image -}}
{{ $desc := .description | markdownify -}}
{{ $title := .title | markdownify -}}
<div class="col-lg-4 mb-5">
<div class="card-shadow">
<div class="m-3 d-block mx-auto" style="width: 125px;"><img style="max-width:100%;" src="{{ $image }}"></div>
<h4 class="text-center">{{ $title }}</h4>
<p>{{ $desc }}</p>
</div>
</div>
{{ end }}
</div>
</div>
4 changes: 2 additions & 2 deletions docs/layouts/shortcodes/blocks/feature.html
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,9 @@
<div class="d-md-flex text-xs-center text-sm-center text-md-left p-2 w-75 h-25 align-items-center justify-content-center mx-auto {{ if not (eq $order "left") }}flex-row-reverse{{ end }}">
<div style="max-width:1000px;">
{{- if not (eq $image "") -}}
<div class="m-4 d-block mx-auto" style="width: 200px;"><img style="max-width:100%;" src="{{ $image }}"></div>
<div class="m-4 d-block mx-auto" style="width: 500px;"><img style="max-width:100%;" src="{{ $image }}"></div>
{{- end -}}
<div class="p-2 mx-lg-5 text-center text-md-left w-100">
<div class="p-2 mx-lg-5 text-center text-md-left w-1000">
{{- if not (eq $title "") -}}
<h3 class="display-5">{{ $title }}</h3>
{{- end -}}
Expand Down
2 changes: 1 addition & 1 deletion docs/layouts/shortcodes/blocks/header.html
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<div class="col-1"></div>
<div class="col-10 py-4 header__content">
<h1 class="headline display-1 mb-2">Amazon EKS Anywhere Documentation</h1>
<div class="mb-3 lead">Run EKS in your own datacenter</div>
<br>
<div class="mb-3">
{{ .Inner }}
</div>
Expand Down

0 comments on commit 889902c

Please sign in to comment.