Skip to content

Commit 7088639

Browse files
committed
fix: fastpaths content improvements for in-your-account flow
- developer/operator essentials: add base app deploy step so labs work without getting-started - explore: add link to modular workshop modules - navigating-labs: restore IDE image at constrained size, clarify Opening the IDE for both event and in-your-account flows - setup/your-account: constrain stretched images to 600px, add Continue button on using-eksctl, fix pagination to skip terraform stub - using-terraform: remove pagination links from stub page
1 parent d3d46ea commit 7088639

7 files changed

Lines changed: 51 additions & 12 deletions

File tree

website/docs/fastpaths/developer/index.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,18 @@ $ prepare-environment fastpaths/developer
1818

1919
Welcome to the EKS Workshop Developer Essentials! This is a collection of labs optimized for developers to learn the features of Amazon EKS most commonly required when deploying workloads.
2020

21+
First, let's deploy the sample application to your cluster:
22+
23+
```bash
24+
$ kubectl apply -k ~/environment/eks-workshop/base-application
25+
```
26+
27+
Wait for all components to be ready:
28+
29+
```bash
30+
$ kubectl wait --for=condition=Ready pods --all -A -l app.kubernetes.io/created-by=eks-workshop --timeout=180s
31+
```
32+
2133
In this learning path, you'll learn:
2234

2335
- How to deploy and manage containerized applications on EKS

website/docs/fastpaths/explore/index.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,9 @@ sidebar_position: 80
44
pagination_prev: null
55
---
66

7-
Congratulations you're done with the learning paths! Don't forget to leave us your feedback through the application! If you have some time left, why not explore additional content in our modular options? Don't forget to run the `prepare-environment` command as the start of each module.
7+
Congratulations you're done with the learning paths! Don't forget to leave us your feedback through the application!
8+
9+
If you have some time left, why not explore additional content in our [modular workshop modules](/docs/introduction)? These cover deeper topics like networking, security, observability, and more. Don't forget to run the `prepare-environment` command at the start of each module.
810

911
import HomepageModuleLink from "@site/src/components/HomepageModuleLink";
1012

website/docs/fastpaths/navigating-labs.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,9 +19,11 @@ The lab exercises are designed in a way that you can run any modules as a self-c
1919

2020
## Opening the IDE
2121

22-
If you haven't done so yet, you can open the IDE from the *Event outputs* section at the bottom of the start page.
22+
If you're **at an AWS event**, open the IDE from the *Event Outputs* section at the bottom of the Workshop Studio start page.
2323

24-
![Event Outputs copy/paste](/img/fastpaths/ide-open.png)
24+
<img src="/img/fastpaths/ide-open.png" alt="Event Outputs copy/paste" width="500" />
25+
26+
If you're running **in your own account**, find the `IdeUrl` in your CloudFormation stack's Outputs tab — see the [setup guide](/docs/fastpaths/setup/your-account) for details.
2527

2628
## Starting a Lab
2729

website/docs/fastpaths/operator/index.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,18 @@ $ prepare-environment fastpaths/operator
2020

2121
Welcome to the EKS Workshop Operator Essentials! This is a collection of labs optimized for operators to learn the features of Amazon EKS most commonly required when operating EKS clusters.
2222

23+
First, let's deploy the sample application to your cluster:
24+
25+
```bash
26+
$ kubectl apply -k ~/environment/eks-workshop/base-application
27+
```
28+
29+
Wait for all components to be ready:
30+
31+
```bash
32+
$ kubectl wait --for=condition=Ready pods --all -A -l app.kubernetes.io/created-by=eks-workshop --timeout=180s
33+
```
34+
2335
Throughout this series of exercises you'll learn:
2436

2537
- Configuring cluster autoscaling with Karpenter

