diff --git a/content/STRUCTURE.json b/content/STRUCTURE.json index 688ed49b..c28e58ef 100644 --- a/content/STRUCTURE.json +++ b/content/STRUCTURE.json @@ -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"}}, diff --git a/content/distrobuilder/news/distrobuilder-1.0.yaml b/content/distrobuilder/news/distrobuilder-1.0.yaml index 93a166af..2069b68f 100644 --- a/content/distrobuilder/news/distrobuilder-1.0.yaml +++ b/content/distrobuilder/news/distrobuilder-1.0.yaml @@ -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. @@ -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: @@ -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: @@ -41,7 +41,7 @@ content: |- - 0x54CC74307A2C6DC9CE618269CD84BCED626471F1 - 0x6D9278A33A9AB3146262DCECF93525A88B699029 - #### Packages and package managers + ## Packages and package managers Distrobuilder currently supports: - apk @@ -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: @@ -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) @@ -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. @@ -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 @@ -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 @@ -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: @@ -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: diff --git a/content/distrobuilder/news/distrobuilder-1.1.yaml b/content/distrobuilder/news/distrobuilder-1.1.yaml index 6a978b58..dd5c22e2 100644 --- a/content/distrobuilder/news/distrobuilder-1.1.yaml +++ b/content/distrobuilder/news/distrobuilder-1.1.yaml @@ -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. @@ -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) diff --git a/content/distrobuilder/news/distrobuilder-1.2.yaml b/content/distrobuilder/news/distrobuilder-1.2.yaml index c2d82544..4a6ad2a5 100644 --- a/content/distrobuilder/news/distrobuilder-1.2.yaml +++ b/content/distrobuilder/news/distrobuilder-1.2.yaml @@ -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. @@ -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) diff --git a/content/distrobuilder/news/distrobuilder-1.3.yaml b/content/distrobuilder/news/distrobuilder-1.3.yaml index 4773f5c6..a7e5dca6 100644 --- a/content/distrobuilder/news/distrobuilder-1.3.yaml +++ b/content/distrobuilder/news/distrobuilder-1.3.yaml @@ -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: @@ -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) diff --git a/content/distrobuilder/news/distrobuilder-2.0.yaml b/content/distrobuilder/news/distrobuilder-2.0.yaml index 3efd9df4..deb8d3cf 100644 --- a/content/distrobuilder/news/distrobuilder-2.0.yaml +++ b/content/distrobuilder/news/distrobuilder-2.0.yaml @@ -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 @@ -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) diff --git a/content/distrobuilder/news/distrobuilder-2.1.yaml b/content/distrobuilder/news/distrobuilder-2.1.yaml index 9248e323..0659bcf4 100644 --- a/content/distrobuilder/news/distrobuilder-2.1.yaml +++ b/content/distrobuilder/news/distrobuilder-2.1.yaml @@ -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: @@ -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) diff --git a/content/distrobuilder/news/distrobuilder-3-0-has-been-released.yaml b/content/distrobuilder/news/distrobuilder-3-0-has-been-released.yaml index 79847329..ba790338 100644 --- a/content/distrobuilder/news/distrobuilder-3-0-has-been-released.yaml +++ b/content/distrobuilder/news/distrobuilder-3-0-has-been-released.yaml @@ -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: @@ -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)