[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
branch master updated: doc: Add container example to run a web browser.
From: |
guix-commits |
Subject: |
branch master updated: doc: Add container example to run a web browser. |
Date: |
Thu, 07 May 2020 04:04:51 -0400 |
This is an automated email from the git hooks/post-receive script.
ambrevar pushed a commit to branch master
in repository guix.
The following commit(s) were added to refs/heads/master by this push:
new 60131df doc: Add container example to run a web browser.
60131df is described below
commit 60131df02b521235a311031f9410f530ded60f33
Author: Pierre Neidhardt <address@hidden>
AuthorDate: Sun May 3 10:08:56 2020 +0200
doc: Add container example to run a web browser.
* doc/guix.texi (Invoking `guix environment'): Add paragraph and example to
run Eolie in a guix environment container. Add `container' cindex for the
first container example, and the `certificates' cindex for the web browser
example.
---
doc/guix.texi | 17 +++++++++++++++++
1 file changed, 17 insertions(+)
diff --git a/doc/guix.texi b/doc/guix.texi
index bc5ecbb..ffef097 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -4777,6 +4777,7 @@ additionally includes Git and strace:
guix environment --pure guix --ad-hoc git strace
@end example
+@cindex container
Sometimes it is desirable to isolate the environment as much as
possible, for maximal purity and reproducibility. In particular, when
using Guix on a host distro that is not Guix System, it is desirable to
@@ -4793,6 +4794,22 @@ guix environment --ad-hoc --container guile -- guile
The @code{--container} option requires Linux-libre 3.19 or newer.
@end quotation
+@cindex certificates
+Another typical use case for containers is to run security-sensitive
+applications such as a web browser. To run Eolie, we must expose and
+share some files and directories; we include @code{nss-certs} and expose
+@file{/etc/sll/certs/} for HTTPS authentication; finally we preserve the
+the @code{DISPLAY} environment variable since containerized graphical
+applications won't display without it.
+
+@example
+guix environment --preserve='^DISPLAY$' --container --network \
+ --expose=/etc/machine-id \
+ --expose=/etc/ssl/certs/ \
+ --share=$HOME/.local/share/eolie/=$HOME/.local/share/eolie/ \
+ --ad-hoc eolie nss-certs dbus -- eolie
+@end example
+
The available options are summarized below.
@table @code
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- branch master updated: doc: Add container example to run a web browser.,
guix-commits <=