moved blogs to mkdocs plugin

okd-project · Oct 17, 2023 · adf3d09 · adf3d09
1 parent 038c1ea
commit adf3d09
Show file tree

Hide file tree

Showing 26 changed files with 152 additions and 140 deletions.
diff --git a/docs/blog.md b/docs/blog.md
diff --git a/docs/blog/.authors.yml b/docs/blog/.authors.yml
@@ -0,0 +1,9 @@
+authors:
+  jmeng:
+    name: Jakob Meng
+    description: https://github.com/jm1
+    avatar: https://www.okd.io/img/okd-panda-flat_rocketeer_with_number.svg
+  dmueller:
+    name: Diane Mueller
+    description: https://github.com/dmueller2001
+    avatar: https://www.okd.io/img/okd-panda-flat_rocketeer_with_number.svg
diff --git a/docs/blog/2021-03-07-new-blog.html.md b/docs/blog/2021-03-07-new-blog.html.md
diff --git a/docs/blog/index.md b/docs/blog/index.md
@@ -0,0 +1 @@
+# Posts
diff --git a/...Hours-at-KubeconEU-on-OpenShiftTV.html.md → ...Hours-at-KubeconEU-on-OpenShiftTV.html.md b/...Hours-at-KubeconEU-on-OpenShiftTV.html.md → ...Hours-at-KubeconEU-on-OpenShiftTV.html.md
@@ -1,10 +1,18 @@
+---
+draft: false
+date: 2021-05-06
+---
+
 # OKD Working Group Office Hours at KubeconEU on OpenShift.tv
 
 <!--- cSpell:ignore Kubecon Charro Gruver autoplay allowfullscreen -->
