aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAvatar Irvin Choi <simdol8080@gmail.com> 2016-10-28 23:01:20 +0900
committerAvatar Bo Ørsted Andresen <zlin@exherbo.org> 2017-05-09 15:13:29 +0200
commitcb674a66eeaebdc9c1e2c3324020540faacb92b7 (patch)
tree8a9e7374ac7c0f9ebce4124d01d9af38ec1388d2
parent31fb0bb9270f7899e8e75fd930c97daaf0319a27 (diff)
downloaddocs-cb674a66eeaebdc9c1e2c3324020540faacb92b7.tar.gz
docs-cb674a66eeaebdc9c1e2c3324020540faacb92b7.tar.xz
mirrors.mkd: add git repository mirror
This commit adds a git repository mirror, how to change the Paludis sync repo, and addresses some awkward wordings. The git server is equipped with 100Mbp/s network and is located in the US. Although it can be cloned with ssh, one needs gitlab account and have their public key registered. If you need ssh access, please contact me. Please note that for now, I will be only accepting Exherbo devs' request for ssh access. I wanted to contribute something valuable to Exherbo, and this came to mind as the git cloning performance was nat satisfactory on my region, and there were no other repository mirrors I could use. If any repositories are missing, broken, or out sync, please feel free to contact me. Change-Id: I639b0b93e90831daef509003728d0a1c64fb6614 Reviewed-on: https://galileo.mailstation.de/gerrit/7481 Reviewed-by: Bo Ørsted Andresen <zlin@exherbo.org>
-rw-r--r--mirrors.mkd61
1 files changed, 48 insertions, 13 deletions
diff --git a/mirrors.mkd b/mirrors.mkd
index b6cbf89..72d63b0 100644
--- a/mirrors.mkd
+++ b/mirrors.mkd
@@ -9,11 +9,11 @@ CSS: /css/main.css
Contributing a mirror to Exherbo is fairly simple. It consists of syncing
with the master mirror every so often via `rsync`, adding an entry to
-the `arbor` line in ::arbor's [mirrors.conf], and sending a patch to
-Gerrit which adds the mirror.
+the `arbor` line in ::arbor's [mirrors.conf], and submitting a patch to
+Gerrit, which adds the mirror.
-Mirrors with HTTP(S), FTP, with IPv4 and v6 (or both) are accepted
-currently.
+Mirrors with HTTP(S), FTP, with IPv4 and v6 (or both) are currently
+accepted.
For example, on the mirror at somasis.com, a cronjob executes `rsync` at
the 42nd minute of 2:00 (that's AM, for 12-hour users) every day:
@@ -29,19 +29,54 @@ transfer modification times, and preserve executability.
Obviously, you should not copy this example blindly.
-In addition, please don't synchronize much more than a day. The main mirror
-only updates once a day. Your IP may be banned if you are mean to the mirror.
+In addition, please don't synchronize much more than once a day. The
+main mirror only updates once a day. Your IP may be banned if you are
+mean to the mirror.
Practice common courtesy and don't be rude to our servers. Thank you. :)
-## List of mirrors
+## List of distfile mirrors
-Mirror URL | Owner | Location | Notes |
---------------------------------------------- | ----------------------------------------- | ------------------ | --------------------------- |
-<http://distfiles.exherbo.org/distfiles> | Kim Højgaard-Hansen <kimrhh@exherbo.org> | Germany | Master mirror, IPv4 only |
-<http://mirrors.dotsrc.org/exherbo/> | Kim Højgaard-Hansen <kimrhh@exherbo.org> | Denmark | Dual IP stack |
-<ftp://mirrors.dotsrc.org/exherbo/> | Kim Højgaard-Hansen <kimrhh@exherbo.org> | Denmark | Dual IP stack |
-<https://www.somasis.com/dl/mirror/exherbo/> | Kylie McClain <somasis@exherbo.org> | Germany | Dual IP stack, HTTPS only |
+Mirror URL | Owner | Location | Notes |
+--------------------------------------------- | ----------------------------------------- | ------------------ | ---------------------------------- |
+<http://distfiles.exherbo.org/distfiles/> | Kim Højgaard-Hansen <kimrhh@exherbo.org> | Germany | Master mirror, IPv4 only |
+<http://mirrors.dotsrc.org/exherbo/> | Kim Højgaard-Hansen <kimrhh@exherbo.org> | Denmark | Dual IP stack |
+<ftp://mirrors.dotsrc.org/exherbo/> | Kim Højgaard-Hansen <kimrhh@exherbo.org> | Denmark | Dual IP stack |
+<https://www.somasis.com/dl/mirror/exherbo/> | Kylie McClain <somasis@exherbo.org> | Germany | Dual IP stack, HTTPS only |
+
+## List of git repository mirrors
+
+Mirror URL | Owner | Location | Notes |
+--------------------------------------------- | ----------------------------------------- | ------------------ | ---------------------------------- |
+<https://git.exherbo.org/> | Exherbo Developers | Denmark | Master mirror, IPv4 only |
+<https://git.nightly.network/exherbo/> | Irvin Choi <simdol8080@gmail.com> | United States | IPv4, HTTPS only |
+
+
+## Changing mirror on Paludis
+
+By default, Paludis uses `git.exherbo.org` to sync repositories with git
+protocol. To use different repository, simply edit `/etc/paludis/repositories/{repository_name}.conf`'s
+`sync` value into repository you want to use.
+
+For example, steps for changing git mirror from `https://git.exherbo.org/` to `https://git.nightly.network/exherbo/`
+for `arbor` would be:
+
+1) Open `/etc/paludis/repositories/arbor.conf` with text-editor of your choice.
+
+2) Under location, replace `sync` value so that:
+
+`sync = git+https://git.exherbo.org/arbor.git`
+
+would be:
+
+`sync = git+https://git.nightly.network/exherbo/arbor.git`.
+
+3) Save the file, and exit.
+
+4) Sync the repository, `cave sync arbor`.
+
+That's it! If you have multiple repositories that you wish to change the mirror
+of, consider using `sed` to make your life easier.
[mirrors.conf]: //git.exherbo.org/arbor.git/tree/metadata/mirrors.conf