Expanding Series functionality (#15269)

adamgordonbell · web-flow · commit 2171254f6911 · 2025-06-10T12:18:00.000-04:00
* Add blog series page, data, and layout; update tag template for series display

* Add sidebar for blog series navigation on series tag pages

* Add series prefix handling in sidebar and update title display logic

* Refactor series sidebar layout to conditionally display series title and description based on availability.

* Refactor blog titles for consistency and improved clarity by changing the format to include colons instead of commas for series identifying parts.

* Enhance blog series sidebar: Add series data display and update markup for consistency.

* Refactor blog series sidebar title display for improved readability and reuse of title components.

* Refactor blog tags and update blog series list for clarity and accuracy.

* Enhance blog series descriptions for clarity and detail in `blog_series.yml`.

* Add meta images for blog series and introduce a script to extract series metadata from blog posts.

* Remove extract_series_meta_images.py script and its functionality.
diff --git a/content/blog/advanced-aws-networking-part-1/index.md b/content/blog/advanced-aws-networking-part-1/index.md
@@ -1,5 +1,5 @@
 ---
-title: "Advanced AWS Networking, Part 1"
+title: "Advanced AWS Networking: Part 1"
 
 # The date represents the post's publish date,
 # and by default corresponds with the date this file was generated.
diff --git a/content/blog/advanced-aws-networking-part-2/index.md b/content/blog/advanced-aws-networking-part-2/index.md
@@ -1,5 +1,5 @@
 ---
-title: "Advanced AWS Networking, Part 2"
+title: "Advanced AWS Networking: Part 2"
 
 # The date represents the post's publish date,
 # and by default corresponds with the date this file was generated.
diff --git a/content/blog/aws-serverless-analytics/index.md b/content/blog/aws-serverless-analytics/index.md
@@ -1,7 +1,7 @@
 ---
 title: "AWS Serverless Analytics"
 authors: ["evan-boyle"]
-tags: ["aws", "data-and-analytics", "serverless", "architecture-as-code"]
+tags: ["aws", "data-and-analytics", "serverless"]
 date: "2020-01-30"
 meta_desc: "Building a serverless data warehouse on AWS using architecture as code."
 meta_image: "ServerlessArchitecture.png"
diff --git a/content/blog/cloud-systems-part-one/index.md b/content/blog/cloud-systems-part-one/index.md
@@ -1,5 +1,5 @@
 ---
-title: "Cloud Systems Part One: Static Sites and AWS S3"
+title: "Cloud Systems: Static Sites and AWS S3"
 
 date: 2021-12-15
 
diff --git a/content/blog/cloud-systems-part-three/index.md b/content/blog/cloud-systems-part-three/index.md
@@ -1,5 +1,5 @@
 ---
-title: "Cloud Systems Part Three: Deploying to Amazon ECS"
+title: "Cloud Systems: Deploying to Amazon ECS"
 
 date: 2021-12-28T14:52:42Z
 
diff --git a/content/blog/cloud-systems-part-two/index.md b/content/blog/cloud-systems-part-two/index.md
@@ -1,5 +1,5 @@
 ---
-title: "Cloud Systems Part Two: Containerizing a Website"
+title: "Cloud Systems: Containerizing a Website"
 
 date: 2021-12-27T12:26:10-08:00
 
diff --git a/content/blog/creating-and-reusing-cloud-components-using-package-managers/index.md b/content/blog/creating-and-reusing-cloud-components-using-package-managers/index.md
@@ -1,7 +1,7 @@
 ---
 title: "Creating and Reusing Cloud Components using Package Managers"
 authors: ["chris-smith"]
-tags: ["packages", "architecture-as-code"]
+tags: ["packages"]
 meta_desc: "Pulumi's code-centric approach to infrastructure can make you more productive programming the cloud. Package up, share, and reuse our code."
 date: "2018-08-09"
 
diff --git a/content/blog/embrace-kubernetes-part1/index.md b/content/blog/embrace-kubernetes-part1/index.md
@@ -1,5 +1,5 @@
 ---
-title: "It’s Time to Embrace Kubernetes! Really? (Part 1)"
+title: "It's Time to Embrace Kubernetes: Part 1"
 date: 2020-12-09
 meta_desc: "How to evaluate your choices when choosing Kubernetes as your application platform"
 meta_image: embrace-k8s.png
diff --git a/content/blog/embrace-kubernetes-part2/index.md b/content/blog/embrace-kubernetes-part2/index.md
@@ -1,5 +1,5 @@
 ---
-title: "It’s Time to Embrace Kubernetes! Really? (Part 2)"
+title: "It's Time to Embrace Kubernetes: Part 2"
 date: 2020-12-11
 meta_desc: "How to evaluate your choices when choosing Kubernetes as your application platform."
 meta_image: embrace-k8s.png
diff --git a/content/blog/kubernetes-fundamentals-part-one/index.md b/content/blog/kubernetes-fundamentals-part-one/index.md
@@ -1,5 +1,5 @@
 ---
-title: "Kubernetes Fundamentals Part One"
+title: "Kubernetes Fundamentals: Part One"
 date: 2021-07-23T12:54:53-05:00
 draft: false
 meta_image: k8s-fundamentals.png
diff --git a/content/blog/kubernetes-fundamentals-part-two/index.md b/content/blog/kubernetes-fundamentals-part-two/index.md
@@ -1,5 +1,5 @@
 ---
-title: "Kubernetes Fundamentals Part Two"
+title: "Kubernetes Fundamentals: Part Two"
 date: 2021-09-02T12:54:53-05:00
 draft: false
 meta_image: k8s-fundamentals.png
diff --git a/content/blog/managing-aws-credentials-on-cicd-part-1/index.md b/content/blog/managing-aws-credentials-on-cicd-part-1/index.md
@@ -1,7 +1,7 @@
 ---
-title: "Managing AWS Credentials on CI/CD"
+title: "Managing AWS Credentials on CI/CD: Part 1"
 date: 2020-03-12
-meta_desc: "Best practices for managing AWS credentials on CI/CD"
+meta_desc: "Best practices for managing AWS credentials on CI/CD: Part 1 in series"
 meta_image: meta.png
 authors:
     - chris-smith
diff --git a/content/blog/managing-aws-credentials-on-cicd-part-2/index.md b/content/blog/managing-aws-credentials-on-cicd-part-2/index.md
@@ -1,7 +1,7 @@
 ---
-title: "Managing AWS Credentials on CI/CD - Part 2"
+title: "Managing AWS Credentials on CI/CD: Part 2"
 date: 2020-03-26
-meta_desc: "Best practices for managing AWS credentials on CI/CD - Part 2 in the series"
+meta_desc: "Best practices for managing AWS credentials on CI/CD: Part 2 in the series"
 meta_image: key.png
 authors:
     - chris-smith
diff --git a/content/blog/managing-aws-credentials-on-cicd-part-3/index.md b/content/blog/managing-aws-credentials-on-cicd-part-3/index.md
@@ -1,7 +1,7 @@
 ---
-title: "Managing AWS Credentials on CI/CD - Part 3"
+title: "Managing AWS Credentials on CI/CD: Part 3"
 date: 2020-05-14
-meta_desc: "Best practices for managing AWS credentials on CI/CD - Part 3 in the series"
+meta_desc: "Best practices for managing AWS credentials on CI/CD: Part 3 in the series"
 meta_image: cicd.png
 authors:
     - chris-smith
diff --git a/content/blog/organizational-patterns-automation-team/index.md b/content/blog/organizational-patterns-automation-team/index.md
@@ -1,5 +1,5 @@
 ---
-title: "Organizational Patterns - An Automation Team"
+title: "Organizational Patterns: An Automation Team"
 
 # The date represents the post's publish date, and by default corresponds with
 # the date this file was generated. Posts with future dates are visible in development,
diff --git a/content/blog/organizational-patterns-developer-portal/index.md b/content/blog/organizational-patterns-developer-portal/index.md
@@ -1,5 +1,5 @@
 ---
-title: "Organizational Patterns - A Developer Portal"
+title: "Organizational Patterns: A Developer Portal"
 
 # The date represents the post's publish date, and by default corresponds with
 # the date this file was generated. Posts with future dates are visible in development,
diff --git a/content/blog/organizational-patterns-infra-repo/index.md b/content/blog/organizational-patterns-infra-repo/index.md
@@ -1,5 +1,5 @@
 ---
-title: "Organizational Patterns - A Single Infra Repo"
+title: "Organizational Patterns: A Single Infra Repo"
 
 # The date represents the post's publish date, and by default corresponds with
 # the date this file was generated. Posts with future dates are visible in development,
diff --git a/content/blog/series.md b/content/blog/series.md
@@ -0,0 +1,7 @@
+---
+title: "Pulumi Blog: All series"
+layout: series
+meta_desc: A list of all Pulumi blog series, sorted alphabetically.
+---
+
+All [Pulumi blog](/blog/) series, sorted alphabetically.
diff --git a/data/blog_series.yml b/data/blog_series.yml
@@ -0,0 +1,62 @@
+# List of tags that represent blog series
+# These tags will be displayed on the /blog/series/ page
+# Ordered by most recent post date (newest first)
+series:
+  - slug: "platform-engineering-pillars"
+    title: "Platform Engineering Pillars Series"
+    description: "Six essential pillars for transforming infrastructure chaos into streamlined developer platforms: provisioning, self-service, workflows, security, observability, and governance."
+    meta_image: "/blog/platform-engineering-pillars-1/meta.png"
+  - slug: "ai-slack-bot"
+    title: "AI Slack Bot Series"
+    description: "Build AI-powered Slack bots using RAG, Embedchain, and AWS infrastructure with Pulumi, from basic chatbots to production-ready systems with real-time document processing."
+    meta_image: "/blog/ai-slack-bot-to-chat-using-embedchain-and-pulumi-on-aws/meta.png"
+  - slug: "iac-best-practices"
+    title: "IaC Best Practices Series"
+    description: "Master Infrastructure as Code through a real-world case study: code organization, stack management, developer workflows, security patterns, and automation strategies for containerized applications on Kubernetes."
+    prefix: "IaC Best Practices: "
+    meta_image: "/blog/iac-best-practices-understanding-code-organization-stacks/meta.png"
+  - slug: "aws-networking-advanced"
+    title: "Advanced AWS Networking Series"
+    description: "Build hub-and-spoke network architecture in AWS with centralized egress and traffic inspection using Pulumi. Covers Transit Gateway setup, inspection VPC implementation, spoke VPC configuration, cost optimization through shared NAT gateways, and AWS Network Firewall integration for centralized security policies."
+    prefix: "Advanced AWS Networking: "
+    meta_image: "/blog/advanced-aws-networking-part-1/aws-advanced-networking-part-1.png"
+  - slug: "organizational-patterns"
+    title: "Organizational Patterns Series"
+    description: "Platform teams implementing infrastructure patterns to enable developer self-service through centralized repositories, automation teams, and developer portals using Pulumi"
+    prefix: "Organizational Patterns: "
+    meta_image: "/blog/organizational-patterns-infra-repo/meta.png"
+  - slug: "cloud-systems"
+    title: "Cloud Systems Series"
+    description: "Hands-on guide to modern cloud engineering practices: build and deploy a personal website through static hosting (S3), containerization (Docker), and orchestration (AWS ECS/Fargate) using infrastructure as code"
+    prefix: "Cloud Systems: "
+    meta_image: "/blog/cloud-systems-part-one/meta.png"
+  - slug: "kubernetes-fundamentals"
+    title: "Kubernetes Fundamentals Series"
+    description: "Learn container orchestration from local development to managed cloud services - deploy containerized apps, manage scaling, understand cluster architecture, and bridge Dev/Ops workflows using YAML and infrastructure as code with Pulumi."
+    prefix: "Kubernetes Fundamentals: "
+    meta_image: "/blog/kubernetes-fundamentals-part-one/k8s-fundamentals.png"
+  - slug: "azure-top-5"
+    title: "Top 5 Things for Azure Developers Series"
+    description: "Master virtual machines, serverless functions, static websites, Kubernetes cluster deployment, and DevOps automation on Azure"
+    prefix: "Top 5 Things an Azure Developer Needs to Know: "
+    meta_image: "/blog/top-5-things-for-azure-devs-intro/azure-top-5.png"
+  - slug: "embrace-kubernetes"
+    title: "Embrace Kubernetes Series"
+    description: "Learn strategic Kubernetes adoption: evaluate organizational readiness, assess technical requirements, identify suitable first projects, and implement Kubernetes where it delivers real business value"
+    prefix: "It's Time to Embrace Kubernetes: "
+    meta_image: "/blog/embrace-kubernetes-part1/embrace-k8s.png"
+  - slug: "kubernetes-getting-started"
+    title: "Getting Started with Kubernetes Series"
+    description: "Build Kubernetes clusters on AWS, Azure, GCP and deploy applications using Infrastructure as Code. Learn core objects like pods, services, volumes, deployments and move from basic setups to complex microservices."
+    prefix: "Getting Started With Kubernetes: "
+    meta_image: "/blog/getting-started-with-k8s-part1/getting-started.png"
+  - slug: "aws-credentials-cicd"
+    title: "Managing AWS Credentials on CI/CD Series"
+    description: "Step-by-step guide to secure AWS credentials in CI/CD pipelines: create dedicated IAM users, automate credential rotation, assume IAM roles for temporary access, and encrypt sensitive data with Pulumi. Includes serverless automation code and multi-account security patterns."
+    prefix: "Managing AWS Credentials on CI/CD:"
+    meta_image: "/blog/managing-aws-credentials-on-cicd-part-1/meta.png"
+  - slug: "architecture-as-code"
+    title: "Architecture as Code Series"
+    description: "Learn how to abstract infrastructure components across virtual machines, serverless, Kubernetes, and microservices architectures using modern programming languages with Pulumi"
+    prefix: "Architecture as Code: "
+    meta_image: "/blog/architecture-as-code-intro/architecture.png"
diff --git a/layouts/blog/series.html b/layouts/blog/series.html
@@ -0,0 +1,47 @@
+{{ define "main" }}
+    <div class="container mx-auto px-4 py-8">
+        <div class="lg:flex">
+            <div class="lg:w-3/12 pr-8">
+                {{ partial "blog/sidebar.html" . }}
+            </div>
+
+            <div class="lg:w-7/12">
+                <header>
+                    <h1 class="no-anchor">{{ .Title }}</h1>
+                    {{ .Content }}
+                </header>
+
+                {{ with .Site.Data.blog_series }}
+                    {{ range .series }}
+                        <article class="mb-8 pb-8 border-b border-gray-200">
+                            <h2 class="no-anchor">
+                                <a data-track="series-{{ .slug }}" href="/blog/tag/{{ .slug }}/">{{ .title }}</a>
+                            </h2>
+                            
+                            <section class="blog-list-description">
+                                {{/* Display meta image if available */}}
+                                {{ if .meta_image }}
+                                    <a href="/blog/tag/{{ .slug }}/"
+                                        ><img
+                                            class="rounded-lg md:m-2 md:mt-0 md:max-w-xs md:float-right my-8 border-2 border-gray-100"
+                                            src="{{ .meta_image }}"
+                                            alt="{{ .title }}"
+                                    /></a>
+                                {{ end }}
+                                
+                                {{/* Display description */}}
+                                <p>{{ .description }}</p>
+                                
+                                {{/* Read more link */}}
+                                <p>
+                                    <a data-track="read-more-series" href="/blog/tag/{{ .slug }}/">View series &rarr;</a>
+                                </p>
+                            </section>
+                        </article>
+                    {{ end }}
+                {{ end }}
+            </div>
+            <div class="lg:w-2/12 pl-8"></div>
+        </div>
+    </div>
+{{ end }}
diff --git a/layouts/partials/blog/series-list-sidebar.html b/layouts/partials/blog/series-list-sidebar.html
@@ -0,0 +1,81 @@
+<!--
+    Series list sidebar, showing all blog series with the current series highlighted.
+    Only shows on series tag pages.
+-->
+{{ $currentTag := "" }}
+{{ $isSeriesTag := false }}
+
+<!-- Check if current tag is a series tag -->
+{{ $currentTag = .Data.Term }}
+{{ with .Site.Data.blog_series }}
+    {{ range .series }}
+        {{ if eq .slug $currentTag }}
+            {{ $isSeriesTag = true }}
+        {{ end }}
+    {{ end }}
+{{ end }}
+
+{{ if $isSeriesTag }}
+<aside class="lg:pr-8 sticky-sidebar">
+    <!-- Sidebar menu toggle for mobile. -->
+    <div class="lg:hidden">
+        <button class="blog-sidebar-toggle items-center px-3 py-2 border rounded text-purple border-purple">Toggle Series Navigation</button>
+    </div>
+
+    <h2 class="no-anchor hidden lg:flex mt-2 mb-6">
+        <a data-track="sidebar" class="text-2xl" href="{{ relref . "/blog" }}">Pulumi Blog</a>
+    </h2>
+
+    <!-- Sidebar content. Hidden on smaller displays unless toggled. -->
+    <div class="blog-sidebar-content hidden lg:block">
+        {{ partial "blog/search" . }}
+
+        <hr class="my-8" />
+
+        <!-- Series List Navigation -->
+        <div class="my-4">
+            <h5 class="no-anchor text-lg font-semibold mb-4">All Blog Series</h5>
+            
+            <ul class="list-none p-0 space-y-2">
+                {{ with .Site.Data.blog_series }}
+                    {{ range .series }}
+                        <li class="leading-snug">
+                            {{ if eq .slug $currentTag }}
+                                <!-- Current series - highlighted -->
+                                <div class="bg-blue-50 border-l-4 border-blue-500 pl-3 py-2 rounded-r">
+                                    <div class="text-sm font-semibold text-blue-900">{{ .title }}</div>
+                                    <div class="text-xs text-blue-700 mt-1">{{ substr .description 0 50 }}{{ if gt (len .description) 50 }}...{{ end }}</div>
+                                    <div class="text-xs text-blue-600 mt-1">Current series</div>
+                                </div>
+                            {{ else }}
+                                <!-- Other series -->
+                                <div class="pl-3 py-1">
+                                    <a data-track="series-list" class="text-sm hover:text-blue-600" href="/blog/tag/{{ .slug }}/">
+                                        <div class="font-medium">{{ .title }}</div>
+                                        <div class="text-xs text-gray-600 mt-1">{{ substr .description 0 50 }}{{ if gt (len .description) 50 }}...{{ end }}</div>
+                                    </a>
+                                </div>
+                            {{ end }}
+                        </li>
+                    {{ end }}
+                {{ end }}
+            </ul>
+            
+            <!-- Link to view all series -->
+            <div class="mt-4 pt-3">
+                <a class="text-blue-600 text-sm" href="/blog/series/">View all series &rarr;</a>
+            </div>
+        </div>
+
+        <hr class="my-8" />
+
+        {{ partial "sidebar-cta" . }}
+    </div>
+
+    <div class="lg:hidden pb-4">
+        <!-- Vertical spacer, for mobile layouts. -->
+    </div>
+</aside>
+{{ else }}
+    {{ partial "blog/sidebar.html" . }}
+{{ end }}
diff --git a/layouts/partials/blog/series-sidebar.html b/layouts/partials/blog/series-sidebar.html
diff --git a/layouts/taxonomy/tag.html b/layouts/taxonomy/tag.html
