Avro
  1. Avro
  2. AVRO-1025

migrate website & dist to svnpubsub

    Details

    • Type: Improvement Improvement
    • Status: Open
    • Priority: Major Major
    • Resolution: Unresolved
    • Affects Version/s: None
    • Fix Version/s: None
    • Component/s: None
    • Labels:
      None

      Description

      ASF infrastructure has requested that all projects migrate to svnpubsub for their websites and release distributions.

        Issue Links

          Activity

          Hide
          Doug Cutting added a comment -

          I committed the docs to subversion and asked Infrastructure to switch the website to automatically update from there in INFRA-4443.

          Show
          Doug Cutting added a comment - I committed the docs to subversion and asked Infrastructure to switch the website to automatically update from there in INFRA-4443 .
          Hide
          Doug Cutting added a comment -

          We need to first make sure that all of our website is in https://svn.apache.org/repos/asf/avro/site/publish/. Currently the only thing that's not there is the docs/ directory containing documentation for all past releases. So that needs to be added to svn and we need to update the release instructions to indicate that the documentation for new releases should be added to svn rather than copied to a directory on people.apache.org/www/avro.apache.org/docs/. Once this is done then we can ask Infra to switch on svnpubsub and changes to https://svn.apache.org/repos/asf/avro/site/publish/ will automatically be propagated to the website rather than manually as they are today.

          For releases we need to:

          • create https://dist.apache.org/repos/dist/release/avro/
          • copy people.apache.org:/www/www.apache.org/dist/avro to this directory in svn
          • tell Infra to start using this svn directory as the master for Avro distribution
          • update release instructions to indicate that files should be placed in svn rather than on people.apache.org.

          I think that's it.

          Show
          Doug Cutting added a comment - We need to first make sure that all of our website is in https://svn.apache.org/repos/asf/avro/site/publish/ . Currently the only thing that's not there is the docs/ directory containing documentation for all past releases. So that needs to be added to svn and we need to update the release instructions to indicate that the documentation for new releases should be added to svn rather than copied to a directory on people.apache.org/www/avro.apache.org/docs/. Once this is done then we can ask Infra to switch on svnpubsub and changes to https://svn.apache.org/repos/asf/avro/site/publish/ will automatically be propagated to the website rather than manually as they are today. For releases we need to: create https://dist.apache.org/repos/dist/release/avro/ copy people.apache.org:/www/www.apache.org/dist/avro to this directory in svn tell Infra to start using this svn directory as the master for Avro distribution update release instructions to indicate that files should be placed in svn rather than on people.apache.org. I think that's it.
          Hide
          Doug Cutting added a comment -

          The request may have been lost in moderation, so here it is again:

          ---------- Forwarded message ----------
          From: Joe Schaefer <joe_schaefer@yahoo.com>
          To: Apache Infrastructure <infrastructure@apache.org>
          Cc:
          Date: Wed, 8 Feb 2012 04:26:48 -0800 (PST)
          Subject: Mandatory svnpubsub migration by Jan 2013
          [PLEASE DO NOT RESPOND TO THIS POST! DIRECT ALL FURTHER
          INQUIRIES TO infrastructure@apache.org]

          FYI: infrastructure policy regarding website hosting has
          changed as of November 2011: we are requiring all websites
          and dist/ dirs to be svnpubsub or ASF CMS backed by the end of 2012.
          If your PMC has already met this requirement congratulations,
          you can ignore the remainder of this post.

          As stated on http://www.apache.org/dev/project-site.html#svnpubsub
          we are migrating our webserver infrastructure to 100% svnpubsub
          over the course of 2012. If your site does not currently make
          use of this technology, it is time to consider a migration effort,
          as rsync-based sites will be PERMANENTLY FROZEN in Jan 2013 due

          to infra disabling the hourly rsync jobs. While we recommend
          migrating to the ASF CMS [0] for Anakia based or Confluence based
          sites, and have provided tooling [1] to help facilitate this,
          we are only mandating svnpubsub (which the CMS uses itself).

          svnpubsub is a client-server system whereby a client watches an
          svn working copy for relevant commit notifications from the svn
          server. It subsequently runs svn up on the working copy, bringing
          in the relevant changes. sites that use static build technologies
          that commit the build results to svn are naturally compatible with
          svnpubsub; simply file a JIRA ticket with INFRA to request a
          migration: any commits to the resulting build tree will be

          instantly picked up on the live site.

          The CMS is a more elaborate system based on svnpubsub which
          provides a webgui for convenient online editing. Dozens of
          sites have already successfully deployed using the CMS and
          are quite happy with the results. The system is sufficiently
          flexible to accommodate a wide variety of choices regarding
          templating systems and storage formats, but most sites have
          standardized on the combination of Django and Markdown. Talk
          to infra if you would like to use the CMS in this or some other
          fashion, we'll see what we can do.

          NOTE: the policy for dist/ dirs for managing project releases is
          similar. We have setup a dedicated svn server for handling this,
          please contact infra when you are ready to start using it.

          HTH

          [0]: http://www.apache.org/dev/cms
          [1]: https://svn.apache.org/repos/infra/websites/cms/conversion-utilities/

          Show
          Doug Cutting added a comment - The request may have been lost in moderation, so here it is again: ---------- Forwarded message ---------- From: Joe Schaefer <joe_schaefer@yahoo.com> To: Apache Infrastructure <infrastructure@apache.org> Cc: Date: Wed, 8 Feb 2012 04:26:48 -0800 (PST) Subject: Mandatory svnpubsub migration by Jan 2013 [PLEASE DO NOT RESPOND TO THIS POST! DIRECT ALL FURTHER INQUIRIES TO infrastructure@apache.org] FYI: infrastructure policy regarding website hosting has changed as of November 2011: we are requiring all websites and dist/ dirs to be svnpubsub or ASF CMS backed by the end of 2012. If your PMC has already met this requirement congratulations, you can ignore the remainder of this post. As stated on http://www.apache.org/dev/project-site.html#svnpubsub we are migrating our webserver infrastructure to 100% svnpubsub over the course of 2012. If your site does not currently make use of this technology, it is time to consider a migration effort, as rsync-based sites will be PERMANENTLY FROZEN in Jan 2013 due to infra disabling the hourly rsync jobs. While we recommend migrating to the ASF CMS [0] for Anakia based or Confluence based sites, and have provided tooling [1] to help facilitate this, we are only mandating svnpubsub (which the CMS uses itself). svnpubsub is a client-server system whereby a client watches an svn working copy for relevant commit notifications from the svn server. It subsequently runs svn up on the working copy, bringing in the relevant changes. sites that use static build technologies that commit the build results to svn are naturally compatible with svnpubsub; simply file a JIRA ticket with INFRA to request a migration: any commits to the resulting build tree will be instantly picked up on the live site. The CMS is a more elaborate system based on svnpubsub which provides a webgui for convenient online editing. Dozens of sites have already successfully deployed using the CMS and are quite happy with the results. The system is sufficiently flexible to accommodate a wide variety of choices regarding templating systems and storage formats, but most sites have standardized on the combination of Django and Markdown. Talk to infra if you would like to use the CMS in this or some other fashion, we'll see what we can do. NOTE: the policy for dist/ dirs for managing project releases is similar. We have setup a dedicated svn server for handling this, please contact infra when you are ready to start using it. HTH [0] : http://www.apache.org/dev/cms [1] : https://svn.apache.org/repos/infra/websites/cms/conversion-utilities/

            People

            • Assignee:
              Doug Cutting
              Reporter:
              Doug Cutting
            • Votes:
              0 Vote for this issue
              Watchers:
              0 Start watching this issue

              Dates

              • Created:
                Updated:

                Development