-## Video from OKD Working Group Office Hours at KubeconEU on OpenShift.tv
 
 On May 6th 2020, [OKD-Working Group](https://groups.google.com/g/okd-wg) members hosted an hour long community led Office Hour with a brief introduction to the latest release by Red Hat's Charro Gruver then live Q/A!
 
+<!-- more -->
+
+## Video from OKD Working Group Office Hours at KubeconEU on OpenShift.tv
+
 <iframe width="560" height="315" src="https://www.youtube.com/embed/2WV4jtTs9Bg?start=45" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
 
 Join the [OKD-Working Group](https://groups.google.com/g/okd-wg) and add your voice to the conversation!
diff --git a/...ng-the-Next-Generation-of-OKD-together.md → ...ng-the-Next-Generation-of-OKD-together.md b/...ng-the-Next-Generation-of-OKD-together.md → ...ng-the-Next-Generation-of-OKD-together.md
@@ -1,12 +1,19 @@
-# OKD Streams: Building the Next Generation of OKD together
+---
+draft: false
+date: 2022-10-24
+authors:
+  - dmueller
+---
 
-<!--- cSpell:ignore SCOS productized Thorsten Schwesig Humair Coufal Hild Zuccarelli Sherine Khoury Vadim Rutkovsky Alessandro Stefano Magiera Marrich Glombek Gompa massopen Innes -->
+# OKD Streams - Building the Next Generation of OKD together
 
-*by [Diane Mueller](https://github.com/dmueller2001)*
+<!--- cSpell:ignore dmueller SCOS productized Thorsten Schwesig Humair Coufal Hild Zuccarelli Sherine Khoury Vadim Rutkovsky Alessandro Stefano Magiera Marrich Glombek Gompa massopen Innes -->
 
-date: 2022-10-25
+OKD is the community distribution of Kubernetes that powers Red Hat OpenShift. The OKD community has created reusable Tekton build pipelines on a shared Kubernetes cluster for the OKD build pipelines so that they could manage the build & release processes for OKD in the open.
 
-OKD is the community distribution of Kubernetes that powers Red Hat OpenShift. The OKD community has created reusable Tekton build pipelines on a shared Kubernetes cluster for the OKD build pipelines so that they could manage the build & release processes for OKD in the open. With the [operate-first.cloud](https://www.operate-first.cloud/){target=_blank} hosted at the [massopen.cloud](https://massopen.cloud/){target=_blank}, the OKD community has launched a fully open source release pipeline that the community can participate in to help support and manage the release cycle ourselves. The OKD Community is now able to build and release stable builds of OKD 4.12 on both Fedora CoreOS and the newly introduced CentOS Stream CoreOS. We are calling it OKD Streams.
+<!-- more -->
+
+With the [operate-first.cloud](https://www.operate-first.cloud/){target=_blank} hosted at the [massopen.cloud](https://massopen.cloud/){target=_blank}, the OKD community has launched a fully open source release pipeline that the community can participate in to help support and manage the release cycle ourselves. The OKD Community is now able to build and release stable builds of OKD 4.12 on both Fedora CoreOS and the newly introduced CentOS Stream CoreOS. We are calling it OKD Streams.
 
 ## New Patterns, New CI/CD Pipelines and a new CoreOS
 

diff --git a/...g/2022-10-20-OKD-at-Kubecon-NA-Detroit.md → docs/blog/posts/OKD-at-Kubecon-NA-Detroit.md b/...g/2022-10-20-OKD-at-Kubecon-NA-Detroit.md → docs/blog/posts/OKD-at-Kubecon-NA-Detroit.md
@@ -1,13 +1,18 @@
-# OKD at KubeCon + CloudNativeCon North America 2022
-
-<!--- cSpell:ignore Kubecon Magiera ICPSR McCune Westin Hopin Vadim Rutkovsky Zuccarelli Glombek Krejci -->
+---
+draft: false
+date: 2022-10-20
+authors:
+  - dmueller
+---
 
-*by [Diane Mueller](https://github.com/dmueller2001)*
+# OKD at KubeCon + CloudNativeCon North America 2022
 
-date: 2022-10-20
+<!--- cSpell:ignore dmueller Kubecon Magiera ICPSR McCune Westin Hopin Vadim Rutkovsky Zuccarelli Glombek Krejci -->
 
 Are you heading to Kubecon/NA October 24, 2022 - October 28, 2022 in Detroit at KubeCon + CloudNativeCon North America 2022?
 
+<!-- more -->
+
 If so, here's where you'll find members of the OKD Working Group and Red Hat engineers that working on delivering the latest releases of OKD at Kubecon!
 
 ## October 25th

diff --git a/...o-debugging-okd-release-artifacts.html.md → ...ion-to-debugging-okd-release-artifacts.md b/...o-debugging-okd-release-artifacts.html.md → ...ion-to-debugging-okd-release-artifacts.md
@@ -1,9 +1,15 @@
-# An Introduction to Debugging OKD Release Artifacts
+---
+draft: false 
+date: 2022-09-09
+---
 
 <!--- cSpell:ignore Moiseev Cune autoplay OCPBUGS -->
+# An Introduction to debugging OKD release artifacts
 
 _by [Denis Moiseev](https://github.com/lobziik) and [Michael McCune](https://github.com/elmiko)_
 
+<!-- more -->
+
 During the course of installing, operating, and maintaining an OKD cluster it is natural for users to come across strange behaviors and failures that are difficult to understand. As Red Hat engineers working on OpenShift, we have many tools at our disposal to research cluster failures and to report our findings to our colleagues. We would like to share some of our experiences, techniques, and tools with the wider OKD community in the hopes of inspiring others to investigate these areas.
 
 As part of our daily activities we spend a significant amount of time investigating bugs, and also failures in our release images and testing systems. As you might imagine, to accomplish this task we use many tools and pieces of _tribal knowledge_ to understand not only the failures themselves, but the complexity of the build and testing infrastructures. As Kubernetes and OpenShift have grown, there has always been an organic growth of tooling and testing that helps to support and drive the development process forward. To fully understand the depths of these processes is to be actively following what is happening with the development cycle. This is not always easy for users who are also focused on delivering high quality service through their clusters.

diff --git a/docs/blog/2022-12-12-Building-OKD-payload.md → docs/blog/posts/building-OKD-payload.md b/docs/blog/2022-12-12-Building-OKD-payload.md → docs/blog/posts/building-OKD-payload.md
@@ -1,9 +1,18 @@
+---
+draft: false
+date: 2022-12-12
+categories:
+  - Build
+---
+
 # Building the OKD payload
 
 <!--- cSpell:ignore SCOS buildconfigs buildconfig Kustomize kustomization baremetal -->
 
 Over the last couple of months, we've been busy building a new OKD release on [CentOS Stream](https://www.centos.org/centos-stream/) [CoreOS](https://en.wikipedia.org/wiki/Container_Linux) (SCOS), and were able to present it for the [OpenShift Commons Detroit 2022](https://www.okd.io/blog/2022-10-20-OKD-at-Kubecon-NA-Detroit/).  
 
+<!-- more -->
+
 While some of us created a Tekton pipeline that could [build SCOS](https://www.youtube.com/watch?v=HcGsvSms--A&list=PLaR6Rq6Z4Iqck7Z0ekuJdsMU1fE6hkd6d&index=2) on a Kind cluster, others were tediously building the OKD payload with Prow, but also creating a [Tekton](https://tekton.dev/) pipeline for building that payload on any OpenShift or OKD cluster.
 
 The goal of this effort is to enable and facilitate community collaboration and contributions, giving anybody the ability to do their own payload builds and run tests themselves.

diff --git a/...-From-OKD-to-OpenShift-in-3-Years.html.md → .../from-OKD-to-OpenShift-in-3-Years.html.md b/...-From-OKD-to-OpenShift-in-3-Years.html.md → .../from-OKD-to-OpenShift-in-3-Years.html.md
@@ -1,10 +1,16 @@
-# Rohde & Schwarz's Journey to OpenShift 4 From OKD to Azure Red Hat OpenShift
+---
+draft: false
+date: 2021-05-04
+---
+
+# From OKD to OpenShift in 3 Years - talk by Josef Meier (Rohde & Schwarz) from OpenShift Commons Gathering at Kubecon  
 
 <!--- cSpell:ignore Rohde Schwarz Schwarz's kubecon autoplay allowfullscreen -->
-## From OKD to OpenShift in 3 Years - talk by Josef Meier (Rohde & Schwarz) from OpenShift Commons Gathering at Kubecon  
 
 On May 4th 2020, [OKD-Working Group](https://groups.google.com/g/okd-wg) member Josef Meier gave a wonderful talk about Rohde & Schwarz's Journey to OpenShift 4 from OKD to ARO (Azure Red Hat OpenShift) and discussed benefits of participating in the OKD Working Group!
 
+<!-- more -->
+
 <iframe width="560" height="315" src="https://www.youtube.com/embed/1CEIRK9H1-w" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
 
 Join the [OKD-Working Group](https://groups.google.com/g/okd-wg) and add your voice to the conversation!
diff --git a/docs/blog/img/build_okd_payload_1.png → docs/blog/posts/img/build_okd_payload_1.png b/docs/blog/img/build_okd_payload_1.png → docs/blog/posts/img/build_okd_payload_1.png
diff --git a/docs/blog/img/build_okd_payload_2.png → docs/blog/posts/img/build_okd_payload_2.png b/docs/blog/img/build_okd_payload_2.png → docs/blog/posts/img/build_okd_payload_2.png
diff --git a/docs/blog/img/build_okd_payload_3.png → docs/blog/posts/img/build_okd_payload_3.png b/docs/blog/img/build_okd_payload_3.png → docs/blog/posts/img/build_okd_payload_3.png
diff --git a/.../okd-panda-flat_rocketeer_with_number.svg → .../okd-panda-flat_rocketeer_with_number.svg b/.../okd-panda-flat_rocketeer_with_number.svg → .../okd-panda-flat_rocketeer_with_number.svg
diff --git a/...-avoid-using-fcos-33.20210301.3.1.html.md → ...-avoid-using-fcos-33.20210301.3.1.html.md b/...-avoid-using-fcos-33.20210301.3.1.html.md → ...-avoid-using-fcos-33.20210301.3.1.html.md
@@ -1,12 +1,17 @@
+---
+draft: false
+date: 2021-03-19
+---
+
 # Please avoid using FCOS 33.20210301.3.1 for new OKD installs
 
 <!--- cSpell:ignore Vadim -->
 
-Hi,
-
 Due to several issues ([1] and [2]) fresh installations using FCOS
 33.20210301.3.1 would fail. The fix is coming in Podman 3.1.0.
 
+<!-- more -->
+
 Please use an older stable release - 33.20210217.3.0 - as a starting
 point instead. See download links at
 [https://builds.coreos.fedoraproject.org/browser?stream=stable](https://builds.coreos.fedoraproject.org/browser?stream=stable]) (might

diff --git a/...p-okd-testing-deployment-workshop.html.md → ...p-okd-testing-deployment-workshop.html.md b/...p-okd-testing-deployment-workshop.html.md → ...p-okd-testing-deployment-workshop.html.md
@@ -1,11 +1,18 @@
+---
+draft: false 
+date:  2021-03-22
+---
+
 # Recap OKD Testing and Deployment Workshop - Videos and Additional Resources
 
 <!--- cSpell:ignore Charro Gruver Vadim Rutkovsky Magiera Rohde Schwarz throughs BCIT Ramanujam Datto  -->
 
-## The OKD Working Group held a virtual community-hosted workshop on testing and deploying OKD4 on March 20th
-
 On March 20th, [OKD-Working Group](https://groups.google.com/g/okd-wg) hosted a day-long event to bring together people from the OKD and related Open Source project communities to collaborate on testing and [documentation of the OKD 4 install and upgrade processes for the various platforms](https://github.com/elmiko/okd-deployment-configuration-guides) that people are deploying OKD 4 on as well to identify any issues with the current documentation for these processes and triage them together.
 
+<!-- more -->
+
+## The OKD Working Group held a virtual community-hosted workshop on testing and deploying OKD4 on March 20th
+
 The day started with all attendees together in the ‘main stage’ area for 2 hours where community members gave an short welcome along with the following four presentations:
 
 - [What is OKD4 (with a Release Update) - by Charro Gruver (Red Hat)](https://youtu.be/fOKve11GOJg)

diff --git a/docs/blog/slides/OKD-Workshop.pdf → docs/blog/posts/slides/OKD-Workshop.pdf b/docs/blog/slides/OKD-Workshop.pdf → docs/blog/posts/slides/OKD-Workshop.pdf
diff --git a/...kd-2021-03-20-josef-meier-dns-diagram.pdf → ...kd-2021-03-20-josef-meier-dns-diagram.pdf b/...kd-2021-03-20-josef-meier-dns-diagram.pdf → ...kd-2021-03-20-josef-meier-dns-diagram.pdf
diff --git a/...23-07-18-State-of-Affairs-in-OKD-CI-CD.md → ...og/posts/state-of-Affairs-in-OKD-CI-CD.md b/...23-07-18-State-of-Affairs-in-OKD-CI-CD.md → ...og/posts/state-of-Affairs-in-OKD-CI-CD.md
@@ -1,16 +1,25 @@
+---
+draft: false 
+date: 2023-07-18
+categories:
+  - Build
+authors:
+  - jmeng
+---
+
 # State of affairs in OKD CI/CD
 
-*by [Jakob Meng](https://github.com/jm1)*
-
-date: 2023-07-18
+<!--- cSpell:ignore jmeng SCOS scos -->
 
 [OKD](https://www.okd.io/) is a community distribution of Kubernetes which is built from Red Hat OpenShift components on
 top of Fedora CoreOS (FCOS) and recently also CentOS Stream CoreOS (SCOS). The OKD variant based on Fedora CoreOS is
 called [OKD or OKD/FCOS](https://github.com/okd-project/okd). The SCOS variant is often referred to as [OKD/SCOS](
 https://github.com/okd-project/okd-scos/).
 
-The previous blog posts introduced [OKD Streams](2022-10-25-OKD-Streams-Building-the-Next-Generation-of-OKD-together.md)
-and [its new Tekton pipelines](2022-12-12-Building-OKD-payload.md) for building OKD/FCOS and OKD/SCOS releases. This
+<!-- more -->
+
+The previous blog posts introduced [OKD Streams](OKD-Streams-Building-the-Next-Generation-of-OKD-together.md)
+and [its new Tekton pipelines](building-OKD-payload.md) for building OKD/FCOS and OKD/SCOS releases. This
 blog post gives an overview of the current build and release processes for FCOS, SCOS and OKD. It outlines OKD's
 dependency on OpenShift, an remnant from the past when its Origin predecessor was a downstream rebuild of OpenShift 3,
 and concludes with an outlook on how OKD Streams will help users, developers and partners to experiment with future
@@ -94,7 +103,6 @@ https://github.com/okd-project/okd-coreos-pipeline/)), to build OKD/SCOS (with [
 https://github.com/okd-project/okd-payload-pipeline)) and to build operators (with [okd-operator-pipeline](
 https://github.com/okd-project/okd-operator-pipeline)). [The OKD Streams pipelines have been created to improve the
 RHEL9 readiness signal for Red Hat OpenShift. It allows developers to build and compose different tasks and pipelines to
-easily experiment with OpenShift and related technologies](
-https://www.okd.io/blog/2022-10-25-OKD-Streams-Building-the-Next-Generation-of-OKD-together/). Both
+easily experiment with OpenShift and related technologies](OKD-Streams-Building-the-Next-Generation-of-OKD-together.md). Both
 `okd-coreos-pipeline` and `okd-operator-pipeline` are already used in OKD's CI/CD and in the future
 `okd-payload-pipeline` might supersede OCP CI for building OKD payload components and mirroring OCP payload components.
diff --git a/...e-okd-testing-deployment-workshop.html.md → ...posts/testing-deployment-workshop.html.md b/...e-okd-testing-deployment-workshop.html.md → ...posts/testing-deployment-workshop.html.md
@@ -1,7 +1,15 @@
+---
+draft: false
+date: 2021-03-16
+categories:
+  - Testing
+---
+
 # Save The Date! OKD Testing and Deployment Workshop (March 20) Register Now!
 
 <!--- cSpell:ignore throughs Magiera Rohde Schwarz Charro Gruver BCIT Ramanujam Datto hopin -->
 
+<!-- more -->
 ## The OKD Working Group is hosting a virtual workshop on testing and deploying OKD4
 
 On March 20th, [OKD-Working Group](https://groups.google.com/g/okd-wg) is hosting a [one day event](https://hopin.com/events/okd-testing-and-deployment-workshop) to bring together people from the OKD and related Open Source project communities to collaborate on testing and [documentation of the OKD 4 install and upgrade processes for the various platforms](https://github.com/elmiko/okd-deployment-configuration-guides) that people are deploying OKD 4 on as well to identify any issues with the current documentation for these processes and triage them together.

diff --git a/docs/css/extra.css b/docs/css/extra.css
@@ -39,11 +39,11 @@
 [data-md-color-primary=blue-grey] {
     --md-primary-fg-color--light: hsla(200, 48%, 30%, 1);
     --md-default-bg-color: hsla(0, 0%, 87%, 1);
-	--md-default-bg-color--light: hsla(0, 0%, 90%, 1);
-	--md-default-bg-color--lighter: hsla(0, 0%, 93%, 1);
-	--md-default-bg-color--lightest: hsla(0, 0%, 96%, 1);
-	--md-default-fg-color: rgba(0, 0, 0, 0.95);
-	--md-default-fg-color--light: rgba(0, 0, 0, 0.8);
+    --md-default-bg-color--light: hsla(0, 0%, 90%, 1);
+    --md-default-bg-color--lighter: hsla(0, 0%, 93%, 1);
+    --md-default-bg-color--lightest: hsla(0, 0%, 96%, 1);
+    --md-default-fg-color: rgba(0, 0, 0, 0.95);
+    --md-default-fg-color--light: rgba(0, 0, 0, 0.8);
 }
 
 [data-md-color-scheme=okd] {
@@ -74,7 +74,7 @@
     --md-code-hl-variable-color: var(--md-code-fg-color);
     --md-typeset-color: var(--md-default-fg-color);
     --md-typeset-a-color: var(--md-primary-fg-color--light);
-    --md-typeset-a-color--light:  hsla(0, 0%, 100%, 1);
+    --md-typeset-a-color--light: hsla(0, 0%, 100%, 1);
     --md-typeset-mark-color: var(--md-default-fg-color--lightest);
     --md-typeset-kbd-color: hsla(var(--md-hue), 15%, 94%, 1);
     --md-typeset-kbd-accent-color: hsla(var(--md-hue), 15%, 94%, 1);
@@ -105,7 +105,7 @@
 
 .md-container {
 
-    background-image: linear-gradient( var(--md-default-bg-color--lightest), var(--md-default-bg-color--white) );
+    background-image: linear-gradient(var(--md-default-bg-color--lightest), var(--md-default-bg-color--white));
 }
 
 .md-nav {

diff --git a/docs/installation.md b/docs/installation.md
@@ -15,8 +15,6 @@ OKD support installation on bare metal hardware, a number of virtualization plat
 
 If you want to install on a typical developer workstation, then [Code-Ready Containers](crc.md) may be a better options, as that is a cut-down installation designed to run on limited compute and memory resources.
 
-You can find examples of OKD installations, setup by OKD community members in the [guides](guides/overview.md) section.
-
 ## Getting Started
 
 To obtain the openshift installer and client, visit [releases](https://github.com/okd-project/okd/releases){: target=_blank} for stable versions or [https://amd64.origin.releases.ci.openshift.org/](https://amd64.origin.releases.ci.openshift.org/){: target=_blank} for nightlies.