From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1.migadu.com ([2001:41d0:1008:1e59::1]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms1.migadu.com with LMTPS id WDENGcKgV2Z8iwAAA41jLg (envelope-from ) for ; Wed, 29 May 2024 23:40:18 +0200 Received: from aspmx1.migadu.com ([2001:41d0:403:4876::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1.migadu.com with LMTPS id 0GF5E8KgV2a/2AAA62LTzQ (envelope-from ) for ; Wed, 29 May 2024 23:40:18 +0200 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=autistici.org header.s=stigmate header.b=UhBsluvy; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org"; dmarc=pass (policy=none) header.from=gnu.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1717018818; h=from:from:sender:sender:reply-to:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding:resent-cc: resent-from:resent-sender:resent-message-id:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=wMZoJp5SG5VLI0v9TimsUOowPD1K1DKB8UesoC6q+fw=; b=GJzGdYj7Yi3C/5+B+juhr0ZdeNQwOu6a0l9FFKTUle3MIXrNNqz1XpHF5bmyMkcicJ5NBS 0edRTeGf/OqMndJiBpo4PfXASK6/eL4Q0tyf94m0bHAU+Y6RTpXt0xbVBvIzn2cSekEXYC tyJ/j427MbjO9ysUASLoVdOmZ6EIomIznlKgs7SyVMg/AjQUbVblJqfFmmv53en+njyVwM JSJi53uIhQLgT6ETUVbTS8ZWOi7VosMrDx9GwMc0oEDqBaGsdz6eeus79XfOowYN3jM6hX ifxXavQE97sZWtOVBu604M/UCfSN7UHtadeSf8jFKIpJ/tMR37vcfcBULCKDhQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=autistici.org header.s=stigmate header.b=UhBsluvy; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org"; dmarc=pass (policy=none) header.from=gnu.org ARC-Seal: i=1; s=key1; d=yhetil.org; t=1717018818; a=rsa-sha256; cv=none; b=d0g1myxmiCiAiPBPqBF9hGhxUH5w7CpCM2lxmPWz/uo5YXkaR4P3LvVNFT/iP+1rr/g50u 3khapN0m3SKN/+W4OEzbWbc8nHOmqLVhI9G1Hvs7WT7Knf00f0/OQkOCDIsBzICdpwQwUN Po0edTfZ7j0LpRm5ZpIQ5qGCfIC4dOqLVOtvAcqzSPh1TM2sdXqyFwHrOZOxMCatehF+ky BK9maggEiF64T8BvQf9GGZ1LsicmwfjbyB7fMFO5GMXgCVT1IRnJYx9OqCISC6NbzWWgfG 1b1dpCrsAM506NGZu6aUJ9QUb7t4Nc/CwoMfVfv+NnqiGL/pxVK1QmaSBCaYcA== Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 2EE31A04F for ; Wed, 29 May 2024 23:40:18 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1sCR1X-0000nO-QC; Wed, 29 May 2024 17:39:55 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1sCR1W-0000mt-Te for guix-patches@gnu.org; Wed, 29 May 2024 17:39:54 -0400 Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1sCR1V-0001oE-IK; Wed, 29 May 2024 17:39:53 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1sCR1e-0008D1-8r; Wed, 29 May 2024 17:40:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#71263] [PATCH 1/5] doc: Minor changes to the OCI-backed Services documentation. References: <39e6b8e8-c1df-f5fb-5e43-f238d0d4067f@autistici.org> In-Reply-To: <39e6b8e8-c1df-f5fb-5e43-f238d0d4067f@autistici.org> Resent-From: Giacomo Leidi Original-Sender: "Debbugs-submit" Resent-CC: pelzflorian@pelzflorian.de, ludo@gnu.org, matt@excalamus.com, maxim.cournoyer@gmail.com, guix-patches@gnu.org Resent-Date: Wed, 29 May 2024 21:40:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 71263 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: To: 71263@debbugs.gnu.org Cc: Giacomo Leidi , Florian Pelz , Ludovic =?UTF-8?Q?Court=C3=A8s?= , Matthew Trzcinski , Maxim Cournoyer X-Debbugs-Original-Xcc: Florian Pelz , Ludovic =?UTF-8?Q?Court=C3=A8s?= , Matthew Trzcinski , Maxim Cournoyer Received: via spool by 71263-submit@debbugs.gnu.org id=B71263.171701876631399 (code B ref 71263); Wed, 29 May 2024 21:40:02 +0000 Received: (at 71263) by debbugs.gnu.org; 29 May 2024 21:39:26 +0000 Received: from localhost ([127.0.0.1]:55961 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sCR13-0008AJ-Bd for submit@debbugs.gnu.org; Wed, 29 May 2024 17:39:26 -0400 Received: from confino.investici.org ([93.190.126.19]:48531) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sCR11-0008AA-36 for 71263@debbugs.gnu.org; Wed, 29 May 2024 17:39:23 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=autistici.org; s=stigmate; t=1717018752; bh=wMZoJp5SG5VLI0v9TimsUOowPD1K1DKB8UesoC6q+fw=; h=From:To:Cc:Subject:Date:From; b=UhBsluvyevlm4biWkspy+ANL2Uj0/43v81d24ZdTf4zY0M3Asnjhv8iF2Jo9bxN1t 1U4gG4rQq4n2X7fWspGI4QTxtGbBBM5u4rkHdArRWEyzDaqIrz3TtYRgD5CRHYxWtw HF4QSTWfPpDzPshCt/GXtPTIi86aHT0WH9Yi7Lwo= Received: from mx1.investici.org (unknown [127.0.0.1]) by confino.investici.org (Postfix) with ESMTP id 4VqN7N2Qxqz1111; Wed, 29 May 2024 21:39:12 +0000 (UTC) Received: from [93.190.126.19] (mx1.investici.org [93.190.126.19]) (Authenticated sender: goodoldpaul@autistici.org) by localhost (Postfix) with ESMTPSA id 4VqN7N1ll8z110x; Wed, 29 May 2024 21:39:12 +0000 (UTC) Date: Wed, 29 May 2024 23:38:52 +0200 Message-ID: <31ff6a93a8c7b50e5152f75b091b28851d5c4cc8.1717018735.git.goodoldpaul@autistici.org> X-Mailer: git-send-email 2.41.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-to: Giacomo Leidi X-ACL-Warn: , Giacomo Leidi via Guix-patches From: Giacomo Leidi via Guix-patches via Errors-To: guix-patches-bounces+larch=yhetil.org@gnu.org Sender: guix-patches-bounces+larch=yhetil.org@gnu.org X-Migadu-Country: US X-Migadu-Flow: FLOW_IN X-Spam-Score: -4.95 X-Migadu-Queue-Id: 2EE31A04F X-Migadu-Scanner: mx10.migadu.com X-Migadu-Spam-Score: -4.95 X-TUID: +dTaYRbBp3ze * doc/guix.texi: Clarify the example and remove reduntant escapes. Change-Id: I38f5517ae46b391ba21ae5a94c6dcc272e245036 --- doc/guix.texi | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/doc/guix.texi b/doc/guix.texi index c1ff049f03..8662586b46 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -40547,6 +40547,7 @@ Miscellaneous Services (service oci-container-service-type (list (oci-container-configuration + (network "host") (image (oci-image (repository "guile") @@ -40559,20 +40560,17 @@ Miscellaneous Services '("-c" "(display \"hello!\n\")"))) (oci-container-configuration (image "prom/prometheus") - (network "host") (ports '(("9000" . "9000") ("9090" . "9090")))) (oci-container-configuration (image "grafana/grafana:10.0.1") (network "host") - (ports - '(("3000" . "3000"))) (volumes '("/var/lib/grafana:/var/lib/grafana"))))) @end lisp -In this example two different Shepherd services are going be added to the +In this example three different Shepherd services are going be added to the system. Each @code{oci-container-configuration} record translates to a @code{docker run} invocation and its fields directly map to options. You can refer to the @@ -40580,8 +40578,8 @@ Miscellaneous Services documentation for the semantics of each value. If the images are not found they will be @url{https://docs.docker.com/engine/reference/commandline/pull/,pulled}. The -spawned services are going to be attached to the host network and are supposed -to behave like other processes. +services with @code{(network "host")} are going to be attached to the host network +and are supposed to behave like native processes with regard to networking. @end defvar @@ -40613,8 +40611,8 @@ Miscellaneous Services value can be a list of pairs or strings, even mixed: @lisp -(list '(\"LANGUAGE\" . \"eo:ca:eu\") - \"JAVA_HOME=/opt/java\") +(list '("LANGUAGE\" . "eo:ca:eu") + "JAVA_HOME=/opt/java") @end lisp Pair members can be strings, gexps or file-like objects. Strings are passed base-commit: 6f72ad465c1e2df965e8d73b209497b4ef456527 -- 2.41.0