You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@pdfbox.apache.org by Jeremias Maerki <de...@jeremias-maerki.ch> on 2008/08/11 16:57:46 UTC
Forrest-based website ready for deployment (missing permissions)
As promised I've set up the Forrest website. I've used ForrestBot which
faciliates the generation bit a lot. Only a "svn up" on
/www/incubator.apache.org/pdfbox is required afterwards to make it live.
However, I have to get group permissions for the "incubator" group
before I can do that myself. If anyone else can do the SVN stuff before
I get the necessary permissions, feel free to proceed.
- login to people.apache.org
- cd /www/incubator.apache.org/pdfbox
First time:
svn co http://svn.apache.org/repos/asf/incubator/pdfbox/site/ .
After that:
svn up
Getting more automation like Jukka prefers needs some additional work.
Maybe Hudson can help...
Jeremias Maerki
Re: Forrest-based website ready for deployment (missing permissions)
Posted by Philipp Koch <ph...@day.com>.
the site is live! thanks jeremias for the initial setup!
regards,
philipp
On Mon, Aug 11, 2008 at 7:30 PM, Niall Pemberton
<ni...@gmail.com> wrote:
> On Mon, Aug 11, 2008 at 6:21 PM, Jeremias Maerki <de...@jeremias-maerki.ch> wrote:
>> Should be fine. Thanks! So the site should be live in an hour or so, i.e.
>> after the next sync.
>
> Yes, although I thought it was a bit longer (~4hrs) - but I can never remember
>
> Niall
>
>> On 11.08.2008 19:15:25 Niall Pemberton wrote:
>>> On Mon, Aug 11, 2008 at 3:57 PM, Jeremias Maerki <de...@jeremias-maerki.ch> wrote:
>>> > As promised I've set up the Forrest website. I've used ForrestBot which
>>> > faciliates the generation bit a lot. Only a "svn up" on
>>> > /www/incubator.apache.org/pdfbox is required afterwards to make it live.
>>> > However, I have to get group permissions for the "incubator" group
>>> > before I can do that myself. If anyone else can do the SVN stuff before
>>> > I get the necessary permissions, feel free to proceed.
>>> >
>>> > - login to people.apache.org
>>> > - cd /www/incubator.apache.org/pdfbox
>>> >
>>> > First time:
>>> > svn co http://svn.apache.org/repos/asf/incubator/pdfbox/site/ .
>>>
>>> I tried that, but it created a site directory inside the pdfbox one
>>> (sorry don't usually use svn from the command line) - so I removed the
>>> pdfbox folder and did
>>>
>>> cd /www/incubator.apache.org/
>>> svn co http://svn.apache.org/repos/asf/incubator/pdfbox/site/ pdfbox
>>>
>>> This looks like its done it OK, but let me know if I've screwed
>>> anything up and I'll fix it - otherwise should be there afer the next
>>> sync.
>>>
>>> Niall
>>>
>>> > After that:
>>> > svn up
>>> >
>>> > Getting more automation like Jukka prefers needs some additional work.
>>> > Maybe Hudson can help...
>>> >
>>> > Jeremias Maerki
>>> >
>>> >
>>
>>
>>
>>
>> Jeremias Maerki
>>
>>
>
Re: Forrest-based website ready for deployment (missing permissions)
Posted by Niall Pemberton <ni...@gmail.com>.
On Mon, Aug 11, 2008 at 6:21 PM, Jeremias Maerki <de...@jeremias-maerki.ch> wrote:
> Should be fine. Thanks! So the site should be live in an hour or so, i.e.
> after the next sync.
Yes, although I thought it was a bit longer (~4hrs) - but I can never remember
Niall
> On 11.08.2008 19:15:25 Niall Pemberton wrote:
>> On Mon, Aug 11, 2008 at 3:57 PM, Jeremias Maerki <de...@jeremias-maerki.ch> wrote:
>> > As promised I've set up the Forrest website. I've used ForrestBot which
>> > faciliates the generation bit a lot. Only a "svn up" on
>> > /www/incubator.apache.org/pdfbox is required afterwards to make it live.
>> > However, I have to get group permissions for the "incubator" group
>> > before I can do that myself. If anyone else can do the SVN stuff before
>> > I get the necessary permissions, feel free to proceed.
>> >
>> > - login to people.apache.org
>> > - cd /www/incubator.apache.org/pdfbox
>> >
>> > First time:
>> > svn co http://svn.apache.org/repos/asf/incubator/pdfbox/site/ .
>>
>> I tried that, but it created a site directory inside the pdfbox one
>> (sorry don't usually use svn from the command line) - so I removed the
>> pdfbox folder and did
>>
>> cd /www/incubator.apache.org/
>> svn co http://svn.apache.org/repos/asf/incubator/pdfbox/site/ pdfbox
>>
>> This looks like its done it OK, but let me know if I've screwed
>> anything up and I'll fix it - otherwise should be there afer the next
>> sync.
>>
>> Niall
>>
>> > After that:
>> > svn up
>> >
>> > Getting more automation like Jukka prefers needs some additional work.
>> > Maybe Hudson can help...
>> >
>> > Jeremias Maerki
>> >
>> >
>
>
>
>
> Jeremias Maerki
>
>
Re: Forrest-based website ready for deployment (missing permissions)
Posted by Jeremias Maerki <de...@jeremias-maerki.ch>.
Should be fine. Thanks! So the site should be live in an hour or so, i.e.
after the next sync.
On 11.08.2008 19:15:25 Niall Pemberton wrote:
> On Mon, Aug 11, 2008 at 3:57 PM, Jeremias Maerki <de...@jeremias-maerki.ch> wrote:
> > As promised I've set up the Forrest website. I've used ForrestBot which
> > faciliates the generation bit a lot. Only a "svn up" on
> > /www/incubator.apache.org/pdfbox is required afterwards to make it live.
> > However, I have to get group permissions for the "incubator" group
> > before I can do that myself. If anyone else can do the SVN stuff before
> > I get the necessary permissions, feel free to proceed.
> >
> > - login to people.apache.org
> > - cd /www/incubator.apache.org/pdfbox
> >
> > First time:
> > svn co http://svn.apache.org/repos/asf/incubator/pdfbox/site/ .
>
> I tried that, but it created a site directory inside the pdfbox one
> (sorry don't usually use svn from the command line) - so I removed the
> pdfbox folder and did
>
> cd /www/incubator.apache.org/
> svn co http://svn.apache.org/repos/asf/incubator/pdfbox/site/ pdfbox
>
> This looks like its done it OK, but let me know if I've screwed
> anything up and I'll fix it - otherwise should be there afer the next
> sync.
>
> Niall
>
> > After that:
> > svn up
> >
> > Getting more automation like Jukka prefers needs some additional work.
> > Maybe Hudson can help...
> >
> > Jeremias Maerki
> >
> >
Jeremias Maerki
Re: Forrest-based website ready for deployment (missing permissions)
Posted by Niall Pemberton <ni...@gmail.com>.
On Mon, Aug 11, 2008 at 3:57 PM, Jeremias Maerki <de...@jeremias-maerki.ch> wrote:
> As promised I've set up the Forrest website. I've used ForrestBot which
> faciliates the generation bit a lot. Only a "svn up" on
> /www/incubator.apache.org/pdfbox is required afterwards to make it live.
> However, I have to get group permissions for the "incubator" group
> before I can do that myself. If anyone else can do the SVN stuff before
> I get the necessary permissions, feel free to proceed.
>
> - login to people.apache.org
> - cd /www/incubator.apache.org/pdfbox
>
> First time:
> svn co http://svn.apache.org/repos/asf/incubator/pdfbox/site/ .
I tried that, but it created a site directory inside the pdfbox one
(sorry don't usually use svn from the command line) - so I removed the
pdfbox folder and did
cd /www/incubator.apache.org/
svn co http://svn.apache.org/repos/asf/incubator/pdfbox/site/ pdfbox
This looks like its done it OK, but let me know if I've screwed
anything up and I'll fix it - otherwise should be there afer the next
sync.
Niall
> After that:
> svn up
>
> Getting more automation like Jukka prefers needs some additional work.
> Maybe Hudson can help...
>
> Jeremias Maerki
>
>
Re: Forrest-based website ready for deployment (missing permissions)
Posted by Jukka Zitting <ju...@gmail.com>.
Hi,
On Mon, Aug 11, 2008 at 5:57 PM, Jeremias Maerki <de...@jeremias-maerki.ch> wrote:
> As promised I've set up the Forrest website. I've used ForrestBot which
> faciliates the generation bit a lot.
I tried generating the web site but had the following issues:
1) Forrest doesn't work with Java 6. Disabling sitemap validation (see
patch below) made it work.
2) I have Forrest 0.8 which seems to produce slightly different output
than 0.9-dev, resulting in changes to almost all output files even if
I haven't changed any of the input files.
Issue 1 is easy enough to work around, but what should we do about
issue 2? Standardize a specific Forrest version to use when generating
the site?
I'm currently discussing with the ASF infrastructure team on whether
it's OK with them for us to use a CI build to generate the site. That
way we could have a single controlled environment where the site is
built, which would negate issue 2.
BR,
Jukka Zitting
Index: website/forrest.properties
===================================================================
--- website/forrest.properties (revision 686463)
+++ website/forrest.properties (working copy)
@@ -95,7 +95,7 @@
#forrest.validate=false
forrest.validate.xdocs=false
#forrest.validate.skinconf=${forrest.validate}
-#forrest.validate.sitemap=${forrest.validate}
+forrest.validate.sitemap=false
#forrest.validate.stylesheets=${forrest.validate}
#forrest.validate.skins=${forrest.validate}
#forrest.validate.skins.stylesheets=${forrest.validate.skins}
Re: Forrest-based website ready for deployment (missing permissions)
Posted by Jeremias Maerki <de...@jeremias-maerki.ch>.
On 12.08.2008 11:29:48 Jukka Zitting wrote:
> Hi,
>
> On Mon, Aug 11, 2008 at 5:57 PM, Jeremias Maerki <de...@jeremias-maerki.ch> wrote:
> > - login to people.apache.org
> > - cd /www/incubator.apache.org/pdfbox
> > [...]
> > After that:
> > svn up
> >
> > Getting more automation like Jukka prefers needs some additional work.
>
> I just added a simple cronjob that automatically keeps the
> /www/incubator.apache.org/pdfbox folder up to date. So no need for
> manual updates.
Cool. Thanks!
> > Maybe Hudson can help...
>
> I'm also discussing with the infra team on whether we really do need
> to keep the generated site in svn, or if we could just use a CI server
> to build and deploy the site directly from sources.
The answer I got in the past was that infra wants the generated site in
SVN to make it easier to redeploy (without external help) after a
recovery. At some point I just deployed the XML and XML Graphics
websites using SCP but I switched back to SVN to make them happy.
Personally, I don't care so much how it needs to be done. With
ForrestBot it's easy to change if necessary.
> BR,
>
> Jukka Zitting
Jeremias Maerki
Re: Forrest-based website ready for deployment (missing permissions)
Posted by Jukka Zitting <ju...@gmail.com>.
Hi,
On Tue, Aug 12, 2008 at 12:29 PM, Jukka Zitting <ju...@gmail.com> wrote:
> On Mon, Aug 11, 2008 at 5:57 PM, Jeremias Maerki <de...@jeremias-maerki.ch> wrote:
>> Maybe Hudson can help...
>
> I'm also discussing with the infra team on whether we really do need
> to keep the generated site in svn, or if we could just use a CI server
> to build and deploy the site directly from sources.
The infrastructure team decided to allow sites to be generated and
deployed directly from sources without committing the generated files
in svn.
Based on that decision I just configured our Hudson build to generate
also our web site, and added the following script to my personal
crontab (to be run once a day) on people.apache.org:
#! /bin/sh
umask 002
if ssh hudson.zones.apache.org \
test -f pdfbox/website/build/site/index.html
then
/usr/local/bin/rsync \
-r --delete --rsync-path=/opt/sfw/bin/rsync \
hudson.zones.apache.org:pdfbox/website/build/site/ \
/www/incubator.apache.org/pdfbox
fi
In my home directory on hudson.zones.apache.org I have a symlink
"pdfbox" that points to the PDFBox checkout used by our Hudson build.
The script checks that the site is generated (so our site won't break
if there's a build failure) and deploys the generated site to
/www/incubator.apache.org/pdfbox.
Basically, with this machinery in place you just need to commit your
changes to the site sources in website/src and the changes will be
automatically deployed to the live web site.
I hope everyone is happy with with this change. If not, I can revert
the deployment process to what we had before.
BR,
Jukka Zitting
Re: Forrest-based website ready for deployment (missing permissions)
Posted by Jukka Zitting <ju...@gmail.com>.
Hi,
On Mon, Aug 11, 2008 at 5:57 PM, Jeremias Maerki <de...@jeremias-maerki.ch> wrote:
> - login to people.apache.org
> - cd /www/incubator.apache.org/pdfbox
> [...]
> After that:
> svn up
>
> Getting more automation like Jukka prefers needs some additional work.
I just added a simple cronjob that automatically keeps the
/www/incubator.apache.org/pdfbox folder up to date. So no need for
manual updates.
> Maybe Hudson can help...
I'm also discussing with the infra team on whether we really do need
to keep the generated site in svn, or if we could just use a CI server
to build and deploy the site directly from sources.
BR,
Jukka Zitting