From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0.migadu.com ([2001:41d0:403:4876::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms13.migadu.com with LMTPS id aDfHL1muaGaWeAEAqHPOHw:P1 (envelope-from ) for ; Tue, 11 Jun 2024 20:06:49 +0000 Received: from aspmx1.migadu.com ([2001:41d0:403:4876::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0.migadu.com with LMTPS id aDfHL1muaGaWeAEAqHPOHw (envelope-from ) for ; Tue, 11 Jun 2024 22:06:49 +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="ZD/sOads"; 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=1718136409; 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=45Ajyebs4mIZo4WlVstmdCYlMPKF63fbAv2wLDec1g8=; b=O92qwfvpqYf6+Ba+F+mEQqDCLKjWyepNzTlCvML07HtOIewkalHlUaBFUFyhSlufuUSpOd vy4Xe5BdyXp9zg0OOugFzn7wRlLeCoBlxrQCY1ERlH5tyKNQnS1p3nmo/yJSVMb7pQoAD7 wYJoP3czgFGR2tgWQjASpCywsVmeaO68so20nsoY0j8fgN4P0vBHHEAM+kIivr5AM78F+D utaM2dPVSO87qrMfkj9LRFP/K1It6Gp6RNjy66kYIclG9iiaSzbAz1jf1EgML5kyyjnANd PS1EhZ43RbOkvh0VCwUikbYSeb1erxH7gfVMpYm0tcHdfKKWX6Ovjr1ophpnAQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=autistici.org header.s=stigmate header.b="ZD/sOads"; 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=1718136409; a=rsa-sha256; cv=none; b=n48vAKrycQn1GpyxQhDy7Lz96vuuWofppNRw6TD/iAJ+l5TkWXFPWjAZpPtu1/bZ4cUVXP ha261s+z+nf8iBQ1uqYArScE14lgLNLzFZQu+WEjxjS87LsMX6buiueg3synOVtcJNKxam GrqkysYzgTlbNGx8FWBnLveOoIVPzEGQFltj0POR6ACjClqNW51e2jxdofOJrbfITGGYp2 dwmt8wQVAxPTtLi3fakznNL9pP5pIspzX/V4Fabgd63AqIp/ffc9tsFqc6PQ+ic8cP+2pG RgtSBMsPORIHOQ/uyfYFqCFzPpNAtYJdxyk15ckFD5KGQkwKxifRZTV+fwWp5g== 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 A7B2D69C94 for ; Tue, 11 Jun 2024 22:06:49 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1sH7ku-0004pz-9S; Tue, 11 Jun 2024 16:06:08 -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 1sH7ks-0004o4-C5 for guix-patches@gnu.org; Tue, 11 Jun 2024 16:06:06 -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 1sH7ks-0007ek-3T; Tue, 11 Jun 2024 16:06:06 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1sH7kp-0002EB-5z; Tue, 11 Jun 2024 16:06:03 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#71263] [PATCH v2 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: Tue, 11 Jun 2024 20:06:03 +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.17181363338480 (code B ref 71263); Tue, 11 Jun 2024 20:06:03 +0000 Received: (at 71263) by debbugs.gnu.org; 11 Jun 2024 20:05:33 +0000 Received: from localhost ([127.0.0.1]:36305 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sH7kK-0002Ch-MS for submit@debbugs.gnu.org; Tue, 11 Jun 2024 16:05:33 -0400 Received: from confino.investici.org ([93.190.126.19]:64077) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sH7kI-0002CL-6E for 71263@debbugs.gnu.org; Tue, 11 Jun 2024 16:05:30 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=autistici.org; s=stigmate; t=1718136323; bh=45Ajyebs4mIZo4WlVstmdCYlMPKF63fbAv2wLDec1g8=; h=From:To:Cc:Subject:Date:From; b=ZD/sOadsPBG6FpN/lsV8zm9DmKGvu6JLMssh2r+b+X/+22f7XYfm6j+fG43zfRbQt 2hqNuZMcO0zK4jDrNGzW7hZ6/eDvZq7WdBCDXK0HJTbsnhqWUMmX2w1Gtoy5+SvdjS KLglQZkSgT5cofmvEvYu6MkwY6ad3+oMvs0yFxC4= Received: from mx1.investici.org (unknown [127.0.0.1]) by confino.investici.org (Postfix) with ESMTP id 4VzKR76kNWz10wK; Tue, 11 Jun 2024 20:05:23 +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 4VzKR763VQz10tQ; Tue, 11 Jun 2024 20:05:23 +0000 (UTC) Date: Tue, 11 Jun 2024 22:04:56 +0200 Message-ID: X-Mailer: git-send-email 2.45.1 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.94 X-Migadu-Queue-Id: A7B2D69C94 X-Migadu-Scanner: mx10.migadu.com X-Migadu-Spam-Score: -4.94 X-TUID: Ygkch1jEfoQW * 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 769ca1399f..5a06d7cdc5 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -40601,6 +40601,7 @@ Miscellaneous Services (service oci-container-service-type (list (oci-container-configuration + (network "host") (image (oci-image (repository "guile") @@ -40613,20 +40614,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 @@ -40634,8 +40632,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 @@ -40667,8 +40665,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: df5648daa1a5d097a430131bbff353b865b476b6 -- 2.45.1