PATCH] doc: Add information about mirrors.

  • Open
  • quality assurance status badge
Details
3 participants
  • Xinglu Chen
  • raid5atemyhomework
  • zimoun
Owner
unassigned
Submitted by
raid5atemyhomework
Severity
normal
R
R
raid5atemyhomework wrote on 6 Mar 2021 02:18
(name . Guix Patches)(address . guix-patches@gnu.org)
_oiAHSH32poEWuaFsGPEk5ZeUX58lKUdj-IJ8eQm-SqD1sS7RfFuvPTSlfsZkxN36dbO1WwVrj0OYRTuOPADPIVufs87aCMOlhsSth48U7E=@protonmail.com
Closes: 46942


From 63bcc0750248369b2171409168fd200e3841f0a5 Mon Sep 17 00:00:00 2001
From: raid5atemyhomework <raid5atemyhomework@protonmail.com>
Date: Sat, 6 Mar 2021 09:12:53 +0800
Subject: [PATCH] doc: Add information about mirrors.

* doc.texi (Getting Substitutes from Other Servers): Add a list of
mirror substitute servers.
(Using a Custom Guix Channel): Add a list of mirror Guix repositories.
---
doc/guix.texi | 22 ++++++++++++++++++++++
1 file changed, 22 insertions(+)

Toggle diff (47 lines)
diff --git a/doc/guix.texi b/doc/guix.texi
index 464c1141d8..d4582b009f 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -86,6 +86,7 @@ Copyright @copyright{} 2020 raingloom@*
Copyright @copyright{} 2020 Daniel Brooks@*
Copyright @copyright{} 2020 John Soo@*
Copyright @copyright{} 2020 Jonathan Brielmaier@*
+Copyright @copyright{} 2021 raid5atemyhomework@*

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
@@ -3879,6 +3880,16 @@ as a fallback. Of course you can list as many substitute servers as you
like, with the caveat that substitute lookup can be slowed down if too
many servers need to be contacted.

