From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 6901194598360547328 X-Received: by 2002:a19:c55:: with SMTP id 82mr688843lfm.84.1606812044247; Tue, 01 Dec 2020 00:40:44 -0800 (PST) X-BeenThere: isar-users@googlegroups.com Received: by 2002:ac2:5a02:: with SMTP id q2ls857094lfn.1.gmail; Tue, 01 Dec 2020 00:40:43 -0800 (PST) X-Google-Smtp-Source: ABdhPJyGEnX2wA7yXWJ1W/5mkvX6/bjvAwk974kCMDdah9DdO8rh8TJJReSRzoUNiosjMEuWdJU9 X-Received: by 2002:a19:4a08:: with SMTP id x8mr741313lfa.322.1606812042993; Tue, 01 Dec 2020 00:40:42 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1606812042; cv=none; d=google.com; s=arc-20160816; b=HIZsI3xo83XpERRpgqePMduyfPnh3GqMoPJkn76EtMlpD4jwQLC3aOj+vw/NiTejLu 5xDNoX4KU9qRI1n063aLa7xpAlSvU+4oxfE9yZdmHiho/3eLrayNVKbvFH0hHe2YKQvP UKhYlauSFdVEzOm80BGYxBmJFxLzwOoyqTTlav0U9kVy01QBD0xfJJ7b24ZB3Rv0dXyy Y17wpam8TVwZG9X2cNvQ9n5hBgiWsghAltkMkiqmWic0Oz0RGjA9oTd5dxYafxUFUILY UKODM4Rue9ZNOA36rMP7r94DeYWENzTc/ixCi9jqkMQwjK+w+Vo73ZHuXKohB3N+15FQ ikBw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:content-language:in-reply-to:mime-version :user-agent:date:message-id:from:references:cc:to:subject; bh=vfb83X0ay5H7s1YDy4aN/zZRL/t+0J/82q6PhkaMxto=; b=aEcz1nEDGsDvU5mz8NCNknwVAZzVyaT2tBOmZiHRTpL8Bcx6hs189lK/Shn7C5Q8jT B5PmrDPY9uFBnwQ7ae7X+/KHoEzyJb5m+rVvRgtnnxVJOYlziJ3qmL5HhbLdoqHYHJ9k 3RU4ZQBnqfhRJ3DIwcKuggTqks+SdWHCzW7QGTLl9v+LpcNE/TLxcw/pweG91lP1QHz9 owlp0ZCU2Y2ROpEp/tGiQLZiWGpYQHb9RidgOTfVSmgo945STZgUYtDUu4XWRevfB5xX T2lHN5bZul0kcGkT8Vs9GqJLBHzv8Trg2kLpIRl5Lj3FIuwFcVI2QqOZ4Sl9P58JUuFi ImVQ== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=pass (google.com: domain of jan.kiszka@siemens.com designates 192.35.17.2 as permitted sender) smtp.mailfrom=jan.kiszka@siemens.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=siemens.com Return-Path: Received: from thoth.sbs.de (thoth.sbs.de. [192.35.17.2]) by gmr-mx.google.com with ESMTPS id f5si60961ljc.0.2020.12.01.00.40.42 for (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Tue, 01 Dec 2020 00:40:42 -0800 (PST) Received-SPF: pass (google.com: domain of jan.kiszka@siemens.com designates 192.35.17.2 as permitted sender) client-ip=192.35.17.2; Authentication-Results: gmr-mx.google.com; spf=pass (google.com: domain of jan.kiszka@siemens.com designates 192.35.17.2 as permitted sender) smtp.mailfrom=jan.kiszka@siemens.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=siemens.com Received: from mail2.sbs.de (mail2.sbs.de [192.129.41.66]) by thoth.sbs.de (8.15.2/8.15.2) with ESMTPS id 0B18egLQ022497 (version=TLSv1.2 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 1 Dec 2020 09:40:42 +0100 Received: from [167.87.39.132] ([167.87.39.132]) by mail2.sbs.de (8.15.2/8.15.2) with ESMTP id 0B18efZw020506; Tue, 1 Dec 2020 09:40:41 +0100 Subject: Re: [RFC] Image templates To: Cedric Hombourger , isar-users@googlegroups.com Cc: joe_macdonald@mentor.com, Henning Schild , "Cirujano-Cuesta, Silvano" References: <6bf9a786-51b8-2430-90f5-2857746d003f@mentor.com> From: Jan Kiszka Message-ID: <6218fc7b-2515-5b81-91b6-6fd0d275ae02@siemens.com> Date: Tue, 1 Dec 2020 09:40:41 +0100 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.5.0 MIME-Version: 1.0 In-Reply-To: <6bf9a786-51b8-2430-90f5-2857746d003f@mentor.com> Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 8bit X-TUID: AoKpJeqM0mas On 01.12.20 08:59, Cedric Hombourger wrote: > Image Templates for ISAR > ======================== > > Introduction > ------------ > > Embedded System projects may have multiple teams working at different > levels. It is not uncommon to have groups creating a "base platform" > which is handed over to product teams to customize further. > Thanks to ISAR leveraging bitbake, image recipes from a base layer may > be easily extended by product layers but also with its ability to > produce and use a `base-apt` instead of upstream package feeds. > This workflow functions well in many cases, it may not be optimal for > application teams. Such teams are typically receiving a base platform > release that is likely to be left untouched for weeks. > Creating a product image for those teams is sometimes as easy as adding > a few packages. There is another use case, even for base image developers: accelerating the turn-around time when working only on few, widely isolated packages, may it be the kernel or a bootloader artifact. For that scenario, it should be possible to define an image template excluding those bits, only injecting them on top in a second step. > > In such cases, it may be desirable to have a mechanism for ISAR to > construct product images starting from the base platform root > file-system instead of ISAR's bootstrap root file-system. We will refer > to these base platform root file-systems as _Template Images_. > > This document will describe both the construction and the use of > _template images_. > > Construction > ------------ > > Developers needing to produce image templates in addition to bootable > system images will have their image recipes `inherit` the > `produce-image-template` class either as part of their image development > or by extending an existing image with an appropriate `.bbappend`. > > The class would invoke a `do_rootfs_template` task after > `do_rootfs_install` and before the post-processing tasks (which should > be applied on the final image). This new task would simply create a > template image in the deploy folder built from the common root > file-system artifacts. Some systems may have additional, more extensive > post-processing operations that must be performed on the final > image, this class will still allow for such operations to function > normally. > > It is anticipated that configuration files in `/etc/apt/sources.list.d` > and `/etc/resolv.conf` should be excluded (they should be recreated > while the template image is imported). A subsequent update > will define a criteria for determining which files should be excluded > from the tarball. As yet the specific mechanism has not been determined, > whether it would be a file list, pattern or some other > external attributes. We anticipate other objects that may need to be > excluded are `/etc/hosts` and proxy configuration, to name two simple > examples. > > The process of constructing the base image would then continue as usual > (with post-processing and imager tasks). > > It is suggested to expose the produced image template as an opaque > binary blob and use a `.tmpl.img` file extension although the initial > implementation is anticipated to be a compressed tarball. > The template filesystem may need embedded meta-data to be consumed by > import mechanism or image recipes that make use of templates but omitted > from the final rootfs. It would be useful at the outset > to either specify a minimal set of metadata (build date, image name and > feature list is the initial list to be considered) and the structure of > that metadata (currently considering either JSON-formatted > suitable for extraction with `jq` or `deb` packaging, which has embedded > metadata in the cpio archive). > > Usage > ----- > > Application teams may create image recipes referencing image templates > in their SRC_URI list. As noted above, image templates would use the > `.tmpl.img` file extension. This would be used by ISAR's `rootfs` > class to locate image templates in the list and make sure that only one > template is specified (extracting a template over another would have > unpredictable results). > > If the bulk of the template intelligence is present in the `do_rootfs` > stages, the `do_rootfs_prepare` task from the `rootfs` class would > behave differently.  In this case, an image template may be added to > an image SRC_URI. Instead of copying ISAR's bootstrap rootfs, the > template feature would instead unpack the specified template. It would > also be necessary to copy `/etc/apt/sources.list.d` from the bootstrap > and possibly other files (e.g. `/etc/resolv.conf`). As the environment > may include different apt sources, a complete `apt-get update` would be > in order. > > ISAR would then "enter" the unpacked template carrying updated apt > sources to install packages listed in `IMAGE_INSTALL` and > `IMAGE_PREINSTALL` using `apt- get install` as it does today in > `do_rootfs_install`. > > This design should allow images constructed from an image template to > produce a new image template (e.g. a base platform could provide a > template having a BSP and a minimal Debian system, and middleware teams > could then produce their own template with middleware stacks added and > finally consumed by application teams to produce a final system image). > There will likely be a number of traps we can stumble over, but the general vision is shared. One of the trap is that you may not only need a target image template but also the corresponding buildchroots, if not isar-bootstraps. Would your model be that a developer works within the layer that creates the template? A key issue would be that changes to the layer that invalidate the template would be detected and make the template-based build fail or fall back to the full build. Or would your model be that templating enforce a split build via separate repos? That might be problematic from the maintenance perspective as application injection will come before imaging, and the latter is not the task of an application developer. > Future Work > ----------- > > It may be desirable to offer a mechanism to remove packages coming from > an image template (application teams may need to optimize the final > system image to meet the footprint constraints of their design and/or > to reduce the attack surface by removing services they do not need). > > Status > ------ > > This high-level design was created to seek early feedback from the ISAR > developer community by exposing the problem we are trying to solve and > the mechanism we are proposing as a solution. The next step would be > the development of a Proof-of-Concept in the event where positive > comments are received. This document may also be updated as feedback is > received and may result in different approaches being discussed. > > We will be happy to answer questions you may have or provide more > details in areas where this document would be too evasive. > The whole thing also reminds me a lot of how docker images are created. I wonder to which degree we can learn from that, reuse concepts or avoid pitfalls. Adding Silvano with whom I was recently discussing base container image generation via Isar. Jan -- Siemens AG, T RDA IOT Corporate Competence Center Embedded Linux