website/docs/fastpaths/setup/your-account/index.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -32,33 +32,33 @@ We are continuously working to optimize the IAM permissions. Please raise a [Git
3232

3333
Scroll to the bottom of the screen and acknowledge the IAM notice:
3434

35-
![acknowledge IAM](/docs/introduction/setup/your-account/acknowledge-iam.webp)
35+
<img src="/docs/introduction/setup/your-account/acknowledge-iam.webp" alt="acknowledge IAM" width="600" />
3636

3737
Then click the **Create stack** button:
3838

39-
![Create Stack](/docs/introduction/setup/your-account/create-stack.webp)
39+
<img src="/docs/introduction/setup/your-account/create-stack.webp" alt="Create Stack" width="600" />
4040

4141
The CloudFormation stack will take roughly 5 minutes to deploy, and once completed you can retrieve information required to continue from the **Outputs** tab:
4242

43-
![cloudformation outputs](/docs/introduction/setup/your-account/vscode-outputs.webp)
43+
<img src="/docs/introduction/setup/your-account/vscode-outputs.webp" alt="cloudformation outputs" width="600" />
4444

4545
The `IdeUrl` output contains the URL to enter in your browser to access the IDE. The `IdePasswordSecret` contains a link to an AWS Secrets Manager secret that contains a generated password for the IDE.
4646

4747
To retrieve the password open the `IdePasswordSecret` URL and click the **Retrieve** button:
4848

49-
![secretsmanager retrieve](/docs/introduction/setup/your-account/vscode-password-retrieve.webp)
49+
<img src="/docs/introduction/setup/your-account/vscode-password-retrieve.webp" alt="secretsmanager retrieve" width="600" />
5050

5151
The password will then be available for you to copy:
5252

53-
![password in Secrets Manager](/docs/introduction/setup/your-account/vscode-password-visible.webp)
53+
<img src="/docs/introduction/setup/your-account/vscode-password-visible.webp" alt="password in Secrets Manager" width="600" />
5454

5555
Open the IDE URL provided and you will be prompted for the password:
5656

57-
![IDE password prompt](/docs/introduction/setup/your-account/vscode-password.webp)
57+
<img src="/docs/introduction/setup/your-account/vscode-password.webp" alt="IDE password prompt" width="600" />
5858

5959
After submitting your password you will be presented with the initial IDE screen:
6060

61-
![IDE initial screen](/docs/introduction/setup/your-account/vscode-splash.webp)
61+
<img src="/docs/introduction/setup/your-account/vscode-splash.webp" alt="IDE initial screen" width="600" />
6262

6363
The next step is to create an EKS cluster to perform the lab exercises in. Please follow one of the guides below to provision a cluster that meets the requirements for these labs:
6464

website/docs/fastpaths/setup/your-account/using-eksctl.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: Using eksctl
33
sidebar_position: 20
4+
pagination_next: fastpaths/navigating-labs
45
---
56

67
This section outlines how to build a cluster for the lab exercises using the [eksctl tool](https://eksctl.io/). This is the easiest way to get started, and is recommended for most learners.
@@ -26,9 +27,17 @@ This process will take approximately 20 minutes to complete.
2627

2728
## Next Steps
2829

29-
Now that the cluster is ready, head to the [Navigating the labs](/docs/fastpaths/navigating-labs) section or skip ahead to any module in the workshop using the top navigation bar. Once you've completed the workshop, follow the steps below to clean up your environment.
30+
Now that the cluster is ready, head to the Navigating the labs section to get started.
3031

31-
## Cleaning Up (steps once you are done with the Workshop)
32+
import Link from '@docusaurus/Link';
33+
34+
<Link className="button button--primary button--lg" to="/docs/fastpaths/navigating-labs">Continue to Navigating the Labs →</Link>
35+
36+
<br/><br/>
37+
38+
---
39+
40+
## Cleaning Up (after you're done with the entire Workshop)
3241

3342
:::tip
3443
The following demonstrates how to clean up resources once you are done using the EKS cluster. Completing these steps will prevent further charges to your AWS account.

website/docs/fastpaths/setup/your-account/using-terraform.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
11
---
22
title: Using Terraform
33
sidebar_position: 30
4+
pagination_next: null
5+
pagination_prev: null
46
---
57

68
:::danger

0 commit comments

Comments
 (0)