Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 2 additions & 6 deletions docs/learn/concepts.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,17 +6,13 @@ import Intro from '@site/src/components/Intro';
import Steps from '@site/src/components/Steps';
import StepNumber from '@site/src/components/StepNumber';
import Step from '@site/src/components/Step';
import ReactPlayer from 'react-player';
import GettingStartedSlides from '@site/docs/slides/_getting-started.mdx';

<Intro>
Your platform ensures consistent service delivery every time. A well-designed platform seamlessly integrates with your monitoring, security, and compliance systems, building on your established foundation. Automated software delivery pipelines deploy new services quickly and easily. The reference architecture supports AWS EKS, Amazon ECS, and Lambda functions.
</Intro>


<figure>
<ReactPlayer controls url="https://docs.cloudposse.com/assets/refarch/handoffs/introduction-to-toolchain.mp4" />
<figcaption>AI generated voice</figcaption>
</figure>
<GettingStartedSlides />

<Steps>

Expand Down
38 changes: 38 additions & 0 deletions docs/resources/legacy/setup-videos/development.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
---
title: "Development Videos"
sidebar_label: "Development"
description: "Overview videos for component development"
---
import Intro from '@site/src/components/Intro';
import Steps from '@site/src/components/Steps';
import Step from '@site/src/components/Step';
import StepNumber from '@site/src/components/StepNumber';
import PrimaryCTA from '@site/src/components/PrimaryCTA';
import ReactPlayer from 'react-player';

:::warning Legacy Content
These videos are preserved for reference but may not reflect current implementation details.
See the [Component Development](/learn/component-development) documentation for up-to-date information.
:::

<Intro>
This video covers how to develop custom Terraform components using Cloud Posse's
conventions and integrate them with the reference architecture.
</Intro>

<Steps>
<Step>
## <StepNumber/> Component Development

Learn how to build custom Terraform components that integrate with the Cloud Posse
reference architecture. This covers component structure, using Cloud Posse modules,
integrating with Atmos stacks, and following conventions for consistent infrastructure.

<figure>
<ReactPlayer controls url="https://docs.cloudposse.com/assets/refarch/handoffs/component-development.mp4" />
<figcaption>AI generated voice</figcaption>
</figure>

<PrimaryCTA to="/learn/component-development">View Current Documentation</PrimaryCTA>
</Step>
</Steps>
87 changes: 87 additions & 0 deletions docs/resources/legacy/setup-videos/foundation-setup.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,87 @@
---
title: "Foundation Setup Videos"
sidebar_label: "Foundation Setup"
description: "Overview videos for setting up your AWS foundation"
---
import Intro from '@site/src/components/Intro';
import Steps from '@site/src/components/Steps';
import Step from '@site/src/components/Step';
import StepNumber from '@site/src/components/StepNumber';
import PrimaryCTA from '@site/src/components/PrimaryCTA';
import ReactPlayer from 'react-player';

:::warning Legacy Content
These videos are preserved for reference but may not reflect current implementation details.
See the [Foundation Layer](/layers/foundation) for up-to-date documentation.
:::

<Intro>
These videos cover the foundational elements of the Cloud Posse Reference Architecture,
including project setup, account management, identity configuration, and network architecture.
</Intro>

<Steps>
<Step>
## <StepNumber/> Introduction to Toolchain

Learn about the essential tools Cloud Posse uses to manage infrastructure as code.
This guide covers the Geodesic Toolbox Container for standardizing development environments,
the Atmos framework for implementing conventions and workflows, Terraform for managing
cloud infrastructure, and GitHub Actions for CI/CD automation.

<figure>
<ReactPlayer controls url="https://docs.cloudposse.com/assets/refarch/handoffs/introduction-to-toolchain.mp4" />
<figcaption>AI generated voice</figcaption>
</figure>

<PrimaryCTA to="/layers/project">View Current Documentation</PrimaryCTA>
</Step>

<Step>
## <StepNumber/> Account Management

Review how Cloud Posse designs and manages AWS Account architectures using Atmos and Terraform,
aligning with the AWS Well-Architected Framework. This covers provisioning the Terraform state
backend, organizing accounts into Organizational Units (OUs), applying Service Control Policies
(SCPs), and configuring account-level settings.

<figure>
<ReactPlayer controls url="https://docs.cloudposse.com/assets/refarch/handoffs/account-management.mp4" />
<figcaption>AI generated voice</figcaption>
</figure>

<PrimaryCTA to="/layers/accounts">View Current Documentation</PrimaryCTA>
</Step>

<Step>
## <StepNumber/> Identity and Authentication

Learn how Cloud Posse sets up fine-grained access control for an entire organization using
Permission Sets, IAM roles, and AWS IAM Identity Center (SSO). This addresses the challenges
of managing access across multiple AWS accounts with a solution that ensures precise control,
easy role switching, and compatibility with different identity providers.

