releng/wiki
8
0
Fork 0
mirror of https://git.resf.org/sig_core/wiki.git synced 2024-12-21 10:48:34 +00:00
Code Issues Packages Projects Releases Wiki Activity

Start adding modifications and prepping for existence

Browse Source
This commit is contained in:
Louis Abel 2022-10-15 17:28:22 -07:00
parent 26f894b417
commit 0aef8d1ec9
Signed by: label
GPG Key ID: B37E62D143879B36
13 changed files with 159 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
.github/workflows/gh.yml vendored Normal file
View File

@ -0,0 +1,29 @@
---
name: mkdocs build
on:
push:
branches:
- main
jobs:
build:
runs-on: ubuntu-latest
strategy:
matrix:
python-version: [ 3.8 ]
steps:
- uses: actions/checkout@v2
- name: Set up Python ${{ matrix.python-version }}
uses: actions/setup-python@v2
with:
python-version: ${{ matrix.python-version }}
architecture: x64
- name: Install requirements
run: python3 -m pip install -r requirements.txt
- name: Deploy
run: python3 -m mkdocs gh-deploy --force
...

14
README.md Normal file
View File

@ -0,0 +1,14 @@
# SIG/Core Wiki
[![mkdocs build](https://github.com/rocky-linux/sig-core-wiki/actions/workflows/gh.yml/badge.svg)](https://github.com/rocky-linux/sig-core-wiki/actions/workflows/gh.yml)
This is the wiki repository for SIG/Core.
https://sig-core.rocky.page
## Building
To test the appearance of this wiki, give it a try:
```
```

4
docs/.pages
View File

@ -2,6 +2,6 @@
nav:
- ... | index.md
- ... | about.md
- Documentation | documentation
- SOP | sop
- Documentation: documentation
- SOP: sop
...

2
docs/CNAME
View File

@ -1 +1 @@
core.sig.rocky.page
sig-core.rocky.page

3
docs/assets/icon-white.svg Normal file
View File

@ -0,0 +1,3 @@
<svg width="4096" height="4096" viewBox="0 0 192 192" fill="none" xmlns="http://www.w3.org/2000/svg">
<path fill-rule="evenodd" clip-rule="evenodd" d="M186.658 127.658C190.119 117.746 192 107.093 192 96C192 42.9807 149.019 0 96 0C42.9807 0 0 42.9807 0 96C0 122.234 10.523 146.011 27.5783 163.338L124.958 65.9584L149 90L186.658 127.658ZM169.122 158.205L124.958 114.042L55.7978 183.202C68.0268 188.849 81.6455 192 96 192C125.288 192 151.514 178.884 169.122 158.205Z" fill="white"/>
</svg>
Side by Side

After

Width:  |  Height:  |  Size: 487 B

4
docs/documentation/.pages
View File

@ -1,6 +1,6 @@
---
nav:
- ... | index.md
- Composing Releases | compose.md
- Empanadas | empanadas.md
- Composing Releases: compose.md
- Empanadas: empanadas.md
...

7
docs/documentation/compose.md Normal file
View File

@ -0,0 +1,7 @@
---
title: Composing Releases
---
This page goes over the process of composing a release.
More to come.

43
docs/documentation/empanadas.md Normal file
View File

@ -0,0 +1,43 @@
---
title: Empanadas
---
This page goes over `empanadas`, which is part of the SIG/Core toolkit. Empanadas
assists SIG/Core is composing repositories, creating ISO's, creating images, and
various other activities in Rocky Linux. It is also used for general testing and
debugging of repositories and its metadata.
## Contact Information
| | |
| - | - |
| **Owner** | SIG/Core (Release Engineering & Infrastructure) |
| **Email Contact** | releng@rockylinux.org |
| **Mattermost Contacts** | `@label` `@neil` |
| **Mattermost Channels** | `~Development` |
## General Information
`empanadas` is a python project using poetry, containing various built-in modules
with the goal to try to emulate the Fedora Project's pungi to an extent. While it
is not perfect, it achieves the very basic goals of creating repositories, images
and ISO's for consumption by the end user. It also has interactions with peridot,
the build system used by Rocky Linux to build the distribution.
For performing syncs, it relies on the use of podman to perform syncing in a
parallel fashion. This was done because it is not possible to run multiple dnf
transactions at once on a single system and looping one repository at a time is
not sustainable.
## Requirements
* Poetry must be available on the system
* Podman must be installed on the system
* fpart must be installed on the system (available in EPEL)
* Enough storage should be available if repositories are being synced
## Using Empanadas
###
{% include "resources_bottom.md" %}

21
docs/documentation/index.md
View File

@ -15,12 +15,12 @@ derivative or another project entirely.
The tools in use for the distribution are in the table below.
| Tool | Maintainer | Code Location |
|-----------------|-------------------|---------------------------------------------------------------------|
| srpmproc | SIG/Core at Rocky | [GitHub](https://github.com/rocky-linux/srpmproc) |
| empanadas | SIG/Core at Rocky | [sig-core-toolkit](https://github.com/rocky-linux/sig-core-toolkit) |
| Peridot | SIG/Core at Rocky | |
| MirrorManager 2 | Fedora Project | [MirrorManager2](https://github.com/fedora-infra/mirrormanager2) |
| Tool | Maintainer | Code Location |
|-----------------|------------------|---------------------------------------------------------------------|
| srpmproc | SIG/Core at RESF | [GitHub](https://github.com/rocky-linux/srpmproc) |
| empanadas | SIG/Core at RESF | [sig-core-toolkit](https://github.com/rocky-linux/sig-core-toolkit) |
| Peridot | SIG/Core at RESF | [GitHub](https://github.com/rocky-linux/peridot) |
| MirrorManager 2 | Fedora Project | [MirrorManager2](https://github.com/fedora-infra/mirrormanager2) |
For Rocky Linux to be build, we use `Peridot` as the build system and
`empanadas` to "compose" the distribution. As we do not use Koji for Rocky
@ -36,12 +36,17 @@ Step by step, it looks like this:
* Distribution is built and maintained in Peridot
* Comps and pungi configuration is converted into the peridot format for the project
* Repositories are created in yumrepofs based on the configuration provided
* A repoclosure is ran against the repositories from empanadas to ensure there are no critical issues
* In Parallel:
* Repositories are synced as a "full run" in empanadas
* Lorax is ran using empanadas in the peridot cluster
* Repositories are synced as a "full run" in empanadas
* Lorax is ran using empanadas in the peridot cluster
* Lorax results are pulled down from an S3 bucket
* DVD images are built for each architecture
* Compose directory is synced to staging for verification
* Staging is synced to production to allow mirror syncing
* Bit flip on release day
## General Updates

13
docs/include/resources_bottom.md
View File

@ -51,3 +51,16 @@
**Technology**: Mailman 3 + Hyper Kitty
**Contact**: `~Infrastructure` in Mattermost and `#rockylinux-infra` in Libera IRC
=== "Contacts"
| Name | Email | Mattermost Name | IRC Name |
|---------------------------------|-------------------------|-------------------|--------------------|
| Louis Abel | label@rockylinux.org | @nazunalika | Sokel/label/Sombra |
| Mustafa Gezen | mustafa@rockylinux.org | @mustafa | mstg |
| Skip Grube | skip@rockylinux.org | @skip77 | |
| Sherif Nagy | sherif@rockylinux.org | @sherif | |
| Pablo Greco | pgreco@rockylinux.org | @pgreco | pgreco |
| Neil Hanlon | neil@resf.org | @neil | neil |
| Taylor Goodwill | tg@resf.org | @tgo | tg |

22
docs/index.md
View File

@ -6,18 +6,20 @@ title: SIG/Core
## About
Rocky Linux Center for Technical Excellence
The Rocky Linux Core Special Interest Group (SIG/Core) dedicates themselves to the development, building, production, and release of Rocky Linux for the Enterprise Linux community and the many users around the world. This group is a mixture of core Rocky Linux developers and infrastructure and the members of this group are also members of other groups within the Rocky Linux community (such as SIG/AltArch) as well as the Enterprise Linux community as a whole.
## Mission Statement
SIG/Core strives to ensure a stable distribution is built, tested, and provided to the community from the RESF as a compatible derivative of Red Hat Enterprise Linux.
## Contact
| Role | Name | Email | Mattermost Name | IRC Name |
|------------------------------------: |------------------------------- |--------------------- |--- | --- |
| Identity Management & Release Engineering Co-Lead | Louis Abel | label@rockylinux.org | @nazunalika | Sokel/label/Sombra |
| Release Engineering Co-Lead | Mustafa Gezen | mustafa@rockylinux.org | @mustafa | mstg |
| Release Engineering and Development | Skip Grube | skip@rockylinux.org | @skip77 | |
| Release Engineering and Development | Sherif Nagy | sherif@rockylinux.org | @sherif | |
| Release Engineering and Development | Pablo Greco | N/A | @pgreco | pgreco |
| Infrastructure | Neil Hanlon | neil@resf.org | @neil | neil |
| Infrastructure | Taylor Goodwill | tg@resf.org | @tgo | tg |
| Role | Name | Email | Mattermost Name | IRC Name |
|---------------------------------------------------|---------------------------------|------------------------ |-------------------|--------------------|
| Identity Management & Release Engineering Co-Lead | Louis Abel | label@rockylinux.org | @nazunalika | Sokel/label/Sombra |
| Release Engineering Co-Lead | Mustafa Gezen | mustafa@rockylinux.org | @mustafa | mstg |
| Release Engineering and Development | Skip Grube | skip@rockylinux.org | @skip77 | |
| Release Engineering and Development | Sherif Nagy | sherif@rockylinux.org | @sherif | |
| Release Engineering and Development | Pablo Greco | pgreco@rockylinux.org | @pgreco | pgreco |
| Infrastructure | Neil Hanlon | neil@resf.org | @neil | neil |
| Infrastructure | Taylor Goodwill | tg@resf.org | @tgo | tg |

5
docs/sop/.pages
View File

@ -1,4 +1,5 @@
--- nav:
---
nav:
- ... | index.md
- Release Procedures | sop_release.md
- Release Procedures: sop_release.md
...

22
mkdocs.yml
View File

@ -1,7 +1,7 @@
---
# Wiki information
site_name: SIG/Core Wiki
site_url: https://core.sig.rocky.page
site_url: https://sig-core.rocky.page
site_description: >-
The wiki for Rocky Linux Core SIG.
@ -11,7 +11,19 @@ repo_name: sig_core/wiki
edit_uri: edit/main/docs/
theme:
name: cinder
name: material
palette:
- media: "(prefers-color-scheme: light)"
scheme: default
toggle:
icon: material/weather-night
name: Switch to dark mode
- media: "(prefers-color-scheme: dark)"
scheme: slate
toggle:
icon: material/weather-night
name: Switch to dark mode
logo: assets/icon-white.svg
highlightjs: true
hljs_languages:
- bash
@ -19,12 +31,12 @@ theme:
- yaml
- perl
features:
- navigation.tabs
- navigation.tabs.sticky
- navigation.top
- search.highlight
- search.suggest
- toc.integrate
#- navigation.tabs
#- navigation.tabs.sticky
#- navigation.top
markdown_extensions:
- abbr
- admonition