Skip to content

Commit 6f2ae82

Browse files
ebeneliasonebeneliason
authored
Card list (#115)
* Introduce CardGroup and CardList components * CardList chapters for Intro guide * CardList chapters for Build it Yourself guides * Clarify page title for production grade design intros
1 parent 7234c29 commit 6f2ae82

File tree

26 files changed

+524
-326
lines changed

26 files changed

+524
-326
lines changed

‎_docs-sources/guides/build-it-yourself/2-landing-zone/0-intro/0-what-youll-learn-in-this-guide.md

Lines changed: 34 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,8 @@ sidebar_label: What you’ll learn in this guide
33
pagination_label: Configure Your Accounts With Landing Zone
44
---
55

6+
import { CardList } from "/src/components/CardGroup"
7+
68
# Configure Your Accounts with Landing Zone
79

810
:::caution
@@ -11,32 +13,37 @@ This guide hasn’t been updated in the past 6 months. If you find any inaccurac
1113

1214
:::
1315

14-
This guide will walk you through the process of configuring a production-grade AWS account structure, including how to manage multiple environments, users, permissions, and audit logging. We’ll also discuss how to implement a Landing Zone solution that lets you quickly spin up new AWS accounts that all implement a security baseline that enforces your company’s policies.
15-
16-
This guide consists of four main sections:
17-
18-
<div className="dlist">
19-
20-
#### [Core concepts](../1-core-concepts/0-aws-account.md)
21-
22-
An overview of the core concepts you need to understand to set up an AWS account structure, including AWS
23-
Organizations, IAM Users, IAM Roles, IAM Groups, CloudTrail, and more.
24-
25-
#### [Production-grade design](../2-production-grade-design/0-intro.md)
16+
## Overview
2617

27-
An overview of how to configure a secure, scalable, highly available AWS account structure that you can rely on in
28-
production. To get a sense of what production-grade means, check out
29-
[The production-grade infrastructure checklist](https://gruntwork.io/guides/foundations/how-to-use-gruntwork-infrastructure-as-code-library#production_grade_infra_checklist).
30-
31-
#### [Deployment walkthrough](../3-deployment-walkthrough/0-pre-requisites.md)
32-
33-
A step-by-step guide to configuring a production-grade AWS account structure using the Gruntwork AWS Landing Zone
34-
solution, including how to manage it all with customizable security baselines defined in Terraform.
35-
36-
#### [Next steps](../4-next-steps.md)
37-
38-
What to do once you’ve got your AWS account structure configured.
39-
40-
</div>
18+
This guide will walk you through the process of configuring a production-grade AWS account structure, including how to manage multiple environments, users, permissions, and audit logging. We’ll also discuss how to implement a Landing Zone solution that lets you quickly spin up new AWS accounts that all implement a security baseline that enforces your company’s policies.
4119

42-
Feel free to read the guide from start to finish or skip around to whatever part interests you.
20+
## Sections
21+
22+
Feel free to read this guide from start to finish or skip around to whatever sections interest you.
23+
24+
<CardList>
25+
<Card
26+
title="Core Concepts"
27+
href="../core-concepts/aws-account"
28+
>
29+
An overview of the core concepts you need to understand to set up an AWS account structure, including AWS Organizations, IAM Users, IAM Roles, IAM Groups, CloudTrail, and more.
30+
</Card>
31+
<Card
32+
title="Production-grade Design"
33+
href="../production-grade-design/intro"
34+
>
35+
An overview of how to configure a secure, scalable, highly available AWS account structure that you can rely on in production.
36+
</Card>
37+
<Card
38+
title="Deployment Walkthrough"
39+
href="../deployment-walkthrough/pre-requisites"
40+
>
41+
A step-by-step guide to configuring a production-grade AWS account structure using the Gruntwork AWS Landing Zone solution, including how to manage it all with customizable security baselines defined in Terraform.
42+
</Card>
43+
<Card
44+
title="Next Steps"
45+
href="../next-steps"
46+
>
47+
What to do once you’ve got your AWS account structure configured.
48+
</Card>
49+
</CardList>

‎_docs-sources/guides/build-it-yourself/2-landing-zone/2-production-grade-design/0-intro.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
pagination_label: Production-grade Design
33
---
44

5-
# Intro
5+
# Intro to Production-grade Design
66

77
With all the core concepts out of the way, let’s now discuss how to configure a production-grade AWS account structure that looks something like this:
88

‎_docs-sources/guides/build-it-yourself/3-pipelines/0-intro/0-what-youll-learn-in-this-guide.md

Lines changed: 38 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,8 @@ sidebar_label: What you’ll learn in this guide
33
pagination_label: Set Up an Infrastructure CI/CD Pipeline
44
---
55

6+
import { CardList } from "/src/components/CardGroup"
7+
68
# Set Up an Infrastructure CI/CD Pipeline
79

810
:::caution
@@ -11,6 +13,8 @@ This guide hasn’t been updated in the past 6 months. If you find any inaccurac
1113

1214
:::
1315

16+
## Overview
17+
1418
This is a comprehensive guide of how to design, configure, and implement a Continuous Integration and Continuous
1519
Delivery pipeline for your infrastructure code. This guide will walk you through the steps to set up a secure CI/CD
1620
pipeline for your favorite infrastructure as code tools (e.g., Terraform) using your favorite CI/CD platform (e.g.,
@@ -20,29 +24,37 @@ TLDR: If you follow this guide, you’ll be able to set up a pipeline that works
2024

2125
![For an extended version with audio commentary, see <https://youtu.be/iYXghJK7YdU>](/img/guides/build-it-yourself/pipelines/walkthrough.gif)
2226

23-
This guide consists of four main sections:
24-
25-
<div className="dlist">
26-
27-
#### [Core Concepts](../1-core-concepts/0-why-is-it-important-to-have-ci-cd.md)
28-
29-
An overview of the core concepts you need to understand what a typical CI/CD pipeline entails for infrastructure code,
30-
including a comparison with CI/CD for application code, a sample workflow, infrastructure to support CI/CD, and threat
31-
models to consider to protect your infrastructure.
32-
33-
#### [Production-grade design](../2-production-grade-design/0-intro.md)
34-
35-
An overview of how to configure a secure, scalable, and robust CI/CD workflow that you can rely on for your
36-
production application and infrastructure code. To get a sense of what production-grade means, check out
37-
[The production-grade infrastructure checklist](https://gruntwork.io/guides/foundations/how-to-use-gruntwork-infrastructure-as-code-library#production_grade_infra_checklist).
38-
39-
#### [Deployment walkthrough](../3-deployment-walkthrough/0-pre-requisites.md)
40-
41-
A step-by-step guide to deploying a production-grade CI/CD pipeline in AWS using code from the Gruntwork
42-
Infrastructure as Code Library.
43-
44-
#### [Next steps](../4-next-steps.md)
45-
46-
What to do once you’ve got your CI/CD pipeline set up.
47-
48-
</div>
27+
## Sections
28+
29+
Feel free to read this guide from start to finish or skip around to whatever sections interest you.
30+
31+
<CardList>
32+
<Card
33+
title="Core Concepts"
34+
href="../core-concepts/why-is-it-important-to-have-ci-cd"
35+
>
36+
An overview of the core concepts you need to understand what a typical CI/CD pipeline entails for infrastructure code,
37+
including a comparison with CI/CD for application code, a sample workflow, infrastructure to support CI/CD, and threat
38+
models to consider to protect your infrastructure.
39+
</Card>
40+
<Card
41+
title="Production-grade Design"
42+
href="../production-grade-design/intro"
43+
>
44+
An overview of how to configure a secure, scalable, and robust CI/CD workflow that you can rely on for your
45+
production application and infrastructure code.
46+
</Card>
47+
<Card
48+
title="Deployment Walkthrough"
49+
href="../deployment-walkthrough/pre-requisites"
50+
>
51+
A step-by-step guide to deploying a production-grade CI/CD pipeline in AWS using code from the Gruntwork
52+
Infrastructure as Code Library.
53+
</Card>
54+
<Card
55+
title="Next Steps"
56+
href="../next-steps"
57+
>
58+
What to do once you’ve got your CI/CD pipeline set up.
59+
</Card>
60+
</CardList>

‎_docs-sources/guides/build-it-yourself/3-pipelines/2-production-grade-design/0-intro.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ pagination_label: Production Grade Design
33
sidebar_label: Intro
44
---
55

6-
# Intro to Production Grade Design
6+
# Intro to Production-grade Design
77

88
With all the core concepts out of the way, let’s now discuss how to configure a production-grade CI/CD workflow for
99
infrastructure code, using a platform that looks something like this:

‎_docs-sources/guides/build-it-yourself/4-vpc/0-intro/0-what-youll-learn-in-this-guide.md

Lines changed: 33 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,8 @@ sidebar_label: What you’ll learn in this guide
33
pagination_label: Deploy a Production-grade VPC
44
---
55

6+
import { CardList } from "/src/components/CardGroup"
7+
68
# Deploy a Production-grade VPC
79

810
:::caution
@@ -11,28 +13,34 @@ This guide hasn’t been updated in the past 6 months. If you find any inaccurac
1113

1214
:::
1315

14-
This guide consists of four main sections:
15-
16-
<div className="dlist">
17-
18-
#### [Core concepts](../1-core-concepts/0-default-vp-cs-and-custom-vp-cs.md)
19-
20-
An overview of the core concepts you need to understand to use VPCs, including subnets, route tables, security
21-
groups, NACLs, peering connections, and endpoints.
22-
23-
#### [Production-grade design](../2-production-grade-design/0-intro.md)
24-
25-
An overview of how to configure a secure, scalable, highly available VPC that you can rely on in production. To get a
26-
sense of what production-grade means, check out [The production-grade infrastructure checklist](https://gruntwork.io/guides/foundations/how-to-use-gruntwork-infrastructure-as-code-library#production_grade_infra_checklist).
27-
28-
#### [Deployment walkthrough](../3-deployment-walkthrough/0-pre-requisites.md)
29-
30-
A step-by-step guide to deploying a production-grade VPC in AWS using code from the Gruntwork Infrastructure as Code Library.
31-
32-
#### [Next steps](../4-next-steps.md)
33-
34-
What to do once you’ve got your VPC(s) deployed.
35-
36-
</div>
37-
38-
Feel free to read the guide from start to finish or skip around to whatever part interests you!
16+
## Sections
17+
18+
Feel free to read this guide from start to finish or skip around to whatever sections interest you.
19+
20+
<CardList>
21+
<Card
22+
title="Core Concepts"
23+
href="../core-concepts/default-vp-cs-and-custom-vp-cs"
24+
>
25+
An overview of the core concepts you need to understand to use VPCs, including subnets, route tables, security
26+
groups, NACLs, peering connections, and endpoints.
27+
</Card>
28+
<Card
29+
title="Production-grade Design"
30+
href="../production-grade-design/intro"
31+
>
32+
An overview of how to configure a secure, scalable, highly available VPC that you can rely on in production.
33+
</Card>
34+
<Card
35+
title="Deployment Walkthrough"
36+
href="../deployment-walkthrough/pre-requisites"
37+
>
38+
A step-by-step guide to deploying a production-grade VPC in AWS using code from the Gruntwork Infrastructure as Code Library.
39+
</Card>
40+
<Card
41+
title="Next Steps"
42+
href="../next-steps"
43+
>
44+
What to do once you’ve got your VPC(s) deployed.
45+
</Card>
46+
</CardList>

‎_docs-sources/guides/build-it-yourself/4-vpc/2-production-grade-design/0-intro.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
pagination_label: Introduction to Production-grade design
33
---
44

5-
# Intro
5+
# Intro to Production-grade Design
66

77
With all the core concepts out of the way, let’s now discuss how to configure a production-grade VPC that looks
88
something like this:

‎_docs-sources/guides/build-it-yourself/5-kubernetes-cluster/0-intro/0-what-youll-learn-in-this-guide.md

Lines changed: 36 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,8 @@ sidebar_label: What you’ll learn in this guide
33
pagination_label: Deploy a Production-grade Kubernetes Cluster
44
---
55

6+
import { CardList } from "/src/components/CardGroup"
7+
68
# Deploy a Production-grade Kubernetes Cluster
79

810
:::caution
@@ -11,33 +13,37 @@ This guide hasn’t been updated in the past 6 months. If you find any inaccurac
1113

1214
:::
1315

14-
This guide will walk you through the process of configuring a production-grade Kubernetes cluster on AWS.
15-
16-
The guide consists of four main sections:
17-
18-
<div className="dlist">
19-
20-
#### [Core concepts](../1-core-concepts/0-why-kubernetes.md)
21-
22-
An overview of the core concepts you need to understand to use Kubernetes, including why you may want to use
23-
Kubernetes, Kubernetes architecture, the control plane, worker nodes, different ways to run Kubernetes, services,
24-
deployments, auto scaling, auto healing, RBAC, and more.
25-
26-
#### [Production-grade design](../2-production-grade-design/1-use-eks.md)
27-
28-
An overview of how to configure a secure, scalable, highly available Kubernetes cluster that you can rely on in
29-
production. To get a sense of what production-grade means, check out
30-
[The production-grade infrastructure checklist](https://gruntwork.io/guides/foundations/how-to-use-gruntwork-infrastructure-as-code-library#production_grade_infra_checklist).
31-
32-
#### [Deployment walkthrough](../3-deployment-walkthrough/0-pre-requisites.md)
33-
34-
A step-by-step guide to deploying a production-grade Kubernetes cluster in AWS using code from the Gruntwork
35-
Infrastructure as Code Library.
36-
37-
#### [Next steps](../4-next-steps.md)
38-
39-
What to do once you’ve got your Kubernetes cluster deployed.
40-
41-
</div>
42-
43-
Feel free to read the guide from start to finish or skip around to whatever part interests you!
16+
## Sections
17+
18+
This guide will walk you through the process of configuring a production-grade Kubernetes cluster on AWS. Feel free to read it from start to finish or skip around to whatever sections interest you.
19+
20+
<CardList>
21+
<Card
22+
title="Core Concepts"
23+
href="../core-concepts/why-kubernetes"
24+
>
25+
An overview of the core concepts you need to understand to use Kubernetes, including why you may want to use
26+
ubernetes, Kubernetes architecture, the control plane, worker nodes, different ways to run Kubernetes, services,
27+
deployments, auto scaling, auto healing, RBAC, and more.
28+
</Card>
29+
<Card
30+
title="Production-grade Design"
31+
href="../production-grade-design/intro"
32+
>
33+
An overview of how to configure a secure, scalable, highly available Kubernetes cluster that you can rely on in
34+
production.
35+
</Card>
36+
<Card
37+
title="Deployment Walkthrough"
38+
href="../deployment-walkthrough/pre-requisites"
39+
>
40+
A step-by-step guide to deploying a production-grade Kubernetes cluster in AWS using code from the Gruntwork
41+
Infrastructure as Code Library.
42+
</Card>
43+
<Card
44+
title="Next Steps"
45+
href="../next-steps"
46+
>
47+
What to do once you’ve got your Kubernetes cluster deployed.
48+
</Card>
49+
</CardList>

‎_docs-sources/guides/build-it-yourself/5-kubernetes-cluster/2-production-grade-design/0-intro.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
pagination_label: Production-grade Design
33
---
44

5-
# Intro
5+
# Intro to Production-grade Design
66

77
With all the core concepts out of the way, let's now discuss how to configure a production-grade Kubernetes cluster
88
that looks something like this:

0 commit comments

Comments
 (0)