The easiest way to get started with using Jenkins to build your WebObjects projects is to make use of WOJenkins. WOJenkins is a set of shell scripts and Jenkins job configurations that should fit most WebObjects projects out-of-the-box, but they can also be modified to fit specific needs.

To make use of WOJenkins, you will need all of the following:

  1. A running Jenkins server. Ideally setup and configured using the Installing and Configuring Jenkins instructions.
  2. Git SCM installed on the Jenkins server.
  3. The Jenkins Git Plugin installed
  4. The Jenkins Multiple SCMs Plugin installed

Installing WebObjects and Project Wonder Frameworks

Before you can build your framework or application you will need to have WebObjects, Project Wonder and woproject.jar installed on your Jenkins server. The WOJenkins scripts and job configurations depend upon all three of them being installed in the JENKINS_HOME/WOFrameworksRepository directory.

The quickest way to install everything you need is by using WOJenkins itself! Specifically, by using the WOJenkins InstallWOAndWOnder job configuration.

  1. Change directories into JENKINS_HOME/jobs
    cd /Users/Shared/Jenkins/Home/jobs/
  2. Clone job configuration from github.com repository
    sudo git clone https://github.com/avendasora/WOJenkins_Job_InstallWOAndWOnder.git Install_WebObjects_And_Wonder
  3. Set correct ownership and permissions - If you used the Mac OSX Jenkins installer, the user and group that it will be using are both "jenkins"
    sudo chown -R jenkins:jenkins Install_WebObjects_And_Wonder
  4. Open Jenkins and tell it to reload the configuration files so it will see the new job.
  5. Open the new Job.
    You should see a new job called Install_WebObjects_And_Wonder. You'll see the following options:
    1. The version of WebObjects to be downloaded from Apple and installed in JENKINS_HOME/WOFrameworksRepository/WebObjects
    2. The branch of Project WOnder that should be built after cloning the Project Wonder github repository.
    3. The build target for wonder that should be run. Usually you'll want the default of just the frameworks.

      Depending upon the speed of your internet connection, this job may take a long time to complete (several minutes to several hours or more) the first time it is run since it downloads the WebObjects installer from Apple, and clones the entire Project Wonder Git repository (including all the commit history back to the beginning of time). Subsequent runs should be much faster as the job will not download or install WebObjects again and only new commits will be pulled from the Project Wonder Git repository.

Troubleshooting WebObjects & Wonder Install