Initial commit for experimental okd.io

Projet has been scaffolded with Docusaurus and a landing page has been started.
All previous markdown content has been copied as-is, save for fixing syntaxt to support MDX and fixing any broken links.

.devcontainer/devcontainer.json

@@ -0,0 +1,32 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/debian
+{
+	"name": "Debian",
+	// Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+	"image": "mcr.microsoft.com/devcontainers/base:bullseye",
+	"features": {
+		"ghcr.io/devcontainers/features/git-lfs:1": {
+			"autoPull": true,
+			"version": "latest"
+		},
+		"ghcr.io/devcontainers/features/github-cli:1": {
+			"version": "latest"
+		},
+		"ghcr.io/devcontainers/features/node:1": {
+			"nodeGypDependencies": true,
+			"version": "lts",
+			"nvmVersion": "latest"
+		}
+	},
+
+
+
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	"forwardPorts": [3000]
+
+	// Configure tool-specific properties.
+	// "customizations": {},
+
+	// Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+	// "remoteUser": "root"
+}

.eslintrc

@@ -0,0 +1,3 @@
+{
+    "extends": ["plugin:@docusaurus/recommended"]
+}

.github/dependabot.yml

@@ -0,0 +1,18 @@
+version: 2
+updates:
+  - package-ecosystem: "devcontainers"
+    directory: "/"
+    schedule:
+      interval: weekly
+
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      time: "06:00"
+    commit-message:
+      prefix: "npm"
+    groups:
+      all:
+        patterns:
+          - "*"

.github/workflows/deploy.yml

@@ -0,0 +1,49 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build:
+    name: Build Docusaurus
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 18
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+      - name: Build website
+        run: npm run build
+
+      - name: Upload Build Artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: build
+
+  deploy:
+    name: Deploy to GitHub Pages
+    needs: build
+
+    # Grant GITHUB_TOKEN the permissions required to make a Pages deployment
+    permissions:
+      pages: write # to deploy to Pages
+      id-token: write # to verify the deployment originates from an appropriate source
+
+    # Deploy to the github-pages environment
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -0,0 +1,20 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

README.md

