From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 7093853974562865152 X-Received: by 2002:a2e:bd17:0:b0:24b:4c2a:20c5 with SMTP id n23-20020a2ebd17000000b0024b4c2a20c5mr12758800ljq.422.1651666586674; 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-Google-Smtp-Source: ABdhPJzOh47ZnwFB4ijGmBUxdxtCJVDnlpMLC2GVRlDKdhFMdNQbw5Y5W1HUrABUK0Oqa2OCmc+l 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 Return-Path: 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; 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 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 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=KLutERRD13fl/jwiA6dry2No9ZgQUMOsnuBu9h1TtXE=; b=FBslkrciHGeLvdYTfqp148wygSV+R4vP/zwfI7i9MQHtBkTSweOIapywFT7gXH1KR10AlM4mQHYHdmq4beoqs3zrY5Yy3DzGCtkLPo76cPnWTJzsR60FB4xmViwUjJDEt7hs6Hs/QxY7n2+V149zuPrj09BB2nyw1uFm+tp+MCrhkCvBCZlM4iWbDgV3Bmid1JtaUKpjm2Se/xDdR0YfWtE4/RhNgjBuRK+Yw7n1Jyvo0n+jBlqwJ6NW97kYq9YFTmBaGoCcPpdpJy/y6toI7l90VbYCblOqCDuk89R6gU4wSeO/ClD4wwR+JGf7MTSQZW7EbEfV/eq3gpEMGGnFPg== 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 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: 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-TUID: v38x3UL99nb4 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 -- 2.30.2