+Below is a list of available substitute servers for the Guix distribution
+channel; you can add a mirror that is nearer to you if you find that the
+official Guix substitute server is slow:
+
+@itemize
+@item @code{https://mirror.sjtu.edu.cn/guix} - China, SJTU.
+@item @code{https://ci.guix.gnu.org} - Germany, official Guix server.
+You should always add this as the last substitute URL as a fallback.
+@end itemize
+
Note that there are also situations where one may want to add the URL of
a substitute server @emph{without} authorizing its key.
@xref{Substitute Authentication}, to understand this fine point.
@@ -5072,6 +5083,17 @@ From there on, @command{guix pull} will fetch code from the @code{super-hacks}
branch of the repository at @code{example.org}. The authentication concern is
addressed below ((@pxref{Channel Authentication}).

+Below is a list of available mirrors of the @code{guix} repository; you can
+replace the @code{guix} channel with one that is nearer to you if you find
+that the official @code{guix} repository is slow:
+
+@itemize
+@item @code{https://mirror.sjtu.edu.cn/git/guix.git} branch @code{master}
+- China, SJTU.
+@item @code{https://git.savannah.gnu.org/git/guix.git} branch @code{master}
+- USA, Official Guix.
+@end itemize
+
@node Replicating Guix
@section Replicating Guix

--
2.30.1
R
R
raid5atemyhomework wrote on 23 Jul 2021 17:31
(name . 46956@debbugs.gnu.org)(address . 46956@debbugs.gnu.org)
6RyYVcJoJhvMCz2UJj6yg4EgZ6aZydyINXNGeJPgCU9dJpMsPYuzkCOnmD3QPmOAkGYsQbsKhAIKYoANT3h_N0ec82UoRAv5rPlTAFyTG68=@protonmail.com
Bump.
R
R
raid5atemyhomework wrote on 1 Aug 2021 11:42
(name . 46956@debbugs.gnu.org)(address . 46956@debbugs.gnu.org)
7zGqQ3lOs6diNijaSas_PhK_CSVdsCgw6df9k82Q8HSzVzAkSTcT7oA7JWu4TqG_qleTzcugvvt7qh4nK0gtLXY7JVLBKfqcM1E8vPzZ5CU=@protonmail.com
BUMP
X
X
Xinglu Chen wrote on 1 Aug 2021 13:24
Re: [bug#46956] PATCH] doc: Add information about mirrors.
87pmux8l28.fsf@yoctocell.xyz
On Sat, Mar 06 2021, raid5atemyhomework via Guix-patches via wrote:

Toggle quote (41 lines)
> Closes: 46942
>
>
> From 63bcc0750248369b2171409168fd200e3841f0a5 Mon Sep 17 00:00:00 2001
> From: raid5atemyhomework <raid5atemyhomework@protonmail.com>
> Date: Sat, 6 Mar 2021 09:12:53 +0800
> Subject: [PATCH] doc: Add information about mirrors.
>
> * doc.texi (Getting Substitutes from Other Servers): Add a list of
> mirror substitute servers.
> (Using a Custom Guix Channel): Add a list of mirror Guix repositories.
> ---
> doc/guix.texi | 22 ++++++++++++++++++++++
> 1 file changed, 22 insertions(+)
>
> diff --git a/doc/guix.texi b/doc/guix.texi
> index 464c1141d8..d4582b009f 100644
> --- a/doc/guix.texi
> +++ b/doc/guix.texi
> @@ -86,6 +86,7 @@ Copyright @copyright{} 2020 raingloom@*
> Copyright @copyright{} 2020 Daniel Brooks@*
> Copyright @copyright{} 2020 John Soo@*
> Copyright @copyright{} 2020 Jonathan Brielmaier@*
> +Copyright @copyright{} 2021 raid5atemyhomework@*
>
> Permission is granted to copy, distribute and/or modify this document
> under the terms of the GNU Free Documentation License, Version 1.3 or
> @@ -3879,6 +3880,16 @@ as a fallback. Of course you can list as many substitute servers as you
> like, with the caveat that substitute lookup can be slowed down if too
> many servers need to be contacted.
>
> +Below is a list of available substitute servers for the Guix distribution
> +channel; you can add a mirror that is nearer to you if you find that the
> +official Guix substitute server is slow:
> +
> +@itemize
> +@item @code{https://mirror.sjtu.edu.cn/guix} - China, SJTU.
> +@item @code{https://ci.guix.gnu.org} - Germany, official Guix server.
> +You should always add this as the last substitute URL as a fallback.
> +@end itemize

https://bordeaux.guix.gnu.org is also an official substitute server;
I think it should be added to the list.

Toggle quote (15 lines)
> Note that there are also situations where one may want to add the URL of
> a substitute server @emph{without} authorizing its key.
> @xref{Substitute Authentication}, to understand this fine point.
> @@ -5072,6 +5083,17 @@ From there on, @command{guix pull} will fetch code from the @code{super-hacks}
> branch of the repository at @code{example.org}. The authentication concern is
> addressed below ((@pxref{Channel Authentication}).
>
> +Below is a list of available mirrors of the @code{guix} repository; you can
> +replace the @code{guix} channel with one that is nearer to you if you find
> +that the official @code{guix} repository is slow:
> +
> +@itemize
> +@item @code{https://mirror.sjtu.edu.cn/git/guix.git} branch @code{master}
> +- China, SJTU.

This Git repo doesn’t seem to accept connetions made through Tor, so it
might not be the best example

Toggle snippet (5 lines)
$ git clone https://mirror.sjtu.edu.cn/git/guix.git
Cloning into 'guix'...
fatal: unable to access 'https://mirror.sjtu.edu.cn/git/guix.git/': Received HTTP code 503 from proxy after CONNECT

There is another mirror on GitHub[1], and suprisingly, it works even
when connecting through Tor.

-----BEGIN PGP SIGNATURE-----

iQJJBAEBCAAzFiEEAVhh4yyK5+SEykIzrPUJmaL7XHkFAmEGhF8VHHB1YmxpY0B5
b2N0b2NlbGwueHl6AAoJEKz1CZmi+1x5iEUQAKXxaBgwCnje87rCdypma62mhsIC
1gS9qBIRdhvtL8IW6csuEYyyF6auGx9dTrAlPOLwydIlpPXJjJslp6ctcXBtWOq8
JYpPrjIjJSHYd3OzTLN1HiFR3N7JWu4futwnIYse6uklLISZZetHDOH0liHiB4N1
wnXC1f0BQib1Poweq9RHDSWkKokyPcYFE4KICuUYGUj/vwmjFQ59MLOnocQtPFq8
JXvHFCrdAA6kP0yB3py0ZVHWhIFalSJh0VyONqQzv4Ui6UNoWhSvw4VYfufk6oZV
XB6LUh1lesnfQ/EOC8gJWVH+xbOYKBj44WYjhivW2/0risMj1DT76jim8uikHT/A
I1MZIV6/V1hGYflg3r+ZklczLmWawQFhKWssvkddhzCYs2e9t4tF/gIBP5rrzhm8
072toWgF1H6upFbxu42bIehDozT/7mFDmbHEVQ31AMpVsC4PVwY+qc7HF6apdB4t
WjoWFKoUEXOcyh2WU04pQG39LIjZ9QSVom9WwfZ33/hSKu6w1X187DM/mEfsc2Bx
MxEVASyeZJTx0SIiLeA7qxKJk1d8tQMwN4aPsC9PZw3glAAIBHpBrtUL0siazC/D
xVsO78MGQQH2+heg28NGhx7OdBAh7z3II2LlskvXbczOnJesxLSnGNeEz+1G67Ok
45fi7tHyR7KJZVLo
=noud
-----END PGP SIGNATURE-----

R
R
raid5atemyhomework wrote on 10 Aug 2021 13:55
(name . Xinglu Chen)(address . public@yoctocell.xyz)(name . 46956@debbugs.gnu.org)(address . 46956@debbugs.gnu.org)
VMOh2B0vnOBG1R21y5ugyX_wNy-9pyxf_iu4Y8fYvH53soFyHRIhtucpCvIUz5wqmAqJY18H02I_6muYmJrPjpdaz6ccqve9iHFgR5-5sds=@protonmail.com
As requested by Xinglu.

Also the original patch has bitrotted and no longer apply to latest master, fixed that as well.

--

From 9eeeeb888c3cdd1a788d2a2646c1baf4cd0d7c09 Mon Sep 17 00:00:00 2001
From: raid5atemyhomework <raid5atemyhomework@protonmail.com>
Date: Tue, 10 Aug 2021 19:52:31 +0800
Subject: [PATCH] [PATCH] doc: Add information about mirrors.

* doc.texi (Getting Substitutes from Other Servers): Add a list of
mirror substitute servers.
(Using a Custom Guix Channel): Add a list of mirror Guix repositories.
---
doc/guix.texi | 28 ++++++++++++++++++++++++++++
1 file changed, 28 insertions(+)

Toggle diff (53 lines)
diff --git a/doc/guix.texi b/doc/guix.texi
index 4eb5324b51..031ec782e1 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -94,6 +94,7 @@ Copyright @copyright{} 2021 Xinglu Chen@*
Copyright @copyright{} 2021 Raghav Gururajan@*
Copyright @copyright{} 2021 Domagoj Stolfa@*
Copyright @copyright{} 2021 Hui Lu@*
+Copyright @copyright{} 2021 raid5atemyhomework@*

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
@@ -3902,6 +3903,20 @@ can list as many substitute servers as you like, with the caveat that
substitute lookup can be slowed down if too many servers need to be
contacted.

+Below is a list of available substitute servers for the Guix distribution
+channel; you can add a mirror that is nearer to you if you find that the
+official Guix substitute server is slow:
+
+@itemize
+@item @code{https://mirror.sjtu.edu.cn/guix} - China, SJTU.
+@item @code{https://ci.guix.gnu.org} - Germany, official Guix server.
+You should always add this as a substitute URL as a fallback.
+@item @code{https://bordeaux.guix.gnu.org} - France, official Guix
+server. You should always add this as a substitute URL as a
+fallback.
+@end itemize
+
+
Note that there are also situations where one may want to add the URL of
a substitute server @emph{without} authorizing its key.
@xref{Substitute Authentication}, to understand this fine point.
@@ -5095,6 +5110,19 @@ From there on, @command{guix pull} will fetch code from the @code{super-hacks}
branch of the repository at @code{example.org}. The authentication concern is
addressed below ((@pxref{Channel Authentication}).

+Below is a list of available mirrors of the @code{guix} repository; you can
+replace the @code{guix} channel with one that is nearer to you if you find
+that the official @code{guix} repository is slow:
+
+@itemize
+@item @code{https://git.savannah.gnu.org/git/guix.git} branch @code{master}
+- USA, Official Guix.
+@item @code{https://github.com/guix-mirror/guix} branch @code{master}
+- USA, unofficial mirror.
+@item @code{https://mirror.sjtu.edu.cn/git/guix.git} branch @code{master}
+- China, SJTU, not available over TOR.
+@end itemize
+
@node Replicating Guix
@section Replicating Guix

--
2.32.0
X
X
Xinglu Chen wrote on 10 Aug 2021 16:03
(name . raid5atemyhomework)(address . raid5atemyhomework@protonmail.com)(name . 46956@debbugs.gnu.org)(address . 46956@debbugs.gnu.org)
87czqlo0qx.fsf@yoctocell.xyz
On Tue, Aug 10 2021, raid5atemyhomework via Guix-patches via wrote:

Toggle quote (5 lines)
> As requested by Xinglu.
>
> Also the original patch has bitrotted and no longer apply to latest
> master, fixed that as well.

The patch LGTM, but I don’t have commit access, so you will have to wait
for someone else to merge it. :-)
-----BEGIN PGP SIGNATURE-----

iQJJBAEBCAAzFiEEAVhh4yyK5+SEykIzrPUJmaL7XHkFAmEShzYVHHB1YmxpY0B5
b2N0b2NlbGwueHl6AAoJEKz1CZmi+1x5AZcQAKYBORESpSraWD3k0wGt/mVyHhRp
Oes6s7P6V7M0PunPEQk7CefOecy+VhDeaVoD9/WhtrFPMiOiTtO+vDllftVxYgcJ
3yHW5Q95fl0mo5QhHtK8UMVccfaIT4N6Udh9tohgsqHg+GRpv4Wa0Krxzc9dmSFv
tpZiHu+cHiJ2WqlfGaCfdK55OhL2XlGZVtDeWzTATqDnwxotc8XRDrHGz92yAc8O
Du2qQCOO6KrDOrrqks6Z+aZeQ2RfdOs4SLcZVz9/Q15X2RRWw9upGT55o4S0z/qP
XnTXZRoggLgC7dPMe0Mpbeg8J23ZL/u4gBjq82xkzPcjLhgFLA04gFmBFFwOcIyt
8hFdaCwNkdYnFYDp6iBLsJZRpgk3rylrWP3urgS61vXhoB/Jj/96/hdK4Vxlf6Yo
cFZgvsNfEjRTwv+y9LD4J4EHKQlNXCcgaWt0TBcJ16sokWfIf6FDdX+1b5rdqT4Y
6BsTKjBVuRr22FMt3QkrJR1AhGDn7972f0wiRZabM1SgLWUfGjNsf4mA3xQU/Cqc
4Ch3/+xK2fi8AKyJGz7UkSD5PrrJjoGYwqJvK66b4b5uXArjZIF3LcAmM5FeJWrm
9uEdBQHwWrx8vOeg61yp81+bAAYcnWhLWQcblAu7NtWJ+AZ2O4lgB9sVmknsnexc
Mw3H8qT6c9yo00II
=M+ly
-----END PGP SIGNATURE-----

Z
Z
zimoun wrote on 17 Aug 2021 13:20
(name . 46956@debbugs.gnu.org)(address . 46956@debbugs.gnu.org)
86o89wco6h.fsf@gmail.com
Hi,

I have not followed closely the discussion so maybe I am off topic.

On Tue, 10 Aug 2021 at 11:55, raid5atemyhomework via Guix-patches via <guix-patches@gnu.org> wrote:

Toggle quote (13 lines)
> +Below is a list of available substitute servers for the Guix distribution
> +channel; you can add a mirror that is nearer to you if you find that the
> +official Guix substitute server is slow:
> +
> +@itemize
> +@item @code{https://mirror.sjtu.edu.cn/guix} - China, SJTU.
> +@item @code{https://ci.guix.gnu.org} - Germany, official Guix server.
> +You should always add this as a substitute URL as a fallback.
> +@item @code{https://bordeaux.guix.gnu.org} - France, official Guix
> +server. You should always add this as a substitute URL as a
> +fallback.
> +@end itemize

From my understanding bordeaux builds by its own and ci too, i.e., they
are not really a mirror from each other. But the last is a real
mirror––from ci I guess.

It implies that the user does not necessary get the same binaries if the
build is not reproducible.

Well, my point is: the word «mirror» from the sentence «you can add a
mirror that is nearer…» should be «server» and the documentation should
not talk about mirror here, IMHO. If my understanding is correct. :-)



Toggle quote (3 lines)
> +@item @code{https://github.com/guix-mirror/guix}branch @code{master}
> +- USA, unofficial mirror.

Who is behind this mirror? Well, I am not sure what means USA here.


All the best,
simon
?
Your comment

Commenting via the web interface is currently disabled.

To comment on this conversation send an email to 46956@debbugs.gnu.org

To respond to this issue using the mumi CLI, first switch to it
mumi current 46956
Then, you may apply the latest patchset in this issue (with sign off)
mumi am -- -s
Or, compose a reply to this issue
mumi compose
Or, send patches to this issue
mumi send-email *.patch