From 4adf52774df4d12f7dc7422ec1e9f8ca2347bb18 Mon Sep 17 00:00:00 2001 From: Dongsu Park Date: Wed, 11 Oct 2023 17:16:22 +0200 Subject: [PATCH 1/2] README: add new README --- README.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..eaf58f5 --- /dev/null +++ b/README.md @@ -0,0 +1,27 @@ +## ue-rs + +`ue-rs` aims to be a drop-in reimplementation of [update_engine](https://github.com/flacar/update_engine/), written in Rust. + +*Note*: this project is still proof-of-concept, highly experimental, not production-ready yet. + +## Why ue-rs? + +Goal of `ue-rs` is to have a minimal, secure and robust implementation of update engine, required by A/B update mechanism of Flatcar Container Linux. +Just like the existing update engine, it downloads OS update payloads from a [Nebraska](https://github.com/flatcar/nebraska/) server, parses its [Omaha](https://github.com/google/omaha/) protocol, verifies signatures, etc. + +This project, however, is different from the original update engine in the following aspects. + +* It aims to be as minimal as possible. Since `update_engine` has a long history of multiple forks of a [ChromiumOS project](https://chromium.googlesource.com/aosp/platform/system/update_engine/), its code base is inherently heavy and complicated. To address that, it is made by rewriting only essential parts like parsing Omaha protocol from scratch, and use pure Rust RSA libraries instead of relying on openssl. +* Written in Rust, a huge advantage for security, especially memory safety, in contrast to the previous `update_engine`, which is written mainly in C++ and bash. +* In addition to traditional OS update payloads, it supports systemd-sysext OEM, which recently started to be included in the Alpha channel of Flatcar Container Linux. + +## Getting started + +Build. + +``` +cargo build +``` + +Run binaries under `target/debug` or examples under `examples`. + From 01f455ff767e7c7f12936a81a749a96c71b5c1d9 Mon Sep 17 00:00:00 2001 From: Dongsu Park Date: Thu, 12 Oct 2023 11:29:28 +0200 Subject: [PATCH 2/2] README: add Github CI status --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index eaf58f5..a4dc252 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,7 @@ ## ue-rs +[![Github CI](https://github.com/flatcar/ue-rs/actions/workflows/ci.yaml/badge.svg)](https://github.com/flatcar/ue-rs/actions) + `ue-rs` aims to be a drop-in reimplementation of [update_engine](https://github.com/flacar/update_engine/), written in Rust. *Note*: this project is still proof-of-concept, highly experimental, not production-ready yet.