From 7fd1f3e5e93cc47a0d95d33d3baf89f587bf06ae Mon Sep 17 00:00:00 2001 From: Zinovii Dmytriv Date: Tue, 11 Apr 2023 19:59:55 +0300 Subject: [PATCH] Added "Slack Archives" to "Community" dropdown + Building Blocks page (#577) Added "Slack Archives" to "Community" dropdown + Building Blocks page --- content/docs/fundamentals/building-blocks.md | 41 +++++++++++++++++++ docusaurus.config.js | 29 ++++++++++--- .../sections/home-callouts/home-callouts.js | 8 ++-- 3 files changed, 68 insertions(+), 10 deletions(-) create mode 100644 content/docs/fundamentals/building-blocks.md diff --git a/content/docs/fundamentals/building-blocks.md b/content/docs/fundamentals/building-blocks.md new file mode 100644 index 000000000..33e51bd16 --- /dev/null +++ b/content/docs/fundamentals/building-blocks.md @@ -0,0 +1,41 @@ +--- +title: Building Blocks +description: 'Building Blocks' +sidebar_position: 25 +--- + +The SweetOps solution by Cloud Posse is a powerful framework for DevOps, designed with multiple building blocks that offer various levels of abstraction. This modular approach allows for complete customization to meet the unique requirements of any business, ensuring a tailored solution that aligns with specific needs and objectives. To understand how it works, it's important to know how these parts work together: [Geodesic](/tutorials/geodesic-getting-started/), [Atmos](https://atmos.tools), [Terraform Components](/components/) (root modules), [Terraform Modules](/modules/), and [GitHub Actions](/github-actions/). + +## Geodesic + +**Your DevOps Toolbox** + +[Geodesic](/tutorials/geodesic-getting-started/) is the ultimate DevOps toolbox, encapsulated within a Docker image. It eliminates the need for individual installations of Terraform, Kubernetes, Helmfile, AWS CLI, and other core tools in the SweetOps methodology. Geodesic is versatile, serving as an interactive cloud automation shell, a base image for other containers, or a crucial element in CI/CD workflows. + +## Atmos + +**Your Workflow Automation Conductor** + +[Atmos](https://atmos.tools) takes the reins as a DevOps workflow automation tool, adept at managing large-scale and intricate infrastructures. It empowers users to manage DRY configurations hierarchically, foster team collaboration, and enforce guardrails through policies as code. Atmos relies on YAML configuration and supports multiple inheritance, simplifying the process of defining and reusing logical groups of configuration. We usually run Atmos inside of Geodesic, but it's not a requirement. + +## Terraform Components + +**Blueprints for Infrastructure Patterns** + +[Terraform Components](/components/) (Root Modules) act as the foundational Terraform configurations for high-level infrastructure elements, such as Kubernetes clusters or VPCs. These root modules enable reusability across different environments, and frequently leverage Terraform child modules, streamlining infrastructure management. + +## Terraform Modules + +**Bricks of Infrastructure Business Logic** + +[Terraform Modules](/modules/) are smaller building blocks of infrastructure that are invoked by components to dictate the business logic associated with configuring infrastructure resources. These versatile modules can be shared among multiple Terraform configurations, allowing for the creation, updating, and deletion of infrastructure resources. + +## GitHub Actions + +**Your Deployment Automation Platform** + +[GitHub Actions](/github-actions/) play a pivotal role as the CI/CD tool, automating software workflows to build, test, and deploy code changes. This powerful platform integrates seamlessly with Geodesic, Atmos and Terraform components and modules, automating deployment to infrastructure environments. + +## TL;DR + +The various building blocks we leverage are [Geodesic](/tutorials/geodesic-getting-started/) as a comprehensive DevOps toolbox, [Atmos](https://atmos.tools) as a workflow automation conductor, [Terraform components](/components/) and [modules](/modules/) as the architects of infrastructure elements and resources, and [GitHub Actions](/github-actions/) as the deployment automation platform. This unified approach empowers teams to efficiently manage and scale their cloud infrastructure. \ No newline at end of file diff --git a/docusaurus.config.js b/docusaurus.config.js index e08207b58..652aae874 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -146,6 +146,7 @@ const config = { type: 'dropdown', label: 'Building Blocks', position: 'left', + to: '/fundamentals/building-blocks/', items: [ { to: '/components/', @@ -177,7 +178,7 @@ const config = { position: 'right', items: [ { - label: 'Forum', + label: 'GitHub Discussions', href: 'https://ask.sweetops.com/', }, { @@ -187,7 +188,15 @@ const config = { { label: 'Slack', href: 'https://slack.sweetops.com/', - } + }, + { + label: 'Slack Archives', + href: 'https://archive.sweetops.com/refarch/', + }, + { + label: 'Office Hours', + href: 'https://cloudposse.com/office-hours/', + }, ], }, { @@ -222,8 +231,8 @@ const config = { label: 'Getting Started', to: '/intro/', }, { - label: 'SweetOps Fundamentals', - to: '/category/fundamentals/', + label: 'Building Blocks', + to: '/fundamentals/building-blocks/', }, { label: 'Tutorials', to: '/category/tutorials/', @@ -235,7 +244,7 @@ const config = { title: 'Community', items: [ { - label: 'Forum', + label: 'Github Discussions', href: 'https://ask.sweetops.com/', }, { @@ -245,7 +254,15 @@ const config = { { label: 'Slack', href: 'https://slack.sweetops.com/', - } + }, + { + label: 'Slack Archives', + href: 'https://archive.sweetops.com/refarch/', + }, + { + label: 'Office Hours', + href: 'https://cloudposse.com/office-hours/', + }, ], }, { title: 'Contact Us', diff --git a/src/theme/sections/home-callouts/home-callouts.js b/src/theme/sections/home-callouts/home-callouts.js index 8e3671b56..09e6db062 100644 --- a/src/theme/sections/home-callouts/home-callouts.js +++ b/src/theme/sections/home-callouts/home-callouts.js @@ -13,10 +13,10 @@ export default function HomeCallouts() { url: useBaseUrl('/intro/'), }, { - title: 'SweetOps Fundamentals', - subtitle: 'Check out our main concepts and philosophy', - urlText: 'Our Fundamentals', - url: useBaseUrl('/category/fundamentals/'), + title: 'Building Blocks', + subtitle: 'Check out our building blocks', + urlText: 'Our Building Blocks', + url: useBaseUrl('/fundamentals/building-blocks/'), }, { title: 'Tutorials',