From patchwork Wed May 4 04:16:07 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Schmidt, Adriaan" X-Patchwork-Id: 1747 Return-Path: Received: from shymkent.ilbers.de ([unix socket]) by shymkent (Cyrus 2.5.10-Debian-2.5.10-3) with LMTPA; Wed, 04 May 2022 14:16:33 +0200 X-Sieve: CMU Sieve 2.4 Received: from mail-lj1-f192.google.com (mail-lj1-f192.google.com [209.85.208.192]) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8) with ESMTPS id 244CGWlT032734 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Wed, 4 May 2022 14:16:32 +0200 Received: by mail-lj1-f192.google.com with SMTP id f6-20020a2e9186000000b0024f3dfdf894sf268887ljg.2 for ; Wed, 04 May 2022 05:16:32 -0700 (PDT) ARC-Seal: i=3; a=rsa-sha256; t=1651666586; cv=pass; d=google.com; s=arc-20160816; b=hruVZwWq1jsLf7v6U8fGfbKycn1j6ClAtl2ei/ryzDYZYe0wHWjekXQKadEvQdHOvG V8VMm8t9TD1D0ogYFN/kOm+CLR1sXDSPpiQxGycFyaE9k2T26RqgqPUChDPrD/21rnAy xHCIVRiTuBdV4DlmtoS7KROXd6ElFQNEsm0xvmYCK9KHgwyTVmemdTLxE8w2pqU1k10a 3N9LFPePqHqeZIAjTi561v1DA9I65eXJ9uaOgNIk6d/MSay7hFe1ZD7x332/NRICxikN PhfPv95bsXiFpYM6Cjf71G4q3QgHlSadFtg2ENwisicHbqqxG/CdMD1iHxY5hW74u9Bi aPRg== ARC-Message-Signature: i=3; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:mime-version:message-id:date :subject:cc:to:from:sender:dkim-signature; bh=Vxhh/0Qf9sj6jaNBI8W2atkohs/Pbt+aYkw8JbSp9hY=; b=ZNU8To3qsoLKwdCLIesLSuYs2d4KikLEAZDt/mrZDonntuqRV43lsCzKbbbh7z8lWF lHjTs7QpCC50suYb0WPCwRTrmywcUi0Nq7w9uaII5H0B2ZCOgBGEkL3CZQKlEJDwZ1UR CNUgNdZe4uTwFxe2B88/a2xHyUCvR+4075MNHZPvetFZqGQYZy1SA8ZHTcEfxJJeyGkg Jze9Zn8Z53SKBX9HCeeWjPJoBAZUp2hK63x+/cPml34mhJMifnZO8sxwJmwP4q5fCHgN WtsTXu8rry1LXEwnbi6ICjYtd85djk4sYcncrJHDCP849WBBVc9vUy26/EY1E+aXM9w8 y4/Q== ARC-Authentication-Results: i=3; gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=selector2 header.b=FBslkrci; arc=pass (i=1 spf=pass spfdomain=siemens.com dmarc=pass fromdomain=siemens.com); spf=pass (google.com: domain of adriaan.schmidt@siemens.com designates 2a01:111:f400:7e1b::609 as permitted sender) smtp.mailfrom=adriaan.schmidt@siemens.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=siemens.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20210112; h=sender:from:to:cc:subject:date:message-id:mime-version :x-original-sender:x-original-authentication-results:precedence :mailing-list:list-id:list-post:list-help:list-archive :list-subscribe:list-unsubscribe; bh=Vxhh/0Qf9sj6jaNBI8W2atkohs/Pbt+aYkw8JbSp9hY=; b=TuCX+VvQ/6VFltm2rl4gc1FIT7cjQu/72uQljbwJI7iV6xAKZtgiwJ/5e47VMUZwMb h7ZVNVx3roEFqfyIcLC/nhCvhSJA/mjX5UIzxod8/yF8zaH1tFnDlhXG/AXqUAVXiHPb +Ljl+Vywf8NKL+/tHltXUzwQxvD6IjbK7/iDvoyBcYVY1RUdfoWUzoGo5LRCy9xhJe1Z 3unUGK8qH6+X/ejO67Op5HK74uaUfwGvxOrUmMOYpKmqOaHqnsOfqBgTnsj4G8H3qXe6 EFfz0Oa3+B0S8bUmL+lC2S6SV2kXnhx2ENqspoo8zW4Eg0i8Ozedls9mdcRs2g4ZqEY5 QMMg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=sender:x-gm-message-state:from:to:cc:subject:date:message-id :mime-version:x-original-sender:x-original-authentication-results :precedence:mailing-list:list-id:x-spam-checked-in-group:list-post :list-help:list-archive:list-subscribe:list-unsubscribe; bh=Vxhh/0Qf9sj6jaNBI8W2atkohs/Pbt+aYkw8JbSp9hY=; b=TgvhDU/PyRpkjObb4WT028EenU9j60uw2HZwu+kzf2XFMFWzeNNeIdTRTlykUnuxCG NB0W1X28jHLfuomAcGOcy+N0CEO2oDPD0j3TcmHSw6JbN5iD+7VeNgiKWQiZbcm3UQAd F6FXIYzcTxMboNMwfQlI7NPWWSUUamLPY0hL/XsnWDQhaz2r5lYzGC5Seryf5MN9Mecx KvgJgOd19aaABccwFCDZhAALvb8DjNTff461YW1HiNIIfbfbZyGB4k+4/z1nlXWuaZyU vTpRXrMWgQuLyDDO83s4DVQcmTNqgM6mcUSTtVLvPj76QRlpxnzl2IcSZqlnHVSHVBea wGQA== Sender: isar-users@googlegroups.com X-Gm-Message-State: AOAM5333iU9Qa9sWpI3QD92KMjVsNyVltFF4dvRXNGix9RP6OR5rxujt b2mMVPVJeMk7iZuVTLlj1cQ= X-Google-Smtp-Source: ABdhPJwBEG+pEKnikGHjhyz/G0Y7bjMVgMm+iMRmrOhAEp/NxGdiOX7V6lqjqhC+OK57BTzbwvdQAg== X-Received: by 2002:a05:6512:114d:b0:473:b1ba:e589 with SMTP id m13-20020a056512114d00b00473b1bae589mr3903532lfg.206.1651666586609; Wed, 04 May 2022 05:16:26 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a05:6512:b1c:b0:472:38f0:bc75 with SMTP id w28-20020a0565120b1c00b0047238f0bc75ls638815lfu.0.gmail; Wed, 04 May 2022 05:16:25 -0700 (PDT) X-Received: by 2002:a05:6512:2244:b0:473:aa9d:8ae1 with SMTP id i4-20020a056512224400b00473aa9d8ae1mr4732433lfu.317.1651666585442; Wed, 04 May 2022 05:16:25 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1651666585; cv=pass; d=google.com; s=arc-20160816; b=KZrWUF4zSBmennNL4ye/bKaipdMWI3lNMXCorR4rIN76xteideLPIZLmWuCcYnIj9L YKcrvmZT9QysOlhybITODpglRyqLlvoOmhB8atMPWC5x8YV9g3kVrRAayseNyt03V8ZR Puv9nlJrEPxyVfYzg8puirJRkqkOqYquIPezSLOz+xsKaRnbOSarAiZ3xn46HNlx3x2M EpjinY+vezqhMGuorMxgtnyWmD4KRf8V7w2gAtVsjjbzr9EMpHAO1EspyctIiNglHl3L J5kRSrgLJ5Ex1rvyoUxQJrWdbcoSI9ueEbSHFUlSp0MHgCA/nOqU8O5QZlvsbeDKTz8J QkOw== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:dkim-signature; bh=KLutERRD13fl/jwiA6dry2No9ZgQUMOsnuBu9h1TtXE=; b=H8u0Sg/WceVuUfkjtuH4R2F7Zh/ztyrMdkiDPW+lm5MGw3qWoMftRTNHdaSbDhpYD/ mRYLlL+jYL8N/6OMHiSjyAtPrzF/Oad/d9nnwslgAUPRV0paJRXKhGSWGS1lK5NcM8b0 9lU/Jq872OjGojZb6edCpCdukyWlXpQpkwXa063iOBay85bhcRqbJw+T06u7ZzQMwk/i UegbM4ndTfPzR5QygZCix9ETHobnHe/Yo3/VHVWbmr+yG2TUgfqPLboDghFqtk8WwHiB RJs2X+0iji/4mJQ6KifjNUyDDHlCUG+o93wnerYVa194QKK+rVaoKBZEdqVaESPP5IMx PzGA== ARC-Authentication-Results: i=2; gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=selector2 header.b=FBslkrci; arc=pass (i=1 spf=pass spfdomain=siemens.com dmarc=pass fromdomain=siemens.com); spf=pass (google.com: domain of adriaan.schmidt@siemens.com designates 2a01:111:f400:7e1b::609 as permitted sender) smtp.mailfrom=adriaan.schmidt@siemens.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=siemens.com Received: from EUR05-AM6-obe.outbound.protection.outlook.com (mail-am6eur05on20609.outbound.protection.outlook.com. [2a01:111:f400:7e1b::609]) by gmr-mx.google.com with ESMTPS id p14-20020a19f10e000000b004720a623d80si595732lfh.7.2022.05.04.05.16.25 for (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Wed, 04 May 2022 05:16:25 -0700 (PDT) Received-SPF: pass (google.com: domain of adriaan.schmidt@siemens.com designates 2a01:111:f400:7e1b::609 as permitted sender) client-ip=2a01:111:f400:7e1b::609; ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=R94ZK1fiUsXJyjihrzQAY0T5/pLbULv7NtNmePEXs0NB7K3jeSTbVULmM0y5UzYRIZppZYUZaMHZOSQAs3Om9rxyYniW3OQ76Q9KkOFzLv+IxnQRqmaxKW7kZYDlLm4oE9VNOHTVGxlrVG/dGhpbPbn/+JGK/ukQalaTidRxNYEam0YaVGcKsOL28QyZRbq+g/Q3M/O6Y9Cbm/uDLbCFXhgONd0+14Ol/u90TwS71DGJV8zfF+vh52qzcnHhPu6HiL4M8faFCjC1rWSb5Wfrer4mzypYvyXxGLFt/7wqW5cv48nl1TFhml5a5cebZiG8QIaXtg212ZyKqQBKqe3WjQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=KLutERRD13fl/jwiA6dry2No9ZgQUMOsnuBu9h1TtXE=; b=akfxysO/2KW6UKddJSR9bJhk88mg9SQP39Csg9VAp7+ATrVJad+CTamtNbxWs03z3qKIxh8te11iHqcka9qcqE41h/fYvBclF98Rqvof5kAPFI9bXgjMTCyurQxu/D2kWUl+fSl5iDbXmsWKLs3oNa66mc5wLazRxWQ89Xtq70dqK7PWKc6QfeOwyzjxF7cO6mx8mRgaMsAQOUVAgHNKzQaF7TATdiD/yVlc6cUq46H2xTpU3QYd8bmz4AN4fZaGnwUrEzHPmo/cXz5UhplelzuqU7CjQtpy/OwhgGs0SZpMychTQBMPtpmP2LumydCWLxupItPlVjEUT2530i+plQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 194.138.21.70) smtp.rcpttodomain=googlegroups.com smtp.mailfrom=siemens.com; dmarc=pass (p=none sp=none pct=100) action=none header.from=siemens.com; dkim=none (message not signed); arc=none Received: from OL1P279CA0026.NORP279.PROD.OUTLOOK.COM (2603:10a6:e10:13::13) by AM0PR10MB2307.EURPRD10.PROD.OUTLOOK.COM (2603:10a6:208:d9::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5186.14; Wed, 4 May 2022 12:16:23 +0000 Received: from HE1EUR01FT011.eop-EUR01.prod.protection.outlook.com (2603:10a6:e10:13:cafe::5c) by OL1P279CA0026.outlook.office365.com (2603:10a6:e10:13::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5206.14 via Frontend Transport; Wed, 4 May 2022 12:16:23 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 194.138.21.70) smtp.mailfrom=siemens.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=siemens.com; Received-SPF: Pass (protection.outlook.com: domain of siemens.com designates 194.138.21.70 as permitted sender) receiver=protection.outlook.com; client-ip=194.138.21.70; helo=hybrid.siemens.com; Received: from hybrid.siemens.com (194.138.21.70) by HE1EUR01FT011.mail.protection.outlook.com (10.152.0.173) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.5227.15 via Frontend Transport; Wed, 4 May 2022 12:16:23 +0000 Received: from DEMCHDC8A0A.ad011.siemens.net (139.25.226.106) by DEMCHDC9SJA.ad011.siemens.net (194.138.21.70) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.24; Wed, 4 May 2022 14:16:22 +0200 Received: from random.ppmd.siemens.net (139.25.68.25) by DEMCHDC8A0A.ad011.siemens.net (139.25.226.106) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.24; Wed, 4 May 2022 14:16:22 +0200 From: Adriaan Schmidt To: CC: Adriaan Schmidt Subject: [PATCH] imagetypes: update recipe API changelog Date: Wed, 4 May 2022 14:16:07 +0200 Message-ID: <20220504121607.3977632-1-adriaan.schmidt@siemens.com> X-Mailer: git-send-email 2.30.2 MIME-Version: 1.0 X-Originating-IP: [139.25.68.25] X-ClientProxiedBy: DEMCHDC8A0A.ad011.siemens.net (139.25.226.106) To DEMCHDC8A0A.ad011.siemens.net (139.25.226.106) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: c1c6061a-8608-4f20-8eda-08da2dc7e77b X-MS-TrafficTypeDiagnostic: AM0PR10MB2307:EE_ X-Microsoft-Antispam-PRVS: X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 1l6CwwyvVQmkF59LrcvfTbRH18quS+Yvbi5n3N47gCNBxh9NouvaLpKxLRQcj0sVSBKU6AMG8K7TcP+V7vVShpUg0ygPyU9i9VbXBgeHxGkSq3Zf6IS75SV9zN5kC5T0JURbpG2cHEpiWWfz3kn8/8iaNZwTDTh+KdiQHLyy6Z8PDOpV61qw7oun3r8iCCPbCdmrfIJpTr6Syt0cmtDq3z2S0qxwAvVYelbxNmLobZsGwkfx6JjRhkb9Dz+sxRtu7SwmWxKifkWnU935DGNSteHJ3sq0AX1Z9imOfonRioquPAw4LV6FoGRlMpC7H1s3ir97BWL/OCSduKpFeCoD+7pTz0oRqeAmptOgDzHLVIajyw4Zcm/R5kyOqf02+7WJ3iXzTrDKdIDtvLTNpEkgMqauaJpwVkxKsiq/l51u7tEAcGu/A3VkZgElmdlEzr/z5A0j2KzjQ4w2m2wu4OQsqBr5/DHSGTr8FO530PhvqWfb1tT1jG3Qthggee2n6KmOFzGVTU2JWhloUPbATXrgXfnCe+dfTYZN5gnO6mteXNeP65clO265OpcoGOxxio95os7YKtFctSv9yIW8Bt8IJhwfDCiYCQlGWPgDgE0SBniFQ/olWsJLPoiYxuYfdR3RHePstYtX786234F2fWURdGFH1IDv2vDos/xKKFrCJSaC+AIPuF1JtWdvh9o45ivdSMeVnPqy2A7p9PwLe3RxQhgood2drxItlLukS5kPVFxS4nCwW6skD4LQKssjyHl8qzMOEslv6YUoKPkTDrkzvg== X-Forefront-Antispam-Report: CIP:194.138.21.70; CTRY:DE; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:hybrid.siemens.com; PTR:hybrid.siemens.com; CAT:NONE; SFS:(13230001)(4636009)(46966006)(36840700001)(40470700004)(40460700003)(6916009)(86362001)(7596003)(36860700001)(70206006)(70586007)(36756003)(508600001)(8936002)(8676002)(82960400001)(356005)(4326008)(1076003)(956004)(5660300002)(2906002)(107886003)(6666004)(82310400005)(47076005)(16526019)(186003)(26005)(44832011)(2616005)(7636003)(316002)(83380400001)(336012)(207903002)(219803003)(403724002); DIR:OUT; SFP:1101; X-OriginatorOrg: siemens.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 04 May 2022 12:16:23.0941 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: c1c6061a-8608-4f20-8eda-08da2dc7e77b X-MS-Exchange-CrossTenant-Id: 38ae3bcd-9579-4fd4-adda-b42e1495d55a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=38ae3bcd-9579-4fd4-adda-b42e1495d55a; Ip=[194.138.21.70]; Helo=[hybrid.siemens.com] X-MS-Exchange-CrossTenant-AuthSource: HE1EUR01FT011.eop-EUR01.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM0PR10MB2307 X-Original-Sender: adriaan.schmidt@siemens.com X-Original-Authentication-Results: gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=selector2 header.b=FBslkrci; arc=pass (i=1 spf=pass spfdomain=siemens.com dmarc=pass fromdomain=siemens.com); spf=pass (google.com: domain of adriaan.schmidt@siemens.com designates 2a01:111:f400:7e1b::609 as permitted sender) smtp.mailfrom=adriaan.schmidt@siemens.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=siemens.com Precedence: list Mailing-list: list isar-users@googlegroups.com; contact isar-users+owners@googlegroups.com List-ID: X-Spam-Checked-In-Group: isar-users@googlegroups.com X-Google-Group-Id: 914930254986 List-Post: , List-Help: , List-Archive: , List-Unsubscribe: , X-Spam-Status: No, score=-0.9 required=5.0 tests=DKIMWL_WL_MED, DKIM_SIGNED, DKIM_VALID,DKIM_VALID_EF,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI, SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on shymkent.ilbers.de X-getmail-retrieved-from-mailbox: INBOX Signed-off-by: Adriaan Schmidt --- RECIPE-API-CHANGELOG.md | 48 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 48 insertions(+) diff --git a/RECIPE-API-CHANGELOG.md b/RECIPE-API-CHANGELOG.md index 5913dd27..c23d7567 100644 --- a/RECIPE-API-CHANGELOG.md +++ b/RECIPE-API-CHANGELOG.md @@ -349,3 +349,51 @@ For a list of well-known Debian build profiles and common practices, we refer to It was replaced by WIC and no more needed. Machines that use `rpi-sdimg` image type should be modified to use `wic` type with `rpi-sdimg` wks file instead. + +### Changes to image types + +The way different image types are handled has changed to be closer to the +implementation in OE. + +Changes when using the built-in types: + * Image recipes no longer inherit their image type class. + * Names of image types, as defined using IMAGE_FSTYPES, no longer have the + suffix `-img`, i.e., `wic-img` becomes `wic`, `ext4-img` becomes `ext4`, + and so on. + * Image types defined in IMAGE_FSTYPES can be suffixed with conversions. + To get a compressed image, set IMAGE_FSTYPES to `wic.xz`, `ext4.gz`, etc. + That also means that the type of the previous `targz-img` is not `tar.gz`. + * Container types (previously CONTAINER_IMAGE_FORMATS) are now + first class image types (oci, oci-archive, docker-archive, + docker-daemon, containers-storage) + * The VM image now has type `ova` (instead of `vm-img`) + +Changes when defining custom image classes: + * Custom image classes that only add a compression step should be removed + and replaced by an image conversion (see below). + * Instead of providing a do_image_mytype task, custom image classes should + now provide IMAGE_CMD_mytype + * Imager dependencies are set as IMAGER_INSTALL_mytype + * Required arguments (variables that must be set) are modelled by + IMAGE_CMD_REQUIRED_ARGS_mytype = "A B C" + * When extending an existing image type, instead of inheriting the base + image class, IMAGE_TYPEDEP_mytype can be set to define dependencies + between image types. + * In the IMAGE_CMD_mytype function: + - image_do_mounts is inserted automatically + - a final chown is inserted automatically + - variables IMAGE_FILE_HOST and IMAGE_FILE_CHROOT are + set to reference the image + - variable SUDO_CHROOT contains the chroot command needed to run in the + build changeroot + * Custom image classes need to be added to IMAGE_CLASSES (e.g., in local.conf + or machine config) so Isar will include them. + +New conversions can be added by defining CONVERSION_CMD_type. + * Dependencies that need to be installed are given as CONVERSION_DEPY_type. + * New conversions must be added to CONVERSION_TYPES before they can be used. + * In conversion commands + - the input file is named ${IMAGE_FULLNAME}.${type} + - the conversions appends its own type, e.g. the output file of a conversion `xz` + would be ${IMAGE_FULLNAME}.${type}.xz + - a final chown is appended automatically