Project Description

The Uyuni doc requires a lot of dependencies installed to be built. Keeping your system on the right versions or reinstalling can be a challenge.

Moreover, we don't build the documentation on the PRs, so we can inspect it, and we don't have it in any place before we prepare releases.

Goal for this Hackweek

  • Create a container image that can build the doc from a set of parameters (git repository, git reference, product)
  • Publish the container to GitHub (at least for now, OBS is not an option, as a lot of gems and npm packages are required) -> to Docker Hub for now
  • Create a github action to build, on demand, the doc and (somehow) publish it -> postponed

Skills

  • Able to write docker files
  • Familiarity with GitHub actions
  • Familiarity with container images on GitHub
  • Familiarity with publishing objects (if possible static website) from PRs, by using GitHub tooling

Resources

Outcome

https://github.com/uyuni-project/uyuni-docs-helper

Looking for hackers with the skills:

uyuni containers github_actions github_page antora susemanager

This project is part of:

Hack Week 22

Activity

  • 10 months ago: juliogonzalezgil added keyword "susemanager" to this project.
  • 10 months ago: j_renner liked this project.
  • 11 months ago: admehmood liked this project.
  • 11 months ago: juliogonzalezgil added keyword "antora" to this project.
  • 11 months ago: juliogonzalezgil started this project.
  • 11 months ago: juliogonzalezgil added keyword "uyuni" to this project.
  • 11 months ago: juliogonzalezgil added keyword "containers" to this project.
  • 11 months ago: juliogonzalezgil added keyword "github_actions" to this project.
  • 11 months ago: juliogonzalezgil added keyword "github_page" to this project.
  • 11 months ago: juliogonzalezgil originated this project.

  • Comments

    • juliogonzalezgil
      10 months ago by juliogonzalezgil | Reply

      WIP at: https://github.com/juliogonzalez/uyuni-docs-container-image

      For now, I focused on publishing the image to the DockerHub, and being able to build the doc from either a local clone or a remote git repository, so I can easily prepare a demo.

      Publishing to GitHub or using this on PRs, will come later.

    • juliogonzalezgil
      10 months ago by juliogonzalezgil | Reply

      While part of the work is pending, it will be handled as part of my work for SUSE Manager.

      The basics are there, and will be presented to the Uyuni Community and the SUSE Manager stakeholders in the next meetings.

    Similar Projects

    Create tool to analyze supportconfig to spot common SUSE Manager / Uyuni issues by cbosdonnat

    [comment]: # (Please use the project descriptio...


    Enhance product migration feature in Uyuni(SUSE Manager) to migrate from regular SLES to SLES4SAP by admehmood

    [comment]: # (Please use the project descriptio...


    Generate ignition/combustion files from Uyuni/SUSE Manager by dvosburg

    [comment]: # (Please use the project descriptio...


    Create language model based on Uyuni documentation by nadvornik

    [comment]: # (Please use the project descriptio...


    Deep clean-up of the Uyuni documentation files by omaric

    Project Description

    This project is plann...


    Hangar: tool for mirror container images & generate rancher image lists. by StarryWang

    Project Description

    Hangar is a tool for ...


    Containerized home mirror by lkocman

    I'm running a simple home mirror, but I managed...


    Building a container bootloader by flonnegren

    [comment]: # (Please use the project descriptio...


    A set of utilities to produce a "from scratch" OCI/Docker container using Opensuse/SLE rpms by ldragon

    [comment]: # (Please use the project descriptio...


    Forklift - Text based GUI utility for dealing with containers by andreabenini

    [comment]: # (Please use the project descriptio...