Skip to content

Commit

Permalink
distrobuilder: fix news header levels
Browse files Browse the repository at this point in the history
Signed-off-by: Benjamin Somers <[email protected]>
  • Loading branch information
bensmrs committed Jun 3, 2024
1 parent ecb2a0b commit 463b0f0
Show file tree
Hide file tree
Showing 8 changed files with 30 additions and 30 deletions.
2 changes: 1 addition & 1 deletion content/STRUCTURE.json
Original file line number Diff line number Diff line change
Expand Up @@ -272,7 +272,7 @@
"generator": "news",
"meta": {"dir": "/content/distrobuilder/news/",
"input": "distrobuilder/news.md",
"toc_depth": "2-2",
"toc_depth": "2-3",
"str_older": "Older news",
"str_back": "Back to the news overview"}},

Expand Down
34 changes: 17 additions & 17 deletions content/distrobuilder/news/distrobuilder-1.0.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ title: Distrobuilder 1.0 has been released
date: 2019/10/21 22:10
origin: https://discuss.linuxcontainers.org/t/distrobuilder-1-0-has-been-released/5987
content: |-
### Introduction
# Introduction
The distrobuilder team is proud to announce its initial release, distrobuilder 1.0!
Distrobuilder is a tool which produces root filesystems, LXC and LXD images.
Expand All @@ -15,8 +15,8 @@ content: |-
It can be seen at work [here](https://jenkins.linuxcontainers.org/view/Images/) building the many images that we [publish daily](https://images.linuxcontainers.org).
### Main components
#### Image details
# Main components
## Image details
This first section covers the usual suspects, the image name, distribution, release, description and architecture.
Example:
Expand All @@ -28,7 +28,7 @@ content: |-
description: Ubuntu {{ image.release }}
architecture: x86_64
#### Image sources
## Image sources
The image sources are distribution specific logic (in Go) to either retrieve a suitable minimal base image or produce one from scratch using commonly available tooling (like `debootstrap`).
Example:
Expand All @@ -41,7 +41,7 @@ content: |-
- 0x54CC74307A2C6DC9CE618269CD84BCED626471F1
- 0x6D9278A33A9AB3146262DCECF93525A88B699029
#### Packages and package managers
## Packages and package managers
Distrobuilder currently supports:
- apk
Expand Down Expand Up @@ -92,7 +92,7 @@ content: |-
variants:
- cloud
#### Files
## Files
Distrobuilder can generate common files like hostname/hosts, some amount of init system configuration files, cloud-init templates and more generating templating for LXD containers.
Example:
Expand All @@ -113,7 +113,7 @@ content: |-
- path: /etc/machine-id
generator: remove
#### Actions
## Actions
Actions are effectively a number of hook points at which a provided shell scripts can be run. Those hooks currently are:
- post-unpack (after the source image was retrieved and unpacked)
Expand Down Expand Up @@ -153,7 +153,7 @@ content: |-
variants:
- cloud
#### Architecture maps
## Architecture maps
One of those tiny internal details, but pretty much every Linux distribution has its own name for the various hardware architecture. Distrobuilder has maps for the most ones, translating between kernel architectures and the name used by the distribution.
This allows for consistent architecture naming in the output, to line up with the patterns used by LXC and LXD.
Expand All @@ -164,15 +164,15 @@ content: |-
architecture_map: debian
#### Conditions
## Conditions
Packages, Files and Actions can all be set to only apply to specific image variants, distribution releases or OS architectures, making it possible to have a single YAML file for an entire Linux distribution. Some examples of this can be found in the previous examples.
### Examples
# Examples
All the production YAML files for [our image server](https://images.linuxcontainers.org) can be [found here](https://github.com/lxc/lxc-ci/tree/master/images).
Those are all pretty featureful and will generally be used to generate multiple releases of the distribution for multiple architectures and often for two variants (standard and cloud-init enabled).
### Supported distributions
# Supported distributions
Distrobuilder can build images for the following distributions:
- Alpine Linux
Expand All @@ -196,7 +196,7 @@ content: |-
Adding a new distribution is usually pretty straightforward and just requires adding a new package manager wrapper and logic to fetch a minimal source image or to produce that image directly.
### Architecture support
# Architecture support
Distrobuilder supports and is actively used on:
- aarch64
Expand All @@ -208,16 +208,16 @@ content: |-
Only native image building is supported at this point, no support for cross-building through `qemu-user-static` or similar tooling.
### Security
# Security
A common issue with the older shell scripts in `lxc-templates` was the lack of validation of the downloaded packages and other artifacts instrumental to the image building process. This was often caused by lack of HTTPS servers to download those files from combined with difficulty of dealing with GPG for the very many distributions we had to support.
Distrobuilder changes that model by using pre-built minimal images downloaded over HTTPS or GPG validated (with support for key retrieval or in-line keyring), then either adding on top of that base image or using the base image to produce a whole new image using the distribution's native tooling.
### How to get it
# How to get it
This new LXD release is already available for you to try on our [demo service](https://linuxcontainers.org/lxd/try-it/).
### Installing it
#### Using the snap
# Installing it
## Using the snap
A snap package is available with both `stable` and `edge` releases.
It can be installed with:
Expand All @@ -228,7 +228,7 @@ content: |-
snap install distrobuilder --classic --edge
#### From source
## From source
The release tarballs can be found on our [download page](https://linuxcontainers.org/distrobuilder/downloads/). Those include a snapshot of all the Go dependencies needed to build distrobuilder.
Alternatively, the current upstream code can be built with:
Expand Down
4 changes: 2 additions & 2 deletions content/distrobuilder/news/distrobuilder-1.1.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ title: Distrobuilder 1.1 has been released
date: 2020/08/20 21:08
origin: https://discuss.linuxcontainers.org/t/distrobuilder-1-1-has-been-released/8749
content: |-
### Introduction
# Introduction
The distrobuilder team is proud to announce its initial release, distrobuilder 1.1!
This release's highlight is the introduction of VM image building support following LXD's introduction of VM support.
Expand Down Expand Up @@ -138,7 +138,7 @@ content: |-
- doc/generators: Add fstab
[/details]
### Downloads
# Downloads
- Main release tarball: [distrobuilder-1.1.tar.gz](https://linuxcontainers.org/downloads/distrobuilder/distrobuilder-1.1.tar.gz)
- GPG signature: [distrobuilder-1.1.tar.gz.asc](https://linuxcontainers.org/downloads/distrobuilder/distrobuilder-1.1.tar.gz.asc)
4 changes: 2 additions & 2 deletions content/distrobuilder/news/distrobuilder-1.2.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ title: Distrobuilder 1.2 has been released
date: 2021/03/23 15:03
origin: https://discuss.linuxcontainers.org/t/distrobuilder-1-2-has-been-released/10592
content: |-
### Introduction
# Introduction
The distrobuilder team is proud to announce its initial release, distrobuilder 1.2!
This release's highlight is the introduction of Windows image repacking.
Expand Down Expand Up @@ -72,7 +72,7 @@ content: |-
- Update gomod
[/details]
### Downloads
# Downloads
- Main release tarball: [distrobuilder-1.2.tar.gz](https://linuxcontainers.org/downloads/distrobuilder/distrobuilder-1.2.tar.gz)
- GPG signature: [distrobuilder-1.2.tar.gz.asc](https://linuxcontainers.org/downloads/distrobuilder/distrobuilder-1.2.tar.gz.asc)
4 changes: 2 additions & 2 deletions content/distrobuilder/news/distrobuilder-1.3.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ title: Distrobuilder 1.3 has been released
date: 2021/08/09 18:08
origin: https://discuss.linuxcontainers.org/t/distrobuilder-1-3-has-been-released/11836
content: |-
### Introduction
# Introduction
The distrobuilder team is proud to announce its initial release, distrobuilder 1.3!
The main highlights are:
Expand Down Expand Up @@ -165,7 +165,7 @@ content: |-
- main: Support ISO generation with mkisofs
[/details]
### Downloads
# Downloads
- Main release tarball: [distrobuilder-1.3.tar.gz](https://linuxcontainers.org/downloads/distrobuilder/distrobuilder-1.3.tar.gz)
- GPG signature: [distrobuilder-1.3.tar.gz.asc](https://linuxcontainers.org/downloads/distrobuilder/distrobuilder-1.3.tar.gz.asc)
4 changes: 2 additions & 2 deletions content/distrobuilder/news/distrobuilder-2.0.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ title: Distrobuilder 2.0 has been released
date: 2021/10/18 03:10
origin: https://discuss.linuxcontainers.org/t/distrobuilder-2-0-has-been-released/12403
content: |-
### Introduction
# Introduction
The distrobuilder team is proud to announce its initial release, distrobuilder 2.0!
As usual, this release fixes a variety of issues as Linux distributions evolve and change the way they're built. Additionally, it also improves the Windows ISO repack feature quite a bit and introduces support for directly importing an image into LXD
Expand Down Expand Up @@ -66,7 +66,7 @@ content: |-
- Update gomod
[/details]
### Downloads
# Downloads
- Main release tarball: [distrobuilder-2.0.tar.gz](https://linuxcontainers.org/downloads/distrobuilder/distrobuilder-2.0.tar.gz)
- GPG signature: [distrobuilder-2.0.tar.gz.asc](https://linuxcontainers.org/downloads/distrobuilder/distrobuilder-2.0.tar.gz.asc)
4 changes: 2 additions & 2 deletions content/distrobuilder/news/distrobuilder-2.1.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ title: Distrobuilder 2.1 has been released
date: 2022/04/27 16:04
origin: https://discuss.linuxcontainers.org/t/distrobuilder-2-1-has-been-released/13954
content: |-
### Introduction
# Introduction
The distrobuilder team is proud to announce the release of distrobuilder 2.1!
Outside of the usual updates to account for changes made by various distributions, the main highlights are:
Expand Down Expand Up @@ -91,7 +91,7 @@ content: |-
- windows: Add viostor driver
[/details]
### Downloads
# Downloads
- Main release tarball: [distrobuilder-2.1.tar.gz](https://linuxcontainers.org/downloads/distrobuilder/distrobuilder-2.1.tar.gz)
- GPG signature: [distrobuilder-2.1.tar.gz.asc](https://linuxcontainers.org/downloads/distrobuilder/distrobuilder-2.1.tar.gz.asc)
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ title: Distrobuilder 3.0 has been released
date: 2023/11/11 03:11
origin: https://discuss.linuxcontainers.org/t/distrobuilder-3-0-has-been-released/18260
content: |-
### Introduction
# Introduction
The distrobuilder team is proud to announce the release of distrobuilder 3.0!
Outside of the usual updates to account for changes made by various distributions, the main highlights are:
Expand Down Expand Up @@ -203,7 +203,7 @@ content: |-
- Update Vyos rolling update iso url
[/details]
### Downloads
# Downloads
- Main release tarball: [distrobuilder-3.0.tar.gz](https://linuxcontainers.org/downloads/distrobuilder/distrobuilder-3.0.tar.gz)
- GPG signature: [distrobuilder-3.0.tar.gz.asc](https://linuxcontainers.org/downloads/distrobuilder/distrobuilder-3.0.tar.gz.asc)

0 comments on commit 463b0f0

Please sign in to comment.