From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 7093853974562865152 X-Received: by 2002:a17:906:d288:b0:6f3:cb6f:428f with SMTP id ay8-20020a170906d28800b006f3cb6f428fmr13646451ejb.332.1652091739524; Mon, 09 May 2022 03:22:19 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a05:6402:40d4:b0:428:1043:6204 with SMTP id z20-20020a05640240d400b0042810436204ls305129edb.2.gmail; Mon, 09 May 2022 03:22:18 -0700 (PDT) X-Google-Smtp-Source: ABdhPJy9vWaI+oQlLcG/GC079FOES6CId/kyuG8jOLtyzpYixV75/8Lw5YI8d3nxnJ/zTCdL2j6Y X-Received: by 2002:aa7:c70f:0:b0:425:f70d:b34 with SMTP id i15-20020aa7c70f000000b00425f70d0b34mr16958995edq.306.1652091738638; Mon, 09 May 2022 03:22:18 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1652091738; cv=pass; d=google.com; s=arc-20160816; b=ZNBTpiTOhY3RCewD+b/W9LzVgVgXBO0M7CfxdEe9njWrP/iQthSFHMewQWrpZSC8Yi MF3FhsJzNMDzo7R0U3y6b8KfYjBQeqgnzhvbZWp1D3psux1C06exqNesBslQ8HV7HTP3 SNjAe1EBo4eh1sLk9imxHaATZEjzAeQoEtMfsHbxilf2q0fF1UPimwiCPqCAQ5aaU5O8 xWlypZD+wYBRkui+IkNXd/0nL+WDMaEPIsvb4g75h0CHCkoyF/P41Agv7J3iVUw8ZD0Z Iw8jBvXcOWTVnKm3uCRS/G6o0pP4NTejIC9UsF0B2UQtDV07zlidT6cQnbgU1BayEMcB UP3Q== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:dkim-signature; bh=XIZdbXEI/JWC2VPVKafQVhygZd4N+Q79LHxNLAI23G8=; b=Z7FDLgasJEugoHba9XKgXEN8QWp0fYYNbiLOOjA+1jnNMQv0QDfEucCauZzesWifH+ cUL0Qll978vSnAE3kRmZdFyH4dK3Kz+a0mymqJDRTrBx8Oejs1TLTaY0dU1c2yw8gjPF Pe2v4QNpfnRe7ve+Zb7rhOMoT5pAm+4ltoydTSG+JiW97EVG55PW720lzQ0hT9rL58XR z/UhtS7/tO3sqZLqFt3qwWESwEttXpq7M4af+wUGtM+C33dWmY9WNDnhfgDzFQcXOD0V iXCcdFk7EX6BmC4JsRACXRX3UQsEl8OY4SEFLbXscHfCpApHGD/HYGV7hZF1M43zhven Nrgg== ARC-Authentication-Results: i=2; gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=selector2 header.b=CxET0O6P; 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::62f as permitted sender) smtp.mailfrom=adriaan.schmidt@siemens.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=siemens.com Return-Path: Received: from EUR05-AM6-obe.outbound.protection.outlook.com (mail-am6eur05on2062f.outbound.protection.outlook.com. [2a01:111:f400:7e1b::62f]) by gmr-mx.google.com with ESMTPS id gv43-20020a1709072beb00b006e8421b806dsi745598ejc.1.2022.05.09.03.22.18 for (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Mon, 09 May 2022 03:22:18 -0700 (PDT) Received-SPF: pass (google.com: domain of adriaan.schmidt@siemens.com designates 2a01:111:f400:7e1b::62f as permitted sender) client-ip=2a01:111:f400:7e1b::62f; Authentication-Results: gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=selector2 header.b=CxET0O6P; 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::62f as permitted sender) smtp.mailfrom=adriaan.schmidt@siemens.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=siemens.com ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=hVwCGmjLf70jMQPtaWfN/j4XbR3c8W9CFIpxFJ/iLJSl1kT6zyyjoVK+Dw7NMSDjwmpPWn0P1TA8wV6nHZuhxQmko2uD9iphWTacneCumgWz24MlXuwxxuHe/+uEkXww0mrqiiOPyHKjl6WojV8TUVNn3r34Vmz+c1HpFAQqm63ltFT/YPvt2NBoA5OwQFeB9tMB2ECEB4MURXo/XDju5me0seEJ4wKJ+gAxF+bKRnV0MGM0ZoPpMqIIJxSnC3g/7HmdLdCrRbcCvh0hDarOljahpVyBK/0/TbYqvSeN/Xl/Yhxz66N3iLq/dtx8DmJPwMg22G97ZNHAjUfQ/vSmTA== 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=XIZdbXEI/JWC2VPVKafQVhygZd4N+Q79LHxNLAI23G8=; b=TagafHC9gigNaoyxTdWwSDWc8gRU3hxkpgJdCLoTq2piBAI/4dBPRl/8aAhjA2KW2WMjji9+Bh3btrKWPjqA71DgNHy2mqXfjnm8TUZCqYCoJiqGoIMI7yJ4xrjB5zTDV2dwDRGvCOKAQdV4FbLtgiphVtec9fD1m4se8LRyrjt7m+dBl31HHCrbvt9h0aoWnru1dhIa6xzocqA0Q6qPhO0b6vZeZ2J0oNXrb9p7ohaElGO1b/GnIitd55AJhR0cZAbe+pdWG5qgnFVikSJvN9rUTvtOki+HtHEOx/tcTNlDr2RqZJxP41oX/lu3PgveuCW1bC4U4KcUwOWpXbEsgA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 194.138.21.73) 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 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=siemens.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=XIZdbXEI/JWC2VPVKafQVhygZd4N+Q79LHxNLAI23G8=; b=CxET0O6P1mSIQ8UTHoCal5Hqnj7nR4hPdlIkSciXEvrou38xeJpOs9HpHY6C162eCfsjoOVih9xZSjpJWxcQp7K3LRXlZ/abidl8ah0xtIY8vCYWNNxtxHLWEgKL2OwrftNWA8rW/Iv6vnHu6CyKMQWNZWl7Zy2ZD/hvThpTajjmfh35Bh3Tt65f0Z84579tYIArSftXkFf74RdW/oZyOsMeBsMGqfrCpYUn0L5fwkdtdewJaKpE49461EVrI/qkif+HFtI96wFzu+j+TvJFalkwBKOJ1xVWnT66RYJ6npy0Y6HsygeMPQfvX5vPcIGto/v2ctIdFsnZJ3JtxMwmVQ== Received: from AS8PR05CA0030.eurprd05.prod.outlook.com (2603:10a6:20b:311::35) by AM9PR10MB4104.EURPRD10.PROD.OUTLOOK.COM (2603:10a6:20b:1f2::5) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5227.20; Mon, 9 May 2022 10:22:18 +0000 Received: from VE1EUR01FT044.eop-EUR01.prod.protection.outlook.com (2603:10a6:20b:311:cafe::39) by AS8PR05CA0030.outlook.office365.com (2603:10a6:20b:311::35) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5227.23 via Frontend Transport; Mon, 9 May 2022 10:22:17 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 194.138.21.73) 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.73 as permitted sender) receiver=protection.outlook.com; client-ip=194.138.21.73; helo=hybrid.siemens.com; Received: from hybrid.siemens.com (194.138.21.73) by VE1EUR01FT044.mail.protection.outlook.com (10.152.3.137) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.5227.15 via Frontend Transport; Mon, 9 May 2022 10:22:17 +0000 Received: from DEMCHDC8A0A.ad011.siemens.net (139.25.226.106) by DEMCHDC9SNA.ad011.siemens.net (194.138.21.73) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.24; Mon, 9 May 2022 12:22:16 +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; Mon, 9 May 2022 12:22:16 +0200 From: Adriaan Schmidt To: CC: Adriaan Schmidt Subject: [PATCH v2 1/1] imagetypes: update recipe API changelog Date: Mon, 9 May 2022 12:22:01 +0200 Message-ID: <20220509102201.3251362-2-adriaan.schmidt@siemens.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20220509102201.3251362-1-adriaan.schmidt@siemens.com> References: <20220509102201.3251362-1-adriaan.schmidt@siemens.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain Return-Path: adriaan.schmidt@siemens.com 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: 19c37b67-df85-4c50-4eb5-08da31a5cb27 X-MS-TrafficTypeDiagnostic: AM9PR10MB4104: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: vBeOEHvQVsCrXANTuxsp/9VjhI0rAx5L+hFQibnc6rK+694bhuPSO/dxoQBW8RUjaA+HK7qqyAi5qLiEpfyTMnRXc2YlezNzGvbQazzEDwdMHi9oKw0KK2xRmalsUgt0EZ9gTEHjcCMgkNrLZTYXViq+L0b2l89SZ4CDvhEfRwesOnCrDSUTtUsxMc+EtvLxtpP2JwhQ4W1ubqkvMpq/JJMNIBVT6gYX0OnsWlsxOqwX5Bsz1rotJk+j1To6Ze5swxiGzl1Z5eHZfTDmDFDmIh0692E/MqE2Cs1sc9Csac3NkAiB5R4NCqpA9+6hNL6Oi61s4TyfUBh5vYKvKuqf1Qc1N4XPrmopXMzsacQgVPzu0AWheCVxkDJ0OOLzqHdYRpHiyCgEeekCeX5ljPitBMxbSik54QPpvls8uPDKKxsgag1+sy09oqTSUWixDXb7+wwG20kxTh45s2P20FlWqOPiQTQQ0Dl2QfUoGMj8y1PJSoDaTsMmDzVw02ZZsGAeLJ9BHcOgSh9Ceg3mZjt0cCPKCEEpXe32mcGWjcbHcCr1YrVRm+pO+nOTRsN6h1ftdALSfchyhIy1dKSsf7QI3Ou+IXGskFxjVsqmUouvXt7EXfH45ZmfLRvw2nbnmnqQPr2qTC+qlEjRWnpZUFS+eJVU565ul42md9g8JYzGOo/4x/AZDwZKsnzBVwhn/2Yd2tKxG5UUHsRxTBco/4CIr6B9T4eX5ETH4DjKZ7UAi499C3TaR/neV4DYwCMu5/2VDK4lqPqFE/9sgS1i0vPYIwtMjIND3qA76ky4+q2H6fQ= X-Forefront-Antispam-Report: CIP:194.138.21.73;CTRY:DE;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:hybrid.siemens.com;PTR:InfoDomainNonexistent;CAT:NONE;SFS:(13230001)(4636009)(36840700001)(40470700004)(46966006)(107886003)(2616005)(5660300002)(1076003)(956004)(86362001)(16526019)(26005)(82310400005)(186003)(336012)(36860700001)(44832011)(82960400001)(8936002)(2906002)(47076005)(81166007)(40460700003)(83380400001)(8676002)(4326008)(70206006)(70586007)(356005)(508600001)(6666004)(6916009)(36756003)(316002)(219803003)(207903002)(403724002)(36900700001);DIR:OUT;SFP:1101; X-OriginatorOrg: siemens.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 09 May 2022 10:22:17.3593 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 19c37b67-df85-4c50-4eb5-08da31a5cb27 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.73];Helo=[hybrid.siemens.com] X-MS-Exchange-CrossTenant-AuthSource: VE1EUR01FT044.eop-EUR01.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM9PR10MB4104 X-TUID: FTQWgt9ZwKJB 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_DEP_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 -- 2.30.2