Skip to content
This repository was archived by the owner on Oct 28, 2024. It is now read-only.

Commit 480aaa2

Browse files
JaimeMagieraJaimeMagiera
authored
Merge pull request #49 from okd-project/wg-statement-scos-base-migration
Working Group statement on build delays and migrating cluster components to SCOS base
2 parents d2c3e7d + c5e6e76 commit 480aaa2

File tree

8 files changed

+91
-60
lines changed

8 files changed

+91
-60
lines changed

Diff for: ‎.github/actions/entrypoint.sh

+1-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
cd "${GITHUB_WORKSPACE}"
44

55
# Python Dependencies
6-
pip --no-cache-dir install git+https://github.com/linkchecker/linkchecker@v10.1.0#egg=linkchecker
6+
pip --no-cache-dir install git+https://github.com/linkchecker/linkchecker@v10.3.0#egg=linkchecker
77
# NodeJS Dependencies
88
npm ci
99

Diff for: ‎.github/workflows/check-build.yml

+34
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
name: Build Check
2+
3+
on:
4+
pull_request:
5+
branches: [ main ]
6+
7+
# Allows you to run this workflow manually from the Actions tab
8+
workflow_dispatch:
9+
10+
env:
11+
TITLE: OKD.io
12+
13+
jobs:
14+
build:
15+
runs-on: ubuntu-24.04
16+
steps:
17+
- name: Checkout Repo
18+
uses: actions/checkout@v4
19+
- name: Install dependencies (Python)
20+
run: pip install -r requirements.txt --break-system-packages
21+
- name: Install dependencies (Node)
22+
run: npm ci
23+
- name: Spellcheck
24+
run: ./node_modules/.bin/cspell "docs/**/*.md"
25+
- name: Build the site
26+
run: mkdocs build --strict --clean --verbose
27+
- name: Upload built site
28+
uses: actions/upload-artifact@v4
29+
with:
30+
name: okd.io
31+
path: public/
32+
if-no-files-found: error
33+
- name: Log any discovered broken links
34+
run: linkchecker -f linkcheckerrc public || true

Diff for: ‎.github/workflows/main.yml

-41
This file was deleted.

Diff for: ‎.github/workflows/publish.yaml

+23-16
Original file line numberDiff line numberDiff line change
@@ -3,23 +3,30 @@ name: Publish
33
on:
44
push:
55
branches: [ main ]
6+
workflow_dispatch:
67

7-
jobs:
8-
publish:
9-
10-
runs-on: ubuntu-latest
11-
12-
env:
13-
NODE_VERSION: 12.x
14-
TITLE: OKD.io
8+
env:
9+
TITLE: OKD.io
1510

11+
jobs:
12+
build:
13+
runs-on: ubuntu-24.04
1614
steps:
17-
- uses: actions/checkout@v2
18-
- name: generate site
19-
uses: ./.github/actions/
20-
21-
- name: Deploy
22-
uses: peaceiris/actions-gh-pages@v3
15+
- name: Checkout Repo
16+
uses: actions/checkout@v4
17+
- name: Install dependencies (Python)
18+
run: pip install -r requirements.txt --break-system-packages
19+
- name: Install dependencies (Node)
20+
run: npm ci
21+
- name: Spellcheck
22+
run: ./node_modules/.bin/cspell "docs/**/*.md"
23+
- name: Build the site
24+
run: mkdocs gh-deploy --strict --clean --verbose -d public
25+
- name: Upload built site
26+
uses: actions/upload-artifact@v4
2327
with:
24-
github_token: ${{ secrets.GITHUB_TOKEN }}
25-
publish_dir: ./public
28+
name: okd.io
29+
path: public/
30+
if-no-files-found: error
31+
- name: Log any discovered broken links
32+
run: linkchecker -f linkcheckerrc public || true

Diff for: ‎docs/blog/posts/okd-future-statement.md

