From owner-svn-doc-head@freebsd.org Sun Jun 17 03:20:42 2018 Return-Path: Delivered-To: svn-doc-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 2168E100AF55; Sun, 17 Jun 2018 03:20:42 +0000 (UTC) (envelope-from eadler@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id C96027C934; Sun, 17 Jun 2018 03:20:41 +0000 (UTC) (envelope-from eadler@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 91FB07C0E; Sun, 17 Jun 2018 03:20:41 +0000 (UTC) (envelope-from eadler@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id w5H3Kf6E091053; Sun, 17 Jun 2018 03:20:41 GMT (envelope-from eadler@FreeBSD.org) Received: (from eadler@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id w5H3KfGM090986; Sun, 17 Jun 2018 03:20:41 GMT (envelope-from eadler@FreeBSD.org) Message-Id: <201806170320.w5H3KfGM090986@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: eadler set sender to eadler@FreeBSD.org using -f From: Eitan Adler Date: Sun, 17 Jun 2018 03:20:41 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r51854 - head/en_US.ISO8859-1/articles/committers-guide X-SVN-Group: doc-head X-SVN-Commit-Author: eadler X-SVN-Commit-Paths: head/en_US.ISO8859-1/articles/committers-guide X-SVN-Commit-Revision: 51854 X-SVN-Commit-Repository: doc MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.26 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 17 Jun 2018 03:20:42 -0000 Author: eadler Date: Sun Jun 17 03:20:41 2018 New Revision: 51854 URL: https://svnweb.freebsd.org/changeset/doc/51854 Log: Committer guide: restore some information about svnsync Even though we don't have currently have active seeds some people still use the old ones. In addition we may restore creating new ones. Update the text a bit to reflect that you can use the mirror. Move the text together into one section, and keep the note about alternatives. Requested by: kib Modified: head/en_US.ISO8859-1/articles/committers-guide/article.xml Modified: head/en_US.ISO8859-1/articles/committers-guide/article.xml ============================================================================== --- head/en_US.ISO8859-1/articles/committers-guide/article.xml Sun Jun 17 03:01:55 2018 (r51853) +++ head/en_US.ISO8859-1/articles/committers-guide/article.xml Sun Jun 17 03:20:41 2018 (r51854) @@ -580,35 +580,6 @@ You need a Passphrase to protect your secret key. - - Checkout from a Mirror - - Check out a working copy from a mirror by - substituting the mirror's URL for - svn+ssh://repo.freebsd.org/base. This - can be an official mirror or a mirror maintained by using - svnsync. - - There is a serious disadvantage to this method: every - time something is to be committed, a - svn relocate to the master repository has - to be done, remembering to svn relocate - back to the mirror after the commit. Also, since - svn relocate only works between - repositories that have the same UUID, some hacking of the - local repository's UUID has to occur before it is possible - to start using it. - - The hassle of a local svnsync mirror - probably is not worth it unless the network connectivity - situation or other factors demand it. Starting - a fresh mirror from empty takes a long time. - Expect a minimum of 10 hours with high speed connectivity. - If international links are involved, expect this to take - four to ten times longer. Another option is to use the - git mirror. - - <literal>RELENG_*</literal> Branches and General Layout @@ -1861,6 +1832,69 @@ U stable/9/share/man/man4/netmap.4 correct location. Instead of a couple of lines of text, the repository journal grows an entire new copy of the file. This is a waste. + + + + Using a Subversion mirror + + There is a serious disadvantage to this method: every + time something is to be committed, a + svn relocate to the master repository has + to be done, remembering to svn relocate + back to the mirror after the commit. Also, since + svn relocate only works between + repositories that have the same UUID, some hacking of the + local repository's UUID has to occur before it is possible + to start using it. + + + Checkout From a Mirror + + Check out a working copy from a mirror by + substituting the mirror's URL for + svn+ssh://repo.freebsd.org/base. This + can be an official mirror or a mirror maintained by using + svnsync. + + + + Setting up a <application>svnsync</application> + Mirror + + Avoid setting up a svnsync + mirror unless there is a very good reason for it. Most + of the time a git mirror is a better + alternative. Starting a fresh mirror from scratch takes + a long time. + Expect a minimum of 10 hours for high speed connectivity. + If international links are involved, expect this to take + four to ten times longer. + + One way to limit the time required is to grab a seed file. + It is large + (~1GB) but will consume less network traffic and take less + time to fetch than svnsync will. + + Extract the file and update it: + + &prompt.user; tar xf svnmirror-base-r261170.tar.xz +&prompt.user; svnsync sync file:///home/svnmirror/base + + Now, set that up to run from &man.cron.8;, do + checkouts locally, set up a svnserve server for local + machines to talk to, etc. + + The seed mirror is set to fetch from + svn://svn.freebsd.org/base. The + configuration for the mirror is stored in + revprop 0 on the local mirror. To see + the configuration, try: + + &prompt.user; svn proplist -v --revprop -r 0 file:///home/svnmirror/base + + Use svn propset to change things. +