<figure>
<ReactPlayer controls url="https://docs.cloudposse.com/assets/refarch/handoffs/identity-and-authentication.mp4" />
<figcaption>AI generated voice</figcaption>
</figure>

<PrimaryCTA to="/layers/identity">View Current Documentation</PrimaryCTA>
</Step>

<Step>
## <StepNumber/> Network and DNS

Understand Cloud Posse's approach to designing robust and scalable Network and DNS architectures
on AWS, with a focus on symmetry, account-level isolation, security, and reusability. Covers
account isolation, connecting multiple accounts using Transit Gateways, deploying AWS Client VPN
for remote network access, and differentiating between DNS service discovery and branded vanity domains.

<figure>
<ReactPlayer controls url="https://docs.cloudposse.com/assets/refarch/handoffs/network-and-dns.mp4" />
<figcaption>AI generated voice</figcaption>
</figure>

<PrimaryCTA to="/layers/network">View Current Documentation</PrimaryCTA>
</Step>
</Steps>
83 changes: 83 additions & 0 deletions docs/resources/legacy/setup-videos/platform-setup.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,83 @@
---
title: "Platform Setup Videos"
sidebar_label: "Platform Setup"
description: "Overview videos for setting up your AWS platform"
---
import Intro from '@site/src/components/Intro';
import Steps from '@site/src/components/Steps';
import Step from '@site/src/components/Step';
import StepNumber from '@site/src/components/StepNumber';
import PrimaryCTA from '@site/src/components/PrimaryCTA';
import ReactPlayer from 'react-player';

:::warning Legacy Content
These videos are preserved for reference but may not reflect current implementation details.
See the [Platform Layer](/layers/platform) for up-to-date documentation.
:::

<Intro>
These videos cover the platform elements of the Cloud Posse Reference Architecture,
including software delivery, GitOps automation, container orchestration, and monitoring.
</Intro>

<Steps>
<Step>
## <StepNumber/> Software Delivery / Release Engineering

Learn about Cloud Posse's approach to CI/CD and release engineering. This covers the
philosophy behind treating pipelines as software, using GitHub Actions for automation,
and implementing consistent deployment patterns across environments.

<figure>
<ReactPlayer controls url="https://docs.cloudposse.com/assets/refarch/handoffs/release-engineering.mp4" />
<figcaption>AI generated voice</figcaption>
</figure>

<PrimaryCTA to="/layers/software-delivery">View Current Documentation</PrimaryCTA>
</Step>

<Step>
## <StepNumber/> GitOps with Terraform

Understand how to implement GitOps for Terraform using GitHub Actions. This covers
plan/apply workflows, drift detection, and the integration with Atmos for managing
infrastructure deployments through pull requests.

<figure>
<ReactPlayer controls url="https://docs.cloudposse.com/assets/refarch/handoffs/gitops.mp4" />
<figcaption>AI generated voice</figcaption>
</figure>

<PrimaryCTA to="/layers/gitops">View Current Documentation</PrimaryCTA>
</Step>

<Step>
## <StepNumber/> ECS Platform

Learn about Amazon ECS (Elastic Container Service) as a container orchestration solution.
This covers the benefits of ECS over Kubernetes for simpler deployments, cluster configuration,
service deployment, and integration with the reference architecture.

<figure>
<ReactPlayer controls url="https://docs.cloudposse.com/assets/refarch/handoffs/ecs.mp4" />
<figcaption>AI generated voice</figcaption>
</figure>

<PrimaryCTA to="/layers/ecs">View Current Documentation</PrimaryCTA>
</Step>

<Step>
## <StepNumber/> Monitoring and SRE

Understand Cloud Posse's approach to monitoring and observability. This covers integrating
with Datadog, setting up monitors, implementing SLIs/SLOs, and building a monitoring-as-code
approach using Terraform.

<figure>
<ReactPlayer controls url="https://docs.cloudposse.com/assets/refarch/handoffs/monitoring.mp4" />
<figcaption>AI generated voice</figcaption>
</figure>

<PrimaryCTA to="/layers/monitoring">View Current Documentation</PrimaryCTA>
</Step>
</Steps>
21 changes: 21 additions & 0 deletions docs/resources/legacy/setup-videos/setup-videos.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
---
title: "Legacy Setup Videos"
sidebar_label: "Setup Videos"
description: "AI-generated overview videos for the Cloud Posse Reference Architecture"
---
import Intro from '@site/src/components/Intro';
import DocCardList from '@theme/DocCardList';

:::warning Legacy Content
These AI-generated overview videos were created during the initial documentation development.
They provide high-level overviews but may not reflect the latest implementation details.

**For current documentation**, please refer to the main documentation sections for each layer.
:::

<Intro>
These videos provide AI-narrated overviews of the Cloud Posse Reference Architecture.
They are organized by the major setup phases: Foundation, Platform, and Development.
</Intro>

<DocCardList />
Loading