+26
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
---
2+
draft: false
3+
date: 2024-06-01
4+
---
5+
6+
<!-- cSpell:ignore SCOS ostree homelabs -->
7+
8+
# OKD Working Group Statement June 1, 2024
9+
10+
We would like to take a moment to outline what's been happening the past few months in terms of OKD releases and what the future holds for the project.
11+
12+
In Summer of 2023, it came to the attention of Red Hat that licensed content was inadvertently being included in the OKD releases. This necessitates a change of the OKD release materials. At the same time, the Working Group has been striving to increase the community's direct involvement in the build and release process. To address these concerns, Red Hat and the Working Group have been collaborating on defining a path forward over the past few months. This work involves moving OKD builds to a new system, changing the underlying OS, and exposing the new build and release process to community members.
13+
14+
After careful consideration, we've settled on using Centos Stream CoreOS (SCOS) as the underlying operating system for the new builds. We've been working with SCOS since it was first announced at KubeCon U.S. 2022. There's a great opportunity with SCOS for the larger Open Source community to participate in improving OKD and further delineating it from other Kubernetes distributions. The builds will be for x86_64 only while we get our bearings. Given rpm-ostree is the foundation of all modern OKD releases, many existing installations will be able to switch to the SCOS distribution in-place. We're working to outline that procedure in our documentation and identify any edge-cases that may require more work to transition.
15+
16+
The payload for OKD on SCOS is now successfully building. There are still end-to-end tests which need to complete successfully and other housekeeping tasks before pre-release nightly builds can spin up an active cluster. We anticipate this happening within the next few weeks. At that point, members of the community will be able to download these nightly builds for testing and exploration purposes.
17+
18+
On the community involvement and engagement side of things, we'll be relaunching our website to align with the first official release of OKD on SCOS. That site will feature much clearer paths to the information users want to get their clusters up and running. We're redoubling our efforts to help homelabs, single-node, and other similar use cases get off the ground. Likewise, the new website will provide much clearer information on how community members can contribute to the project.
19+
20+
We appreciate everyone's patience over the past few months while we solidified the path forward. We wanted to be confident the pieces would fit together and bring about the desired results before releasing an official statement. From here on out, there will be regular updates on our website.
21+
22+
We understand that there will be lots of questions as this process moves forward. Please post those questions on [this discussion thread](https://github.com/okd-project/okd/discussions/1922). We will organize them into this [Frequently Asked Questions page](https://okd.io/scos-migration-faq/).
23+
24+
Many thanks,
25+
26+
The OKD Working Group Co-Chairs

Diff for: ‎docs/scos-migration-faq.md

+2
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
# FAQ - OKD Components based on SCOS
22

3+
<!--cSpell:ignore SCOS -->
4+
35
This FAQ document relates to the builds of OKD that use CentOS Stream CoreOS (SCOS) after work done to stop using RHEL as the base for cluster components, as well as the upgrade path from pre-4.16 OKD FCOS/SCOS installations.
46

57
*Holding Page*

Diff for: ‎mkdocs.yml

+2-1
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
site_name: OKD.io
22
site_description: >-
33
The Community Distribution of Kubernetes that powers Red Hat OpenShift
4-
site_url: https://openshift-cs.github.io/okd.io/index.html
4+
site_url: https://okd.io/
55
site_author: Brian Innes
66
repo_name: "okd-io"
77
repo_url: https://github.com/okd-project/okd.io
@@ -159,3 +159,4 @@ nav:
159159
- Help:
160160
- Getting Help: help.md
161161
- FAQ: faq.md
162+
- SCOS Migration FAQ: scos-migration-faq.md

Diff for: ‎requirements.txt

+3-1
Original file line numberDiff line numberDiff line change
@@ -2,4 +2,6 @@
22
mkdocs==1.6.0
33
mkdocs-material==9.5.25
44
mkdocs-minify-plugin==0.8.0
5-
git+https://github.com/linkchecker/[email protected]#egg=linkchecker
5+
linkchecker==10.4.0
6+
pymdown-extensions==10.8.1
7+
mkdocs-material[imaging]==9.5.25

0 commit comments

Comments
 (0)