|
|
| (6 intermediate revisions by the same user not shown) |
| Line 1: |
Line 1: |
| [[Category:Continuous Integration]] | | #Redirect [[Jenkins]] |
| | |
| Hudson is a continuous integration tool built using Java. It can work as a standalone server since it has the Winstone Servlet Container or it can work on various Servlet Containers or JEE servers such as [[Apache Tomcat]], Glassfish, JBoss, IBM WebSphere, Jetty 6, etc. Hudson supports Apache Ant and [[Maven]] as well as SCM tools such as CSV and [[Subversion]].
| |
| | |
| == Installation ==
| |
| * Download the latest hudson from the [https://hudson.dev.java.net/ hudson web site].
| |
| * Deploy <code>hudson.war</code> file as a web application to Tomcat server.
| |
| | |
| == Use Subdomain to Access Hudson (with SSL) ==
| |
| * Install and enable [http://lckymn.com/wiki/Apache_Tomcat#Using_mod_jk mod_jk].
| |
| * Open the <code>workers.properties</code> file in the <code>/etc/apache2</code> directory.
| |
| * Add a new <code>worker</code> for hudson.
| |
| workers.tomcat_home=/opt/tomcat
| |
| workers.java_home=/usr/lib/jvm/java-6-sun
| |
| ps=/
| |
| worker.list=worker1,'''hudson'''
| |
| worker.worker1.port=8009
| |
| worker.worker1.host=localhost
| |
| worker.worker1.type=ajp13
| |
| worker.worker1.lbfactor=1
| |
| '''worker.hudson.port=8009'''
| |
| '''worker.hudson.host=hudson.yourdomain.com'''
| |
| '''worker.hudson.type=ajp13'''
| |
| '''worker.hudson.lbfactor=1'''
| |
| | |
| * Set up <code>JkMount</code> in the apache virtual host configuration.
| |
| <VirtualHost *:443>
| |
| ServerAdmin master@yourdomain.com
| |
|
| |
| SSLEngine on
| |
|
| |
| SSLOptions +StrictRequire
| |
|
| |
| SSLCertificateFile /etc/ssl/certs/server.crt
| |
| SSLCertificateKeyFile /etc/ssl/private/server.key
| |
|
| |
| ServerName hudson.yourdomain.com
| |
|
| |
| JkMount / hudson
| |
| JkMount /* hudson
| |
|
| |
| </VirtualHost>
| |
| | |
| * Open the <code>$CATALINA_HOME/conf/server.xml</code> file to set up a new tomcat virtual host for the hudson.
| |
| * Add the virtual host info inside the <code>Engine</code> element.
| |
| <source lang="xml">
| |
| <Engine name="Catalina" defaultHost="localhost">
| |
| ... Default Host Info ...
| |
| | |
| <Host name="hudson.yourdomain.com" appBase="webapps"
| |
| unpackWARs="true" autoDeploy="true"
| |
| xmlValidation="false" xmlNamespaceAware="false">
| |
| <Context path="" docBase="hudson" debug="0" reloadable="true" />
| |
| </Host>
| |
| </Engine>
| |
| </source>
| |
| * The docBase, '<code>hudson</code>', must exist in the <code>$CATALINA_HOME/webapps</code> directory. (It should be there after normal deployment through Tomcat).
| |
| $CATALINA_HOME/webapps/application_path
| |
| | |
| * Restart tomcat and apache.
| |
| $ /etc/init.d/tomcat stop
| |
| $ /etc/init.d/tomcat start
| |
| $ /etc/init.d/apache restart
| |
| | |
| * access https://hudson.yourdomain.com.
| |
| | |
| | |
| == Configuration ==
| |
| * To set the Tomcat to use UTF-8 to decode URLs, open <code>$CATALINA_HOME/conf/server.xml</code> file.
| |
| * Add <code>URIEncoding="UTF-8"</code> to the following Connector element.
| |
| <source lang="xml">
| |
| <Connector port="8080" protocol="HTTP/1.1"
| |
| connectionTimeout="20000"
| |
| redirectPort="8443" />
| |
| </source>
| |
| * So it should be like this
| |
| <source lang="xml">
| |
| <Connector port="8080" protocol="HTTP/1.1"
| |
| connectionTimeout="20000"
| |
| redirectPort="8443"
| |
| URIEncoding="UTF-8" />
| |
| </source>
| |
| | |
| | |
| * If it uses <code>mod_jk</code>, add <code>URIEncoding="UTF-8"</code> to
| |
| <source lang="xml">
| |
| <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
| |
| </source>
| |
| * So this should be
| |
| <source lang="xml">
| |
| <Connector port="8009" protocol="AJP/1.3" redirectPort="8443"
| |
| URIEncoding="UTF-8" />
| |
| </source>
| |
| * Restart the tomcat server.
| |
| * <code>JkOptions +ForwardURICompatUnparsed</code> option needs to be added to the <code>/etc/apache2/mods-enabled/jk.load</code> file or in the virtual host setup.
| |
| <VirtualHost *:443>
| |
| ServerAdmin master@yourdomain.com
| |
|
| |
| SSLEngine on
| |
|
| |
| SSLOptions +StrictRequire
| |
|
| |
| SSLCertificateFile /etc/ssl/certs/server.crt
| |
| SSLCertificateKeyFile /etc/ssl/private/server.key
| |
|
| |
| ServerName hudson.yourdomain.com
| |
|
| |
| '''JkOptions +ForwardURICompatUnparsed'''
| |
|
| |
| JkMount / hudson
| |
| JkMount /* hudson
| |
|
| |
| </VirtualHost>
| |
| | |
| * Restart the apache server.
| |
