Page History

Even though Bigtop project manages its own website via Mave's site plugin the deployment still needs to happen by committing to the svnpubsub.

If you want to update Bigtop's website, here's a set of steps you need to go through:

...

• Open a JIRA ticket under the website component that describes the desired changes.

• Checkout our official ASF git repo
  $ git clone :

  Code Block
  language bash
  git clone https://

  git-wip-us

  gitbox.apache.org/repos/asf/bigtop.git

  
  

• Open JIRA ticket for the changes; make the Make the desired changes under ./src/site.

• Build and test the result

  via

  :

  $ mvn

  Code Block
  language bash
  mvn site:site

  
  $

  mvn site:run

  
  $

  firefox http://localhost:8080

  
  

• When satisfied, commit back to the official

  Git repo

  git repo:

  Code Block
  git commit -am 'BIGTOP-XXXX. <Your comment>' git push

  
  

• The deploy command may fail due to missing subversion credentials. To circumvent that, see here.
  To setup proper credential before deploying the code to SVN, REPLACE oflebbe to your account:

  Code Block
  language bash
  --- a/pom.xml +++ b/pom.xml @@ -492,7 +492,7 @@ <distributionManagement> <site> <id>apache.website</id> - <url>scm:svn:https://svn.apache.org/repos/infra/websites/staging/bigtop/trunk/content</url> + <url>scm:svn:https://oflebbe@svn.apache.org/repos/infra/websites/staging/bigtop/trunk/content</url> </site> </distributionManagement>

  
  

• Now it is time to actually publish the website:

  Code Block
  language bash

...

• mvn -Dpassword=xxxxxx site-deploy #yes, dash, not a colon

  
  

• This will deploy the generated website to /www/bigtop.apache.org/ on people.apache.org. You can SSH there to check that things look OK.
  • If you do not have SSH access to people.apache.org, you may skip this step and verify your changes in the next step.
• Once the deployment is done you need to publish the new website via .
  • Login to https://cms.apache.org/bigtop/
  : login
  •  and click the  "Publish bigtop site" link. Otherwise the content won't get propagated.
  • On the publish page, you will see a "View Diff" link.  Click this to ensure the staged changes are acceptable.
  • If the diff looks OK, add a log message about what changed and click "Submit".
• It will take an hour or so for the website to become live, but you can inspect the website by temporarily setting your browser proxy to see the new, unmirrored content (I used FoxyProxy in Firefox) as described in http://www.apache.org/dev/project-site.html.