mirror of
https://git.resf.org/sig_core/wiki.git
synced 2024-12-11 06:06:25 +00:00
Start adding modifications and prepping for existence
This commit is contained in:
parent
26f894b417
commit
0aef8d1ec9
29
.github/workflows/gh.yml
vendored
Normal file
29
.github/workflows/gh.yml
vendored
Normal 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
14
README.md
Normal 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:
|
||||
|
||||
```
|
||||
|
||||
```
|
@ -2,6 +2,6 @@
|
||||
nav:
|
||||
- ... | index.md
|
||||
- ... | about.md
|
||||
- Documentation | documentation
|
||||
- SOP | sop
|
||||
- Documentation: documentation
|
||||
- SOP: sop
|
||||
...
|
||||
|
@ -1 +1 @@
|
||||
core.sig.rocky.page
|
||||
sig-core.rocky.page
|
||||
|
3
docs/assets/icon-white.svg
Normal file
3
docs/assets/icon-white.svg
Normal 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>
|
After Width: | Height: | Size: 487 B |
@ -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
7
docs/documentation/compose.md
Normal 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
43
docs/documentation/empanadas.md
Normal 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" %}
|
@ -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
|
||||
|
||||
|
@ -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 |
|
||||
|
||||
|
@ -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 |
|
||||
|
@ -1,4 +1,5 @@
|
||||
--- nav:
|
||||
---
|
||||
nav:
|
||||
- ... | index.md
|
||||
- Release Procedures | sop_release.md
|
||||
- Release Procedures: sop_release.md
|
||||
...
|
||||
|
22
mkdocs.yml
22
mkdocs.yml
@ -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
|
||||
|
Loading…
Reference in New Issue
Block a user