From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on atuin.qyliss.net X-Spam-Level: X-Spam-Status: No, score=-1.1 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,MAILING_LIST_MULTI,RCVD_IN_DNSWL_NONE,SPF_HELO_NONE autolearn=unavailable autolearn_force=no version=3.4.6 Received: from atuin.qyliss.net (localhost [IPv6:::1]) by atuin.qyliss.net (Postfix) with ESMTP id 41C743BAAB; Tue, 29 Nov 2022 09:09:47 +0000 (UTC) Received: by atuin.qyliss.net (Postfix, from userid 496) id 16E053BA92; Tue, 29 Nov 2022 09:09:44 +0000 (UTC) Received: from mail-lf1-x144.google.com (mail-lf1-x144.google.com [IPv6:2a00:1450:4864:20::144]) by atuin.qyliss.net (Postfix) with ESMTPS id 16F113BB08 for ; Tue, 29 Nov 2022 09:09:41 +0000 (UTC) Received: by mail-lf1-x144.google.com with SMTP id g12so21501199lfh.3 for ; Tue, 29 Nov 2022 01:09:41 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=unikie.com; s=google; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=WoLTwngsgP6ELdvBaJIR77YTnC3cbCLJv2pW/YDTv/o=; b=bbxll8GgIPBPDfW32xInf9enCH9RT7P/O/VMFpZRbEltrl46duUwTLhwx9hH2SWVl4 2y7nhXb660+kPaUAtkkGyriE7kT8T16hlnMetDvPlIFl664oIEhRY4rnsHYdDk37StFF 2iFcHtv13mpEXT1pt7j734PezmTLF1WmU1G24JDcKMeKa6PzGRI93KTUIkaVd5rq23Ln wcJeXViUJNyii1cYdcEXTXD4pROrO/Pq+TMFpbparSzWb7PrCvyzbddMZd2GY0DJI9T4 sWRY+oGEYQ011tW+I9zBIEBXMo8dYVkfUx/+fhCvToEFjQfx/rifQDgD2CtyjWqjm2Uk dwpg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=WoLTwngsgP6ELdvBaJIR77YTnC3cbCLJv2pW/YDTv/o=; b=7Na/h37itu7u0WaE+hWkrbKvAmCnIRrdtO8jAfKl7GZu1ponz85pwRHdoOTtGD6/lL lHIczjVDC101Xh80w0IUjKy2iAJnp3vMNvagII07GWnI1nQfvI00lJNBHWpkSgCaSYqf sVw68Ij/BIzJ4LWIVU3VLlYMeeqoCfeuaV8dixNkK6oGvRiUb14pSisnQ7f9B7JxgGiy i2j8KV7oXL3nKdYZG+dPLgNlW6qPZXhgXVsVnSyUvSxwom+B3Nym5yhbjiDyK40kh/xo UvxObBBqDp3FJbutnEStB64zzsr35wsuR4kCldvZ3nRqw9yazMJKFW4qW+zq9HBDssL0 jrkA== X-Gm-Message-State: ANoB5pn+rdvNWVGA8VyzQwCdG/3Hc/wqW6HxTHY7ZAOB/0CqrZtmp6q8 128asXxfosoIM902buNaC1MVOrN3Ac/non8x X-Google-Smtp-Source: AA0mqf4HwqTZV+4kqaXZO8IJkSmeK2lI0Nqyw66a2ZZMiArDxCOXVyDP0ZpEIQmYj4y1/6IO/c6C0g== X-Received: by 2002:a19:6458:0:b0:4b1:d925:da5b with SMTP id b24-20020a196458000000b004b1d925da5bmr18288999lfj.149.1669712976921; Tue, 29 Nov 2022 01:09:36 -0800 (PST) Received: from x220.qyliss.net ([109.204.204.138]) by smtp.gmail.com with ESMTPSA id bd3-20020a05651c168300b002770a48fd12sm1421906ljb.102.2022.11.29.01.09.36 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 29 Nov 2022 01:09:36 -0800 (PST) Received: by x220.qyliss.net (Postfix, from userid 1000) id EAE5D1074F; Tue, 29 Nov 2022 09:09:35 +0000 (UTC) From: Alyssa Ross To: devel@spectrum-os.org Subject: [PATCH] Documentation: add ADR for VM Sources Date: Tue, 29 Nov 2022 09:08:12 +0000 Message-Id: <20221129090812.974715-1-alyssa.ross@unikie.com> X-Mailer: git-send-email 2.35.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Message-ID-Hash: ONTH6HGFP5I2GOPCTV2E6J25UBBNA7YK X-Message-ID-Hash: ONTH6HGFP5I2GOPCTV2E6J25UBBNA7YK X-MailFrom: alyssa.ross@unikie.com X-Mailman-Rule-Hits: header-match-devel.spectrum-os.org-0 X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-config-1 CC: Ivan Nikolaenko X-Mailman-Version: 3.3.5 Precedence: list List-Id: Patches and low-level development discussion Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: Signed-off-by: Alyssa Ross --- Documentation/decisions/009-vm-sources.adoc | 42 +++++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 Documentation/decisions/009-vm-sources.adoc diff --git a/Documentation/decisions/009-vm-sources.adoc b/Documentation/decisions/009-vm-sources.adoc new file mode 100644 index 0000000..457491d --- /dev/null +++ b/Documentation/decisions/009-vm-sources.adoc @@ -0,0 +1,42 @@ += 009 VM Sources +:page-parent: Architecture Decision Records +:page-grand_parent: About Spectrum + +// SPDX-FileCopyrightText: 2022 Unikie +// SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-4.0 + +== Status + +Proposed + +== Context + +It should be possible for Spectrum VMs to come from the root +filesystem (for built-in VMs), or one or more +xref:../appendices/user-partition.adoc[user partitions]. One part of +making this work will be to have the system search multiple sources of +VM definitions, to produce a single view of what VMs are available. + +== Decision + +The system will scan /usr/img/builtin, as well as the svc/data +partition on each user partition, for VM definitions. A single s6-rc +service directory will contain generated services for VMs from all +sources, so that tools like vm-start don't have to be aware of where +VMs come from. (This will continue to be distinct from the s6-rc +database used for host system services.) When a new source of VMs is +discovered, an updated database will be generated and atomically +replace the old one using +xref:https://www.skarnet.org/software/s6-rc/s6-rc-update.html[s6-rc-update]. + +Changes to how user partitions will be discovered and mounted, to +support having multiple user partitions, will be determined later. + +== Consequences + +Built-in VMs can be moved into the root filesystem, allowing the +default user partition to be empty. This will make it easier for +people making custom Spectrum images to add custom VMs without having +to build Spectrum itself themselves -- they can simply replace the +default, empty, partition with a custom one they can produce however +they like. base-commit: 95fba8ac6c872c2ba5e2ea8be5da9f2eb63374c8 -- 2.35.1