[GitHub] [vcl-site] rlenferink commented on pull request #4: Added Jenkinsfile to put deployment configuration in version control

[GitBox <gi...@apache.org>]

rlenferink commented on pull request #4:
URL: https://github.com/apache/vcl-site/pull/4#issuecomment-663841783


   The VCL folder has been created on ci-builds: https://ci-builds.apache.org/job/VCL/
   
   Steps to execute to setup the 'site' job again:
   - Review this PR (e.g. compare it with https://builds.apache.org/view/V/view/Apache%20VCL/job/vcl-site/configure) and if agreed merge it.
   - Before setting up the new job disable the old job on builds.a.o -> httpshttps://builds.apache.org/view/V/view/Apache%20VCL/job/vcl-site/ -> 'Disable / De-activate project'
   - Visit https://ci-builds.apache.org/job/VCL/ and sign-in
   - Click on 'New item'
   - Enter a name (e.g. _site_ which I also did for Celix and Comdev) and select 'Multibranch pipeline'.
   - Click 'OK' to create the job
   
   ### On the job configuration page enter
   - A description, e.g. : `This job is used to build and publish the website for Apache VCL`
   
   **Branch sources**
   - Click 'Add source' -> 'Git'
   - Project repository: `https://gitbox.apache.org/repos/asf/vcl-site.git`
   - Credentials: `jenkins (master pub key)`
   - In the behaviours section, click 'Add' and add the 'Clean before checkout' step.
   
   **Scan Multibranch Pipeline Triggers**
   - Check the 'Periodically if not otherwise run' checkbox and enter a sane value (e.g. 15 minutes).
   
   This is needed because the new ci-builds instance isn't receiving webhooks (yet). Until that is configured we need to scan the repo for changes with a given interval.
   
   **Orphaned Item Strategy**
   - Verify whether the 'Discard old items' is checked.
   - Enter a value in the 'Max # of old items to keep' field, e.g. `10`. This is something I personally like because it doesn't fill the Jenkins environment with a lot of old logging. If VCL wants to keep all logging just keep this field empty.
   
   - Click 'Save' to save the changes.
   - Click 'Scan Multibranch Pipeline Now' to do the initial scan. This will scan the 'master' branch.
   
   -----
   
   After the job has been setup the output should be similar to 
   - https://ci-builds.apache.org/job/Celix/job/site/
   - https://ci-builds.apache.org/job/Celix/job/site/job/master/8/console


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org