hc-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Oleg Kalnichevski <ol...@apache.org>
Subject Re: FYI: Updating the HC "project" site
Date Sat, 05 Jan 2008 21:42:09 GMT

On Sat, 2008-01-05 at 08:25 +0100, Roland Weber wrote:
> Hi folks,
> 
> below is the description how I currently update the
> main section of our website. Since it'll be a while
> until we have good documentation, I feel this info
> should be collected in a mail at least.
> Only committers can deploy the site, but everybody
> is welcome to contribute patches.
> 
> Preconditions:
> - Subversion
> - Maven 2 (always use with -N here!)
> - for deployment: ssh access to people.apache.org
>   (I'm assuming a DSA authentication setup)
> 
> Preparation:
> - check out the 'project' directory from SVN:
>   svn co https://svn.apache.org/repos/asf/httpcomponents/project/
>   (or project-trunk to get the components as well)
> - for deployment, your ~/.m2/settings.xml must contain
>   this section, with your own username of course:
> 
> <servers>
>     <server>
>       <id>apache.website</id>
>       <username>rolandw</username>
>       <privateKey>${usr.home}/.ssh/id_dsa</privateKey>
>       <filePermissions>664</filePermissions>
>       <directoryPermissions>775</directoryPermissions>
>       <configuration></configuration>
>     </server>
> </servers>
> 
> 
> Change and Review:
> - update src/site/site.xml and src/site/apt/ as required
> - regenerate the site locally:
>   mvn -N site:site
> - if you modify site.xml, clean before regenerating:
>   mvn -N clean site:site
> - review the result in the target/site/ directory
> 
> 
> Patch:
> - change to the 'project' directory
> - if you are a committer, apply the changes to SVN:
>   svn commit -m "..."
> - if you are not a committer, prepare the patch:
>   svn diff > site-patch-xxx.txt
>   Attach the patch to a JIRA issue or post it to dev@.
> 
> 
> Deployment (committers only):
> - open one terminal on your local machine to trigger the
>   deployment, and a second on people.apache.org to fix
>   the permissions afterwards
> - on people.a.o, change to /www/hc.apache.org/ and prepare
>   the command:
>   chmod a+x downloads.cgi
> - on your local machine, trigger site deployment:
>   mvn -N site:deploy
>   Make sure nobody is watching you. Maven will ask for
>   your private key phrase, and displays your input as
>   plain text in the terminal.
> - on people.a.o, execute the command prepared above:
>   chmod a+x downloads.cgi
> 
> 

Awesome! Could you please put this info on Wiki where it would be easier
to make changes to?  

Oleg


> cheers,
>   Roland
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@hc.apache.org
> For additional commands, e-mail: dev-help@hc.apache.org
> 
> 


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@hc.apache.org
For additional commands, e-mail: dev-help@hc.apache.org


Mime
View raw message