@@ -0,0 +1,14 @@
+OKD Web
+===
+
+This is a preview project of a new build of [OKD.io](https://okd.io) built on top of [Docusaurus](https://docusaurus.io/)
+
+# Run Locally
+You need to have NodeJS 18 or above.
+
+```shell
+npm install
+npm start
+```
+
+Your browser should open to [http://localhost:3000](http://localhost:3000)

babel.config.js

@@ -0,0 +1,3 @@
+module.exports = {
+  presets: [require.resolve('@docusaurus/core/lib/babel/preset')],
+};

blog/2021/03-16-testing-deployment-workshop.md

@@ -0,0 +1,38 @@
+---
+title: OKD Testing and Deployment Workshop
+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.
+
+The day will start with all attendees together in the ‘main stage’ area for 2 hours where we will give an short welcome and describe the logistics for the day, give a brief introduction to OKD4 itself then walk thru a install deployment to vSphere using UPI approach along with a few other more universal best practices such as DNS/DHCP server configuration) that apply to all deployment targets.
+
+Then we will break into tracks specific to the deployment target platforms for deep dive demos with Q/A, try and answer any questions you have about your specific deployment target's configurations, identify any missing pieces in the documentation and triage the documentation as we go.  
+
+There will be 4 track break-out rooms set-up for 3 hours of deployment walk throughs and Q/A with session leads:
+
+- vSphere/UPI - lead by Jaime Magiera (UMich) and Josef Meier (Rohde & Schwarz)
+- Bare Metal/UPI - lead by Andrew Sullivan (Red Hat) and Jason Pittman (Red Hat)
+- Single Node Cluster - lead by Charro Gruver (Red Hat) and Bruce Link (BCIT)
+- Home Lab Setup - lead by Craig Robinson (Red Hat) and Sri Ramanujam (Datto)
+
+Our goal is to triage our existing community documentation, identify any short comings and encourage your participation in the [OKD-Working Group](https://groups.google.com/g/okd-wg)'s testing of the installation and upgrade processes for each OKD release.
+
+This is community event NOT meant as a substitute for Red Hat technical support.
+
+There is no admission or ticket charge for [OKD-Working Group](https://groups.google.com/g/okd-wg) events. However, you are required to complete a free hopin.to platform registration and watch the hopin site for updates about registration and schedule updates.
+
+We are committed to fostering an open and welcoming environment at our working group meetings and events. We set expectations for inclusive behavior through our code of conduct and media policies, and are prepared to enforce these.
+
+You can Register for the workshop [here](https://hopin.com/events/okd-testing-and-deployment-workshop):
+
+[https://hopin.com/events/okd-testing-and-deployment-workshop](https://hopin.com/events/okd-testing-and-deployment-workshop)

blog/2021/03-19-please-avoid-using-fcos-33.20210301.3.1.md

@@ -0,0 +1,29 @@
+---
+draft: false
+date: 2021-03-19
+---
+
+# Please avoid using FCOS 33.20210301.3.1 for new OKD installs
+
+<!--- cSpell:ignore Vadim -->
+
+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
+need some scrolling),
+
+Note, that only fresh installs are affected. Also, you won't be left
+with outdated packages, as OKD does update themselves to latest stable
+FCOS content during installation/update.
+
+1. [https://bugzilla.redhat.com/show_bug.cgi?id=1936927](https://bugzilla.redhat.com/show_bug.cgi?id=1936927)
+2. [https://github.com/openshift/okd/issues/566](https://github.com/openshift/okd/issues/566)
+
+--
+Cheers,
+Vadim

blog/2021/03-22-recap-okd-testing-deployment-workshop/index.md

@@ -0,0 +1,38 @@
+---
+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  -->
+
+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)
+- [Walk Thru of the OKD Release and Build Processes - Vadim Rutkovsky (Red Hat)](https://youtu.be/HmmV1mLRtbM)
+- [Walk Thru of the OKD Deployment and Configuration Guides - Jamie Magiera (UMich)](https://youtu.be/-AwpvgbaMVg)
+- [Best Practices such as DNS/DHCP server and Load Balancer Configuration) - Josef Meier (Rohde and Schwarz)](https://youtu.be/by6ZmwWC8bs)
+
+Then attendees then broke into track sessions specific to the deployment target platforms for deep dive demos with live Q/A, answered as many questions as possible about that specific deployment target's configurations, attempted to identify any missing pieces in the documentation and triage the documentation as we went along.  
+
+The 4 track break-out rooms set-up for 2.5 hours of deployment walk throughs and Q/A with session leads:
+
+- [Automated Installation on vSphere UPI - lead by Jaime Magiera (UMich) and Josef Meier (Rohde & Schwarz)](https://youtu.be/vCoznRt3_2I)
+- [Bare Metal/UPI - lead by Andrew Sullivan (Red Hat) and Jason Pittman (Red Hat)](https://youtu.be/eM_pYnf_xFw)
+- [Single Node Cluster - lead by Charro Gruver (Red Hat) and Bruce Link (BCIT)](https://youtu.be/lI382l3u4fM)
+- [Home Lab Setup - lead by Craig Robinson (Red Hat), Sri Ramanujam (Datto) and Vadim Rutkovsky(Red Hat)](https://youtu.be/nDDhguTZgLE)
+
+Our goal was to triage our existing community documentation, identify any short comings and encourage your participation in the [OKD-Working Group](https://groups.google.com/g/okd-wg)'s testing of the installation and upgrade processes for each OKD release.
+
+## Resources:
+
+- [Link to Playlist](https://www.youtube.com/playlist?list=PLaR6Rq6Z4Iqfe0yvNnyYZnYR3Z3Emb_Zm)
+- [OKD Workshop Slides - Charro Gruver](./OKD-Workshop.pdf)
+- [DNS DHCP Load Balancer Diagram - Josef Meier](./workshop-okd-2021-03-20-josef-meier-dns-diagram.pdf)

blog/2021/05-04-from-OKD-to-OpenShift-in-3-Years.md

@@ -0,0 +1,16 @@
+---
+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 -->
+
+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!

blog/2021/05-06-OKD-Office-Hours-at-KubeconEU-on-OpenShiftTV.md

@@ -0,0 +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 -->
+
+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!

blog/2022/09-09-debugging-release-artifacts.md

@@ -0,0 +1,37 @@
+---
+title: An introduction 
+slug: an-introduction-to-debugging-okd-release-artifacts
+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.
+
+On 2 September, 2022, we had the opportunity to record a video of ourselves diving into the [OKD release artifacts](https://amd64.origin.releases.ci.openshift.org/) to show how we investigate failures in the continuous integration release pipeline. In this video we walk through the process of finding a failing release test, examining the [Prow console](https://docs.prow.k8s.io/docs/overview/architecture/), and then exploring the results that we find. We explain what these artifacts mean, how to further research failures that are found, and share some other web-based tools that you can use to find similar failures, understand the testing workflow, and ultimately share your findings through a bug report.
+
+<iframe width="560" height="315" src="https://www.youtube.com/embed/4QPc7iOTaWE" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+
+To accompany the video, here are some of the links that we explore and related content:
+
+* [www.okd.io/installation/](https://www.okd.io/installation/) - the main OKD installation page, where our journey begins
+* [amd64.origin.releases.ci.openshift.org/](https://amd64.origin.releases.ci.openshift.org/) - OKD releases for AMD64, the place to go for release images and continuous integration reporting
+* [docs.prow.k8s.io/docs/overview/architecture/](https://docs.prow.k8s.io/docs/overview/architecture/) - an overview of Prow architecture, this is useful to understand how Prow operates
+* [github.com/openshift/release](https://github.com/openshift/release) - OpenShift and OKD’s Prow configuration, go here to find how the jobs are setup
+* [github.com/openshift/origin/](https://github.com/openshift/origin/) - conformance tests for OpenShift and OKD, this is where many of the Kubernetes tests are located
+* [steps.ci.openshift.org/](https://steps.ci.openshift.org/) - CI step registry, useful for discovering how test jobs flow together
+* [search.ci.openshift.org/](https://search.ci.openshift.org/) - CI log search, useful for finding similar test failures
+* [docs.ci.openshift.org/docs/](https://docs.ci.openshift.org/docs/) - home of the OpenShift CI docs
+* [docs.ci.openshift.org/docs/getting-started/useful-links/](https://docs.ci.openshift.org/docs/getting-started/useful-links/) - useful links to various services, also links to talks and presentations
+* [docs.ci.openshift.org/docs/how-tos/artifacts/](https://docs.ci.openshift.org/docs/how-tos/artifacts/) - explanations of CI artifacts
+* [issues.redhat.com](https://issues.redhat.com) - OpenShift/OKD bug reporting system
+
+Finally, if you do find bugs or would like report strange behavior in your clusters, remember to visit [issues.redhat.com](https://issues.redhat.com) and use the project **OCPBUGS**.
+

blog/2022/10-20-OKD-at-Kubecon-NA-Detroit.md

@@ -0,0 +1,34 @@
+---
+draft: false
+date: 2022-10-20
+authors:
+  - dmueller
+---
+
+# OKD at KubeCon + CloudNativeCon North America 2022
+
+<!--- 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
+
+At the OpenShift Commons Gathering on Tuesday, October 25, 2022 | 9:00 a.m. - 6:00 p.m. EDT, we're hosting an in-person OKD Working Group Lunch & Learn Meet up from 12 noon to 3 pm lead by co-chairs [Jaime Magiera (ICPSR at University of Michigan Institute for Social Research)](https://github.com/JaimeMagiera), [Diane Mueller(Red Hat)](https://github.com/dmueller2001) and special guests including [Michael McCune(Red Hat)](https://github.com/elmiko) in Break-out room D at the Westin Book Cadillac a 10 minute walk from the conference venue.
+followed by a Lightning Talk: OKD Working Group Update & Road Map on the OpenShift Common main stage at 3:45 pm. The main stage event will be live streamed via Hopin so if you are NOT attending in person, you'll be able to join us online.
+
+Registration for OpenShift Commons Gathering is FREE and OPEN to ALL for both in-person and virtual attendance - [https://commons.openshift.org/gatherings/kubecon-22-oct-25/](https://commons.openshift.org/gatherings/kubecon-22-oct-25/)
+
+## October 27th
+
+At 11:30 am EDT, the OKD Working Group will hold a Kubecon Virtual Office Hour that on OKD Streams initiatives and the latest release lead by OKD Working Group members:
+[Vadim Rutkovsky](https://github.com/vrutkovs), [Luigi Mario Zuccarelli](https://github.com/lmzuccarelli), [Christian Glombek](https://github.com/LorbusChris) and [Michelle Krejci](https://github.com/craychee)!
+
+Registration for the virtual Kubecon/NA event is required to join the Kubecon Virtual Office Hour
+
+If you're attending in person and just want to grab a cuppa coffee and have a chat with us, please reach ping either of the OKD working group co-chairs [Jaime Magiera (ICPSR at University of Michigan Institute for Social Research)](https://twitter.com/jaime4a2), or [Diane Mueller(Red Hat)](https://twitter.com/pythondj)
+
+Come connect with us to discuss the OKD Road Map, OKD Streams initiative, MVP Release of OKD on CentOS Streams and the latest use cases for OKD, and talk all things open with our team.