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
?