環境
- OS: Debian 12
- jenkins version: 2.440.3
- jre: adoptium jre 17
安裝
安裝必要package
sudo apt install -y fontconfig
部屬 tomcat
安裝 jre
- 從 adoptium 官方網站下載 java 17
- 安裝 jre
sudo mkdir -p /usr/local/lib/jvm
sudo tar -zxf ~/OpenJDK17U-jre_x64_linux_hotspot_17.0.11_9.tar.gz -C /usr/local/lib/jvm
sudo ln -s /usr/local/lib/jvm/jdk-17.0.11+9-jre /usr/local/lib/jvm/jre-17-latest
安裝 tomcat
- 設定使用者
sudo useradd -r tomcat -s /sbin/nologin
- 設定目錄
sudo mkdir -p /var/tomcat/dump
sudo mkdir -p /usr/local/share/apache-tomcat/
sudo mkdir -p /var/log/tomcat/jenkins
sudo mkdir -p /usr/local/etc/catalina/jenkins/
sudo mkdir -p /home/tomcat
sudo -u tomcat mkdir -p /usr/local/etc/catalina/jenkins/{webapps,temp,work}
sudo chown -R tomcat: /var/log/tomcat
sudo chown -R tomcat: /usr/local/share/apache-tomcat
sudo chown -R root: /usr/local/share/apache-tomcat/apache-tomcat-9-latest/logs
sudo chown -R tomcat: /usr/local/etc/catalina
sudo chown -R tomcat: /var/tomcat/dump
sudo chown -R tomcat: /home/tomcat
- 下載 tomcat 並安裝
wget https://archive.apache.org/dist/tomcat/tomcat-9/v9.0.88/bin/apache-tomcat-9.0.88.tar.gz
sudo tar -zxf ~/apache-tomcat-9.0.88.tar.gz -C /usr/local/share/apache-tomcat
sudo ln -s /usr/local/share/apache-tomcat/apache-tomcat-9.0.88 /usr/local/share/apache-tomcat/apache-tomcat-9-latest
sudo rm -rf /usr/local/share/apache-tomcat/apache-tomcat-9-latest/webapps/*
sudo rm -rf /usr/local/share/apache-tomcat/apache-tomcat-9-latest/logs/*
- 設定 tomcat 參數
sudo -u tomcat ln -s /var/log/tomcat/jenkins /usr/local/etc/catalina/jenkins/logs
sudo -u tomcat cp -r /usr/local/share/apache-tomcat/apache-tomcat-9-latest/conf /usr/local/etc/catalina/jenkins/conf
<?xml version="1.0" encoding="UTF-8"?>
<Server port="-1" shutdown="SHUTDOWN">
<Listener className="org.apache.catalina.startup.VersionLoggerListener" />
<Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
<Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
<Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
<Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />
<GlobalNamingResources>
<Resource name="UserDatabase" auth="Container"
type="org.apache.catalina.UserDatabase"
description="User database that can be updated and saved"
factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
pathname="conf/tomcat-users.xml"
cachingAllowed="false"
/>
</GlobalNamingResources>
<Service name="Catalina">
<Connector port="8080"
protocol="org.apache.coyote.http11.Http11AprProtocol"
connectionTimeout="20000"
redirectPort="8443"
maxParameterCount="1000"
disableUploadTimeout= "true"
server="jenkins"
URIEncoding= "UTF-8"
/>
<Engine name="Catalina" defaultHost="localhost">
<Realm className="org.apache.catalina.realm.LockOutRealm">
<Realm className="org.apache.catalina.realm.UserDatabaseRealm"
resourceName="UserDatabase"/>
</Realm>
<Host name="localhost" appBase="webapps"
unpackWARs="false" autoDeploy="false" reloadable="false"
>
<Valve className="org.apache.catalina.valves.RemoteIpValve"
internalProxies=".*"
remoteIpHeader="x-forwarded-for" proxiesHeader="x-forwarded-by" protocolHeader="x-forwarded-proto"
httpsServerPort="443"
/>
<Valve className="org.apache.catalina.valves.ErrorReportValve" showReport="false" showServerInfo="false" />
<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
prefix="localhost_access_log" suffix=".txt"
pattern="%h %l %u %t "%r" %s %b" />
</Host>
</Engine>
</Service>
</Server>
- 設定 daemon
- /etc/systemd/system/jenkins.service
[Unit]
Description=Apache Tomcat Web Application Container
After=syslog.target network.target
[Service]
Type=forking
Environment=JAVA_HOME=/usr/local/lib/jvm/jre-17-latest
Environment=CATALINA_PID=/run/jenkins.pid
Environment=CATALINA_HOME=/usr/local/share/apache-tomcat/apache-tomcat-9-latest
Environment=CATALINA_BASE=/usr/local/etc/catalina/jenkins
Environment="JENKINS_PREFIX=/jenkins"
#CATALINA_OPTS
Environment='CATALINA_OPTS=-server -Xshare:off -Xms2g -Xmx2g -Djava.net.preferIPv4Stack=true -XX:+EliminateLocks -XX:+UseBiasedLocking -XX:MaxJavaStackTraceDepth=100 -XX:+UseG1GC -XX:MaxGCPauseMillis=95'
#JAVA_OPTS
Environment='JAVA_OPTS=-Duser.language=zh -Duser.region=TW -Djava.awt.headless=true -Djava.security.egd=file:/dev/./urandom -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/var/tomcat/dump'
ExecStart=/usr/local/share/apache-tomcat/apache-tomcat-9-latest/bin/startup.sh
ExecStop=/bin/kill -15 $MAINPID
User=tomcat
Group=tomcat
UMask=0007
RestartSec=10
Restart=always
[Install]
WantedBy=multi-user.target
- 部屬 jenkins war
wget https://get.jenkins.io/war-stable/2.440.3/jenkins.war
sudo -u tomcat mkdir -p /usr/local/etc/catalina/jenkins/webapps/jenkins
sudo unzip -q jenkins.war -d /usr/local/etc/catalina/jenkins/webapps/jenkins
- 啟動
systemctl restart jenkins && tail -f /var/log/tomcat/jenkins/catalina.out
systemctl enable jenkins