From 0572c98ddb4674f5cdd1f80c30934e1c5e1bc75f Mon Sep 17 00:00:00 2001 From: Neeptossss Date: Thu, 23 Nov 2023 22:29:21 +0100 Subject: [PATCH] refacto(chore): switch to helm --- .DS_Store | Bin 0 -> 6148 bytes .old/jenkins.clusterrole.yaml | 10 + .old/jenkins.clusterrolebinding.yaml | 14 + .old/jenkins.configmap.yaml | 23 + .old/jenkins.deployment.yaml | 60 + .old/jenkins.pvc.yaml | 35 + .old/jenkins.secret.yaml | 7 + .old/jenkins.service.yaml | 27 + .old/jenkins.serviceaccount.yaml | 6 + .old/registry.deployment.yaml | 22 + .old/registry.pvc.yaml | 15 + .old/registry.service.yaml | 13 + docs/install.md | 1 + helm/.DS_Store | Bin 0 -> 6148 bytes helm/whanos-1.0.0.tgz | Bin 0 -> 165554 bytes helm/whanos/.DS_Store | Bin 0 -> 6148 bytes helm/whanos/.helmignore | 23 + helm/whanos/Chart.lock | 9 + helm/whanos/Chart.yaml | 31 + helm/whanos/charts/.DS_Store | Bin 0 -> 6148 bytes helm/whanos/charts/docker-registry-2.2.2.tgz | Bin 0 -> 14486 bytes helm/whanos/charts/jenkins-4.8.3.tgz | Bin 0 -> 74882 bytes helm/whanos/charts/jenkins/.DS_Store | Bin 0 -> 8196 bytes helm/whanos/charts/jenkins/CHANGELOG.md | 2705 +++++++++++++++++ helm/whanos/charts/jenkins/Chart.yaml | 48 + helm/whanos/charts/jenkins/README.md | 1127 +++++++ helm/whanos/charts/jenkins/VALUES_SUMMARY.md | 421 +++ .../whanos/charts/jenkins/templates/NOTES.txt | 68 + .../charts/jenkins/templates/_helpers.tpl | 554 ++++ .../templates/config-init-scripts.yaml | 18 + .../charts/jenkins/templates/config.yaml | 86 + .../charts/jenkins/templates/deprecation.yaml | 115 + .../charts/jenkins/templates/home-pvc.yaml | 41 + .../jenkins/templates/jcasc-config.yaml | 45 + .../jenkins/templates/jenkins-agent-svc.yaml | 43 + .../jenkins-aws-security-group-policies.yaml | 16 + .../templates/jenkins-backup-cronjob.yaml | 168 + .../templates/jenkins-backup-rbac.yaml | 64 + .../jenkins-controller-alerting-rules.yaml | 26 + .../jenkins-controller-backendconfig.yaml | 24 + .../templates/jenkins-controller-ingress.yaml | 77 + .../jenkins-controller-networkpolicy.yaml | 76 + .../templates/jenkins-controller-pdb.yaml | 34 + .../jenkins-controller-podmonitor.yaml | 30 + .../templates/jenkins-controller-route.yaml | 34 + .../jenkins-controller-secondary-ingress.yaml | 56 + .../jenkins-controller-servicemonitor.yaml | 45 + .../jenkins-controller-statefulset.yaml | 413 +++ .../templates/jenkins-controller-svc.yaml | 56 + .../whanos/charts/jenkins/templates/rbac.yaml | 149 + .../jenkins/templates/secret-additional.yaml | 21 + .../jenkins/templates/secret-claims.yaml | 29 + .../jenkins/templates/secret-https-jks.yaml | 20 + .../charts/jenkins/templates/secret.yaml | 20 + .../templates/service-account-agent.yaml | 26 + .../jenkins/templates/service-account.yaml | 26 + .../jenkins/templates/tests/jenkins-test.yaml | 49 + .../jenkins/templates/tests/test-config.yaml | 14 + helm/whanos/charts/jenkins/values.yaml | 999 ++++++ helm/whanos/templates/_helpers.tpl | 62 + helm/whanos/templates/jenkins-namespace.yaml | 4 + helm/whanos/templates/jenkins-sa.yaml | 82 + helm/whanos/templates/jenkins-volume.yaml | 30 + helm/whanos/values.yaml | 130 + jenkins/init.sh | 0 jenkins/job_dsl.groovy | 43 +- 66 files changed, 8379 insertions(+), 11 deletions(-) create mode 100644 .DS_Store create mode 100644 .old/jenkins.clusterrole.yaml create mode 100644 .old/jenkins.clusterrolebinding.yaml create mode 100644 .old/jenkins.configmap.yaml create mode 100644 .old/jenkins.deployment.yaml create mode 100644 .old/jenkins.pvc.yaml create mode 100644 .old/jenkins.secret.yaml create mode 100644 .old/jenkins.service.yaml create mode 100644 .old/jenkins.serviceaccount.yaml create mode 100644 .old/registry.deployment.yaml create mode 100644 .old/registry.pvc.yaml create mode 100644 .old/registry.service.yaml create mode 100644 helm/.DS_Store create mode 100644 helm/whanos-1.0.0.tgz create mode 100644 helm/whanos/.DS_Store create mode 100644 helm/whanos/.helmignore create mode 100644 helm/whanos/Chart.lock create mode 100644 helm/whanos/Chart.yaml create mode 100644 helm/whanos/charts/.DS_Store create mode 100644 helm/whanos/charts/docker-registry-2.2.2.tgz create mode 100644 helm/whanos/charts/jenkins-4.8.3.tgz create mode 100644 helm/whanos/charts/jenkins/.DS_Store create mode 100644 helm/whanos/charts/jenkins/CHANGELOG.md create mode 100644 helm/whanos/charts/jenkins/Chart.yaml create mode 100644 helm/whanos/charts/jenkins/README.md create mode 100644 helm/whanos/charts/jenkins/VALUES_SUMMARY.md create mode 100644 helm/whanos/charts/jenkins/templates/NOTES.txt create mode 100644 helm/whanos/charts/jenkins/templates/_helpers.tpl create mode 100644 helm/whanos/charts/jenkins/templates/config-init-scripts.yaml create mode 100644 helm/whanos/charts/jenkins/templates/config.yaml create mode 100644 helm/whanos/charts/jenkins/templates/deprecation.yaml create mode 100644 helm/whanos/charts/jenkins/templates/home-pvc.yaml create mode 100644 helm/whanos/charts/jenkins/templates/jcasc-config.yaml create mode 100644 helm/whanos/charts/jenkins/templates/jenkins-agent-svc.yaml create mode 100644 helm/whanos/charts/jenkins/templates/jenkins-aws-security-group-policies.yaml create mode 100644 helm/whanos/charts/jenkins/templates/jenkins-backup-cronjob.yaml create mode 100644 helm/whanos/charts/jenkins/templates/jenkins-backup-rbac.yaml create mode 100644 helm/whanos/charts/jenkins/templates/jenkins-controller-alerting-rules.yaml create mode 100644 helm/whanos/charts/jenkins/templates/jenkins-controller-backendconfig.yaml create mode 100644 helm/whanos/charts/jenkins/templates/jenkins-controller-ingress.yaml create mode 100644 helm/whanos/charts/jenkins/templates/jenkins-controller-networkpolicy.yaml create mode 100644 helm/whanos/charts/jenkins/templates/jenkins-controller-pdb.yaml create mode 100644 helm/whanos/charts/jenkins/templates/jenkins-controller-podmonitor.yaml create mode 100644 helm/whanos/charts/jenkins/templates/jenkins-controller-route.yaml create mode 100644 helm/whanos/charts/jenkins/templates/jenkins-controller-secondary-ingress.yaml create mode 100644 helm/whanos/charts/jenkins/templates/jenkins-controller-servicemonitor.yaml create mode 100644 helm/whanos/charts/jenkins/templates/jenkins-controller-statefulset.yaml create mode 100644 helm/whanos/charts/jenkins/templates/jenkins-controller-svc.yaml create mode 100644 helm/whanos/charts/jenkins/templates/rbac.yaml create mode 100644 helm/whanos/charts/jenkins/templates/secret-additional.yaml create mode 100644 helm/whanos/charts/jenkins/templates/secret-claims.yaml create mode 100644 helm/whanos/charts/jenkins/templates/secret-https-jks.yaml create mode 100644 helm/whanos/charts/jenkins/templates/secret.yaml create mode 100644 helm/whanos/charts/jenkins/templates/service-account-agent.yaml create mode 100644 helm/whanos/charts/jenkins/templates/service-account.yaml create mode 100644 helm/whanos/charts/jenkins/templates/tests/jenkins-test.yaml create mode 100644 helm/whanos/charts/jenkins/templates/tests/test-config.yaml create mode 100644 helm/whanos/charts/jenkins/values.yaml create mode 100644 helm/whanos/templates/_helpers.tpl create mode 100644 helm/whanos/templates/jenkins-namespace.yaml create mode 100644 helm/whanos/templates/jenkins-sa.yaml create mode 100644 helm/whanos/templates/jenkins-volume.yaml create mode 100644 helm/whanos/values.yaml create mode 100644 jenkins/init.sh diff --git a/.DS_Store b/.DS_Store new file mode 100644 index 0000000000000000000000000000000000000000..cfd7fabc0d262d524f58d5ff8fc12187791b8e65 GIT binary patch literal 6148 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≤CPvms1hX|o(vT9kiraMg4VFYm+i@3*;~G;hN^L>dp)7&3H&<%vyWCSn3R%gt zTOHD7>-q+}IZX74FiIkalIHD2!)(VGqI>k@)pAJjGb|&KzFE)P4fMwvqG9Z$cWwUs zOT+htKs#Uq(BI1OJsvN?8q44w)6^LorZI2h@4dP1S*a^6aBGmMxk}ChHYQS7-v^1% z#?h39+Jhp)U=vXjy)+^+oLIW+Jk-L7`iZ$L(YXS_$%K_{FysVZyG@s3?@6nES~1i2 zUe@1Ak`fZxIVLol=xs6>OiQQJv{Vp{m-{GHoJMZ1dhE6$Q* z9Sd5Ey*~deB&T7K0X)SC_{{VP4C6F|fxaeie{!0~v1%Ps+=G^VO*6%0WF-p-AS~8Q%MC*W^Ek;=|Zph zCK$J)Jl0emPcl9gCx-44L4|B1OT)0$qN<4*Z z%o&@`T<$X14$WvrVww^Y+XQMAob72l?aK5E9q8zQDJ3`VM$L{cybo>RxPeglg?v65VNWrt(5p_Ph1T?uNo0v1nb1@pO#FF&pC8(HF&Z$T6o%2i9kI z38YcT2$%43$e0w8;|%@Eh9U@pbebZ?7xVjE}#C z1k(XX+Wyj}PEBu``v2`v$st%ZL{nSLASw)oRHwU)P*YpNF66U`D%%w_Mc;>5go-H7 zKF$MgR{(tWNnh@%4aiV-35PA?^H&F`*XwVYFncIquKQMWg@Sr>8OPZKr+Gp+4T~%2 zA&PRnz1}j^h%^Yj-=Kby)Y3Cu00M15NY{EYYXiCYCHiHy_jK>WS-uh{GYx-?w4RRn)R^dygT z_=?%wE4lLY<#b@lyvAZe4;atTkFd__p@Fk<{~vpQzt*^p?2qE}H&>w@dZuB4^G1M% z`S$#NAp{7J5Rw4hJ$p_s$5s-9V;kE^2&{gda~tRO&Xt_Udb4E9juTkD*36Lo>{+xe zl}fTyDwV1}H4Pqc!65mFaH7J5oXe3nRf5gOCP;Cw#C#s3`b?kmcy>FOsyk+*ekN(^t0@VUGIrzng1X+UeG&Bnv39lUW zaRRX=@uLeZIE&FCmC?&U*EPoIIE$~-@eMHhNb&Ql$6{XS%?C3I==3y;ZdK4>NkD9i z74(tyNi_QSrWa_SgjwdvYQfnd*ee3@#}&j1I{Cy*3p4GB9``9kk4X?w*gCNs9YNEc z(JyDvgs&{i0i6mW__P{4&|w~cs!qibmH@bMvMH1F>)I$1Y@)hQ#j+JUUyvfM3q2?J zDA=!yXlpj|N1^-#T;4SD0MvszLAx6$TR~9ew^00U20gkDgtm$|0qiG7+$n=2DK~pB zf;~3aFVR75LbSD^LC&SLbrp=EY8lor&@zMBk;kd@i3ydd)?_f}I3c@bGPt2|U;1Bg z-0EV+utP4}c@DX4%!Gj^>1~rd9v<$)Xzq-l<&nmbe$a=SJ%)k`p+<&$u8vKTfInu+ zA#P8x@PtCJS$xNIJg^aJ$(x7~DoChXIB~dz^0`7(c)~VTaMeMuQ=+f`8}U$N9U&fS zT&SU}H-y~4a6KOpB{Y2&p?O|Yy&6D%h!D^1Z2*T%5d+-jO0F?{Ef2sE^!yMvCm=;_ z{Qrjz(Zn_XArD3_u!@8~qFrGhR3do;=4Q}D9Ueo^3yyAU0P`ze6`>}$Ya!g`jmrYN zu)v}Ws@fQ*^QX}b!Dx|E1a9TJFd*Xsx<9}<%B<2zgmf`U?uADbE$s4K;p$4y~ej4#e`F6hIVN@8_0^zqia$V4pnWw&4!x;*JVCls$=x*2WW}Ig|Q$gZF-GI z%ZAtP=zANsbv3v|ZK2oo_&qPWE)U)j{UNAg)kx)p@{?dxyMes+d_(i1SFGr=JB%-+ zymn9&ov^N_k-h2wg?h55aE=VFQKMhW$lX1YXw|S`#PAFFrHZRL9pwYP>TD zhk^c60fv4EavxsM*Wd!pkiME*3pYl*SLf)&snW1F`g2&^TZ9@rUgY9~rB3{j?UIZ? z)RM9Mph?LHgEt&Py@5jZyqanq+f{3hz&au$TD5FzKDH-b2dcUdMibic8E$lVT@f6T z!{}R&MTj;8Y_^!3=1Cacc5vj`XTQvB3zJfr>iDxcXAOORYBd83_IXb%8lR!6cVQ|XN zgMd7?p4%?4Y+v!HwRxLyaF5PTIIMx(k7BDSB@^z7Xx9%E4U%L*#Ztwa^gZ}EL1*~j zEU8SKK!uw4wu0HDVYrYrN&-m4O$QfNqn;X6eG~ z)UUty8qNCEO>d27ibi4W6m#r(w|jYd>A$6AG@e*}}89PhGN@bf^ zvTRFXIDU*SIx&vaK*dB;$M&EV%w`-h%sEtfqVi0pGg&ft_MrnUS_aWrL*Py<3wvE8 z-Jv)(=e~us1cot8qP39?2w@m;(2*Nl=q$sD5HCCfRdEy9!DzD_LDnQr#e{?Y4HXR# z>W@9~krjrhsR5fn@M#GI1dD_TSaPU$y9YMHNS43RxRcFL;2&u#k!e2-6eS5yf-3XcrylB0<`u{=H&A^2$YT;Yu&%o{ceWQwg|3qB#C za~>MFQ4<)E6!VHMjg8?Dx)>Y`^x?=r=1k(dH85N_Q%y5ZYfG@e`ldZBl#8W!cCG8Y-wAPYE`Bg_QIZ+^nMF3l+$!l2&Qs!74rkJ?vO&_)AcN5LQF zu#_+6%dCp(4g(D?rzn9$4D_p)7nx%(7d!)g{6Kn`;;8;8_=`BN(P1j!w-eV4{*ZJv z_ph~Zdlll^@qWec-Q*}J?zi+I+qTP}$acF<_fBrp7D$v5NbHmmh0rn<@n@vywQh)l zz#b6;S&m$NhgnWgx^FJ0M?C8ZaTVg=i$o(If+^B$OM{N@i6(;rrlL5uu2{AX3+uuE zdL;YGn-UIIs_!YPr7K)_ls@!TWdK!wf?^K&nGHE-Vb@5|aF@s+gA)IR#l>AU7}`imiLVo48YB3PWrx6zZW4 zNf644Lm7-AZCi0%2*>EeRY2F>kyNRuUt$_=)|INRgKikh6pfJz-$-2~`I=(d@#Xq9 zv)zY4J426%Wbg{Kbr1T5bxd9%iOUT%dSa85EfW2f;=4|x8M$~-Y-b4s4+)+ftB#N> z3t{u%m?}gC6%~wKdjwsGUGtF&jX-6gi&gsnN#dP^IRdG#f2l%!{Vj%? zlz;ey=EA~2fzm-*Wl78ceDa|c{OyTx1Cba3Ss1~3zUE*6TFLa|&h#>nFX zVaF)GjSLX9Rn;*R!%{*5O2BJjJp^|^#nDhG_CQfBT9vR7MYTuqh z2G%7y)4LG)7NN?7Aim}jkP<)~J&nO)pzCkC9Eg%hKu8Io7r~JOz&F_*uW%P`3_dC^ zK=`p0fwC6yt5iv-fStSsKEaBh@j}S)5MwEY6Clv}%|P?gkz*st?Pg3>AF@bVG@X3p zA5TaPp%18fiO+?IZnxINa-ZBbs_vYH3!@W?2{AR|WgEJ&PFxf3Sj1}szp)~yZTRvM z6J9KcvAks?FtFX3>T>Wjyue)t@CigTLa8Kv7e4R8CoX)l2nB_P;k;5hB-2S367qT+ z;KxT7GJAq;p`e*S8c;77K4yR{9TwfUj=ZrA%kV~Q!6Vp!ZH5CluxY3f!4+P^%7NyE zS{%B#&kt>Th`HlFxB`Rmh7r{+%7^gpMA49GL0RmBWLR3kGzt~hD+gNM$Qby*wI@i9 zqW>oHlWFb7wxcyN@#tAM`0`cLP(A2T0|d%Jgs%vp<+}#9g12oQ6risa*j!o9q(@VT z1tklE)A4m$@oI7 zG6i@jr&1s(=?2M26!XQ!^^skO-z)2QJK~Zxkt9&qzn46ut17&i*$zgR0!PuR)b}56 zGG?NqKA}cOp2qQWrk{{#@+QaSI3mY)-^N_w_9IEn?EXDHAc(oqLOPexP*-$vqZk#T zNfNuV_%=-)6lsZ`NC^?KH4YtbjGxdbV^4Ec2R1Apy2yEVuSg{@g^%TrRP63&!ntF_ zz6D2^W>P-{(a~Kzl##?=+)&cgU%_)PWhAQ>P+eD@qX`jmDP|7i_dV!x2?D|zY;A^* z3OJf1Y7-%pzaz>8Hj)thIwZhA$WD*@f-XjMJ>nql8DqzsvzZ=HqS8d@JZgf|lrm16 z$fyd_MohuRO`2SenuR+MeXAOA+QDAuCU)INyPOC5aA3O-Pk=yZNb||jEDiX!MAdcr z9bDW1$|Zqwx((ng%mBqHKo|@PdlcHPF*J}j9-4OG-tPau|M&lcP5xA)@BoV+XR6Tm z@BSFU5fTQ!-`oA~NR>cbP&;Z9rIWV?_N!)x_^)-+)9-9I1$^hZFWW@IG5g3H))0Es zIS&xo+KG@}0|0OQZCfW&LMCtUrgyzAR8 zQFJI4aPa2*!Q;Tx!N-ruB@m7>!+yVi@RWgJk~2r70!4S`N#`<@#7!WUQ3K3rpPMNB zJRt*zE29jH{96ioi)>USc4&;=CqBSA0?EdW1bw0&s^mrf{(%@7IPV>iH5A~4kh1wo z*o%!h5c)Rgs~+5|fDNFjk)prRci5$o0Pq2O;s<{c7(O<9^n)IuI(194_28rb#_sM4 zlbx;o>uR-HZ3O>w6#P&1y4q65w-dE&PPB5%xg58q{h-WU*)8--->TK>Nwrt29kq+I zQSRn-@ESD9#wB@pLL5)clPzMJJsiUvvzdgZ{4;A zv(ZVzFeX)Ko)4~ey)Gi*QdD__=+ zcgv%#`!APYyLZ!X&y(ZH=+o%y)u-KYsc1Z$>|J-Z^qx_P<&nvyV^H1K@ z^>x2gZy?0fqx&G1J*8EbNGooevruOBkS>3wdYTY+W zNB8da!`J%m)b9>jS9|8kH?7f~U)Z}&@5I!q`xC!-@>I6IeL5YT^{kz8&4G8bmiFz) zDh)e~sPpaC-#dP~y?q$Hg={L_4>$pDA$iVCzV0Z*sD}d zCZkEY0rkC7=~LBI+tWH!x2(O>%Jk@Y>r>}$a$6gJyT82I+8=!~8PT)(PT@|!Y1@s< zU3j;D@w_$aZh4*F$@5@xP^)~>n-AA#JL=wGXV(3?HJ%KN=hn%=P5I!Hd+@1eeVuQ$ z2gm0Z#lGjCGNSF#-n@PH^y&EY%f-`T^fv&#k}di7kt zyQryJ|737`R^Mtnx~olVx8It_&nNb<@wi)mJndb5gJs8VJ4d(mt(un?1Ml|e>b`N^zp6byoqTz?ZS?HoQT5xX7Iy#Z^ImD@@7(C0V4?6l`f^u$ zsCnJnt;V<7(^LC-R6o(TIw!aHcg5EDVC417C&TLK;Y;n_JMCNzZ4-VSs^8A6dr=t0H z*OkY+{m#wqUZF65EP3|H*J3YR`-4dt8pR!TZ@l+u@O5&x=k0%~*DrQIT^ru{U8g#& z_nq0K0OyYbZ@=wbZ#{R1=V$YWvU_!~+j!EOe!br9mrpwrJM8|Ew^coB>0eKJRb%V) z=x%nPPwT_S>tfTH77K;F{!zVf(y!?I{r$o2-sGlbS@r$#iFJQEKD};jHK(<`vNM#3FI>`Ue8VDE9iyt8W?)f-0CxPI(53ZwbS z?)=iZn^mAcznOYZH>DH%xqoTb?#}CXTD!Y{t?Es;(`j^{&IZM=cE16y z=g&J87Y@U<@0T9C*E@Rc=HPg*dUiSdviI<4nopH4#esG5xPR#nTKj`)+3@emd(*9l zYOj2K@@?nw+o;hx9oU1~y;^V@y;^C~s&dRLrujVc6`07)m+^{Y`mA_4nw`K)>@b%!zX?x!F{e0)ixKF{1tIm(zo@&RMHagy%i0R6yHxy?S&zoV0q?-DjLy(N1Toje|m; zo=%RdU0l&_*2<3AANx++$XN_3`o1(c`zfU01!^eb!HJpY__V z6Lx?6ZQAS}9iYdepr3X0>a?&1rphe*d*sziw75Xc%hM*;&85Tm1Uv z-044u&yQxaGyU`++@ga*{pb2k^QeI<4riB4kJ>?8KArZeU+|DLoApz1NG`|bQw1Cq2XyXjvDvT4_ZH|Rrd6-eQkJA3l+5MdbL=7 z+}SOk_s&kIovY^2sCzc;PPe9(ebqa@==Pq=>gBan^uM}|&SS^k`qUqcoA+NPqlekI zcGs#o)0@*)^?Yl_h@QKCL4R!8UvKVfM-TUN^SJPMHnzUBcI&flNox*E$M>VX-J!92 zetvm!z7JcP-Syl;v3kDMo56-^mhR8H?HzxoeZq(y+)T@*;dt*!AMc-8t&6?AJLl%+ z%jI$JLTz}3dtV*iel7Jcuj~W6ehV*K6{}aSeZ713o#s@p&FjZE&%?TY+#kDbM)YLY zy0~dy?2g=%N4s>a?YcLO$~SLxxpV1EcMd+O&8O*}RaW)u>Ev>2>!#DJ_rH8O8a-XP zy*;<)e|_$2o!!C1ta}hjetqZ2t?bt9yQ^#0E|$-$(6Mid&FhP=yIW7!m7~Xl>wW*| z;HWxl99OTaN6l*SwAOt*?Kb*5$Jh0v+U%xUtu&6R*VS;3syu01n0!M!*-8y*y% zork;Ow;SWisnlENHRID+#fNI4U29f$4yJqa!o%RcSFj(h?1z)-mrt!-RV`h0pUbzN z8_Lu1r-%E7wl^}W`~8dO-k#Yn*5~&(-O215x-7k!$#_@D`v^%d~KV7w* z$@oFl z=g&>8a&mL}G`MX)o!?aMFV&fKer|l*nLZlbxq4LmI={Kxs=K9dkJ@WlkA9~ztRI~e zzulVGEF>AKn6Ywu1z8NDz5nO?YURhqNr zd|sOQcBo8@zE+>Fj_uO9zkA?lkB=AUb=51@3g*dq{b*<4&MJ*@>uGn;GS9zWIZs>0 z{ovX=81Ed^;Pm*h_<3y&r13G6He#th$f zpsKT1D9!Fzed-VwnKs5m?E3B@$nBJKD76d%bFnRf-b^+86Whh0^@m^&0WMj*OcfTr(#l`G{G}>w#v>-~;d}W>BA;gY|9V!`uH58PexhoFkVA1H{S+c&<&L8d!5D_+}r)2m!54xaE0t=d2G=oQ7I#6IxO80 zh6?4g0(#g9avjBc<13cn3z$%~z{KILawwnZ19HiRs%KzlUYFqe28?yoS-?Jrl=_vX z8pOz<2!qKsCu5qtgLex;$tFU?D<0>Lc-=!Ch4PcUkJ#YfRGn>5A3Og1*l@Q2f~-~j z(Kcueylv3Ft!)DiI-<@UbSsqnHebbktJh8 zaY$YuBV8xYsw4)zUG1Hb#ZRJNQ4UY!sZ{6_ z*b;OBiDSqDZC~|xwpdO^hVxU8wer`$UP^f_@Vm>O4oCAw79WGo+JdYpO#+tI_PFtT{G? zJz}ZaK^QuTe3)z!t{g})plZG`#epg=oOlpSEZ;DrX(1UuSXPh}H6xW}hxH6gqmZ@; zHV!&q7R*cfy=)5@2*1zJP1wW)Xg2bWI>YcbOx>n&Gi_VPh$S>+6YVm@wGrWfpo1?9 zsp1au!BHc>g0NplE)Pn;kK)@3-VBjfBjwJ^>@F#K*PvjuNGw`m4WO>a>^$N_gq*P+ z@mrlze76U~(hq~NqAStiGs*J-XPgHl5&^jfIOo#I1Dp6l9fDl_aiW_1I~t6S{!3;$ z8XSDULylqeLt=Msv<}D69a1Pp^p4M4isA+gYXn^*m?Zp>%R9tXgToQU#wCN*44#Kk zSvmTeFF5fMe8MnPC;FPEh14|cMM%np z1;URbh^VCIIKfO<+!0?gd7KN*4+U=o6fGwfQJHl*^1}D$QFt}(ZIaBUQW{Hca)VPt zruB-DUS3wN88f&`%3cN{98)Z%6=B3m#d0N}wzdw=AP%2LOG6cRYb=-7kbnG~DkfQnt4J;cwXmp|Nl z6jcDjY(hjIq8ZJDlL=>;Ayp)MeNb?X-|1PFYRh!+Nlf9IMLR$CDqjm1NTeHNx+eF7 zFCgKGe=SUNj)&Y1xkr&t_4Vi!M-TYJ7j|Lh(mTkmX4lt26^vDDg2DqREMuEi@&U1t z1p*l%>*6{cnodWOJ%Xp*7*LQsWB_BrlwuaMmWf9_wkWaf9oT2fn~=ULyHg?q%VQU^+~o@x+It~MO#KloEt-@92``ucirtU zyaNl{fX?YfeLHvw{)XcFy1uGCAXM{p1Z5F2aVR+)L}L6fxE3)Bcc7}@1xKJOOGBp^ z&v*`=e>x=skV1vyPe^b+&|Q&jK{Q}V}p#!VU?(*JW^RoF|_01 zwN2s``9#hnAqPb&4FqS4FBKj=@@taV5m_jAWgF$GL?U2X%I}f5?s$CZ#{>fV3nIb! zeN~hnzH# zZp@_^Y_tJN;fA16@H4XCkzg@&E5Jd3Me{&&{u+_z06A}72nVN9j2AW^$@~YLsZ9!BxqzVK@#^MOqkfo38WY@NKGu9J_a<24r5qom~bKjoWBSg ze)%B^O89C&Kb*Le0*6v|2y#VG2EPRVmy2$r@wF6NO?(``Jg%N5;vC>0&=9&f=uNQS zcXzlf6lFsl2U>SI6qJZK*R4&5J;&gicp9 z+A9YiJV`-Cb*S%sLs4YLmeL;mdZPo-M#%!2gOqPFepXs+=}q2xQw$DsSGlA z7M8CLqd*h}s$tSNLBp~qo;gR05a+GMbv$47Cx~9|L^Vu^Le=oa!ZB2J)36}(Izkpd ztjH68F30u^AD_}deE>k=37?RMeUG9Y6m50Ou(*={+MO&C$j0Vs!CiN;hg1Ph1(SmqX1->g8#z z9T{6xai}@m(?h-p%Fl%_UD=1D<1S+*%o{2BmOvY+P&FT~hAzuJk8`Pz za{(2t-XRfz+n{M!hK>HJK2KZ-j!e5xPmkL)78{x1=+o%3Bzf+s=>_U}aBFx55lEpd zK;y1MUp353OV)enTgZEwb^H+Iyqyq66&-B~ycj&OvjD&w>XInGl?QzSFF}c+d@~{X7Dm(dN2&#icrObiJZ+A; ziwAlXp4oykFDT)>wxl@ww`8*K-{3yoPpO|Oa*edm*Md=NBw*~o=`&%5fIR! zMZ^q^SQbO9q=^+waD?;7tb*vg1ht7z)l?K>ACyE<_~cMlyK411jiZ}hqjj1e>uW)w z;62&ym`m=!RmYGeF7K=8nys&fC{RbLH$tHMW27DTNWCrsV+I>X)n0dVjWe<3g35*9 zfA}4^ls^b|;J>{8{_}pbk!sm2Z$CBsvb&%{>#A4p=KUxC6>SuY#o}J2g8o}97Nh^& zuaql)DOGmM`}>vB?%w`iilzP1Zt*Xm_=f#V{7pPxb^lU)bz9NS{hRz=UKH@b!6=!B zpJhPWF)+>Fm>D&f1ImvdYlz0gH3I_VQ7I2jG2o*MKFR^QQC1qXCH?sE5#_^S=oi6> zmmEZBAd%*qNOA&23Bg*Vc(m*_2BZaw;RA1~6*7R=0!3qcx}pGdnSeq!+=*2n$qEY` z@VqR&4)_3mK!Ly8-vHD`HX0RUAnQ3rU!>rFY!K6n`=%!j_h*vzl|h#0GPOoOH>Cwl z52g@aovx*WA3xU0RM&fX!PNO?@%vM9sHA=sHyxCoV2Y}RbAk9>lG`4S?v_Y9@kY=z z59uh9TQ3jfTDFd0gr!{|s%~%YKnz_BpOBi`x;n0ZZ(ntKpFeES$v1@l3Uki}!4bq! z{n6*#OWt#!mJeF+{#pE2-Xg61$T6Ke3&QedgwIAh!X-jge>Ja$566g2e9F(O*d-UD zXXGD0a+@jhRsaSfS6>Sz@CVYP!w>8eVkfX-W!8(b>0KyefN z_z`SN_&<0mj@nW%wgK3L1`*hnCPz}zvKd_;j5xXI|mj`|MU%Qg>fvE(H%~{ z^m~lrYltU}VW_n%J^ORdhQhk`f8L#}URq|ZO4<9ILj&Tlf!8Y&FOc1+yWFt(^jn`+10z*(hngPzR zu!2fZiCL!AZQwx&bX%J+FULdf+seJsaI$o4T=b+itI+veNIYDLhSF!A`B;1%r;j5+#Rec`HQ;Pa4EVGEvl=u!s)#vrM z{t=1*fV*m^)o7h^P9E4tlQ{C||MNfpgH#fX?{9k~#Q^eEL8dMMA{0XhLr&XwY#m+d z(mN?V4^nkUI+S8*rgx25MezD+hAlbIbJscLD|Mkw6U- zsve&Sl0-1!5z--!dPC0roQjEYi}4*e%Gx~cBX3H)!WVoeqJ}C+fsO1%>^=KL3Q6}A z6kJqF(8O7#4(?-~K_~O2$-qQDbewVI>9&ylNGX92-!T)*<J=C#s3#&s4|3u`FwM5KmlG-Vdg4Fnc`Ehd2wgXOD$kgGd}; z40LouiSDdvwjIL*8wAYyxYZ5HA_oTtYMc4B#z2_op>~9`(qjiNU&wJ9sFx~Yo^YEu zqr)?j1a&Mx#gKG{fMD#9!Xc@>^6&0s{-iPUhr%ZRX) zRa^LFtpojuOH!_);~zUgu1O9{BWRAPR$_SG1bT(t(%$|$`dhQdfq+x?N(ZH#{r%m8 zo(FhgPo;&YNVagi4QJImv^LsA)eBN0Cv ztOtZr2^-mHGaHG6#6G|UobxwFEY4rJJjsF0baBY_0f1BD_KAS0*kqEj>#CMsHJy># znv6lYobbsqOVrqe=58*M=iF2xcxTuMhTl|x$DL(_mk22lg#*^mv3rT{5?9cz?OLU@{(>P zT)A(gXW?Q>T~=Duri83)Vl;8`TGLcdqhY5WUUlTvA>rhMXbe334160w!AbgqqgcfX z{9+5v9UF=D1p6h$FW3YdmhFR$(7rA$c9@GWy19v4mY0^QwAmN}dGH&s0=aJapdx&+ zCHhLuw;iaO<9Hv1*NJ@-OJ(bmP-kIZhzY9$$8g+-ZZpwP9V@s<$eM7dYV!^p+r;Y^ zaa9kEcK{(b@Gm3T;fM#H!0#9ZjLBKV4rR964AuuKZB52?^3Y4F#g`HKgud8=Vd)JI zx{Ff&9-^DMd)u%;4rC<*ejpeg+3b@LAhzTdI#{sT%vYkl z!C8o^`p3$y?{Gdt?+ z%paRgu`b=1T>O^$Dbu_;bIVts&Wz#6G=?J|%?B2q5#8I;J00OU-rYza(QOA3_6mnL z!2n-5I3jnU+;LtIeNo6_uQRJIA zktF11j)=>HHm6bG(47~JViZ%D8-Wn0rmiJUMsAl7M~Z<&XZsEqCpaKa&R(nvLGU1uY2%xgS3i$tK0cW^z1)fkYps6APCTbl+M?VhCCnuZ+K1sEO z_*aWywuo&OegU33g(9m_o6`sUG&;T@YM2@lTkAIX5NTDYo5&DtO#_81X6OummvYS?k@r+LjDJF1U^3WLQEY;rFzRAE9veo3d_J+-^$b(e-E`jghQ*H3MYmj3gV5sKa zHg@e>^YHy6!5=oPV3W`gP^w2RrHTuz!kA`DxEN+vwZwTG6vJ02O*;3ggkI&O6Dd4T z;A+Z`9}2zd3O<`f)wJYs;lMFPL`RuDd_h+QnHe;tNOWf=aX1}vRfSn93OV!*V!P(x zIM(DMaRTE)F-9k%mXc{Hs-hDpxt5JB7yt|%Rq;k@d3Vp7jKN047KL~q22K&HF?mp9 zz;;YUkLAya)s2*(y(55j@#5~#<6V$G1XvBCT#X)tWY=%gP7=?6 z4_P#q525A~en3ulAzHzQboB+q^cPu$=JEX%M^YmwsgW-RlXR%VVRl@b~L9fmog*)7j@(ohQ;R{|GI^GZ|{7Aa>b zgt3yAPB~4HlauBYx%XxBh24n9YeXqxW@_Xakg3zNgzp! zgwNt7FL+w)5nnD$Ye|dIC*0@887~*ugt?rBadS=hmJ}y2peRLSxm4M&eA?No>?g${ zika^*3GSJsMOlrsdpyppB;qC$e#IApEn9A!l2H*DAW4vND><)7Ow$tIVDMY$PMmn< zz$YHXoC&E&X$SyHuZkk{49y3*f#G_74ky2lu7%W_iFk9Nri4&jFh^o;rk0>Q0U?M&g}erEo~2kxo1n#P!zg=-sZOEjv6}4L8+B`yP9vH*A2G?LG?B?joKz<^H3Sj> zD5RYY_(<#I{ka1{j^&O=xF%tOXObm)O+1iFNzlyBm;%kNvIGH|-x(9237(fA&>CP^ z7GMp$C91V=Yq**tODB_w1PP!-RPd%CZyzr~q3(|#d?9f~%2z-A+EEt}6gv^H7Odl3 zKs>i8-UQGkPBqJDXaZ>i>3D(&2rn^3t&uCA=J1i`4k79_aV?0?1dr-RGnn)8j)(A( zk|5tJ%x4}Bk69%g|4s$u;qz7xl7`D*(QWlf~e4y@@7rYb%Y351MkfU3*#+a zZRt(1>6E24y0DV;%hWwpI`cBFw4b)lR$W$nnrB>jj;kxHLQ;Pbz(b%eRzLX_1HS%ZZo1QI6h!T)-+y=JGKm@|nZA%O#rw=b2Pwd8>GN=nNkc2@d zZn8#YqE7Ab6^dLt(p8C~hXajHBs9o6Xux z2HYHOBA@koZ3GXC#t|i1R5g^*gQ2p9Zd!$8Xe6~MSe;@>MKB^RPmT3Al9Y(rcp{mKUcz|qH*6~thQ;#j zL2G*A+GA$G5B?EoXJ7;C>8tjGklMsmH^FZpg?ngC#e_xetK;t^B`>q{W6r2bi%{7* zaKQUnpl3L-?il*2uKFsH>H_J@>QVi2O}IZ;G{blcThU2NmyN^N*hb+u85#r0c?;>o*n;E#zR^4Y8lj;o^h$QhR5=fcYq z+=FJlcXo9g8KTQZx0j0@`&a0Z38B+7!UJ_`tKG|by)BL}di1^5Xx882Bl7IzWG(>7 zV@HU_hObk<{(jSm&RycHgKXv_+w%`!`1lR!*2qFQ*uIg)n@0KZqu`>>DN>y8!v8Ng z?wKk-^>6WcT=>|5zB?yYb=gM}E<09{ ze-d*mzTIs2aEz?2D^XP<2YY;FyJ123BHTo;uy&inLyj#k<-ddEOX z7TXG)*6=CT9Xf3B={TpQwFkq}4*|QiT%)SwAx*TNC5?|T zvBbE;EWtiuT5z;1bMZvxs41-d$*JW)o~mh*>SNVXhfr7g^IXKMf#j`cJEEjA^#_So z6X5MIoGU*f)E_~FG#e(2ivbdIhhxH}SbLy~ac!2S70 zPwV$z#$Pu1zqH5~e(CbRRNUE#<^SBPl;7q5&-kIE4X;S0CILkyez(owUH-pX{v*%{ zbN-zyTW`d!ls)JJ1*VvKN%Vp746iJWDb&UQ{1YgH1Q1bC11~TV_`n-5X+j_B;9q|S z{s>w$ctac6{E-{XR1Y{VoErATGv^@WMBfH39AK<+-v%gy6MdIsp&*72ifh=gwHC1+ z;HC(M6zD>K;($BjS#@<>eI2x2I1M&4{vFO`}(a$bqrp zp&3YXh6Qgm2Nb5NOGle5ILcMtfATYRy!~Nk`$J{(@8HMBzXNgQCrBW| z)}4whu;5?dZ+{EQTOjvggNFVoQ+Bw=d@Gu1Z011u9|avw3)aLmX~hp4v>P8b;&p&R zy-YSYff8u9taz@RFXcfgbV6K=4LPp0s=^rN}3O3 zVqT&$;q+WMlW~PE%57*sJ*>$ZR6P1JTp@VALDQp_mcqnyu~8IdyC%dH+5>L{e#O#g zLsPR&X}u}0tQs$|z?K-wItAoH^^%K8 zkn)kpRHjm?`3ugyxisIYE_mVK4-CujMhGp6*H2 zs_SHav8+qjsuIwjL7=+O`sf37;@jlvA=uGue+1o`;bHdz$JTMCB^L&VA|Ff~+X7J4 zMwGNRQmr98Oc^-YG(lZOcwP#5p>W4a!Rb+s%ogTx$b;XQg*|S3$Y}XU$>zYUAB;1> z_L0T(0RSfe35jL2k{3RJ!vI(710_zj@=n9W$3=;)AQQNPhK^gMNl&c!5a^gr8| zH>Zsjs9m*AE*rJpzd-8Pu;dpXMaFU;bBh~ePja9?@j>#S#L~-tjCC>hF~3}kEG=1b zv)ETI-Zk>&;|&f}!wlQV6s0`sfp`j~&g>wnCRPwlorB@s2 z5R2+{>_(AN7jld%yozZ;Vl}>FiG~(3F4kC$^Q1&aD|SN6b+oVtT=Cbk&y#xHK1J@e zdN_VF^LE8mdn@tJlYCvDE^SpmQccy;pxbCK(=D;)TlFkL^-VrlH42Ws)OX`*zwzhe zDQD{_!HCEv6%q@twxYCE!~lV031cWk`-HSuz8*~oBy>w!cG)gj0uf>}{52tj+gGIa(K14Qtq1j?k<`urJZQx+7AKRx;f*D(zjG=`mtnBMcKEK;n zHEI`;O;P^+vLk`&;&8!VQ4*i3wYw;w6Ax+l z??v;LtC=!wRRr$dv~|d0Lb>4))&VOiMs#vG8TkX z%~U;)E4l$6K~BjntU{bT_(vFhIF}0%N|K5saWArzl$h~PrzS1h|FPTF>!N@b?EgFE zot^0ZzhB;Y-~WHc?}dlNS(NuQi$CJ){qSf6H%WS`D9Rf}8^yAJ;z)i55k+F1|LWxs z@0;KQ*j#p-rWh!hx9XIg8qpGAFoXd0rFLvw6T?z*h}`_+&@Qp^7XINCd-#WyH*uNM zpgc4FY6vzgjXs@ZZ{jGrv=i;`z7lf0w9owsr~muR|D$LA+q-ddtKv_i75(@87V3Xw zI-u)O#aqb`v`GKk+l$(NO8YzS{+~bPm%IrHm-*anwR8s}GH*o?5Y*JWIpp8P9Flfh zvA_jHVsxXU6R}_{K{G8J0NYhEb6kJ&p=+sT&s7HlL*rpFq3ji(ICUwS@dzBpc0)L> z;2(zxk!G^I;Karf;-;=pnOad)OBd1!Wbn@dxt6V?6qE=@4Po<-9e=)%2CcTa$wl5+ zFX%f%hL}6O$LthPb$|%LTT)*V<9WG<4;MD`i)>(2m z5K~FGx16%Ehpz~DF3J9l)<;A4B&3Am4c&{-Qxqi;?fiH7{#n;Q&IO=ou5I1h{pAjU z3*!GO<=FZ!@9*rtum7L%dy(d=fb!!Wuba5Gb#C`L=Ul+9>udPkiibhW!ux6PPjnh2 zvm&nSQt|0&BdAYIQGKQ9L&!VvvRJb%ZQ{Dn(&qFebz-}HLr1r+s_Prp@EEGPX;_dY z7B7{HYXIEaeHwsXqM-ZPB{7_NF{U%U0EkM zFF#i#?!}IC!ci0T!n8j5EQ2)hU>l{{k0-te84(j;#D)y#GrNHE2yu{eVx%cHLr!di zjXsB09^o{ZmhdSyqx}ZpC6WY?eFPx^IZcpIj5ZugFdpkYIZnKFtP+S?#-cW9!RG^ z8u{eqn9`3#X%c(Lp!WrKqfqcn2MB*$=A1}x(3`vq9osW}oFM-&sg#d^0&)Unf>w73 z{)uu3D!%GHc)5QGWmI<<8D9l>#@I2Tj8_FHR^&lO4Mw10Mjj+@^q(cWe3Y8PhCcF! za1$%6Z>Y->`TT41uta zl#!~G-C=Aj#KoAp#u8Q-OZ~HuhcKZ=V(Sa`-PC0+IV=#jT^wdFtHb#N#k0L; zrb2vzCNQtgJnV${Am;rCoG7W@b-!0@wR*Sv{i6Q$d*e7VB$8Z7^oP?&U%+`JZxa25 z8NMX#D0e>dsm(6X+0Q&tD9Eu4;_Fg<8LttX)_=?0Dp!_!1Miz{tq=rb73I23^jUG3P<4d z>gx2e{=M36Up8vhUgN6uz1FE8*IT_t^|C7)heMD<(3I}PD&XFGg|L5xup==Ba#=gE zjN&8{?O{frr~)o}UW=4cBz%`8`w zaG8InQKTy>X|dzcj7~iKw3Slxl_RMR28M+)Wb@5BwqBLK0KjqK0J<*Jk0)+0DA+1x zSi{E9vf1PM6VxVw$``G!fEhG~BmWSTip7|;(S0YaV@NLI7?cw|)5Q{lcjUU;b zkL-_tefHbUxA{a?QPCxOK z6N`FEyX_)2@LRWvT#sd zz(HIPu?(?YwxUHAA_b(!`h?SX5?R>=*tzZYEE9{+wl_-DBuT+UfkK7-N&v!i=jW>OiEqN9;DNX)4d ze`LD^!5{gk75gr#>hAo0!~O3yh24o6D3uCO9fP>}fPd!D4MBMF2LH@Cw(jM& z(QTbqFzq2KF@jFHIWLIv;l$DrYylldY`%f9Wxi>i{ZR* z2D#BpoGEJnaI$TMdErg^_fYfET9NMjKXbo-KRIOiW!3+~X{M+qMD95Xl8YHm1B>u~ zilt)I|F`s>|MTbkUgDTNoJ4V4dkp;%oP-X*>80r0KvP4eS&ePW@NL(yhI!3)p&bw! zhg(#ek?KrV)vr<_88}WIp`{2yyeMl{CL}t{yh4DzZ=ZkA*(GLePs6j2tb<@mcvY4Y zNF3qNF3v8>qL;&=3j_6h8xlYB)Oec270E(q%I{m``){@VKTz19rDw+kTCo3@_Dj+H zKb8Icz4!h9XZ(`)O7SyihzLlkDhm-f!X+?pNkUZ5BDyO@{k)$>|1>aqi61r%Q*TkF zRN$Q~jW3H3nTgOs*uTtFg9>lCi?1O617!kwSq^^Ww?O{yR*KQ{AA$sVm;XQE7fhZH z!P@R2=m09H4?i&DG@0bl- zEVfs^?|c8o`yT!F8F#!$@fG$uHrZC+7cI9Kl?e1K z>j1g^0YCvG-*>2gi=+A@kFkrsx2I)bsKXz^ zor$_bPR4x_+a&`9#f^&)EO>Z&2+*W4c1*|;XLKE?83RLGlLwO#YONKR=NQSz>ryKw z=uotSi{==u6LV-H{U(r+(LlYV*%L0ay-m?XsATHG$o2$JtKi>wl%3SZS-pJ1B3axt zz1r;9w$D;2N*C1o>iF}mj%6lG^h>WkXMCze_$JwtvaOY%-X>~Swkf?k6$-x<&VNMn zb#QvM*W3SgclRst`@iD*`R`}^BFj*kGB7-Z2$}Vg&NfNe`vNj?OP@^rRgGo`9L*jeVuSS;_Cqy8V|{r&gz-%t6a_)6OPvEjKB zCr~MmCi)Qi(fhfdd~ql-0hUV{uj{b2BEtpX?y>||y7ZF`?t%-zcD%}pQ5=rmf8WCX zUA8dEXf2pWscpv+J)otJZ6pYqYA)SeY&yKscM*k09$5N ziZyWq-U=p+Oq1qS>uM#a z`V$?5|4V->?EkJk@!>KSfQ9iN`_c3N&d$64@6Y)q@2dDSCv5uorR_k=8yN#X0y8l2 z-rG(pgShW(KInZ2kM3kHHbpWy291T+h6@~48HEtCmW&n>z@A%U3hswFL6@5 z38L4kcTYT5Kke2j)~I;jl%BwVtL#EFzYHr(lEyvaBNQb03-+X^iOg+}q3;@6C(c3a z#Y%kK+kG?}vKs3WT>sH!9g;d!N0+bDNGkK(`>o&mZ~5OU`k$}*a4<1F=x4hHOxOP^ zmEHZA|Ih9_{@c&_QQbi>*H+sNqTqS?Gu1o(p=BiQ#uO*KmBHa}kD=pqS#}a?5fjRL;a|dQ7tTVIpE~F`i1K4qIWLHpNiV z2qRR&r8DH={EN^P4b;Np#Cr*O-9@p-3p478+4NGSk3b+CnU$E4rWX`a3#PKdSAQiZ zG^u7-HcYdb$^)yo32mNE0&19kd5{dgXXw~?Hc|( za*qd4&e6!LWRp%JjU_noMyd~6n+7{5d<#u zd|(fNKQg?aL&0nT-pHPqI_N{Bh^ZRXvCYXJK@c#3kOgQZ%^r_~)@%!+0`A1BdN&?) zx52AZk4ItOAFhebAE%FqV zZrN7Hwta2}{8He=I!E#4h57Xqr7m-{Xv7OM=%EY~k(J++z9u|x#^$_b`(Oh;f{kD& zO{ZJjGr8mh;C z67Hes%#i#wcsiV{NfG10ei?i_)v%!Jr8$mh6VJED4WWEC4Ng{5K*swN`QT}n`-ToR z)kV(+#;`i^?G7|;RgZx-M}6~f1zec%kpmm1;rZYL$Pwk&MFo%!oC7)ZpUvo4a+fFc zyU-lNxCXa;P>SKi;|_Wo97zP01(>EGaVCrrZBI;-&cQVDVL2dDN%_`vd=mFp*&e%K zawZa$XNHzeSAd<=$Eu|tf`5XXH_B~;9LlLrzVmnd9Sf@CnDg%xu6~pQ{}P-}(oa}y ze$=h$iEEEV1|WWjl+lfaXpnJgn;^d#PX1`06MDT2%Q1FWVs#}p!{m{v(3)IJ9a;k{ z#+{Z{i?H|-LAFhH?oXu(qMj!ipx2Xlv{pIC;(M$ zFTPtnvt=GwSZLAPm61J;X1!18oHyyWBWT3c9c`@uT2ig3>O^-Yq?ZiyKgM!%ZRPj~!`c zf9xoD(JUd{Yhe8_1UET!MGg$oHM#NZR#n zmqxmQjo^^6u&{1;LFq2kT<9a&v?*)*1FCg?(LFX?wDJx=BddVr4?ym(UT$$iQP^?W z$i`Y(ByED?$^)ExK@;iYsBtQ4*uFsTUFZ58b*^;L=NdY!y2FUTRNbL>2>u!Su*8VZ zRZKABCzB3-Icka#C?Ow|?Zu1oU(p_uu$ZjtGd4PG_MaFglq|AB_I0+f)W9$$9@S*L zK~6zSt8Kgf=a-j-#Aw-I+-O}dxpEkNh$?&}6)3sSydYph@#DwGkTxyaRy}WKyZYx3 z8|U@bMWfaIe%9-?yWcPBU%S1lPW^kk+U?$5b&fZ4^6#};_k|wB=w_e!rZIrpT#HTy z_IQD@I;@_k_GL1Ja;D@a^t?d$#DuTBOa|k0gyO0UQAwE25|OK!nPOCzJ}_xZp6{|q z*w-BH&=GBU*2%$QDIQ;U_>}8sD)U3dnut_OgHML%8`cmPNhebm%1X(p`q;1tt(anh z6@zZQ)~WZpk$nRhu@6DPomd4A(=UWAXH%vz{r1)I_g1x8mo;$00bPf`fdNgOWWtxe z!^@Jo2B15AY18M`+v@kLc2ej5p~M=%aY-v$)PQoVsh*a{#<9F_KS1mAhYdOan}9{? za5nm!bicb-r|MPY_FCu}*$UpKa}vj5MRCxdpEJ86hrI)eGJ}2Bw*AlIIaJj~urO0y zu(4IF4Pus=^azHeu(MwYcKRCawXd zEHu2ZFW@|3u`%DiEF(bAhe)e=@TlH`c_VsQ!mhO%q0Gu?gy5?=l5>LpTo{9j&vW+= z9su#cz3}${lg~~|4A%vW9<7oTLvFETY1JXkEU_`tYYW)|sa3nR?{t;au39IJ(`9%| zmd*p))S(N0WAbK$J8T5fnpnrYob+}xG&5~(BDtL;4bE$-S0l~exX7n!`{f1P+lB>l z+fo@PsUjUc0mNO95i3h2rs~k3(k0G6ndVZqCipW(mRUq45{s5eX)dd{mo|V3DkdqJ zZtP8>e`b5Wyp0iglZnk_GE3|8_v0rSrHq4@P@CDS#!pF~kTYil3iZ=A_~0bNe84B) zRfCo!%1@k8L@Dp2Fvbee6y)*aS(3>Ss-{0`yLKN+m1_sR;eD570quKAF_#TtMKodg zs_Rc2)OwbLYM7ZkUyVP&Y=V5;)t3HDV+t+kdCN8?)RVPFe=byYW0e-fit#2E->$84 zwH1;Q@3VflJFIt$`0r#9m$&%l_kY1Oy|T>tAsDEp_up_k$oH9Z_>p!v^VQ+1_kM+C z?&Z?I)_?KE+p2y~a$JoVdUWLy(_QlLXEE?CTv*ec&6HX~yKSJc^F$HB@gR!P>y zvaY*7|JJ)`)6KeeQw&S7t_s_&LM-{KulTS5iOR6#jeqih#t1|sRVOgPD3p=r;(>5X z(hxQWeTW~R3?GiY_-%-SP4Xg*2RLsfkO4fHkE~fG6RE_pU+RM-=!*-7D~VWiS#jEU z8rpA6|io&h!Lq06_h{VMOol%I4PR1|RLM}Hsw*rV*_}(uW~wayFo~yi30WoCaakyxNm2g2Oqj9H zEjJm)mx0Hwc2~Xk{!`yB$E0nlbj!ddzF!vPNE(9OA_vWE(QV9kSQsioBJz^Uew}&{ zkdx%s&>s!{v?Bi3RD09>zm;;S63zcpEWP8u{*)h&))hr#q&i7w0xh~p)mio=fpzvi&L`(dq!8fQwB8Gj zIWf;0KEYCgGde2~v*=_Vs+O%IJ{FIZMM`e+dOv-b&{6tYrhvTGYb6|Esgp{AbBZuZ z_?2uJBZHq@Fn(B&R(0Z);^6&J9J{xaZL7&wAEjSNo5R5@A`8J7fD9Av(pL2&)eIVT zbEy*0XO=i{Fko(m&&D5B>!7!f2a7a|NoSqXpul)TXUi6ubz5sZ5{MRh6h~Rguw8? z#DhBUZJ?T_Jp<>s76tk4(1r>Zh!2CH5FeH(c0#wI90AAi9_-779mWKYC;Ga3i*1g;| zLYeal@Cj<{AErG-e=`d#Ha{YRE2;vg!Nfo$r_k*qazp3`uS~;3|DCD6Hp=~LRW{^J z3k~808I;zc3HiUYU}z9L9ioLe*#jC&d5nS=6bz~bi`4J{WqZfh>9#?(oAV4pau zS1z#o&)60HI{TI912B$}yGz2>Jq$p<6XNcRyk2-VH@Am)+>W!tibYF#TJ@yiybuSl zBzNta+_Gj6XKUSaFrxdTL#4pwl{>G7#X1u&!@QbF-f^MuSFG+QtFFDN3f@gn%pN*> zg!QBv;4VE`@ori5&;vl+WX^{};B<$OnkJ|BbfWo_VFZ;K8!MUn3xWZk$p4{%x8eWyX%Yut{r`W&&*u~fO#bl?kc;=^ z42g@rQ1#kbEAUkm{!@rT44A)NvA?dlgRkD?IXu4bMBGkhEMW2n)^7YpvN+^TPPS1t zzRH~^_<1D%$FRf~27*7u|6`hL@_!nHU-|zZ@$*pjn|Sk3QPAtOoj-MutRxwV`S`}l zVKSd$^P;1Fvj9FOfbnr6zCd;)e^-DtdaUN|JA=+6-aq-$Q1##cem|QUJ-!rtwxok^ z#-fm|>p>RgNxSe-R-op5rfvg4PJSbGd#jo%jisTrJfA7~Hts%>c7MA0JV7U4@b8dn zf9k$Kp8cu&Y)ST~n}>y%N(NQgU&Ix^*`-$~;AE+lDM(mZ0KMWIb-dxXcoF=HSLsi8 zi!k%+AAbHH$^Uf`$d`zKPxJrH{C^sM&Hw*ne!irb3aaRSPZ83=?vF~?(%>7&_qYwl@F0o;bfne1)@nKb)qA9WKF$AOS50JQC??T;ra1T%|4)*5L;v@q zB>Kw#|A?P){{J{gcnt5_lmk3eE39IWJDK{HBWA~aJ}V-*J8yS`H}85F_Q~4P9awaq zAT;WzyIo54RrvfT2%kr61t_l^mp4E1-CH9ceD{x-#62JpyAUUKpiO)R#c}EG zrI3Qj`s5Q}3!}lCj^kYjFS}O0t$AllF6)C&+}QCr0Ykl>bg%Gz# z@^*Dc#66(0wQcL3jGHv{d>|8U_Y=xjWO6|c+tqLg0}o*s{H~fmj9ay+JCAVV#TZRg z!WhcW@_Ux|fzvTw>8ER>t=5`+cxFFlRyFVo^dE*ic**a(b>sF6-J|yr>mY`0uEXfF zop}F`UrdcEZ^1=s`ddiUj}QDQB9o2#Z2?tw9Qq(Bh^IIFhIjuHI1(Qx|A8UkDnEVx zua^YD*ZklAq@Uj>|8H7~7`a0}@{OpMQh8=AG5Ah{=_KrhDOQRsXKOC~xlY-amj!^G04|{Y^TN(q5_NXqt+g)-G>vmo> zFw@TuZR|e(CqEp&`Tq3P+wa|F@%#7KgXf>daS%rv@!u#2zs7(6ke@wr0tK0MJ9iww z87QlolcLSnOGNUhYa)(XR&!OmxrrX~1Fx3^(>NUf4w2cR&3c*fPMolH&wKKr=S$WM zRZeb@kyOq6m;J>std0&3vCW~|cJl+*ao+ccCQ`O_-QEfcb=6$MjXPfQjyE|cRo}09 z|AL%f^e-TQEwr3!=*g<9+D=@1-zA+s>4wyFqxxIj>1VFe!zc!IqYGn)k&N=u%fwoM`Ya$ zRZVWF8@UO&Wj$f*p`FZmBh-Fgkc{=bAZm)=*KQ~G+EzqjtfMr!7i6~g2b{ds`8G^IzI45aQ}DJlDF$&2Dh8tvTFFQ?atfc zlIJtcO0krnY6$el)wiIIbHOXYT8nkgd%eBOu3eJQOOjr zG6qssABAS>OvvlgcR##+2~ZvFEh1jw&>3%TaE|cZK#KLMu5x%~tho~_>rBX-mgKCi zVV}cPWfisH=&QDB2ArB$6Jfs@3qwDW2dma2_D(lIB{p9z_>y<5z8u<4yqS*wbu9#- zm`+`ZcU?8xxLa}tO03CSByMP4j6`_1ddZM{!Sm~Wy(Cp5x0DfHq#xM8g;W&Q*s3jT zDGocZtLAgwDP5biB~TDoRt?F;erZdB=tc!Dfox&p>ghe%cBG-8C8<)!Igz_VZUm3q z@=mNJ?hi8o&v7o+O;2W{-d!^y&T6yq-d+f5YA2~PxK(8TLI7nzn!kL*n|=)#OKgyD z<}b&uUtI#y(yHUVF!VECwi1VF$;2C!PiV^ZVO@I{5oP*CyRHkdeM#RgIq6squM4Ns zBTwyEzu>*#D6$W%deYcU)S?jEKPcB5{LXM>p`u^R2|I}WYQL6V6N{ekz4@AI=s0Kc zfD0+|?)()g*9{D6*uK4laFF}oQzjPMkj`wfal3UZ6^I@>>q|-X# zjWJSGB}i2@!zY@>6Re4vsoDvVwG)2-snfzc+VTGFZY9DhLm*n~f$|y@Lb4E?==`S> zTuqgANX!^D`OrErzjN{)6=zhDrCXE7bdz73de!lH)eoKhCM4n=s!QrP@dA&?s;h3q z1l2e*d0ZknK)kRXgth8_O|V~}JnQIL9`d&91ZoTsTD&?LJG;o~52Z;B+ln)*d{#e*=(uEdPU zPFX^JBQ*9S_r_1cFpQ?tJP!(>PvbCgZ+MXA>`D+zv#ZbtLc$8!{`rkWuIGBYKBn6r z1EIQLt6hZRgt|9AyGm*5v#TVeX#pQkefK8GuA(r^(}G6SM?(4yhEI4#sC7o3N@)$I ziQ!~{>x**;2M0H%ywKW`ViGUqb|u-msu8gXR36|*x13+scj{KXHPmw)=d@WcVLf(y z)%MlUc6VaBoOST2nEkTqb6(f1;o`95HD`@cAp@7Dj^muP%T;}c46|Racvn}=Ak2WZ z(9B>BibCjBB$A_E21KcyL6%6F2rc%!BveIYQ5XMse!iWLJqFdQo;Y_53h}-Lb{6%!`ez z7t4lTOCKeCQgAq_t3z|O5*XkAKo}Sx{R$EJ|ZnVV%wMiGeUQX6cHGo`) zDR{2$PQ?_&FVx=JzB4i`0L{0N)`)wztgTC*N*xq@$kG9*Ck}bn@q8dvlgr3gIWBim5iib~w?q-`3+N}h@5zc@X9`T7)e z^9?_dV0)jWFtlW*me4Zx0(W|k_PCS8!y4q!ioeA51V?Mf>zh~S&yi zRvmy=E4{zrynshyjc!*%et7rp+;S?l9T^r?Pgd)0)%KR+l{{p}^$XVV^RCT#-@j1- z8tI7pg3`_zdO6_z18^G{?5{3K&O3F^^aB9*?|MDa_z5>I)l{Rc$KR3hu<^t@uh6er zoLLN9?^1ZlcY+m=4-eY$aQ4UE>UbLbq9^@SI!cg4wk{Dk&IMn#H@qMV))jeMNbLTR zY5|I{db}mOMn}}Z8&C*1>nrW745W+KUf%nY@n&MHtNcTiar)rstz2y&0iQnaw@B$p zd5-fMo^p-e#?e*=1MIZ9nSruWHDspz^h77qU>7;61k;&TV7Ff)7gElf7}xwSCa=#D+v)@60;NtFB%0VZqnE zyW~SxeN{8>XC&hg@@Z7)Aa9!+-VHznIjm%3@*TWx8=*RCH_7fBb@navV#24; zMMC;M`@CZ-?f4lnc2sB|Lmm$FW1rW&2%*fLbZzrvn}Kz!R(8FbcdS5$o&kpT4K;(b zz-U*>3*2+%$vJIqeqx>VvW24hWG|bVmrY~!vhh4Ot*{51b|9F4Jc^TFyi(o`2tnU2 zcr#kB%^>xRRK0j8_w#Ro;j`KHJ(R0;fP+1Lub)6LcxXCiDz{xLCIqf_n2wl%nC-e3 zU++Y$wXSUX;&wqul%X!;X~1i`|=|%&v+kO`{|&1Nr$* z^XnlG2$-PJ&d-B;d?5FFWg_Z>@sk!Iofc7)?fh z6HH%_KHbjnHPNZ_8e_jQrf9{?WYjQkS9fAdOR87WwOUp}pu*|h1h`hGsOpu4QIKLi zVnkq>uv+4|>e(dDr4?cA__7^1a0&6}XvOuA7)*^ZlZQ|fAB2^RIy$zfP(vaZf{J^` zwEQ#l3QrH0g;D(Efd-&OpupVBj#5PCQGOn zrn1;nH>|4F)2k#OZC6_JrH+Gosp*pdq*NN17+iIbRckVal&R{9jUszJU}Ss2>y_r? z6ufm$wj9=;O;sRJiIv$#W!nrSOUCl+^@{x3X3!6ChJWv>f}3g5Q;f+07@uH2xW{-Q z64XYKocQI#5{n>Sa@V-l$-Cmb~$^oVFz00^>pVY`R3Ph2A()6 zZ(0KKUL_(<$jO;bcf&4vwg(Y+5@g>7?$q^NP0Ldf6!SxuY^ZWF12q+QiIfEDB!adl zH>Q;>Hn6$S(8O;G){vR+27Wvv`#NV5^71~+0--x3vtRc20!ovE1DBjZi?Zh(*Hjf- z*rxXax|zvjG;z?Xyc+5|P>^S%Cc=Eq^1F+Tr;s%YXv7ZPn#;o+xYU2L6pk1yn$2M-O0mt<9`yjnDjmcqikjY2GVj2b))&xC z3C59k>ZfCc|FQc1Sj&H;Zom20Lprk?QFCV+($Kw`CR0D5Wgez+Y3aD?DW~$ie%RUA z-$WY6wd+Nj_lJ4gFtHPpoWwxq1;M$Hb_j{lOryBC9gW&^-$a1&U+_gZL`Eg15QTmomfv!#PaWC zHkfxQrmyxUZ~)SFVk_{@C6}C&4=?Tf8MElOx3_j^x8oQTJ3JPW^5;c0aIqX0>zW^k z?Ok)$HITDz&HKqT+rU?<4bY8rD(ttYzFf35mkOB5H_e4{G)jmS7ro@=#wAkuvk0lC zLi%=37UQ9*QqX~}QG|CTQ5<3Z#D=IJXG$EYBnd-QXu(TiWpKhjvgJzdU~x8pcm9Ox zI60|VhYlV#U_4Uh$}`yKHj~rSe2^bOJU)s>FUor=_u^A=ulu|Z)D5UhM}Gyz3-W+< z@0n5Xm%qW~yeCVM7rV!I3|$|!aHG)){ZnR*pLcD>QO_v&s&2tkC-{Y3c#zlYe&8MX zF9eNHMVLB{N*eg-_|^N<%d5-xuU{Wu{KZ{jY+IUwub5Db&Mn;(hW|6YbI+x8*ADp9 zJNI_(fQO}HXx}-CHsxWeN!(kVh)6I{&xs0@kL0Uu9dbtv*!qng&2YKaG7}#P(!Qzv_`5)fB zJHIp@2$>!}TG>nGo3Jx#1i2@3U3r1lou@LTWV{A~U0h-z&rDw!MI3o!PI&HKiCVWc8|QxVc$`QGfj;w>%?V+YY2%4?_BhwS>&{ zqU!XZaC?T*0z{__OmoE`nVU~^Kn@<)op)_}bLSQ_+ljMPGNtcjc=odDg)KWO-Me2D zPpBqgPRpY%r=Pyuo0#|NeNuG@wLOto#06J_LL=7a#zUtWv%Fp(0;nU>?pW#HJO25S zs6zq0_)xVq9Uvv0Sc$0d-j^bkNF3|OG{wmC3^qpina$jb1AY}Q3%DT^w683-!6 z1Uko%{nbrwkq(8Bc`sc(YWs`1ja8OjT!p(PYkTn&^Es5qVAN77F;X4E_~SS56d+xZ zRYK0FcE^;EIv@w?La&PVWFNE9_QKG&Ci-N`qZhc;kkz?h!t!n)cgMB@VX>t}B<^&< zL7=&Y0Ck*8Ce+TqNiLzL2NJ_vr<0mSUO6~na)inj6Q+l*^^#S8#m>6c8NC0?LA-+_ zX|s>Zjm52>s=&sdT1HzW6HdvBb!^Fn_N+YSJHZ@5CdqTJy#^B8QyxmW+R_iNuW5?= zC^zH!IP_ks;@!(*=|fh7t(xB%gy+zWAdc>C^7a7z)QRJq%3M(uP1pw2xX0lkgYO@p z*mht|!MZ{x1fp7X(%~e&Y1)EM z1ly~H3MA(`xfR-tN(JuCfr{@i&p zt&*383Vd5h^auNvn#2q#XIxkUMsh{E%B(dh)bPmfdp75;kO@QKd1_aK`?jd?1DD2}ynWcq{qdt~okf`qPkp(CMkgWoPVR9r*F@wNyUF?%5g znmg?|S+D_{x`R0;>!R5W-yuRQ9t^q_%ZKWQzvQf_tA=0lylskJX464at!xbi2+B0X zLqEy8w)wTq#&`pPtR=+=wjB;?i({LQU?>}t_n^{#lMa@3V)${<-d?asy3`5UXf{IJ=ZGJuucOQMXzQ&MfX}CwO(7 zZG^XfVEv*xX}cBqN#^4Wt?gZtd8W`yxUlf0lkxFZ=y(cL!v3go%&WI)fU+n*c(-mEUeEOYZkr=Tc-?bSuEh!e>zdUd z!&IrKewgXgtx%weCQga2#|_{PB19G`IWL5i(wCd4(f8G+^H|*a1|edUWm&M*u8Vx3 zq)3X9#JF13CinxsDytgghIRcHmjnfV_=~>VQ-zDfB5Dr>IQ1T@qdZnMSyoN8TrW*> z&4!(7>n!FN`P+`Tt&Ex34%8Jmf{z-z#UMN#@Y{^fOYdW={f&?j)F?NtuQcmr)o&FN zm@{`zlaiDl>LzJ}WjXW_pPBCKMb2qSX1?z1WiJ>EU#1W1npxw@WiaIRIe6 z<_P&RGO6_@g-nkVR_E(l#x0dsXx&tQU2{47?4?S}goLH48EK+l&JO&g2|&wRQw5>?$c0-Z7qWO`MZneJj@MQl_?D^1<9fdzfJD^|~J0s(@gC z9S1v^VUT;(BIqbQ)G%~aChT}d-n0eR>H7huQNG85vK_|=p$$^kgB6DyQTv-P(PU)G zqz$5`VsT5h0-ue(Hj#lP$*~%K3vv=Y<{OIPRv-zIF0f|XIx(aBf--5aWYsviO=mjG z>aA4O(KiR47hd2rgaoNny_TjBep+xxCd=vRO!?SEyyy;7e#t&wpk>{k^X`YXA1;S( zW4kRGC@A^5>tw!{EF1?0@$VxX9kchI@Bz%Sc#iW8xxWs41!#+QMAE#cQE9Yv?>%t6 zt8dg-5VPAT;6$&Ct!{3(53m?top%pd)~T*UZ5v^!nEc`rlM$_K+1o{1>wuS`5||X0 zQF0PtUAt}y*mXG`IkZGUUYPNl{OefqF9|^0Hss%{rhu%67vld3{C^7nPszWEGwm5_ z6d6oU{?*O~6{~V4)mURPwj*RmAP1WvYj3Rid5-g_q5DFQ5JL|DcM$!Y66y-dd*u$A z?eZ)FLf&R<3obT6C4Y6(m0eQkKf4I zvzdpaNyMn4<6)q9ko1?43D;~Ktd5tpFk~Bk`-nqEHAM&j?Uu@xrY8gV=q1r(18X)j z32d<}W;;{Y7w99ERim4f4NYIoXV;Op+DzOJ_+Yofn3=qI;O2-EAhnwR@xWO&dsNJa zVP1H*ZjSpmZPT^w@ElDF6uOiF}@tP7xt5rfzg*!Ho12`Ncp)tzt1e}DaIoXi0- zx|8XSRYOX4({^GQ3Y%|a0r9e$cN#+yld?V6Bl`w9o!s~b&NrkjOWqVJqS~WlHRHTd zH*vmE4A1^bEF2a-b$kMTAiNjAEL4L;R}i19doC8M?l>#%gw51(gqp1ee$V~J&6SkS zVhe06F_~>A_|NVgjt6XWqzuV^V>$A0PcZP<-#UbRgGmxIlhQGE{M|09e4#DJUQ0XW z1p*2hnn4lS5l)5+H-K8zNt9Jyv6{@V^#&7W zB}!*&BhHFqE%+6y@e0TJuI=Q`LU@gS=+;sX0JUk=@f*Mu(m~^ml=G@7+ir=&0iBm< z4uLGycWH_TMesYpt1KQBrfy)Ei%~dV>?(SEVX`?M$jj`7l>d%ZHE3{mvQF3S7g8U@ ze$<3_oj7HAzE=1LzDuVvgX4(ImaHFy6~}Ja+Z8M(sN2Bv&<`mOkr@kxg?YPN@}^J@ zMJv$@s&r6(8*UE+J(KQyI4oDHf{eUoAhO^yrcjG=2CQbqJ5ZRRzSw}K{<>tV!(aP> z<=288=e!e}YeyEOo;PI62u^ILET}w%Th>Xa(=#|}aE-*AK3wwMOs3s{ zZ@V<8L*T+xi;I{4%#?!|rX#B&ZP6<8`)nue1pCN!lc8;EHQ0iNy~M;&G%`o&9>U}W zrG7_hXa$;xNf}p!Ap(f|=XfPFH2?`B1H0x8dcswZ8z`fR^52&=S{>rjlGO_O2EjN!DA%>sv)c#r&s*X>G(4{N-1TgYwP7=MrLvgmEs0}L~+i!D7sIVmk@OY;8W zl^HAdi7MAVsTm?O0rLBujrs+#ud250>+RCX#y;;+!$AwXTM-F&6R|V2S#g^$Wr7e>{Ej?`Ll=uijt0QXpsQhL&q;Lv>%a{V)#oi2MGacbRKQ zP{%Q!t4v&UPne6gN|#MkydPU%Bxfsx*sshRp`*N0Q`)qtX~EppW|Z$iVc=k$_6Xs< z8hYg-Qypd19YI-x$mZ?{@%`t?2s_HoPbvsx$ zFfyIn04)k+e~7Z`dbvd<0dW7n14s#pKUZ4nk=F3~TsDiENd|17pJ3%IF63&;a%xO$ zv9>7~Ff3$vI(&tyS=)1AsFPbJOc;5+z8Ive!Qhsuc^iC49P$Ml02qKH-#^7P;Un^w zc8#Rv%bDErY|*yY(lHA~3#)ZjSGl_93!xd-JAn5E!;vYvdZa{zu3N~F7dosWqt?O( z!^d@$$JM6_k_01_Ak092Q=EJfCY1X68fw5S)QeV0P~@U* z2TLeNdRsR(^oveiXNCkWma2ozxPhL5hA#CTX`7tCP^q4HIHkg+c20;YE+z@cN7ade zJ?cTdt4Uw88*~Sw{W(b6b+$8` zd}ckjjC_Di4%Qep*)zTn041>)NIC^(iWW=LLpj90U$N1HinFIJ6+R=LeLA z`mT_q1hH{Eepb)0u}XfyOY)C@9Ll40C;>v-?#?CW$|9@=2lFe}&7k%W`t0vJwBmB< zy*JDG&<+-=x^6k7vY^GT7IuXKF9jb3YVRd^gPuW|p}!F=@Lk{ag#78?G-JOt1E~b2 zx3st&=R_+svy0RJc6D+3?&2?3CvV@pIX!uY302gCf9KVWG5(>6(NHac_hFlv^~!a2 z_0HIpkM(EAf%l;dr+l~JbU$)H$NzdE9!ny@&XoG&`g)h+!PQ?-6?)1$E;dia>VA@8 zN$5E46X-D;a$ZK=XW%${-*ajF;ond(fo=~>2hp}3c-=r4sLZD7@FQaCBsd7s~OAxW~miLt6&1xa52>7sHREK9!qjMIiw#osxs)d zxQecGF1wSp16Q@CT(7;Hv?N8cj-!b$AsO%~sOu+&8EzC4l7HRy9Q}W%z|fC$87cmi zm{LLQ(GmK!HOhB`>FBT2lnVZ~b5~00baZEbH0s{6M2kAA*rqJ;_vc#Dz<(gu60Qit znR?0bj&r2a1<6bXI9^sA9v)q(VMXi}rD&Jtz1st|*$xT>^YebQ5M;z|jJr=I+Nc|c zCVzJ9({4*5^zYZao12KYl_94nVH97|+Y*QAHC z33c$+z-QzfBu31P@Q*oP4P-Xlt@w;&cUCgUu;5D*fWn$WbyG8A-O~jmNWljSi$F!b ztlU^L(6jQ&*F7I0Ysz4Z@)s*B7?6AHW1*<|yEei5Gha zJYNssaVu;9iB`5#)5@{D4k|=kL((JQVzOP`(hYLI>qns)3BIXgJ)1B8QJ$xpiaF!M zju*%XaXL-skLb&>r|GTau>;B z4LyVCpH~s4JJsTc72)_EwfI4N4qrnv<6r*c6yeyOudQ@HMbVM>DLpvw^$`LkQtcXO zINWXCb|Z0JwlUZxv}vG1W4OK1BLdsaM0U)z{x&C2)jk*!JUcfROE>tJYZ{|dA8a13 z#`ayf(4?wiHE_IstcQ)SRMnX3%6?$Y-xzw}s)mz!$DkTRCMNXQ>QknO%DWuul1_;% zXM0%0%XZ0`ycGIFfZeS+5Nj8WK@WiG?yK_7`tHC4O=L47eZ%|7ot=|zWEWGh)s=H} z3-@k^FlPPTwqde0P^zv~v*2B2+BqPor{%JsV-TxN)ejku>ev+Oeu07&h$o(RtQpAj zTQ=m2=XL;pXvuRZiRz!Lsr05sp|7w@N41&FZcWN3#$AQG6VQvtAz5=d9mONJtURQ( zL#(I{qV19!iBdKAmSiUqaL(LAQu^h|L`EJ#juS5C2=N!FY)6MAoLC{6V2740=j8AI zu%6i4%D=M}9(jgG+3oVM;qusF;+gV1qM4o7>|Pq1Hk9R`ySB3l+I6Al>baDFmn&~q zD%60e@lalt;0#%;(cpeV@NgvDsrgCf&E zGjj>_3EJ#Nf(HOe+Wu$zFsXi?o39guvz)^Fi&rnKJpOiF7tQm*Di~+mx7LnOn4>=y zFV^85OB3VspK0?^s)$9KUn}*jCqls8z%hVT{L#u|h8xoH4J|;I?>mjf_RFtB`~62>tL`DN8xdu?@-JI-u21BR_&jE@{bCLlqN zh)vKD3LCV^7DSF5)ZnhGrZ`dv`0}%&>aX9x_~qU4zh8>Wt#966oE?$Fex2!ZrvC81 z*nghA{PUs89s!4bfB5?33P?#kY5WIg{jly2CHQ;SAHJ^guI<}$a8KIhYCZ5nao_&X z%w{&5ndOsRaL?P~mB!v0hjtWpLRF4JJTN+RoO4w<43(Iy=cMNiMsR22h?h2LRFtY} zRL-W=dk^R;Ot~i_=Q|EY-kD4(Lp4ZI7c@fp{9Lfo18Z_iY!avPi^1kQgy2gdPYu7S6S*#-Rv=+inZJ#qt zL}S;yC%sT`hH7a&W^!-)ke9yVh z{6yGOV}5$B=iF~}`pL-X^!4(_s*tAFJ_9L&On-w$qZ7bO6p}?q`o7j`;2uqq)FV3D zx`DZMxDv1Y@TTIo;x`xT{Qj%>{jB&m8bo0{O_Jo#dR7sU)jbMsSUb}lXNC+`ZQ2=` z{26wj)WW~7+l|9}3k|C_u<_s21M$xqNgn<*EYJmuhE+pR0$-qZ69 z$=gu_pv_nU=nb+%%CSKfBGTX!Qi8Nxf`=Dpl1{Us=>fXWzel`~9oatK;+YS7#^3@6O)7 zxjMNxeR=xk-P!T0%h^5M9SqwEut>&gnP9b=8fm~gq=LU?BN;|AvCqDe(-XCyK0NM1 zlW3^ZqFkBbFlq_?5RJnFXd-K8w8Qq9^WhLoK#r$!Eo8Zw1TyI|mb)Eig|5=a#FD!+TFzXkrxaD9X`Ie z`FOR^5&nA;tFyYz4snwp&Y$cd){lqDJg#MN0L}MzJgS+5m;qYoFp+L&O4)(qd^&B6 zt1c&EfpMd$KBTM{Y!I#*+H2k@1115ZL$y@jadtLaY^kN(2R?c~MhAd{`JU?^xXzn) z;78<4wl~^&KODiI}=4w#NbuBj5u(EXcEm#g9!a-siRP;c%jeFB_Gx+@^ke! z)`5FksPuN6w%5a_j&lk?qjvv9nWeqr4SKh&9>t{1e&zY_0@(bo>weJXkydXmK{%0U zoH|&EDn|~X%CSconn<rN_7NXEv=PHFe=e9 zpIZ>%=0gl{k5b?*O6sh%!-99tgp6`j^xx7!qgOA|jy_e9fjSBBVPNUE&^k_t&8pnt z$TVsk`JhTV5*kE1S&vxt!!Z;KTzsJC6FSZbR3r{P5n=;xs4&Z|O27WDANcaM(2wQ- zrEzbeJ4}_!UpmFbvEdjpsZT_(b#sfbHfXgS6DW`MtxkZ zlZN~U-DN~fFH8^w!J`*OTx=G`;0;=8s!4ZMJVIL7XxLzmb=hHW^;#?j=tdwfKd5Z} zDD^zg%nEPs>cZyAZM*rQbZtWGo|+Gb%QmZOz6Tc{jwqQa(^2F}G1pOFRV(I>neXCR zBI>`c9`y)vU4z7b^siDb&&+^sZbr+Vu=;N$0@UBth$jAJ{r-;44PkuvnJayz zRl&8-5?fBH3s+rrQ`LOV3v;>o%v`6O@~^68HJq&0dLFvg)2+oJr_Y8Z@mu+`< z|HvhLzdcyK=G}Ld*uMANR}Q`R&U*Cby$9WqPmg-{?k@`ZQeS40r;o_95oG@}xlO8~ z=C7+}J@DSVJM-C0T_*IqCg&$?bwqp`CgC)Q!^E*(y@lI$bkB?4*kk$6aq^t{&>$2ak)d0wd+u=Euj|A zmGt4{+@n5jhQegUo)|tEg~*6R;*{uBRk__;-_nzX`PL4$kbb40EcV}DygIPEKch2R z_t{1*6kr1?I3E@?4Wz(;UIRIn=UvqdGH+rj712?-+as)N?Jj&lvNalcn9dKVxj7S- z0iac^n_^s4560r<59mixv)Yj#EuHo!b-OMUw3S`ku8QaPCFn~tM|WkjzCnlW1lkW^ zQC-`Wo%Nwo^CH;_3ep**WhOiNOXrS-$lsY3;AB{I?Rvf-Oc;#-I|r#QCJ&z5m?{*z zPi&i0I=yHI%!aT$pz^ft`4JfvJDT_adR3*j9#DrjD~J`T{XH5-)HhF_z{!HW4CS-Z zIaRlFxHj;^14k$f)o?^|&V8Ph=~R!79S7%3J}zsGhgkLfiesUUpb;jCp~0vhWocTb znnvU}8#TSyo(hJ>sTmqhJ-?t~Zia@)7G$>5=IX)x!`KiArb&?|EX*~5z;VFphH~3y z>iECEc=b#+E>WxjX<5%v`eji@fsXj;QfSk05Q_kbO^r$B6InH{Fd#Li6WlL*Q zVgq|rko4?V5qm*i`h}lKk|AUf_8iQyVgsp44xgIgS-`_AWMQg@`;g%PJWL5A=x7eU zmHj;$rEy?w#4z@`@6kk$mrm;+Eo2Se6mmn#{6|41OsFA~Y_vlV1#b*efN2~5O@{~ZGc(83>U&(x9ZoiEclxIB9G^1^XZ1x@& zHLFmnpyqqNp~jOW@IA_6O)b>D?D};!!S3@WQL)cEwvs#}oCemsxEFdprLr?1MJR1C zuW{5Auw=&2D#t%xj$*v~do&1AYm!A8Bw-mPg(fYJu`DK2HS>EkOzm-g%;Lh&(o~N# z&J0#UL(e;z-XW)=8g{_bO)ajJ`;-^cAfTF*=QvP&E`71s>usEsi0q}|T(E8+8C$bs zQC#L;6nd(*N<7ueH<#r9Y#Y;=L%+8$Nvxe!Fh8Z9mjrq+mGhBR&4>s#d`gP}!cl0y z#)PxNpBlo34_W+YqvIBk2`w_yFbLu(nyO+^3W<~qwu5Pxd%9c=cQ30>Nku^>Of43c zvoec4-%Aadz;O`qtt!d5?njBwjF+u$(q6$43aQQ6s86S*7ep3S-@so;>t!i9H3XGv z-htNAt!v~_A+=>LrxEj$GMpNMR6@EfIID*Rc8VR)yb&T4TlmZFA3~xRyk>W>^{4iG zp88Q1_&m4P(X;Z*7OW|1lf0!g$W4Szm8&brr*tHBa-L>UWF}6h`gI%F6`WUUNmkzv zJkQVk#0*3wg;>atVpNh^x62F4qdbV185KK@)nQB4X9>P;GeIku@b1;6-Lp?Cf8t(I zVx3qPghh~Ld2a3%InW{jOEgw(L3#_7YmC>4^g`>nW>HawWs#USK|?k7adjCU-7~wN z6fS)fSo13=r=d^F(9jETetR?sLYMp1lNO+W$iEoH{WBo~D zaCGbzjQWvs7X;Lzl_ZR@ltrbcm712yZ{EH;y>y3<1DN5QY!tOF+I~=4PY_UB>+z<% zjQy#nsZNFZxvE*Eac0*Ns(i_QZ97vMCTRJIEfSNMCM>nKOtPb3-nf4x=!ES&L87)= z6-H^qxfcYQs08)x#q-!OZ4I<#mk=f3X2I?xrU2Eb3Hy80k7A3ZrD2|WL6Dl&m8Zwv zkHCoKgO6;Gr0~lrwf0UZvAjT2wdxD2Mr?N)#7HEt4xCqHdBF?cte!j{Xup9?jQ6HC zXNpswQ63bA$M|Mj=mS406Ko5-yXV=<93(s`Ei!boWy5_(UA)D*DtUgF*JBV!3ttiD zZ66IjE#u5%)(v-6Zm)RLFRF5oE%6NBf;X7jyDyyP(UgUO+R0G5ZOtGP0(>RRsw$Uf zmD&s{^L)kwDb)7Jw;QM-jx)I*&{tR}5M(9y-%#qQGUeh1U5GvDTZf<@M`%^1><(dV zWDP>y-trEj^EHPZF4p|E?Ft3WvSOV<@y^+j*Wzl2m@G{N{0LbQFu^M^!7Dw%!#$kc z#G2iooe4~9>}qJ*Td8ey3W=2$rVFF&Z2NilR--34`p=GY+!H1XYLtvb8(d|ofW-nJ zzjBxN>bjAItKO9?s&t)q06r%kq*^Z5141IUWaywlF4I@a_J>SCMu1bQuC6({9RZ{I zRD5`3VNbhkwd%Fi{!Hj-GQ55S%-&U#JtAi^><+u?h}=*Y((o1V!QWrAAzxr4)1xI@ zeL#?nU+|y5KVz$vJ8o>L0i2&5sR>L_5IlQ9c3iLA?&k7m|9C;*wx=IgLU4#ZaP;Aq z&8c0OXy|@Z)d&ALQvFhUv!>`FJ+s=KNjdUDD1TfASQV=XSMu`Use$g>S48Wvs{L=w)=a|3{UROlk2voRPSJ{5oR4HucQ+lO*JRX{h@kzm8yega!f{7}x*^!m)v6 z3nXpVm={tnjCh(El2&vcqZ(aV7DGGvuuz=U@aLdvV!?Jiwz0skmz|`PAv82c2Ny- zakBLswJhISAkK3dCsVWdv2v1?HJht*il*JKZPsItJA_i&L>&d{p>MlCiy%xhzswDF zfQ?wyVnT0ko6COj@BB`7(JYpg`an>kp?82JV`~deJvPl#p6N#imns94V~J(D2``3x z#2e|wNt#DYx{82^Ze(iZ>U3*~UUG4I{POLaSAV&9`}W;;mt@t0dFBVf)OHhwH03m< zhNfqH)^9h8nRH&P5Se<3`*8=K{k=4_-3F0IgCNQh{p_LA35UB?i+w1hS)t36VI?Em zy+=)64r2RtrAZE|D5J`}%2xjZqZk#O5OP}(o zp&GKYnlt3rre2|kKzDUSEljrKYb+->)*A~Y z65U=jp4$Gjq=;yeCYiZaiu+o zjuCjQ$Wmrbw=V<$Ce$n2&Jy+T>QN(C@lm8nZJM#4g*h*$hGyV6AAUI^d(@)=l_RW0 z57RtLd@r)r%Xb`8{KP-5TG{3s_or^9ihH!j6RrIElum7rS~-na8pnaP*`;uY9$?#1 zgA$-1*=ohb^No+7op}tmvfq@KlzCcY1vj_y90&3z$R(~RDGo!$f}<0T7rIL8)4??D|)B!!#U(7%$XNYd3|{ z!t=Ey=&RN_5QjFpF&Zbz|FWSYdvt28P@Kg<6ftgZd#TXc$*zDyZ-dV$xSk5NGtVFS z_9M=GFY>Hi?>UYbF1Qd}?%Vn>O$wjIk$y{Hf{8h7hb2AF4ya7yfU{y+D4FZWS{*mp z2f~toel~44Ov<*qWnCd5qm(2T$~#Uhu)}ZDFwUZB%2Gp~I?hB3YtN4p*?R_7N;%v{ zbs1zrpqk;f>LDvfSVq0wLS0?x;)W5H0wE@b8<%M@4Xi0>zi4*OhQ%oRe9@{(SaD8A zC!VEw60=;ZCq5V*lJj(&70MPbupR*Ou~4;;*#wYW*6X4KrOxc{rK6x)%rch70nN>w z6x_IRkt|uWhF)7jRkhN*$^Kq4io-CECet#{^f?T5N08&4$kn6PCi{D76x$~-j>0JO zwF?K)U^n_}%0>{%QJwm>(irlnj8Zz)>j=sN+x9C7b5#f#+u2a$EG<)}bqB;Jy~Mtl z@c*UV>qEQ)qf}sjciB44z?Q129<`U1!)AYPN=McN4QM1(7j1WX&8N1?RYpE5z0hao<{G~DbX2X?uAsS- zjZ=sLiX@5b=+|@_O_^V+*FaNcjB2l^bPrdJ6%BJ;amuEF9qP!VFb#{WoEWhs-;JOJK|kV#8DL%U#QuL0c8*}AG#2k!m7gxbeA z;CaELA}cMLq2s(3`_?MAfTmh)c7NhV56^A;Q9PRRAPu9~qAb0lCT?h%T9WNlyte@P z4D<`x-;1do)#D!Xz06n-g1!)0H*Hl2HCPAsK&&v#M3Pk~(!b{(TP|2Jf8S!4Y06oi zPqlAJ(5H@*t(U7WZfZ(>>ISg)sBN&NaZyquwZ)x0yMx0Hls-r`$m=ycl@ZY@gD#ooTFs@xH{Y{Q*WQo6N z%6uB+erDZ7_ieKj6O;X|egCgoR(#89*5tgq#7Y|F*^PbMDEDaWg+-Cs?}5rTld`%U z*8m=33tUDb2P|6*3Jj)82I9{tG$q|p9233<rWT?O&8`qwf=gK3$j zg*8>#By7h_*+@9Vf$j2(coO(g;!{H?aGc9kT^Su*m;zO!T2d-&TXytBa~ofqt=E=$ zOg%3TY_>S|eX5yiZW#G?ASlR-pbWFAbvmJcIby?VL?y+ZZ6ri#o$T)bU_hV0MWO9; zFN-wD%5tjJ4lBqq0=083Z?<@3$;Y*@9r?Onf({^VM(v1BGUYtX7>&%$gkCQ;4Oci% zuxg%f`yor7dRgS__Zo^V_%o{{U_LZW_sLRbN69#NDO*$OSA*%GVoG+*&=)J3hf`{Z zMsL{6KVBO*RAJe8a_H{>Vul?LG`?J^Eo#{I;ajNS^+R%i>X z_{Wil-dI$jXK&gvpZaBxX1<}T3|*C7t?TLc_kyYIMUF#0^-C6OnFo37pr(O>s&i$< zz)>c4;YCG}rnwm?nZeti-<)1t0?!^f5`lvCYH3crI7{=Xp&&Kfa$VO#D|@SqSS5S~ z$G44go=?50XS@=K=`DAMy(@y)R<6sq@RKmtF(E|ve%0RcPA3ARc)&fal7fR#FeJ^= zw8-MbS^-a1X7n3)X~JlFp%I-B|5q9Xu(E-z?G%9*x;1aQmoQR0x>B zx1C2>JS}J%(b$lK=(B`;S_wW1BK-ucpc7?_L5t&VjUD?8s<4VCOY6v7zOV6wAw3gH zLYk_snSA|Fpdo}xKmp)x^`=^*qxo zWh@CeH{?CX`3}){4!gCH2u!Fr4R!#7ioE?je>(EQrF2?`G||k}6Z_SMhSTc$(2{G; zSJ;rEziV=cbq1d8@eCrKlq^h{A!qjP3AE*f3R1n-10K_ad6~JMs%TNxu_j-T=O}-l zV?CB~#))%0k>}WKUgifLi!$bH2+0IJ>{siYpEEtM1Kel~Og%^fpnr2+n zLrk*DGJK`~LK>1XqV30aW^|aQl=3i|BCkZPW3{ep&0nnJV6e-vbij^_myG+gEc9%& zBg_B{>9+F#F*H``{MgO{XL-t_z>Be2rB)73&d`|vZ{B(cKQ0q5Ej_aqp5qupypRAw zX8PzS0!AVe#{E%9BJ`$=ds(1f)>P&V0HhyRK%7`bA}nL*i-G_~YzeEA+KN<=7C!TW zypTEF7I5wxRpO>9AYrf_UYUA+8Hb^EaYIZ?qNumE+Q!hOS8G!{`nB!v(Zo(Wi}NDM zrezsA&Z=vd?Z9n=wuARBxcQ3bIM!O8lIQu<3v~+8RMxT@`@uFY&(7uN@NAKtd{YEz zNolAu@ieA6GkejBw%@?t$oA|f@;o8> zbm$U5vcwZ9xE3J}lo;1eZ?a@qiZrUUoMu_fGaV7qX{%dUU)@FOrKuw4ss^dTpsf{4f*i@FY>TS^Y(>P+%aG-~@b!4e z`N8rc>tWyte9S$tQy{V;34Og0z-Mr|Y_DaufvruQs9>JGkty}Ukb2r#4lV-JStN)c zkuhY!8WyZ8@)iWOa_{c%rMB~Z8nHA>jUx=a09F$ZRq$vhgexe%wc02B&~di3(`&?C zZ2N8M1$j_t4|b>`_Lg&OXy@}969gqBnbms*ox;kMoZ3nb%kv@%e9zFfj<&c5CWjIQ zo)6<~>r{x&IEr;@m6f4wiJ4bsbIMqH0tsiy=$xl4V7$;ip}-_aSurT9pnfBJHMXM_ z*>sx5eqhpNl&P+LOXokGUAUe`F z9!4US8E<2&P&ZH@@9%{pWr@X<289Vm7`OS6+`gC#05~iC&K_|(T`Np%e;&)cGT|9D zlrecthTeaYSv!k75?v9(}tc@agWkpdla`rC$YcKA{W zSE22PjHf|F121F`HvQa&=LI`@FS2X+$~4JY6j)1;ZbWA$s*Rpf8MLz`v>^tHBxYV3 zP0d@HY5<3V>t-L~{&t>zO3NtsL$2Zn)~cObttBok4f#k%d-nH6A=rGHglU*l&#smL zs8Xw5Yju+g#b)3g>eiwCI$2WYQ5rF(RVG!#r2xFgM#@N=DTAq3*s*%01dm&IVmnO} zO zzDrX#JOCTV+Q;Ww@e>9%OrF|C#WYT)G}f*#nR;x{&5RlYe9bNp@@?-X^#aam8kv)( z9EtdRYT97Q2`0DX11s3TWPXIIlkY8!o~3yiSzA9eVsZA(Og3p#USMr39_l=cnNe_J zpZb2_Wsbvy31HIF#?t_?aQ@TDb2E)-nk9iZ4PwVpfktDgRt=e{(yuv(kl##!2KJ+z z4>Oe_@TUo%ZcC*5-s~PtZM8S|Lh)Z}SeoPTK4&WlDPykm{Fu{12n)9#*s$(hdqb)+ z><`{AZUz261nI3Ba{Tk9CFiNfgGAV!zk^DUXGM_nBGxDO`S;T2e~HxqN6%F)4d&=MP_8IzR9F#@mhmKRUdB6WZzBxEjnk~AadYM^(_}+2{c6`-h2DDuhkrXs5OV7ww zPbP4bRo4$BL&jgimPPba31FMm++wa_REErTt32783|Kice^XR`2?@8|diJx^puH-+iymhx;e_*)vVz zKKw5qj=Q0P)&xJSGYcSjId}U-#p?n}e|b}YlK5ZOUHxzB8YV}|&LSBr=KK&2b2YTx zo!VIkhU&(M70a)o`42!C8>C@1P)zStmGh?O_s$IODzBOxuUNj||Eur$t~bf*HFx`) zxitX*2mpBxfX_7!>ko0<#CJWo=>_IE^`vNT8^Kijd+(1>$%pzv>oLSrP2?#X+JV&@ zli7)~Y!8yDR=5y9wyHrP6#oxIFY0RL&Z`0NJC=ughh5t)5BChT_0f_IUG-5su(>xZ zTW^hn4>l(F8I%tU#`W+ zo@Zz5DJ2o|0jp;ILOS`dIKR+@;m<%}!T+{%tL1P>KR-ao%J2C=F7%ltXHD6T>gOR>T^wp+CG6;V{o_}`Vd>hM7IKo@G;xZ=gVg6W@0crozbj3&OP z+CTmY^X(N7*@uhMSEt99r&n)|U!VS>a~0H+eJE=-?|-qUJqrK-vcEU_`+#J;Zg0hO z@M`;JpL|Mr-6J0KeN#R9QP<7xhsB42eUIvT4`>}?C)xdPRDyI*Sl_pKWspJ!(+O8h z6Cf3OX(6Uk4$m28;Ya()eXdnm)O*_Q@smI^z9n7wM7`Q#n% zmJ?NBw*Ttg<$)e+rQEpAJM2J+krth&EgqAzzT*8rZrL438pVRJBtjuxD&K~BzPol! zZdo(9j%tGkRqq|g1aq_Ht5RQ!5o?pFG?REH${~eIaWd|N4;$;mDpi9#4Iuq31{=?G zu<@Qf2ha(JP`P^r`)|)GeVYsmj+|y??(@w`hL;gs`|5yqmD=XJAkz8*UKgA zpnB!LHF*Im_Ti`FSMN_RuP)!eetmrL7kBxoj#H0%=q;jne)g=M@j5zw!CAcomOCnG zQpE*#BVEP<)n;U-T*W{_Vtcb)by3jNQ7m190?ooo&#?n$y@i)PB7Q`En@HsIy3JXw zV9<#~iM_1m&3a`cz#EYC6Sf-i1>5`*TG|*o6H*mN$)ElzD08<^j+}oSiLV@$GL2Q=Sl2c9E6GGpm|pV7vFbCT1<(F4JdJX z5n5t&1q*4JQMJaG9q8y|9CtA@KOW~EI}GN%u2ID*Q)c|jmFy6S%`|dl*4^B$j+1Gg9M^B z?t)J+RlNQ{_W~HNjr4x^K-Z{UkD|G^>bQ}VvY}CbpwKLfmQ>;>{2-4aYcxhLCR8%r zPoZcV3HJ69D3?{uo$oH*zTT8WNA=J<7w_NbP!ZmAlGhcPs2SMdtQ{TnA$w$JPbOq6 zZ{EH;JtAk8(!#`Q!)}DmZ(6@;>@%*mIU`NmOv<{I$$GL#+Ne^q&1dpmKTO>Kh0OT0 zXg$q!oVQKRvBBxOst1c8WD>6X1uq1%8d~Hm9iLbI(3yR#C|3|tg=_3$^SZjm(wBP$ zm~0L7Oi?~u-c77NGy|I-k!Ls5_1!@HJqA%8@$NV6Q04rH%*NNuHhUh}v0L4K7X3vo zIct!iisSUcUf&(_JHlzr$WriOz$!E?ZFN$Tko^6QgyavPwVK6nH>Zucm(>mb4^eRT z#+$uAK-i2PJ87_ChZGcyagsCDYECx6WIf>@S3C!FMo0Cb1RkYvtr;|H!rJwX4J5em z^Bv89p4(hr^)Oat*1bk&7sG)`uGW|rs9)KW?YQl^9qGrAoiZNYm_pc{ejJ2mR72JL zhAASsf>|!RXxzq$&|N~n;iSdmO~uIeW`f}}lGSZ~J$jkEFwkEBl9`Rm)b*EI?tn2e zQ=1T)fzG6xZ8mO01JfAlem34Z*w^-4VKqtyt#Ee+-iRlXFB@B`nkO;6)71ExJ6f{_ zQqk4A=`~W1v&pG;(}q5sxoOlOUXxk+4P#)0P4h|U8c@*>RBK*lVydS0UHXzO7b|*2 z->FPSpz*xlIFP!FHdtE7cVF0TwLi>uilo_tUe4WJiw}^?*{ap%v`_THKJUp(yS0U> zdVq~67=#5$!E9bBeW@R|l1`wkL$Sn%80R0uE)Qg9#C*FClrUSYRz5$NmqXUj?m#@s zH6L$9c*8T<09t|)e0cV#t@TVT&q}QIv#q&5`;T3b-JK|*Wz_+IiW$EqBCpogi|kQm ztOTdY*EQ>2z=2&d%@4HtjV(`Q!k8(3?bq2vET&o7tz{iIu$^HB3(FUqR$j-M>_scT z?XdAS+G$LkDr^*Q!+yL!lZv#QOi%U!=oLDG|26|Y&GJEL%z|Tq{U{SD0H0-O$-I*4 zgCfny|I6OHZ?|n^d87R|pQ1jh*VytWLZmF;IGubW%d(?bw~^$edpucY5h#+dKolAU zNM@p(*EoNjmpe~#R_(p(0ua1Na?;&rqO285K%r{aeP4fjDtH>F<58Kw<%es7(q^b4 zk8OVEVj^a^J#~jP$n>{-h7}X%J_lK?wpdzD zhwzK$3@5W}B7lKB&?9vPxSVj6gmNk>_cgDLGB~^gb4d4vn=SAY*}mqvS#_TvEumgX zp9tY?z#hAk1HE|69hT)X6iT@>WN9+@sLXw&I!d)m(})OXd{hWpD0&jTzCm1ZYLTrM zbdV}T4+&i*)o4=ub6V37OeGLaW{Zhn92iMt%MXv+VxkCxR_irla~ZDj!OG?$>y8N$w_&VU>ROnNEt{j8a_2#6{qVOACYAXuADX$vJ zO?k@4A~#?d$nEyopMN=evv>CCZ13XY$J6sSzcze1&SjY$L%Loyi8HI2YbeTqXZfH+ zel9|pN6lpz<3*9j!?F;_ZnrTR@ad?H6Z~F?Odl507@{tDu^>G$95X!01&?MxkjW)w76iG_$A&5?MUl4v%po11`kI#5mgO}yOX`$iK46wUur5%1@)IQUC<12H z%FFt+;iXmSj1qm?`)DbcpDxd34mT);ir;%Fo6Ee+6MrF>DfkWpYv#|DfjX(qAAD?% z8UGOOB$I;m2rOMEJr6wDLyNoW(g>Mx(zZSU?TP%yi zD^i~7BDOym%M7s60b?zzC3bw|d?J)B+?&nx69kxYsi>R`06C(J=WW2)9vfmR5G9k+ zvT>3rK=**TSjojg__9Up^t5ioqnQk@z`(!^63=5LMiQJBonoNT;#KfS5t!tMpL93T zOlXf_V4G~7Lq#6*LnkT@=EMl(#-Ybm&@vY3Ar5BvjwyRq7>@)AEZsa=H z;(Yp*yWh{O@4v9)vzJB~tS`P4r0!|xrRKabKXp1bHXul?r6k;m&a`X4;3l^+E|Thz z1E{UIQD9Svl&7KC?6+FAnep!_1O)h6!|m6MW9|?6qWjSsxgRG0k!UO$xN>ZEWw0G3 z;+m(0e>B1B8&o`{I-|Lb=RKQSq7Con21ye+*bErBItU)w(8v27)Cd;mL2<$1yygCe zE7j|zk=#sF3LO%Vr~`t02g_wab7|JDATZ*}9RAhU=w4aK4rY@yhIgDEf&fwrmMor()C958tIU!L60XHGdVjuy|{$#kq){l*y1oY zYo!JzC0CY1vkH;dnE`Yi|>tz7*;%O_` zlxK@2-}~g$*QCKI3wyv%w6FIl0yrJT(^&71?=Fvz3@&?|GA$5xF3RCFF7(?=@ug_B zE>PPN=TRr)c`+kB03MD3dlwhqmBUT20O{&FBf@u&7z8TeVG`#o<1-ivC2-W8SMiM) zPNck|3bl9!`l_rQIZa@j-uOE6ss)ZGp5RLf-Q07>7Jlxu{%$5e!~ERuD*rE z643ksvaqF~O+`VcNaVBu%mn?#)9_!WEd zB$dUJC*DcoY59j`0eVJocZqOa`{Us60apx(r%Zk}v@fCF!MlF#uu(bvYX=Z>`|QH_7%*~tK&7Y+Y@ZRNRSQMAGA+({ zG3hg~q~v9~P4Bnozn~BViybH;17@Y02I;KN1~%+|u*C)@4Z8kaA56L}{rkyC>3`0C z*w_Cc&4U2#LxB8CO=u3zfphCyQI4wqzE=6Gwk*cgaE1;u&L#)e8-C3h2sJCTac(I! zso+!|qRsO&zvkOAA8&^WV|J|hlWs;o1c+wJcnVkWY+9OA0PJhh;cD8eh&K*h)~s50 zS#G)b81AFB8~qk6cawlX)epI9J1P^Q8=YznQE+32^LQK7u`y=1M10=uNQ4Q`MTZFJ zAl}*rxwFq?*%^v)oazDicxXaPHi&XGC~x{Hb>SAJ$_xs)N$o#$fZ&6)0{A*F&;%{Z zuj|qEnTYDAaf(hixM9iPdSPktrCM4QJpGxYBvWx^r5Y##4mY%EYTMLeSP)GmUG-r5 z2wI0!l*yD*@`8_t9t4X??^3L3njcFG^tkDw>gm9-4KA+k@Qmfai_lWNsKLS{u_{`v zihKzr_Nc(Xdf-ZMZeXJ_4ap^JoB~KBUFb%ZG$a5nQzpQk8ng~j!?;-LsI-bwMu)Yh zqL|1Cvh4(A5huZGuEg`*Kfe)Lrps9b|Kj_Er{mxPlI*t4_kfvSd&!2gLVWzmmeIFZ z93D5f#Kxka#@bGz!Qc^wIeu%yhe$K{YG7CxW9s*kDY&Ff1J9j;s_Cd})a48UUqR~) z--X|f9xqJlR+qgz2ogN)tM0n0ka`0BLvjvPT7k=5zE}5~u9l{=pX8`|*P88*v)z zlP+L;3G9v{z81-B3nhO@ua?Ywhqy(AdNUWaT8F@7_?J5(_9$^Ja-P^b9tDGeH=qH% zqBF>U168O2Vl0Y6k3C}OZ0c=aRCfgfjYA!ZDRggt#Zt=rc1#z;i5 z#rT!#(9Y`Y_MW|b@#0mtv%@~5Mxl${$KI9}=T!AsnZg6hEvj!m`bn*R+G1sjANxgY zYy`U3N3lzVRmdxmcJk@pcg9SGq`d2x8JuR-oLN=RGlS@=EBvVs(-eXER7)TxZ2}!v zxTUPghr-&p(i4l5k107dr-CVYV1=65gBPs<;A3L)rvzSrHO`wR8|bx<2?*@88+~s$ ziN!UrJuR~h>Yi&E2u^-22IzZ$E`{X$3s%QMwv^QOBx229ExuzHSBv*;UZ#8MM5gCb z7Icr;#~+l)`>faPc2O9a8-~8#9o?=U+KdZ*!WHK6&jpDYGG!n6&t)# CO_11`Q4 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 literal 0 HcmV?d00001 diff --git a/helm/whanos/charts/docker-registry-2.2.2.tgz b/helm/whanos/charts/docker-registry-2.2.2.tgz new file mode 100644 index 0000000000000000000000000000000000000000..6dd8c7093538a62dfbf8aeca374547bd1d33a2e0 GIT binary patch literal 14486 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 literal 0 HcmV?d00001 diff --git a/helm/whanos/charts/jenkins-4.8.3.tgz b/helm/whanos/charts/jenkins-4.8.3.tgz new file mode 100644 index 0000000000000000000000000000000000000000..15e65fbf28bdfbcac0da68e57293cc5b918273d2 GIT binary patch literal 74882 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�d^`5JyDuLf!fg0(IePh@|7TPD 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 literal 0 HcmV?d00001 diff --git a/helm/whanos/charts/jenkins/.DS_Store b/helm/whanos/charts/jenkins/.DS_Store new file mode 100644 index 0000000000000000000000000000000000000000..ff7f7a8fe5f45ccfc8f65ada100b2f4b59a62fc3 GIT binary patch literal 8196 zcmeHMYitx%6u#fIz>FPWS_>3pvRlh5Sm?G?j4>n%xkkon7-KSZPPGaerf6Kw`!!7pR?3Nj^ck~Qnt9A%Zf5wJ-QhwQ zfiMDL1i}b}5eOr2Jw$-+Y~JK)?tLK*$1nn61pb#1;O9e>I;Zh~jtc4@9W?kQ08w57 z_>JaN2lzVCfW`wlDyXkYHbwP-KovoW0ijOvDBn&r9?(%ig*t;!X9%8*phAKFbkd9Z z+Zp15hGQ6kFap;`fTxe**X)CA=<5329m-fvhNP!5Lzd}!vDg_%W#uzw&XQ-z74m`P zfHR!*(q6$$r1SeZ*Wox;rZi7y_L;_TpH|)C*k0PSjl8d5<_y}>+hy80XE@;$?40ZC zCWSy&WTj85Id-ghZBu=;ITjnKj~-j!6r=f?wId^nJg=@{&$# z3a+u&AX{e9XeEnes)|2t_YgPZ?lbZ((Ykm{II4`zSrA#WVpY=}cgDBwY`=GWu2xy4 zR;%;7il%F3ETePS%y|RdX*X-wIn(a%p%~kqdC)ZSN+s%*4m&+)j91kxTy)D~U7x(W zWF=L|m=6|A?}%0>%i?;sTiW$@4;gmpl@j_6S?+NM(s^U|Fu|~-(I(6OhoyC{vNdOVPTr5k zJ+->t%}s5|<%}FTy{Kkkm7df)W$jzi(M-E&67cC;2>i=+@zvs!)Wuf@6G0gBW2{t{ z*nslOPG`&5I=b9C*g@v7#o_IhFwFzYv{s#Z>UDP)^TF4B~GWnmz`#0mO!(f09fa{Vv=hct=)r#U!azSvJV1!|P{d&z!BISn6L=Jl z;c>$I^LPO-;v`-s%)dscAH$n?3vc5CoW@7^7@zp)AIJCj5kF1BbNfU*;J9O|NehN_!7Qk7=bVXe=PziZ%wu)NO!ukjMv&x>i1LU zjqe*3)K{T_Z{h2HIZpJ-KMZLe4P^0vjtWW=YXABV0e|n0?(qH(?|. + +## 4.6.1 + +Update `configuration-as-code` plugin to fix dependency issues with `azure-ad` plugin + +## 4.6.0 + +Added `.Values.controller.httpsKeyStore.jenkinsHttpsJksSecretKey` to allow overriding the default secret key containing the JKS file. +Added `.Values.controller.httpsKeyStore.jenkinsHttpsJksPasswordSecretName` to allow getting the JKS password from a different secret. +Added `.Values.controller.httpsKeyStore.jenkinsHttpsJksPasswordSecretKey` to allow overriding the default secret key containing the JKS password. + +## 4.5.1 + +Update Jenkins image and appVersion to jenkins lts release version 2.414.1 + + +## 4.5.0 + +Added `.Values.persistence.dataSource` to allow cloning home PVC from existing dataSource. + +## 4.4.2 + +Update Jenkins image and appVersion to jenkins lts release version 2.401.3 + + +## 4.4.1 + +Added `.Values.agent.jnlpregistry` to allow agents to be configured with private registry. + +## 4.4.0 + +Add config keys for liveness probes on agent containers. + + +## 4.3.30 + +Update Jenkins version in controller test matching LTS version + +## 4.3.29 + +Update Jenkins image and appVersion to jenkins lts release version 2.401.2 + + +## 4.3.28 + +Allow the kubernetes API server URL to be configurable. + +## 4.3.27 + +Bump kiwigrid/k8s-sidecar from 1.23.1 to 1.24.4 and jenkins/inbound-agent from 3107.v665000b_51092-5 to 3107.v665000b_51092-15. + +## 4.3.26 + +Fix various typos in the chart documentation. + +## 4.3.25 + +| plugin | old version | new version | +|-----------------------|----------------------|-----------------------| +| kubernetes | 3900.va_dce992317b_4 | 3937.vd7b_82db_e347b_ | +| configuration-as-code | 1625.v27444588cc3d | 1647.ve39ca_b_829b_42 | +| git | 5.0.0 | 5.1.0 | +| ldap | 671.v2a_9192a_7419d | 682.v7b_544c9d1512 | + +## 4.3.24 + +Update Jenkins image and appVersion to jenkins lts release version 2.401.1 + + +## 4.3.23 + +Update Jenkins image and appVersion to jenkins lts release version 2.387.3 + + +## 4.3.22 + + +Bump chart version. + +## 4.3.21 + + +Document building charts for weekly releases. + +## 4.3.20 + + +Enhance repository appearance and miscellaneous cleanup. + +## 4.3.19 + + +Comply with superlinter rules and address ShellCheck issues. + +## 4.3.18 + + +Bump kiwigrid/k8s-sidecar from 1.15.0 to 1.23.1. + +## 4.3.17 + + +Bump jenkins/inbound-agent from 4.11.2-4 to 3107.v665000b_51092-5. + +## 4.3.16 + + +Update bundled plugins: +- [ldap](https://plugins.jenkins.io/ldap/): From 2.5 to 671.v2a_9192a_7419d +- [kubernetes](https://plugins.jenkins.io/kubernetes/): From 3734.v562b_b_a_627ea_c to 3900.va_dce992317b_4 +- [workflow-aggregator](https://plugins.jenkins.io/workflow-aggregator/): From 590.v6a_d052e5a_a_b_5 to 590.v6a_d052e5a_a_b_5 +- [configuration-as-code](https://plugins.jenkins.io/configuration-as-code/): From 1569.vb_72405b_80249 to 1625.v27444588cc3d + +## 4.3.15 + + +Update bats from 1.2.1 to 1.9.0. + +## 4.3.14 + + +Update various GH actions, typo fixes, and miscellaneous chores. + +## 4.3.13 + + +Bump helm-unittest from 0.2.8 to 0.2.11. + +## 4.3.12 + + +Update wording in values.yml. + +## 4.3.11 + +Update Jenkins image and appVersion to jenkins lts release version 2.387.2 + + +## 4.3.10 + +Correct incorrect env var definition +Disable volume mount if disableSecretMount enabled + +## 4.3.9 + +Document `.Values.agent.directConnection` in README. +Add default value for `.Values.agent.directConnection` to `values.yaml` + +## 4.3.8 + +Added `.Values.agent.directConnection` to allow agents to be configured to connect direct to the JNLP port on the +controller, preventing the need for an external HTTP endpoint for this purpose. + +## 4.3.7 + +Added `.Values.controller.shareProcessNamespace` and `.Values.controller.httpsKeyStore.disableSecretMount` to enable sourcing TLS certs from external issuers + +## 4.3.6 + +Update Jenkins image and appVersion to jenkins lts release version 2.387.1 + +## 4.3.5 + +Added `.Values.helmtest.bats.image` and `.Values.helmtest.bats.image` to allow unit tests to be configurable. Fixes [https://github.com/jenkinsci/helm-charts/issues/683] + +## 4.3.4 + +Update Jenkins image and appVersion to jenkins lts release version 2.375.3 + + +## 4.3.3 + +Removed hardcoding of chart version in tests to make maintenance easier + +## 4.3.2 + +Added `.Values.serviceAccount.extraLabels` on Service Account +Added `.Values.serviceAccountAgent.extraLabels` on Agent's Service Account + + +## 4.3.0 + +Moved use of `.Values.containerEnv` within `jenkins` Container to top of `env` block to allow for subsequent Environment Variables to reference these additional ones. + +## 4.2.21 + +Update Jenkins image and appVersion to jenkins lts release version 2.375.2 + + +## 4.2.20 + +Fixed the `controller.prometheus.metricRelabelings` being unable to convert the value to the ServiceMonitor. +Added `controller.prometheus.relabelings` to allow relabling before scrape. +Added default values for `controller.prometheus.relabelings` and `controller.prometheus.metricRelabelings`. + +## 4.2.19 + +CronJob API version upgraded to batch/v1 + +## 4.2.18 + +Added option to set secretEnvVars. + +## 4.2.17 + +Update Jenkins image and appVersion to jenkins lts release version 2.375.1 + + +## 4.2.16 + +Fixed chart notes not rendering Jenkins URL with prefix when `controller.jenkinsUriPrefix` is set. +Fixed chart notes not rendering Jenkins URL with `https` when `controller.ingress.tls` or `controller.controller.httpsKeyStore.enable` is set. +Fixed chart notes rendering wrong JCasC URL when not using `controller.ingress`. + +## 4.2.15 + +Update Jenkins image and appVersion to jenkins lts release version 2.361.4 + +## 4.2.14 + +Added option to mount all keys from an existing k8s secret + +## 4.2.13 + +Adding `tpl` to `controller.additionalExistingSecrets` + +## 4.2.12 + +Update Jenkins image and appVersion to jenkins lts release version 2.361.3 + + +## 4.2.11 + +Update default plugin versions + +| plugin | old version | new version | +|-----------------------|-----------------------|------------------------| +| kubernetes | 3706.vdfb_d599579f3 | 3734.v562b_b_a_627ea_c | +| git | 4.11.5 | 4.13.0 | +| configuration-as-code | 1512.vb_79d418d5fc8 | 1569.vb_72405b_80249 | + +## 4.2.10 +Fix grammar and typos + +## 4.2.9 +Update Jenkins image and appVersion to jenkins lts release version 2.361.2 + +## 4.2.8 +Modify the condition to trigger copying jenkins_config files when configAutoReload option is disabled during Jenkins initialization + +## 4.2.7 +Support for remote URL for configuration + +## 4.2.6 +Add option to set hostnetwork for agents + +## 4.2.5 +Add an extra optional argument to extraPorts in order to specify targetPort + +## 4.2.4 +Remove k8s capibility requirements when setting priority class for controller + +## 4.2.3 Update plugin versions + +| plugin | old version | new version | +| --------------------- | --------------------- | --------------------- | +| kubernetes | 3600.v144b_cd192ca_a_ | 3706.vdfb_d599579f3 | +| workflow-aggregator | 581.v0c46fa_697ffd | 590.v6a_d052e5a_a_b_5 | +| configuration-as-code | 1429.v09b_044a_c93de | 1512.vb_79d418d5fc8 | +| git | 4.11.3 | 4.11.5 | + +Resolve version conflict between default install of plugins. + +## 4.2.2 + +Support Google Managed Prometheus + +## 4.2.1 + +Remove option to provide command and args of agent as YAML. This feature was never supported by the Jenkins Kubernetes +plugin. + +## 4.2.0 + +Add option to provide additional containers to agents + +## 4.1.18 + +Update Jenkins image and appVersion to jenkins lts release version 2.361.1 + + +## 4.1.17 + +Update Jenkins casc default settings to allow `security` configs to be provided + + +## 4.1.16 + +Update Jenkins image and appVersion to jenkins lts release version 2.346.3 + + +## 4.1.15 + +`projectNamingStrategy` is configurable in default config. + +## 4.1.14 + +If `installPlugins` is disabled, don't create unused plugins volume. + +## 4.1.13 + +Update Jenkins image and appVersion to jenkins lts release version 2.346.2 + + +## 4.1.12 + +If keystore is defined, it is now also made available in the initContainer. + +## 4.1.11 + +JCasC ConfigMaps now generate their name from the `jenkins.casc.configName` helper + +## 4.1.10 + +Update Jenkins image and appVersion to jenkins lts release version 2.346.1 + + +## 4.1.9 + +Allow setting `imagePullSecret` for backup job via `backup.imagePullSecretName` + +## 4.1.8 + +Fix path of projected secrets from `additionalExistingSecrets`. + +## 4.1.7 + +Update README with explanation on the required environmental variable `AWS_REGION` in case of using an S3 bucket. + +## 4.1.6 + +project adminSecret, additionalSecrets and additionalExistingSecrets instead of mount with subPath + +## 4.1.5 + +Update README to fix `JAVA_OPTS` name. + +## 4.1.4 +Update plugins + +## 4.1.3 +Update jenkins-controller-statefulset projected volumes definition + +## 4.1.1 +Added 'controller.prometheus.metricRelabelings' to allow relabling and dropping unused prometheus metrics + +## 4.1.0 + +Added `controller.sidecars.configAutoReload.envFrom`, `controller.initContainerEnvFrom`, `controller.containerEnvFrom` + +## 4.0.1 + +No code changes - CI updated to run unit tests using Helm 3.8.2. + +## 4.0.0 + +Removes automatic `remotingSecurity` setting when using a container tag older than `2.326` (introduced in [`3.11.7`](#3117)). If you're using a version older than `2.326`, you should explicitly set `.controller.legacyRemotingSecurityEnabled` to `true`. + +## 3.12.2 + +Update Jenkins image and appVersion to jenkins lts release version 2.332.3 + +## 3.12.1 + +Make namespace configurable for agents and additional agents. + +## 3.12.0 + +Added a flag for disabling the default Jenkins Agent configuration. + +## 3.11.10 + +Update Jenkins image and appVersion to jenkins lts release version 2.332.2 + +## 3.11.9 Bump configuration-as-code plugin version + +| plugin | old version | new version | +| --------------------- | ----------- | ----------- | +| configuration-as-code | 1.51 | 1414.v878271fc496f | + +## 3.11.8 + +Make [externalTrafficPolicy](https://kubernetes.io/docs/concepts/services-networking/service/#traffic-policies) and `loadBalancerSourceRanges` fields customizable for Agent listener service via `controller.agentListenerExternalTrafficPolicy` and `controller.loadBalancerSourceRanges`. + +## 3.11.7 + +Removed Configuration as Code `remotingSecurity` section for Jenkins 2.326 or newer. See [Documentation](https://www.jenkins.io/redirect/AdminWhitelistRule) to learn more. + +## 3.11.6 + +Update Jenkins image and appVersion to jenkins lts release version 2.332.1 + + +## 3.11.5 + +Change Backup Role name function call to match the RoleDef function call in the Backup RoleBinding + +## 3.11.4 + +Update Jenkins image and appVersion to jenkins lts release version 2.319.3 + + +## 3.11.3 + +Update kiwigrid/k8s-sidecar:1.15.0 +Update jenkins/inbound-agent:4.11.2-4 + +## 3.11.2 + +Improve example for workspaceVolume. Clarify that this is not a list. + +## 3.11.1 + +Update configuration-as-code plugin to 1.55.1 + + +## 3.11.0 + +Update default plugin versions + +| plugin | old version | new version | +| --------------------- | ----------- | ----------- | +| kubernetes | 1.31.1 | 1.31.3 | +| git | 4.10.1 | 4.10.2 | + +## 3.10.3 + +Update Jenkins image and appVersion to jenkins lts release version 2.319.2 + + +## 3.10.2 + +Fix definition of startupProbe when deploying on a Kubernetes cluster < 1.16 + +## 3.10.1 + +correct VALUES_SUMMARY.md for installLatestPlugins + +## 3.10.0 + +Update default plugin versions + +| plugin | old version | new version | +| --------------------- | ----------- | ----------- | +| kubernetes | 1.30.11 | 1.31.1 | +| git | 4.10.0 | 4.10.1 | +| configuration-as-code | 1.54 | 1.55 | + +## 3.9.4 + +Add JAVA_OPTIONS to the README so proxy settings get picked by jenkins-plugin-cli + +## 3.9.3 + +Fix config reload request URL when httpsKeystore in use + +## 3.9.2 + +Update Jenkins image and appVersion to jenkins lts release version 2.319.1 +Update following plugins: + +* kubernetes:1.30.11 +* git:4.10.0 +* configuration-as-code:1.54 + +## 3.9.1 + +Adding `tpl` to `controller.overrideArgs` + +## 3.9.0 + +Added containerSecurityContext + +## 3.8.9 + +Fix mounting of HTTPS keystore secret when httpsKeyStore is enabled + +## 3.8.8 + +Update Jenkins image and appVersion to jenkins lts release version 2.303.3 + +## 3.8.7 + +Adding `tpl` to `initScripts` + +## 3.8.6 + +Add `controller.tagLabel` to specify the label for the image tag, for example `jdk11` or `alpine` + +## 3.8.5 + +Move jenkins web root outside of home dir + +## 3.8.4 + +Add `controller.initConfigMap` to pass pre-existing `init.groovy.d` ConfigMaps to the controller + +## 3.8.3 + +Update missed reference to jenkins/inbound-agent:4.11-1 + +## 3.8.2 + +Update jenkins/inbound-agent:4.11-1 + +## 3.8.1 + +Update jenkins/inbound-agent:4.10-3 + +## 3.8.0 + +Update kiwigrid/k8s-sidecar:1.14.2 + +## 3.7.1 + +Update git and casc plugins versions + +## 3.7.0 + +Added the option to create AWS SecurityGroupPolicy resources + +## 3.6.2 + +Fix httpsKeyStore mount when `controller.httpsKeyStore.enable` is `true` + +## 3.6.1 + +Update Jenkins image and appVersion to jenkins lts release version 2.303.2 + + +## 3.6.0 +Support custom agent pod labels + +## 3.5.20 +Disallow ingress on port 50000 when agent listener is disabled + +## 3.5.19 +Add support for specifying termination-log behaviour for Jenkins controller + +## 3.5.18 +Add support for creating a Pod Disruption Budget for Jenkins controller + +## 3.5.17 +Update workdingDir to `/home/jenkins/agent` + +## 3.5.16 +Update location of icon (wiki.jenkins.io is down) + +## 3.5.15 +Add support for adding labels to the Jenkins home Persistent Volume Claim (pvc) + +## 3.5.14 + +* Updated versions of default plugins +* Use verbose logging during plugin installation +* download the latest version of all plugin dependencies (Fixes #442) + +## 3.5.13 + +Update Jenkins image and appVersion to jenkins lts release version 2.303.1 + +## 3.5.12 + +Added extended documentation for Backup and Restore. + +## 3.5.11 + +Sanitized the Jenkins Label + +## 3.5.10 + +Fixed `controller.customJenkinsLabels` not getting templated into the controller `labelString:` field in JCasC + +## 3.5.9 + +Update Jenkins image and appVersion to jenkins lts release version 2.289.3 + + +## 3.5.8 + +Add parameter `backup.serviceAccount.create` to disable service account creation for backup service and `backup.serviceAccount.name` to allow change of the SA name. +`backup.annotations` was moved to `backup.serviceAccount.annotations` + +## 3.5.7 + +Enable setting `controller.serviceExternalTrafficPolicy` to set [the standard Service option](https://kubernetes.io/docs/tasks/access-application-cluster/create-external-load-balancer/#preserving-the-client-source-ip). `externalTrafficPolicy` denotes if this Service desires to route external traffic to node-local or cluster-wide endpoints. + +## 3.5.6 + +Add optional `controller.initContainerResources`, if set, it will change resources allocation for init controller, overwise the `controller.resources` will be used + +## 3.5.5 + +Allow to configure nodeUsageMode via `agent.nodeUsageMode` + +## 3.5.4 + +Update tests to work with unittest 0.2.6 + +## 3.5.3 + +Update Jenkins image and appVersion to jenkins lts release version 2.289.2 + +## 3.5.2 + +Enable setting `controller.installLatestSpecifiedPlugins` to set whether to download the latest dependencies of any plugin that is requested to have the latest version. + +## 3.5.1 +Fix activeDeadlineSeconds wrong type bug in jenkins-backup-cronjob template + +## 3.5.0 + +Allow `controller.podAnnotations` to be render as a template + +## 3.4.1 + +Allow showRawYaml for the default agent's pod template to be customized. + +## 3.4.0 + +configAutoReload container updated from `kiwigrid/k8s-sidecar:0.1.275` to `kiwigrid/k8s-sidecar:1.12.2` + +## 3.3.23 + +Make `controller.ingress.resourceRootUrl` compatible with API version networking.k8s.io/v1 on k8s >= 1.19.x + +## 3.3.22 + +Update Jenkins image and appVersion to jenkins lts release version 2.289.1 + +## 3.3.21 +`persistence.mounts` additionally mount to init container to allow custom CA certificate keystore + +## 3.3.18 +Added `controller.overrideArgs` so any cli argument can be passed to the WAR. + +## 3.3.17 +Correct docs on disabling plugin installation + +## 3.3.16 +Support generating `SecretClaim` resources in order to read secrets from HashiCorp Vault into Kubernetes using `kube-vault-controller`. + +## 3.3.15 +Prevent `controller.httpsKeyStore` from improperly being quoted, leading to an invalid location on disk + +## 3.3.14 +Correct docs on disabling plugin installation + +## 3.3.13 +Update plugins + +## 3.3.12 +Add `controller.additionalExistingSecrets` property + +## 3.3.11 +Add support for disabling the Agent listener service via `controller.agentListenerEnabled`. + +## 3.3.10 +Update Jenkins image and appVersion to jenkins lts release version 2.277.4 + +## 3.3.9 +* Change helper template so user defined `agent.jenkinsUrl` value will always be used, if set +* Simplify logic for `jenkinsUrl` and `jenkinsTunnel` generation: always use fully qualified address + +## 3.3.8 +Update Jenkins image and appVersion to jenkins lts release version 2.277.3 + +## 3.3.7 +fix controller-ingress line feed bug + +## 3.3.6 + +Update Git plugin version to v4.7.1 +Update ldap plugin version to v2.5 + +## 3.3.5 + +Use tpl function for environment vars. Fixes [https://github.com/jenkinsci/helm-charts/issues/324] + +## 3.3.4 + +Update Jenkins image and appVersion to jenkins lts release version 2.277.2 + + +## 3.3.3 + +Enable setting `controller.installLatestPlugins` to set whether to download the minimum required version of all dependencies. + +## 3.3.2 + +Add `controller.additionalSecrets` documentation + +## 3.3.1 + +Add `controller.additionalSecrets` property + +## 3.3.0 + +Change default Jenkins image to `jdk11` variant + +## 3.2.6 + +Add missing `controller.jenkinsUrlProtocol` property + +## 3.2.5 + +Add additional metadata `artifacthub.io/images` for artifacthub + +## 3.2.4 +Update Jenkins image and appVersion to jenkins lts release version 2.277.1 +Update Git plugin version to v4.6.0 +Update kubernetes plugin version to v1.29.2 + +## 3.2.3 + +Fix rendering `controller.ingress.path` + +## 3.2.2 + +Added description for `controller.jenkinsUrl` value + +## 3.2.1 + +Enable setting ImagePullSecrets to controller and agent service accounts. + +## 3.2.0 + +Calculate consistent unique agent IDs to be used in pod templates. Fixes [https://github.com/jenkinsci/helm-charts/issues/270] + +## 3.1.15 + +Fix documentation for the kubernetes probes + +## 3.1.14 + +Typo in documentation + +## 3.1.13 + +Update Jenkins image and appVersion to jenkins lts release version 2.263.4 + +## 3.1.12 + +Added GitHub action to automate the updating of LTS releases. + +## 3.1.11 + +Enable setting controller.updateStrategy to change the update strategy for StatefulSet + +## 3.1.10 + +Fixed issue for the AgentListener where it was not possible to attribute a NodePort + +## 3.1.9 + +Upgrade kubernetes plugin to 1.29.0 and CasC plugin to 1.47 + +## 3.1.8 + +Fix init scripts config map name + +## 3.1.7 + +Fix missing newline when `httpsKeyStore` is enabled + +## 3.1.6 + +Mount controller init scripts from ConfigMap + +## 3.1.5 + +Fix `namespaceOverride` not applied when loading JCasC + +## 3.1.4 + +Update Git plugin version to v4.5.2 + +## 3.1.3 + +Update Jenkins image and appVersion to jenkins lts release version 2.263.3 + +## 3.1.2 + +Enable setting maxRequestsPerHostStr to change the max concurrent connections to Kubernetes API + +## 3.1.1 + +Update Jenkins image and appVersion to jenkins lts release version 2.263.2 + +## 3.1.0 + +* Added `.Values.controller.podSecurityContextOverride` and `.Values.backup.podSecurityContextOverride`. +* Added simple default values tests for `jenkins-backup-cronjob.yaml`. + +## 3.0.14 + +Enable to only backup job folder instead of whole jenkins + +## 3.0.13 + +Improve Documentation around JCasc and Custom Image + +## 3.0.12 + +Added GitHub Action testing on Kind 1.16, 1.17, 1.18, 1.19 & 1.20 + +## 3.0.11 + +Fixes & unit tests for Ingress resources on Kubernetes 1.19 and above + +## 3.0.10 + +Ingress resources on Kubernetes 1.19 (or above) are created with the version `networking.k8s.io/v1` + +## 3.0.9 + +Added support for backing up to Azure Blob Storage. + +## 3.0.8 + +* Typo in documentation + +## 3.0.7 + +* Add support for setting default agent workspaceVolume + +## 3.0.6 + +Use 2.263.1 image + +## 3.0.5 + +* Update appVersion to reflect new jenkins lts release version 2.263.1 + +## 3.0.4 + +* Fix documentation for additional secret mounts + +## 3.0.3 + +* Update `README.md` with explanation on how to mount additional secrets + +## 3.0.2 + +* Fix `.Values.controller.tolerations` and `.Values.controller.nodeSelector` variable names in templates\jenkins-backup-cronjob.yaml + +## 3.0.1 + +* added 'runAsNonroot' to security context + +## 3.0.0 + +* Chart uses StatefulSet instead of Deployment +* XML configuration was removed in favor of JCasC +* chart migrated to helm 3.0.0 (apiVersion v2) +* offending terms have been removed +* values have been renamed and re-ordered to make it easier to use +* already deprecated items have been removed +* componentName for the controller is now `jenkins-controller` +* componentName for the agent is now `jenkins-agent` +* container names are now + * `init` for the init container which downloads Jenkins plugins + * `jenkins` for the Jenkins controller + * `config-reload` for the sidecar container which automatically reloads JCasC +* Updated UI tests to use official `bats/bats` image instead of `dduportal/bats` + +For migration instructions from previous versions and additional information check README.md. + +## 2.19.0 + +* Use lts version 2.249.3 +* Update kubernetes, workflow-aggregator, git and configuration-as-code plugins. +* Fail apply_config.sh script if an error occurs. + +## 2.18.2 + +Fix: `master.javaOpts` issue with quoted values + +## 2.18.1 + +Recommend installing plugins in custom image + +## 2.18.0 + +Removed /tmp volume. Making /tmp a volume causes permission issues with jmap/jstack on certain Kubernetes clusters + +## 2.17.1 + +Fix location of jenkins.war file. +It is located in `/usr/share/jenkins/jenkins.war` and can be fonfigured via `master.jenkinsWar`. + +## 2.17.0 + +Add support for plugin-installation-manager-tool + +## 2.16.0 + +Added Startup probe for Jenkins pod when Kubernetes cluster is 1.16 or newer + +## 2.15.5 + +scriptApproval is taken into account when enableXmlConfig is false. + +## 2.15.4 + +Add Tilt support for easier helm chart development. + +## 2.15.3 + +Fix error on missing `ingress.paths` value + +## 2.15.2 + +Added documentation for ingress and jenkins URL + +## 2.15.1 + +Fix priorityClassName entry in values.yaml file + +## 2.15.0 + +Added support for disabling the helm.sh/chart annotation + +## 2.14.0 + +Added support for annotations in podTemplates + +## 2.13.2 + +Add nodeSelector in the backup pod +Fix tolerations in the backup pod + +## 2.13.1 + +Update list of maintainers + +## 2.13.0 + +Added Support for websockets in the default Jcasc config +Added trailing slash to JENKINS_URL env var + +## 2.12.2 + +Added unit tests for most resources in the Helm chart. + +## 2.12.1 + +Helm chart README update + +## 2.12.0 + +Add option to configure securityContext capabilities + +## 2.11.0 + +Added configurable security context for jenkins backup CronJob and annotations to its serviceaccount. + +## 2.10.0 + +Make activeDeadlineSeconds for backup job configurable + +## 2.9.0 + +Make namespace of PrometheusRule configurable + +## 2.8.2 + +Bumped configuration-as-code plugin version from 1.41 to 1.43. +See [configuration-as-code plugin issue #1478](https://github.com/jenkinsci/configuration-as-code-plugin/issues/1478) + +## 2.8.1 + +Fix indentation of JAVA_OPTS + +## 2.8.0 + +Add support for helm unittest and include first tests + +## 2.7.2 + +Target port of container `jenkins-sc-config` taken the value from values.yaml. + +## 2.7.0 + +Add a secondary ingress template for those who want a second ingress with different labels or annotations or whatever else. + +Example: You want /github-webhook to be on a public ingress, while the main Jenkins intance to be on a private locked down ingress. + +## 2.6.5 + +Update configScripts example + +## 2.6.4 + +Add timja as a maintainer + +## 2.6.3 + +Update k8s-sidecar image to 0.1.193 + +## 2.6.2 + +Only mount empty dir secrets-dir if either `master.enableXmlConfig` or `master.secretsFilesSecret` is set +Fixes #19 + +## 2.6.1 Do not render empty JCasC templates + +## 2.6.0 First release in jenkinsci GitHub org + +Updated README for new location + +## 2.5.2 + +Fix as per JENKINS-47112 + +## 2.5.1 + +Support Jenkins Resource Root URL + +## 2.5.0 + +Add an option to specify that Jenkins master should be initialized only once, during first install. + +## 2.4.1 + +Reorder README parameters into sections to facilitate chart usage and maintenance + +## 2.4.0 Update default agent image + +`jenkins/jnlp-slave` is deprected and `jenkins/inbound-agent` should be used instead. +Also updated it to newest version (4.3-4). + +## 2.3.3 correct templating of master.slaveJenkinsUrl + +Fixes #22708 + +## 2.3.2 Fix wrong value for overwritePluginsFromImage + +Fixes #23003 +Fixes #22633 + +Also fixes indentation for #23114 + +## 2.3.1 + +Always mount {{ .Values.master.jenkinsRef }}/secrets/ directory. Previous it +was mounted only when `master.enableXmlConfig` was enabled. + +## 2.3.0 + +Add an option to specify pod based on labels that can connect to master if NetworkPolicy is enabled + +## 2.2.0 increase retry for config auto reload + +Configure `REQ_RETRY_CONNECT` to `10` to give Jenkins more time to start up. + + +Value can be configured via `master.sidecars.configAutoReload.reqRetryConnect` + +## 2.1.2 updated README + +## 2.1.1 update credentials-binding plugin to 1.23 + +## 2.1.0 + +Add support to set `runAsUser` and `runAsGroup` for `agent`. + +## 2.0.1 + +Only render authorizationStrategy and securityRealm when values are set. + +## 2.0.0 Configuration as Code now default + container does not run as root anymore + +The README contains more details for this update. +Please note that the updated values contain breaking changes. + +## 1.27.0 Update plugin versions & sidecar container + +| plugin | old version | new version | +| --------------------- | ----------- | ----------- | +| kubernetes | 1.25.3 | 1.25.7 | +| workflow-job | 2.38 | 2.39 | +| credentials-binding | 1.21 | 1.22 | +| configuration-as-code | 1.39 | 1.41 | + +configAutoReload container updated from `kiwigrid/k8s-sidecar:0.1.132` to `kiwigrid/k8s-sidecar:0.1.144` + +## 1.26.0 + +Add support to override `workingDir` for default pod template + +## 1.25.0 + +Add support for installing plugins in addition to the chart's default plugins via `master.additionalPlugins` + +## 1.24.0 + +Allow configuration of yamlMergeStrategy via `agent.yamlMergeStrategy` + +## 1.23.2 + +In the `jenkins.xml.podTemplate` helper function, allow templating of all string values under `agent.volumes` except `type` by rendering them with the `tpl` function + +## 1.23.1 + +Added auto detection for Ingress API version + +## 1.23.0 + +Allow to use an existing secret for the jenkins admin credentials + +## 1.22.0 + +Add support for UI security in the default JCasC via `master.JCasC.securityRealm` and `master.JCasC.authorizationStrategy` which deny anonymous access by default + +## 1.21.3 + +Render `agent.envVars` in kubernetes pod template JCasC + +## 1.21.2 + +Cleanup `agent.yamlTemplate` rendering in kubernetes pod template XML configuration + +## 1.21.1 + +Render `agent.nodeSelector` in the kubernetes pod template JCasC + +## 1.21.0 + +Add support for overriding Ingress paths via `master.ingress.paths` + +## 1.20.0 + +Add the following options for configuring the Kubernetes plugin. + +- master.slaveDefaultsProviderTemplate +- master.slaveJenkinsUrl +- master.slaveJenkinsTunnel +- master.slaveConnectTimeout +- master.slaveReadTimeout + +## 1.19.0 + +Add support for disabling remember me via `master.disableRememberMe` +Add support for using a different markup formatter via `master.markupFormatter` + +## 1.18.1 + +Add support for executor mode configuraton with `master.executorMode`. + +## 1.18.0 Make installation of configuration-as-code plugin explicit + +Instead of configuring the configuration-as-code plugin version via +`master.JCasC.pluginVersion` it is now installed via `master.installPlugins` + +## 1.17.2 + +Allow templating of `serviceAccount.annotations` and `serviceAccountAgent.annotations` by rendering them with the `tpl` function + +## 1.17.1 + +Add support for Persistent Volume Claim (PVC) in `agent.volumes` + +## 1.17.0 + +Render `agent.volumes` in kubernetes pod template JCasC + +## 1.16.2 + +Reverts 1.16.1 as it introduced an error #22047 + +## 1.16.1 + +Fixed a bug with master.runAsUser variable due to use wrong type for comparison. + +## 1.16.0 + +Add `master.overwritePluginsFromImage` to allow support for jenkins plugins installed in the master image to persist. + +## 1.15.0 Update plugin versions & sidecar container + +| plugin | old version | new version | +| --------------------- | ----------- | ----------- | +| kubernetes | 1.25.1 | 1.25.3 | +| workflow-job | 2.36 | 2.38 | +| git | 4.2.0 | 4.2.2 | +| configuration-as-code | 1.36 | 1.39 | + +configAutoReload container updated from `kiwigrid/k8s-sidecar:0.1.20` to `kiwigrid/k8s-sidecar:0.1.132` + +## 1.14.0 + +support auto-reload container environment variables configuration + +## 1.13.3 + +Fix wrong indent in tolerations + +## 1.13.2 + +Add support for custom ClusterIP + +## 1.13.1 + +Fix `agent.yamlTemplate` rendering in kubernetes pod template JCasC + +## 1.13.0 + +Add `master.networkPolicy.internalAgents` and `master.networkPolicy.externalAgents` stanzas to fine grained controls over where internal/external agents can connect from. Internal ones are allowed based on pod labels and (optionally) namespaces, and external ones are allowed based on IP ranges. + +## 1.12.0 Support additional agents + +Add support for easy configuration of additional agents which inherit values from `agent`. + +## 1.11.3 + +Update the kubernetes plugin from 1.24.1 to 1.25.1 and grant 'watch' permission to 'events' which is required since this plugin version. + +## 1.11.2 Configure agent.args in values.yaml + +## 1.11.1 Support for master.additionalConfig + +Fixed a bug with jenkinsHome variable in range block when master.additionalConfig is set - Helm cannot evaluate field Values in type interface {}. + +## 1.11.0 Add support for configuring custom pod templates + +Add `agent.podTemplates` option for declaring custom pod templates in the default configured kubernetes cloud. + +## 1.10.1 Only copy JCasC files if there are any + +The chart always tried to copy Configuration as Code configs even if there are none. That resulted in an error which is resolved with this. + +## 1.10.0 Remove configuration-as-code-support plugins + +In recent version of configuration-as-code-plugin this is no longer necessary. + +## 1.9.24 + +Update JCasC auto-reload docs and remove stale ssh key references from version "1.8.0 JCasC auto reload works without ssh keys" + +## 1.9.23 Support jenkinsUriPrefix when JCasC is enabled + +Fixed a bug in the configuration as code reload URL, where it wouldn't work with a jenkinsUriPrefix set. + +## 1.9.22 + +Add `master.jenkinsHome` and `master.jenkinsRef` options to use docker images derivates from Jenkins + +## 1.9.21 + +Add `master.terminationGracePeriodSeconds` option + +## 1.9.20 + +Update default plugins + +- kubernetes:1.24.1 +- workflow-job:2.36 +- workflow-aggregator:2.6 +- credentials-binding:1.21 +- git:4.2.0 +- configuration-as-code:1.36 + +## 1.9.19 + +Update docs for Helm 3 + +## 1.9.18 + +Make `jenkins-home` attachable to Azure Disks without pvc + +```yaml + volumes: + - name: jenkins-home + azureDisk: + kind: Managed + diskName: myAKSDisk + diskURI: /subscriptions//resourceGroups/MC_myAKSCluster_myAKSCluster_eastus/providers/Microsoft.Compute/disks/myAKSDisk +``` + +## 1.9.16 + +Fix PodLabel for NetworkPolicy to work if enabled + +## 1.9.14 + +Properly fix case sense in `Values.master.overwriteConfig` in `config.yaml` + +## 1.9.13 + +Fix case sense in `Values.master.overwriteConfig` in `config.yaml` + +## 1.9.12 + +Scriptapprovals are overwritten when overwriteConfig is enabled + +## 1.9.10 + +Added documentation for `persistence.storageClass`. + +## 1.9.9 +Make `master.deploymentAnnotation` configurable. + +## 1.9.8 + +Make `agent.slaveConnectTimeout` configurable: by increasing this value Jenkins will not cancel&ask k8s for a pod again, while it's on `ContainerCreating`. Useful when you have big images or autoscaling takes some time. + +## 1.9.7 Update plugin versions + +plugin | old version | new version +--------------------- | ----------- | ---------- +kubernetes | 1.18.2 | 1.21.2 +workflow-job | 2.33 | 2.36 +credentials-binding | 1.19 | 1.20 +git | 3.11.0 | 4.0.0 +configuration-as-code | 1.27 | 1.32 + +## 1.9.6 + +Enables jenkins to use keystore inorder to have native ssl support #17790 + +## 1.9.5 Enable remoting security + +`Manage Jenkins` -> `Configure Global Security` -> `Enable Agent → Master Access Control` is now enabled via configuration as code plugin + +## 1.9.4 Option to set existing secret with Google Application Default Credentials + +Google application credentials are kept in a file, which has to be mounted to a pod. You can set `gcpcredentials` in `existingSecret` as follows: + +```yaml + existingSecret: + jenkins-service-account: + gcpcredentials: application_default_credentials.json +``` + +Helm template then creates the necessary volume mounts and `GOOGLE_APPLICATION_CREDENTIALS` environmental variable. + +## 1.9.3 Fix `JAVA_OPTS` when config auto-reload is enabled + +## 1.9.2 Add support for kubernetes-credentials-provider-plugin + +[kubernetes-credentials-provider-plugin](https://jenkinsci.github.io/kubernetes-credentials-provider-plugin/) needs permissions to get/watch/list kubernetes secrets in the namespaces where Jenkins is running. + +The necessary role binding can be created using `rbac.readSecrets` when `rbac.create` is `true`. + +To quote from the plugin documentation: + +> Because granting these permissions for secrets is not something that should be done lightly it is highly advised for security reasons that you both create a unique service account to run Jenkins as, and run Jenkins in a unique namespace. + +Therefor this is disabled by default. + +## 1.9.1 Update kubernetes plugin URL + +## 1.9.0 Change default serviceType to ClusterIP + +## 1.8.2 + +Revert fix in `1.7.10` since direct connection is now disabled by default. + +## 1.8.1 + +Add `master.schedulerName` to allow setting a Kubernetes custom scheduler + +## 1.8.0 JCasC auto reload works without ssh keys + +We make use of the fact that the Jenkins Configuration as Code Plugin can be triggered via http `POST` to `JENKINS_URL/configuration-as-code/reload`and a pre-shared key. +The sidecar container responsible for reloading config changes is now `kiwigrid/k8s-sidecar:0.1.20` instead of it's fork `shadwell/k8s-sidecar`. + +References: + +- [Triggering Configuration Reload](https://github.com/jenkinsci/configuration-as-code-plugin/blob/master/docs/features/configurationReload.md) +- [kiwigrid/k8s-sidecar](https://hub.docker.com/r/kiwigrid/k8s-sidecar) + +`master.sidecars.configAutoReload.enabled` now works using `casc.reload.token` + +## 1.7.10 + +Disable direct connection in default configuration (when kubernetes plugin version >= 1.20.2). +Note: In case direct connection is going to be used `jenkins/jnlp-slave` needs to be version `3.35-5` or newer. + +## 1.7.9 + +Prevented Jenkins Setup Wizard on new installations + +## 1.7.8 + +Extend extraPorts to be opened on the Service object, not just the container. + +## 1.7.7 + +Add persistentvolumeclaim permission to the role to support new dynamic pvc workspaces. + +## 1.7.6 + +Updated `master.slaveKubernetesNamespace` to parse helm templates. +Defined an sensible empty value to the following variables, to silence invalid warnings: + +- master.extraPorts +- master.scriptApproval +- master.initScripts +- master.JCasC.configScripts +- master.sidecars.other +- agent.envVars +- agent.volumes + +## 1.7.5 + +Fixed an issue where the JCasC won't run if JCasC auto-reload is enabled [issue #17135](https://github.com/helm/charts/issues/17135) + +## 1.7.4 + +Comments out JCasC example of jenkins.systemMessage so that it can be used by end users. Previously, an attempt to set systemMessage causes Jenkins to startup, citing duplicate JCasC settings for systemMessage [issue #13333](https://github.com/helm/charts/issues/13333) + +## 1.7.2 + +Update kubernetes-plugin to version 1.18.2 which fixes frequently encountered [JENKINS-59000](https://issues.jenkins-ci.org/plugins/servlet/mobile#issue/JENKINS-59000) + +## 1.7.1 + +Update the default requirements for jenkins-agent to 512Mi which fixes frequently encountered [issue #3723](https://github.com/helm/charts/issues/3723) + +## 1.7.0 + +[Jenkins Configuration as Code Plugin](https://github.com/jenkinsci/configuration-as-code-plugin) default configuration can now be enabled via `master.JCasC.defaultConfig`. + +JCasC default configuration includes: + +- Jenkins URL +- Admin email `master.jenkinsAdminEmail` +- crumbIssuer +- disableRememberMe: false +- mode: NORMAL +- numExecutors: {{ .Values.master.numExecutors }} +- projectNamingStrategy: "standard" +- kubernetes plugin + - containerCapStr via `agent.containerCap` + - jenkinsTunnel + - jenkinsUrl + - maxRequestsPerHostStr: "32" + - name: "kubernetes" + - namespace + - serverUrl: "https://kubernetes.default" + - template + - containers + - alwaysPullImage: `agent.alwaysPullImage` + - args + - command + - envVars + - image: `agent.image:agent.imageTag` + - name: `.agent.sideContainerName` + - privileged: `.agent.privileged` + - resourceLimitCpu: `agent.resources.limits.cpu` + - resourceLimitMemory: `agent.resources.limits.memory` + - resourceRequestCpu: `agent.resources.requests.cpu` + - resourceRequestMemory: `agent.resources.requests.memory` + - ttyEnabled: `agent.TTYEnabled` + - workingDir: "/home/jenkins" + - idleMinutes: `agent.idleMinutes` + - instanceCap: 2147483647 + - imagePullSecrets: + - name: `.agent.imagePullSecretName` + - label + - name + - nodeUsageMode: "NORMAL" + - podRetention: `agent.podRetention` + - serviceAccount + - showRawYaml: true + - slaveConnectTimeoutStr: "100" + - yaml: `agent.yamlTemplate` + - yamlMergeStrategy: "override" +- security: + - apiToken: + - creationOfLegacyTokenEnabled: false + - tokenGenerationOnCreationEnabled: false + - usageStatisticsEnabled: true + +Example `values.yaml` which enables JCasC, it's default config and configAutoReload: + +```yaml +master: + JCasC: + enabled: true + defaultConfig: true + sidecars: + configAutoReload: + enabled: true +``` + +add master.JCasC.defaultConfig and configure location + +- JCasC configuration is stored in template `jenkins.casc.defaults` + so that it can be used in `config.yaml` and `jcasc-config.yaml` + depending on if configAutoReload is enabled or not + +- Jenkins Location (URL) is configured to provide a startin point + for the config + +## 1.6.1 + +Print error message when `master.sidecars.configAutoReload.enabled` is `true`, but the admin user can't be found to configure the SSH key. + +## 1.6.0 + +Add support for Google Cloud Storage for backup CronJob (migrating from nuvo/kube-tasks to maorfr/kube-tasks) + +## 1.5.9 + +Fixed a warning when sidecar resources are provided through a parent chart or override values + +## 1.5.8 + +Fixed an issue when master.enableXmlConfig is set to false: Always mount jenkins-secrets volume if secretsFilesSecret is set (#16512) + +## 1.5.7 + +added initial changelog (#16324) +commit: cee2ebf98 + +## 1.5.6 + +enable xml config misspelling (#16477) +commit: a125b99f9 + +## 1.5.5 + +Jenkins master label (#16469) +commit: 4802d14c9 + +## 1.5.4 + +add option enableXmlConfig (#16346) +commit: 387d97a4c + +## 1.5.3 + +extracted "jenkins.URL" into template (#16347) +commit: f2fdf5332 + +## 1.5.2 + +Fix backups when deployment has custom name (#16279) +commit: 16b89bfff + +## 1.5.1 + +Ability to set custom namespace for ServiceMonitor (#16145) +commit: 18ee6cf01 + +## 1.5.0 + +update Jenkins plugins to fix security issue (#16069) +commit: 603cf2d2b + +## 1.4.3 + +Use fixed container name (#16068) +commit: b3e4b4a49 + +## 1.4.2 + +Provide default job value (#15963) +commit: c462e2017 + +## 1.4.1 + +Add Jenkins backendconfig values (#15471) +commit: 7cc9b54c7 + +## 1.4.0 + +Change the value name for docker image tags - standartise to helm preferred value name - tag; this also allows auto-deployments using weaveworks flux (#15565) +commit: 5c3d920e7 + +## 1.3.6 + +jenkins deployment port should be target port (#15503) +commit: 83909ebe3 + +## 1.3.5 + +Add support for namespace specification (#15202) +commit: e773201a6 + +## 1.3.4 + +Adding sub-path option for scraping (#14833) +commit: e04021154 + +## 1.3.3 + +Add existingSecret to Jenkins backup AWS credentials (#13392) +commit: d9374f57d + +## 1.3.2 + +Fix JCasC version (#14992) +commit: 26a6d2b99 + +## 1.3.1 + +Update affinity for a backup cronjob (#14886) +commit: c21ed8331 + +## 1.3.0 + +only install casc support plugin when needed (#14862) +commit: a56fc0540 + +## 1.2.2 + +DNS Zone customization (#14775) +commit: da2910073 + +## 1.2.1 + +only render comment if configAutoReload is enabled (#14754) +commit: e07ead283 + +## 1.2.0 + +update plugins to latest version (#14744) +commit: 84336558e + +## 1.1.24 + +add example for EmptyDir volume (#14499) +commit: cafb60209 + +## 1.1.23 + +check if installPlugins is set before using it (#14168) +commit: 1218f0359 + +## 1.1.22 + +Support servicemonitor and alerting rules (#14124) +commit: e15a27f48 + +## 1.1.21 + +Fix: healthProbe timeouts mapping to initial delay (#13875) +commit: 825b32ece + +## 1.1.20 + +Properly handle overwrite config for additional configs (#13915) +commit: 18ce9b558 + +## 1.1.18 + +update maintainer (#13897) +commit: 223002b27 + +## 1.1.17 + +add apiVersion (#13795) +commit: cd1e5c35a + +## 1.1.16 + +allow changing of the target port to support TLS termination sidecar (#13576) +commit: a34d3bbcc + +## 1.1.15 + +fix wrong pod selector in jenkins-backup (#13542) +commit: b5df4fd7e + +## 1.1.14 + +allow templating of customInitContainers (#13536) +commit: d1e1421f4 + +## 1.1.13 + +fix #13467 (wrong deprecation message) (#13511) +commit: fbe28fa1c + +## 1.1.12 + +Correct customInitContainers Name example. (#13405) +commit: 6c6e40405 + +## 1.1.11 + +fix master.runAsUser, master.fsGroup examples (#13389) +commit: 2d7e5bf72 + +## 1.1.10 + +Ability to specify raw yaml template (#13319) +commit: 77aaa9a5f + +## 1.1.9 + +correct NOTES.txt - use master.ingress.hostname (#13318) +commit: b08ef6280 + +## 1.1.8 + +explain how to upgrade major versions (#13273) +commit: e7617a97e + +## 1.1.7 + +Add support for idleMinutes and serviceAccount (#13263) +commit: 4595ee033 + +## 1.1.6 + +Use same JENKINS_URL no matter if slaves use different namespace (#12564) +commit: 94c90339f + +## 1.1.5 + +fix deprecation checks (#13224) +commit: c7d2f8105 + +## 1.1.4 + +Fix issue introduced in #13136 (#13232) +commit: 0dbcded2e + +## 1.1.3 + +fix chart errors (#13197) +commit: 692a1e3da + +## 1.1.2 + +correct selector for jenkins pod (#13200) +commit: 4537e7fda + +## 1.1.1 + +Fix rendering of customInitContainers and lifecycle for Jenkins helm chart (#13189) +commit: e8f6b0ada + +## 1.1.0 + +Add support for openshift route in jenkins (#12973) +commit: 48c58a430 + +## 1.0.0 + +helm chart best practices (#13136) +commit: b02ae3f48 + +### Breaking changes + +- values have been renamed to follow helm chart best practices for naming conventions so + that all variables start with a lowercase letter and words are separated with camelcase + +- all resources are now using recommended standard labels + + +As a result of the label changes also the selectors of the deployment have been updated. +Those are immutable so trying an updated will cause an error like: + +```text +Error: Deployment.apps "jenkins" is invalid: spec.selector: Invalid value: v1.LabelSelector{MatchLabels:map[string]string{"app.kubernetes.io/component":"jenkins-master", "app.kubernetes.io/instance":"jenkins"}, MatchExpressions:[]v1.LabelSelectorRequirement(nil)}: field is immutable +``` + +In order to upgrade, delete the Jenkins Deployment before upgrading: + +```console +kubectl delete deploy jenkins +``` + +## 0.40.0 + +Allow to override jenkins location protocol (#12257) +commit: 18a830626 + +## 0.39.0 + +Add possibility to add custom init-container and lifecycle for master-container (#13062) +commit: 14d043593 + +## 0.38.0 + +Support `priorityClassName` on Master Deployment (#13069) +commit: e896c62bc + +## 0.37.3 + +Add support for service account annotations in jenkins (#12969) +commit: b22774e2f + +## 0.37.2 + +fix: add hostName to ingress in values.yaml (#12946) +commit: 041045e9b + +## 0.37.1 + +Update to match actual defaults in value.yaml (#12904) +commit: 73b6d37eb + +## 0.37.0 + +Support multiple Jenkins instances in same namespace (#12748) +commit: 32ff2f343 + +## 0.36.5 + +Fix wrong comment in values.yaml (#12761) +commit: 9db8ced23 + +## 0.36.4 + +Re-add value for Ingress API Version (#12753) +commit: ecb7791b5 + +## 0.36.3 + +allow templating of volumes (#12734) +commit: adbda2ca6 + +## 0.36.2 + +Fix self-introduced whitespace bug (#12528) +commit: eec1678eb + +## 0.36.1 + +Add flag to overwrite jobs definition from values.yaml (#12427) +commit: fd349b2fc + +## 0.36.0 + +Replace OwnSshKey with AdminSshKey (#12140) (#12466) +commit: 80a8c9eb6 + +## 0.35.2 + +add note for breaking changes (#12203) +commit: e779c5a54 + +## 0.35.1 + +Allow Jenkins to run with READONLYROOTFS psp (#12338) +commit: 7c419e191 + +## 0.35.0 + +Jenkins OverwriteConfig setting also overwrites init scripts (#9468) +commit: 501335b76 + +## 0.34.1 + +Fix typo on hostname variable (#12156) +commit: 3d337d8dd + +## 0.34.0 + +Allow ingress without host rule (#11960) +commit: ddc966d1e + +## 0.33.2 + +Improve documentation - clarify that rbac is needed for autoreload (#11739) +commit: 9d75a5c34 + +## 0.33.1 + +use object for rollingUpdate (#11909) +commit: cb9cf21e8 + +## 0.33.0 + +Add hostAliases (#11701) +commit: 0b89e1094 + +## 0.32.10 + +Fix slave jnlp port always being reset when container is restarted (#11685) +commit: d7d51797b + +## 0.32.9 + +add ingress Hostname an ApiVersion to docs (#11576) +commit: 4d3e77137 + +## 0.32.8 + +Support custom master pod labels in deployment (#9714) (#11511) +commit: 9de96faa0 + +## 0.32.7 + +Fix Markdown syntax in README (#11496) +commit: a32221a95 + +## 0.32.6 + +Added custom labels on jenkins ingress (#11466) +commit: c875d2b9b + +## 0.32.5 + +fix typo in default jenkins agent image fixes #11356 (#11463) +commit: 30adb9a91 + +## 0.32.4 + +fix incorrect Deployment when using sidecars (#11413) +commit: 362b4cef8 + +## 0.32.3 + +[]: #10131 (#11411) +commit: 49cb72055 + +## 0.32.2 + +Option to expose the slave listener port as host port (#11187) +commit: 2f85a9663 + +## 0.32.1 + +Updating Jenkins deployment fails appears rollingUpdate needs to be (#11166) +commit: 07fc9dbde + +## 0.32.0 + +Merge Sidecard configs (#11339) +commit: 3696090b9 + +## 0.31.0 + +Add option to overwrite plugins (#11231) +commit: 0e9aa00a5 + +## 0.30.0 + +Added slave Pod env vars (#8743) +commit: 1499f6608 + +## 0.29.3 + +revert indentation to previous working version (#11293) +commit: 61662f17a + +## 0.29.2 + +allow running sidecar containers for Jenkins master (#10950) +commit: 9084ce54a + +## 0.29.1 + +Indent lines related to EnableRawHtmlMarkupFormatter (#11252) +commit: 20b310c08 + +## 0.29.0 + +Jenkins Configuration as Code (#9057) +commit: c3e8c0b17 + +## 0.28.11 + +Allow to enable OWASP Markup Formatter Plugin (#10851) +commit: 9486e5ddf + +## 0.28.10 + +Fixes #1341 -- update Jenkins chart documentation (#10290) +commit: 411c81cd0 + +## 0.28.9 + +Quoted JavaOpts values (#10671) +commit: 926a843a8 + +## 0.28.8 + +Support custom labels in deployment (#9714) (#10533) +commit: 3e00b47fa + +## 0.28.7 + +separate test resources (#10597) +commit: 7b7ae2d11 + +## 0.28.6 + +allow customizing livenessProbe periodSeconds (#10534) +commit: 3c94d250d + +## 0.28.5 + +Add role kind option (#8498) +commit: e791ad124 + +## 0.28.4 + +workaround for busybox's cp (Closes: #10471) (#10497) +commit: 0d51a4187 + +## 0.28.3 + +fix parsing java options (#10140) +commit: 9448d0293 + +## 0.28.2 + +Fix job definitions in standard values.yaml (#10184) +commit: 6b6355ae7 + +## 0.28.1 + +add numExecutors as a variable in values file (#10236) +commit: d5ea2050f + +## 0.28.0 + +various (#10223) +commit: e17d2a65d + +## 0.27.0 + +add backup cronjob (#10095) +commit: 863ead8db + +## 0.26.2 + +add namespace flag for port-forwarding in jenkins notes (#10399) +commit: 846b589a9 + +## 0.26.1 + +- fixes #10267 when executed with helm template - otherwise produces an invalid template. (#10403) + commit: 266f9d839 + +## 0.26.0 + +Add subPath for jenkins-home mount (#9671) +commit: a9c76ac9b + +## 0.25.1 + +update readme to indicate the correct image that is used by default (#9915) +commit: 6aba9631c + +## 0.25.0 + +Add ability to manually set Jenkins URL (#7405) +commit: a0178fcb4 + +## 0.24.0 + +Make AuthorizationStrategy configurable (#9567) +commit: 06545b226 + +## 0.23.0 + +Update Jenkins public chart (#9296) +commit: 4e5f5918b + +## 0.22.0 + +allow to override jobs (#9004) +commit: dca9f9ab9 + +## 0.21.0 + +Simple implementation of the option to define the ingress path to the jenkins service (#8101) +commit: 013159609 + +## 0.20.2 + +Cosmetic change to remove necessity of changing "appVersion" for every new LTS release (#8866) +commit: f52af042a + +## 0.20.1 + +Added ExtraPorts to open in the master pod (#7759) +commit: 78858a2fb + +## 0.19.1 + +Fix component label in NOTES.txt ... (#8300) +commit: c5494dbfe + +## 0.19.0 + +Kubernetes 1.9 support as well as automatic apiVersion detection (#7988) +commit: 6853ad364 + +## 0.18.1 + +Respect SlaveListenerPort value in config.xml (#7220) +commit: 0a5ddac35 + +## 0.18.0 + +Allow replacement of Jenkins config with configMap. (#7450) +commit: c766da3de + +## 0.17.0 + +Add option to allow host networking (#7530) +commit: dc2eeff32 + +## 0.16.25 + +add custom jenkins labels to the build agent (#7167) +commit: 3ecde5dbf + +## 0.16.24 + +Move kubernetes and job plugins to latest versions (#7438) +commit: 019e39456 + +## 0.16.23 + +Add different Deployment Strategies based on persistence (#6132) +commit: e0a20b0b9 + +## 0.16.22 + +avoid lint errors when adding Values.Ingress.Annotations (#7425) +commit: 99eacc854 + +## 0.16.21 + +bump appVersion to reflect new jenkins lts release version 2.121.3 (#7217) +commit: 296df165d + +## 0.16.20 + +Configure kubernetes plugin for including namespace value (#7164) +commit: c0dc6cc48 + +## 0.16.19 + +make pod retention policy setting configurable (#6962) +commit: e614c1033 + +## 0.16.18 + +Update plugins version (#6988) +commit: bf8180018 + +## 0.16.17 + +Add Master.AdminPassword in README (#6987) +commit: 13e754ad7 + +## 0.16.16 + +Added jenkins location configuration (#6573) +commit: 79de7026c + +## 0.16.15 + +use generic env var, not oracle specific env var (#6116) +commit: 6084ab4a4 + +## 0.16.14 + +Allow to specify resource requests and limits on initContainers (#6723) +commit: 942a33b1a + +## 0.16.13 + +Added support for NodePort service type for jenkens agent svc (#6571) +commit: 89a213c2b + +## 0.16.12 + +Added ability to configure multiple LoadBalancerSourceRanges (#6243) +commit: 01604ddbc + +## 0.16.11 + +Removing ContainerPort configuration as at the moment it does not work when you change this setting (#6411) +commit: e1c0468bd + +## 0.16.9 + +Fix jobs parsing for configmap by adding toYaml to jobs.yaml template (#3747) +commit: b2542a123 + +## 0.16.8 + +add jenkinsuriprefix in healthprobes (#5737) +commit: 435d7a7b9 + +## 0.16.7 + +Added the ability to switch from ClusterRoleBinding to RoleBinding. (#6190) +commit: dde03ede0 + +## 0.16.6 + +Make jenkins master pod security context optional (#6122) +commit: 63653fd59 + +## 0.16.5 + +Rework resources requests and limits (#6077) (#6077) +commit: e738f99d0 + +## 0.16.4 + +Add jenkins master pod annotations (#6313) +commit: 5e7325721 + +## 0.16.3 + +Split Jenkins readiness and liveness probe periods (#5704) +commit: fc6100c38 + +## 0.16.1 + +fix typo in jenkins README (#5228) +commit: 3cd3f4b8b + +## 0.16.0 + +Inherit existing plugins from Jenkins image (#5409) +commit: fd93bff82 + +## 0.15.1 + +Allow NetworkPolicy.ApiVersion and Master.Ingress.ApiVersion to Differ (#5103) +commit: 78ee4ba15 + +## 0.15.0 + +Secure Defaults (#5026) +commit: 0fe90b520 + +## 0.14.6 + +Wait for up to 2 minutes before failing liveness check (#5161) +commit: 2cd3fc481 + +## 0.14.5 + +correct ImageTag setting (#4371) +commit: 8ea04174d + +## 0.14.4 + +Update jenkins/README.md (#4559) +commit: d4e6352dd + +## 0.14.3 + +Bump appVersion (#4177) +commit: 605d3d441 + +## 0.14.2 + +Master.InitContainerEnv: Init Container Env Vars (#3495) +commit: c64abe27d + +## 0.14.1 + +Allow more configuration of Jenkins agent service (#4028) +commit: fc82f39b2 + +## 0.14.0 + +Add affinity settings (#3839) +commit: 64e82fa6a + +## 0.13.5 + +bump test timeouts (#3886) +commit: cd05dd99c + +## 0.13.4 + +Add OWNERS to jenkins chart (#3881) +commit: 1c106b9c8 + +## 0.13.3 + +Add fullnameOverride support (#3705) +commit: ec8080839 + +## 0.13.2 + +Update README.md (#3638) +commit: f6d274c37 + +## 0.13.1 + +Lower initial healthcheck delay (#3463) +commit: 9b99db67c + +## 0.13.0 + +Provision credentials.xml, secrets files and jobs (#3316) +commit: d305c5961 + +## 0.12.1 + +fix the default value for nodeUsageMode. (#3299) +commit: b68d19516 + +## 0.12.0 + +Recreate pods when CustomConfigMap is true and there are changes to the ConfigMap (which is how the vanilla chart works) (#3181) +commit: 86d29f804 + +## 0.11.1 + +Optionally adds liveness and readiness probes to jenkins (#3245) +commit: 8b9aa73ee + +## 0.11.0 + +Feature/run jenkins as non root user (#2899) +commit: 8918f4175 + +## 0.10.3 + +template the version to keep them synced (#3084) +commit: 35e7fa49a + +## 0.10.2 + +Update Chart.yaml +commit: e3e617a0b + +## 0.10.1 + +Merge branch 'master' into jenkins-test-timeout +commit: 9a230a6b1 + +Double retry count for Jenkins test +commit: 129c8e824 + +Jenkins: Update README | Master.ServiceAnnotations (#2757) +commit: 6571810bc + +## 0.10.0 + +Update Jenkins images and plugins (#2496) +commit: 2e2622682 + +## 0.9.4 + +Updating to remove the `.lock` directory as well (#2747) +commit: 6e676808f + +## 0.9.3 + +Use variable for service port when testing (#2666) +commit: d044f99be + +## 0.9.2 + +Review jenkins networkpolicy docs (#2618) +commit: 49911e458 + +Add image pull secrets to jenkins templates (#1389) +commit: 4dfae21fd + +## 0.9.1 + +Added persistent volume claim annotations (#2619) +commit: ac9e5306e + +Fix failing CI lint (#2758) +commit: 26f709f0e + +## 0.9.0 + +namespace defined templates with chart name (#2140) +commit: 408ae0b3f + +## 0.8.9 + +added useSecurity and adminUser to params (#1903) +commit: 39d2a03cd + +Use storageClassName for jenkins. (#1997) +commit: 802f6449b + +## 0.8.8 + +Remove old plugin locks before installing plugins (#1746) +commit: 6cd7b8ff4 + +promote initContainrs to podspec (#1740) +commit: fecc804fc + +## 0.8.7 + +add optional LoadBalancerIP option. (#1568) +commit: d39f11408 + +## 0.8.6 + +Fix bad key in values.yaml (#1633) +commit: dc27e5af3 + +## 0.8.5 + +Update Jenkins to support node selectors for agents. (#1532) +commit: 4af5810ff + +## 0.8.4 + +Add support for supplying JENKINS_OPTS and/or uri prefix (#1405) +commit: 6a331901a + +## 0.8.3 + +Add serviceAccountName to deployment (#1477) +commit: 0dc349b44 + +## 0.8.2 + +Remove path from ingress specification to allow other paths (#1599) +commit: e727f6b32 + +Update git plugin to 3.4.0 for CVE-2017-1000084 (#1505) +commit: 03482f995 + +## 0.8.1 + +Use consistent whitespace in template placeholders (#1437) +commit: 912f50c71 + +add configurable service annotations #1234 (#1244) +commit: 286861ca8 + +## 0.8.0 + +Jenkins v0.8.0 (#1385) +commit: 0009a2393 + +## 0.7.4 + +Use imageTag as version in config map (#1333) +commit: e8bb6ebb4 + +## 0.7.3 + +Add NetworkPolicy to Jenkins (#1228) +commit: 572b36c6d + +## 0.7.2 + +- Workflow plugin pin (#1178) + commit: ac3a0c7bc + +## 0.7.1 + +copy over plugins.txt in case of update (#1222) +commit: 75b5b1174 + +## 0.7.0 + +add jmx option (#964) +commit: 6ae8d1945 + +## 0.6.4 + +update jenkins to latest LTS 2.46.3 (#1182) +commit: ad90b4c27 + +## 0.6.3 + +Update chart maints to gh u/n (#1107) +commit: f357b77ed + +## 0.6.2 + +Add Agent.Privileged option (#957) +commit: 2cf4aced2 + +## 0.6.1 + +Upgrade jenkins to 2.46.2 (#971) +commit: 41bd742b4 + +## 0.6.0 + +Smoke test for Jenkins Chart (#944) +commit: 110441054 + +## 0.5.1 + +removed extra space from hardcoded password (#925) +commit: 85a9b9123 + +## 0.5.0 + +move config to init-container allowing use of upstream containers (#921) +commit: 1803c3d33 + +## 0.4.1 + +add ability to toggle jnlp-agent podTemplate generation (#918) +commit: accd53203 + +## 0.4.0 + +Jenkins add script approval (#916) +commit: c1746656e + +## 0.3.1 + +Update Jenkins to Latest LTS fixes #731 (#733) +commit: e9a3aed8b + +## 0.3.0 + +Added option to add Jenkins init scripts (#617) +commit: b889623d0 + +## 0.2.0 + +Add existing PVC (#716) +commit: 05271f145 + +## 0.1.15 + +use Master.ServicePort in config.xml (#769) +commit: f351f4b16 + +## 0.1.14 + +Added option to disable security on master node (#403) +commit: 3a6113d18 + +## 0.1.13 + +Added: extra mount points support for jenkins master (#474) +commit: fab0f7eb1 + +## 0.1.12 + +fix storageclass config typo (#548) +commit: 6fc0ff242 + +## 0.1.10 + +Changed default value of Kubernetes Cloud name to match one in kubernetes plugin (#404) +commit: 68351304a + +Add support for overriding the Jenkins ConfigMap (#524) +commit: f97ca53b1 + +## 0.1.9 + +Added jenkins-master ingress support (#402) +commit: d76a09588 + +## 0.1.8 + +Change description (#553) +commit: 91f5c24e1 + +Removed default Persistence.StorageClass: generic (#530) +commit: c87494c10 + +Update to the recommended pvc patterns. (#448) +commit: a7fc595aa + +Remove helm.sh/created annotations (#505) +commit: f380da2fb + +## 0.1.7 + +add support for explicit NodePort on jenkins chart (#342) +commit: f63c188da + +Add configurable loadBalancerSourceRanges for jenkins chart (#360) +commit: 44007c50e + +Update Jenkins version to current LTS (2.19.4) and Kubernetes Plugin to 0.10 (#341) +commit: 6c8678167 + +## 0.1.6 + +Add imagePullPolicy to init container (#295) +commit: 103ee1952 + +## 0.1.5 + +bump chart version with PVC metadata label additions +commit: 4aa9cf5b1 + +## 0.1.4 + +removed `*` from `jenkins/templates/NOTES.txt` +commit: 76212230b + +apply standard metadata labels to PVC's +commit: 58b730836 + +specify namespace in `kubectl get svc` commands in NOTES.txt +commit: 7d3287e81 + +Update Jenkins version to current LTS (#194) +commit: 2c0404049 + +## 0.1.1 + +escape fixed +commit: 2026e1d15 + +.status.loadBalancer.ingress[0].ip is empty in AWS +commit: 1810e37f4 + +.status.loadBalancer.ingress[0].ip is empty in AWS +commit: 3cbd3ced6 + +Remove 'Getting Started:' from various NOTES.txt. (#181) +commit: 2f63fd524 + +docs(\*): update READMEs to reference chart repos (#119) +commit: c7d1bff05 + +## 0.1.0 + +Move first batch of PVC charts to stable +commit: d745f4879 diff --git a/helm/whanos/charts/jenkins/Chart.yaml b/helm/whanos/charts/jenkins/Chart.yaml new file mode 100644 index 0000000..9f79707 --- /dev/null +++ b/helm/whanos/charts/jenkins/Chart.yaml @@ -0,0 +1,48 @@ +annotations: + artifacthub.io/category: integration-delivery + artifacthub.io/images: | + - name: jenkins + image: jenkins/jenkins:2.426.1-jdk11 + - name: k8s-sidecar + image: kiwigrid/k8s-sidecar:1.24.4 + - name: inbound-agent + image: jenkins/inbound-agent:3107.v665000b_51092-15 + - name: backup + image: maorfr/kube-tasks:0.2.0 + artifacthub.io/license: Apache-2.0 + artifacthub.io/links: | + - name: Chart Source + url: https://github.com/jenkinsci/helm-charts/tree/main/charts/jenkins + - name: Jenkins + url: https://www.jenkins.io/ + - name: support + url: https://github.com/jenkinsci/helm-charts/issues +apiVersion: v2 +appVersion: 2.426.1 +description: Jenkins - Build great things at any scale! The leading open source automation + server, Jenkins provides over 1800 plugins to support building, deploying and automating + any project. +home: https://jenkins.io/ +icon: https://get.jenkins.io/art/jenkins-logo/logo.svg +keywords: +- jenkins +- ci +- devops +maintainers: +- email: maor.friedman@redhat.com + name: maorfr +- email: mail@torstenwalter.de + name: torstenwalter +- email: garridomota@gmail.com + name: mogaal +- email: wmcdona89@gmail.com + name: wmcdona89 +- email: timjacomb1@gmail.com + name: timja +name: jenkins +sources: +- https://github.com/jenkinsci/jenkins +- https://github.com/jenkinsci/docker-inbound-agent +- https://github.com/maorfr/kube-tasks +- https://github.com/jenkinsci/configuration-as-code-plugin +version: 4.8.3 diff --git a/helm/whanos/charts/jenkins/README.md b/helm/whanos/charts/jenkins/README.md new file mode 100644 index 0000000..32172e1 --- /dev/null +++ b/helm/whanos/charts/jenkins/README.md @@ -0,0 +1,1127 @@ +# Jenkins + +[![Artifact Hub](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/jenkins)](https://artifacthub.io/packages/helm/jenkinsci/jenkins) +[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) +[![Releases downloads](https://img.shields.io/github/downloads/jenkinsci/helm-charts/total.svg)](https://github.com/jenkinsci/helm-charts/releases) +[![Join the chat at https://app.gitter.im/#/room/#jenkins-ci:matrix.org](https://badges.gitter.im/badge.svg)](https://app.gitter.im/#/room/#jenkins-ci:matrix.org) + +[Jenkins](https://www.jenkins.io/) is the leading open source automation server, Jenkins provides over 1800 plugins to support building, deploying and automating any project. + +This chart installs a Jenkins server which spawns agents on [Kubernetes](http://kubernetes.io) utilizing the [Jenkins Kubernetes plugin](https://plugins.jenkins.io/kubernetes/). + +Inspired by the awesome work of [Carlos Sanchez](https://github.com/carlossg). + +## Get Repository Info + +```console +helm repo add jenkins https://charts.jenkins.io +helm repo update +``` + +_See [`helm repo`](https://helm.sh/docs/helm/helm_repo/) for command documentation._ + +## Install Chart + +```console +# Helm 3 +$ helm install [RELEASE_NAME] jenkins/jenkins [flags] +``` + +_See [configuration](#configuration) below._ + +_See [helm install](https://helm.sh/docs/helm/helm_install/) for command documentation._ + +## Uninstall Chart + +```console +# Helm 3 +$ helm uninstall [RELEASE_NAME] +``` + +This removes all the Kubernetes components associated with the chart and deletes the release. + +_See [helm uninstall](https://helm.sh/docs/helm/helm_uninstall/) for command documentation._ + +## Upgrade Chart + +```console +# Helm 3 +$ helm upgrade [RELEASE_NAME] jenkins/jenkins [flags] +``` + +_See [helm upgrade](https://helm.sh/docs/helm/helm_upgrade/) for command documentation._ + +Visit the chart's [CHANGELOG](https://github.com/jenkinsci/helm-charts/blob/main/charts/jenkins/CHANGELOG.md) to view the chart's release history. +For migration between major version check [migration guide](#migration-guide). + +## Building weekly releases + +The default charts target Long-Term-Support (LTS) releases of Jenkins. +To use other versions the easiest way is to update the image tag to the version you want. +You can also rebuild the chart if you want the `appVersion` field to match. + +## Configuration + +See [Customizing the Chart Before Installing](https://helm.sh/docs/intro/using_helm/#customizing-the-chart-before-installing). +To see all configurable options with detailed comments, visit the chart's [values.yaml](https://github.com/jenkinsci/helm-charts/blob/main/charts/jenkins/values.yaml), or run these configuration commands: + +```console +# Helm 3 +$ helm show values jenkins/jenkins +``` + +For a summary of all configurable options, see [VALUES_SUMMARY.md](https://github.com/jenkinsci/helm-charts/blob/main/charts/jenkins/VALUES_SUMMARY.md). + +### Configure Security Realm and Authorization Strategy + +This chart configured a `securityRealm` and `authorizationStrategy` as shown below: + +```yaml +controller: + JCasC: + securityRealm: |- + local: + allowsSignup: false + enableCaptcha: false + users: + - id: "${chart-admin-username}" + name: "Jenkins Admin" + password: "${chart-admin-password}" + authorizationStrategy: |- + loggedInUsersCanDoAnything: + allowAnonymousRead: false +``` + +With the configuration above there is only a single user. +This is fine for getting started quickly, but it needs to be adjusted for any serious environment. + +So you should adjust this to suite your needs. +That could be using LDAP / OIDC / .. as authorization strategy and use globalMatrix as authorization strategy to configure more fine-grained permissions. + +### Consider using a custom image + +This chart allows the user to specify plugins which should be installed. However, for production use cases one should consider to build a custom Jenkins image which has all required plugins pre-installed. +This way you can be sure which plugins Jenkins is using when starting up and you avoid trouble in case of connectivity issues to the Jenkins update site. + +The [docker repository](https://github.com/jenkinsci/docker) for the Jenkins image contains [documentation](https://github.com/jenkinsci/docker#preinstalling-plugins) how to do it. + +Here is an example how that can be done: + +```Dockerfile +FROM jenkins/jenkins:lts +RUN jenkins-plugin-cli --plugins kubernetes workflow-aggregator git configuration-as-code +``` + +NOTE: If you want a reproducible build then you should specify a non-floating tag for the image `jenkins/jenkins:2.249.3` and specify plugin versions. + +Once you built the image and pushed it to your registry you can specify it in your values file like this: + +```yaml +controller: + image: "registry/my-jenkins" + tag: "v1.2.3" + installPlugins: false +``` + +Notice: `installPlugins` is set to false to disable plugin download. In this case, the image `registry/my-jenkins:v1.2.3` must have the plugins specified as default value for [the `controller.installPlugins` directive](https://github.com/jenkinsci/helm-charts/blob/main/charts/jenkins/VALUES_SUMMARY.md#jenkins-plugins) to ensure that the configuration side-car system works as expected. + +In case you are using a private registry you can use 'imagePullSecretName' to specify the name of the secret to use when pulling the image: + +```yaml +controller: + image: "registry/my-jenkins" + tag: "v1.2.3" + imagePullSecretName: registry-secret + installPlugins: false +``` + +### External URL Configuration + +If you are using the ingress definitions provided by this chart via the `controller.ingress` block the configured hostname will be the ingress hostname starting with `https://` or `http://` depending on the `tls` configuration. +The Protocol can be overwritten by specifying `controller.jenkinsUrlProtocol`. + +If you are not using the provided ingress you can specify `controller.jenkinsUrl` to change the URL definition. + +### Configuration as Code + +Jenkins Configuration as Code (JCasC) is now a standard component in the Jenkins project. +To allow JCasC's configuration from the helm values, the plugin [`configuration-as-code`](https://plugins.jenkins.io/configuration-as-code/) must be installed in the Jenkins Controller's Docker image (which is the case by default as specified by the [default value of the directive `controller.installPlugins`](https://github.com/jenkinsci/helm-charts/blob/main/charts/jenkins/VALUES_SUMMARY.md#jenkins-plugins)). + +JCasc configuration is passed through Helm values under the key `controller.JCasC`. +The section ["Jenkins Configuration as Code (JCasC)" of the page "VALUES_SUMMARY.md"](https://github.com/jenkinsci/helm-charts/blob/main/charts/jenkins/VALUES_SUMMARY.md#jenkins-configuration-as-code-jcasc) lists all the possible directives. + +In particular, you may specify custom JCasC scripts by adding sub-key under the `controller.JCasC.configScripts` for each configuration area where each corresponds to a plugin or section of the UI. + +The sub-keys (prior to `|` character) are only labels used to give the section a meaningful name. +The only restriction is they must conform to RFC 1123 definition of a DNS label, so they may only contain lowercase letters, numbers, and hyphens. + +Each key will become the name of a configuration yaml file on the controller in `/var/jenkins_home/casc_configs` (by default) and will be processed by the Configuration as Code Plugin during Jenkins startup. + +The lines after each `|` become the content of the configuration yaml file. + +The first line after this is a JCasC root element, e.g. jenkins, credentials, etc. + +Best reference is the Documentation link here: `https:///configuration-as-code`. + +The example below sets custom systemMessage: + +```yaml +controller: + JCasC: + configScripts: + welcome-message: | + jenkins: + systemMessage: Welcome to our CI\CD server. +``` + +More complex example that creates ldap settings: + +```yaml +controller: + JCasC: + configScripts: + ldap-settings: | + jenkins: + securityRealm: + ldap: + configurations: + - server: ldap.acme.com + rootDN: dc=acme,dc=uk + managerPasswordSecret: ${LDAP_PASSWORD} + groupMembershipStrategy: + fromUserRecord: + attributeName: "memberOf" +``` + +Keep in mind that default configuration file already contains some values that you won't be able to override under configScripts section. + +For example, you can not configure Jenkins URL and System Admin email address like this because of conflicting configuration error. + +Incorrect: + +```yaml +controller: + JCasC: + configScripts: + jenkins-url: | + unclassified: + location: + url: https://example.com/jenkins + adminAddress: example@mail.com +``` + +Correct: + +```yaml +controller: + jenkinsUrl: https://example.com/jenkins + jenkinsAdminEmail: example@mail.com +``` + +Further JCasC examples can be found [here](https://github.com/jenkinsci/configuration-as-code-plugin/tree/master/demos). + +#### Breaking out large Config as Code scripts + +Jenkins Config as Code scripts can become quite large, and maintaining all of your scripts within one yaml file can be difficult. The Config as Code plugin itself suggests updating the `CASC_JENKINS_CONFIG` environment variable to be a comma separated list of paths for the plugin to traverse, picking up the yaml files as needed. +However, under the Jenkins helm chart, this `CASC_JENKINS_CONFIG` value is maintained through the templates. A better solution is to split your `controller.JCasC.configScripts` into separate values files, and provide each file during the helm install. + +For example, you can have a values file (e.g values_main.yaml) that defines the values described in the `VALUES_SUMMARY.md` for your Jenkins configuration: + +```yaml +jenkins: + controller: + jenkinsUrlProtocol: https + installPlugins: false + ... +``` + +In a second file (e.g values_jenkins_casc.yaml), you can define a section of your config scripts: + +```yaml +jenkins: + controller: + JCasC: + configScripts: + jenkinsCasc: | + jenkins: + disableRememberMe: false + mode: NORMAL + ... +``` + +And keep extending your config scripts by creating more files (so not all config scripts are located in one yaml file for better maintenance): + +values_jenkins_unclassified.yaml + +```yaml +jenkins: + controller: + JCasC: + configScripts: + unclassifiedCasc: | + unclassified: + ... +``` + +When installing, you provide all relevant yaml files (e.g `helm install -f values_main.yaml -f values_jenkins_casc.yaml -f values_jenkins_unclassified.yaml ...`). Instead of updating the `CASC_JENKINS_CONFIG` environment variable to include multiple paths, multiple CasC yaml files will be created in the same path `var/jenkins_home/casc_configs`. + +#### Config as Code With or Without Auto-Reload + +Config as Code changes (to `controller.JCasC.configScripts`) can either force a new pod to be created and only be applied at next startup, or can be auto-reloaded on-the-fly. +If you set `controller.sidecars.configAutoReload.enabled` to `true`, a second, auxiliary container will be installed into the Jenkins controller pod, known as a "sidecar". +This watches for changes to configScripts, copies the content onto the Jenkins file-system and issues a POST to `http:///reload-configuration-as-code` with a pre-shared key. +You can monitor this sidecar's logs using command `kubectl logs -c config-reload -f`. +If you want to enable auto-reload then you also need to configure rbac as the container which triggers the reload needs to watch the config maps: + +```yaml +controller: + sidecars: + configAutoReload: + enabled: true +rbac: + create: true +``` + +### Allow Limited HTML Markup in User-Submitted Text + +Some third-party systems (e.g. GitHub) use HTML-formatted data in their payload sent to a Jenkins webhook (e.g. URL of a pull-request being built). +To display such data as processed HTML instead of raw text set `controller.enableRawHtmlMarkupFormatter` to true. +This option requires installation of the [OWASP Markup Formatter Plugin (antisamy-markup-formatter)](https://plugins.jenkins.io/antisamy-markup-formatter/). +This plugin is **not** installed by default but may be added to `controller.additionalPlugins`. + +### Change max connections to Kubernetes API +When using agents with containers other than JNLP, The kubernetes plugin will communicate with those containers using the Kubernetes API. this changes the maximum concurrent connections +```yaml +agent: + maxRequestsPerHostStr: "32" +``` +This will change the configuration of the kubernetes "cloud" (as called by jenkins) that is created automatically as part of this helm chart. + +### Change container cleanup timeout API +For tasks that use very large images, this timeout can be increased to avoid early termination of the task while the Kubernetes pod is still deploying. +```yaml +agent: + retentionTimeout: "32" +``` +This will change the configuration of the kubernetes "cloud" (as called by jenkins) that is created automatically as part of this helm chart. + +### Change seconds to wait for pod to be running +This will change how long Jenkins will wait (seconds) for pod to be in running state. +```yaml +agent: + waitForPodSec: "32" +``` +This will change the configuration of the kubernetes "cloud" (as called by jenkins) that is created automatically as part of this helm chart. + +### Mounting Volumes into Agent Pods + +Your Jenkins Agents will run as pods, and it's possible to inject volumes where needed: + +```yaml +agent: + volumes: + - type: Secret + secretName: jenkins-mysecrets + mountPath: /var/run/secrets/jenkins-mysecrets +``` + +The supported volume types are: `ConfigMap`, `EmptyDir`, `HostPath`, `Nfs`, `PVC`, `Secret`. +Each type supports a different set of configurable attributes, defined by [the corresponding Java class](https://github.com/jenkinsci/kubernetes-plugin/tree/master/src/main/java/org/csanchez/jenkins/plugins/kubernetes/volumes). + +### NetworkPolicy + +To make use of the NetworkPolicy resources created by default, install [a networking plugin that implements the Kubernetes NetworkPolicy spec](https://kubernetes.io/docs/tasks/administer-cluster/declare-network-policy#before-you-begin). + +[Install](#install-chart) helm chart with network policy enabled by setting `networkPolicy.enabled` to `true`. + +You can use `controller.networkPolicy.internalAgents` and `controller.networkPolicy.externalAgents` stanzas for fine-grained controls over where internal/external agents can connect from. +Internal ones are allowed based on pod labels and (optionally) namespaces, and external ones are allowed based on IP ranges. + +### Script approval list + +`controller.scriptApproval` allows to pass function signatures that will be allowed in pipelines. +Example: + +```yaml +controller: + scriptApproval: + - "method java.util.Base64$Decoder decode java.lang.String" + - "new java.lang.String byte[]" + - "staticMethod java.util.Base64 getDecoder" +``` + +### Custom Labels + +`controller.serviceLabels` can be used to add custom labels in `jenkins-controller-svc.yaml`. +For example: + +```yaml +ServiceLabels: + expose: true +``` + +### Persistence + +The Jenkins image stores persistence under `/var/jenkins_home` path of the container. +A dynamically managed Persistent Volume Claim is used to keep the data across deployments, by default. +This is known to work in GCE, AWS, and minikube. Alternatively, a previously configured Persistent Volume Claim can be used. + +It is possible to mount several volumes using `persistence.volumes` and `persistence.mounts` parameters. +See additional `persistence` values using [configuration commands](#configuration). + +#### Existing PersistentVolumeClaim + +1. Create the PersistentVolume +2. Create the PersistentVolumeClaim +3. [Install](#install-chart) the chart, setting `persistence.existingClaim` to `PVC_NAME` + +#### Long Volume Attach/Mount Times + +Certain volume type and filesystem format combinations may experience long +attach/mount times, [10 or more minutes][K8S_VOLUME_TIMEOUT], when using +`fsGroup`. This issue may result in the following entries in the pod's event +history: + +```console +Warning FailedMount 38m kubelet, aks-default-41587790-2 Unable to attach or mount volumes: unmounted volumes=[jenkins-home], unattached volumes=[plugins plugin-dir jenkins-token-rmq2g sc-config-volume tmp jenkins-home jenkins-config secrets-dir]: timed out waiting for the condition +``` + +In these cases, experiment with replacing `fsGroup` with +`supplementalGroups` in the pod's `securityContext`. This can be achieved by +setting the `controller.podSecurityContextOverride` Helm chart value to +something like: + +```yaml +controller: + podSecurityContextOverride: + runAsNonRoot: true + runAsUser: 1000 + supplementalGroups: [1000] +``` + +This issue has been reported on [azureDisk with ext4][K8S_VOLUME_TIMEOUT] and +on [Alibaba cloud][K8S_VOLUME_TIMEOUT_ALIBABA]. + +[K8S_VOLUME_TIMEOUT]: https://github.com/kubernetes/kubernetes/issues/67014 +[K8S_VOLUME_TIMEOUT_ALIBABA]: https://github.com/kubernetes/kubernetes/issues/67014#issuecomment-698770511 + +#### Storage Class + +It is possible to define which storage class to use, by setting `persistence.storageClass` to `[customStorageClass]`. +If set to a dash (`-`), dynamic provisioning is disabled. +If the storage class is set to null or left undefined (`""`), the default provisioner is used (gp2 on AWS, standard on GKE, AWS & OpenStack). + +### Additional Secrets + +Additional secrets and Additional Existing Secrets, +can be mounted into the Jenkins controller through the chart or created using `controller.additionalSecrets` or `controller.additionalExistingSecrets`. +A common use case might be identity provider credentials if using an external LDAP or OIDC-based identity provider. +The secret may then be referenced in JCasC configuration (see [JCasC configuration](#configuration-as-code)). + +`values.yaml` controller section, referencing mounted secrets: +```yaml +controller: + # the 'name' and 'keyName' are concatenated with a '-' in between, so for example: + # an existing secret "secret-credentials" and a key inside it named "github-password" should be used in Jcasc as ${secret-credentials-github-password} + # 'name' and 'keyName' must be lowercase RFC 1123 label must consist of lower case alphanumeric characters or '-', + # and must start and end with an alphanumeric character (e.g. 'my-name', or '123-abc') + # existingSecret existing secret "secret-credentials" and a key inside it named "github-username" should be used in Jcasc as ${github-username} + # When using existingSecret no need to specify the keyName under additionalExistingSecrets. + existingSecret: secret-credentials + + additionalExistingSecrets: + - name: secret-credentials + keyName: github-username + - name: secret-credentials + keyName: github-password + - name: secret-credentials + keyName: token + + additionalSecrets: + - name: client_id + value: abc123 + - name: client_secret + value: xyz999 + JCasC: + securityRealm: | + oic: + clientId: ${client_id} + clientSecret: ${client_secret} + ... + configScripts: + jenkins-casc-configs: | + credentials: + system: + domainCredentials: + - credentials: + - string: + description: "github access token" + id: "github_app_token" + scope: GLOBAL + secret: ${secret-credentials-token} + - usernamePassword: + description: "github access username password" + id: "github_username_pass" + password: ${secret-credentials-github-password} + scope: GLOBAL + username: ${secret-credentials-github-username} +``` + +For more information, see [JCasC documentation](https://github.com/jenkinsci/configuration-as-code-plugin/blob/master/docs/features/secrets.adoc#kubernetes-secrets). + +### Secret Claims from HashiCorp Vault + +It's possible for this chart to generate `SecretClaim` resources in order to automatically create and maintain Kubernetes `Secrets` from HashiCorp [Vault](https://www.vaultproject.io/) via [`kube-vault-controller`](https://github.com/roboll/kube-vault-controller) + +These `Secrets` can then be referenced in the same manner as Additional Secrets above. + +This can be achieved by defining required Secret Claims within `controller.secretClaims`, as follows: +```yaml +controller: + secretClaims: + - name: jenkins-secret + path: secret/path + - name: jenkins-short-ttl + path: secret/short-ttl-path + renew: 60 +``` + +### RBAC + +RBAC is enabled by default. If you want to disable it you will need to set `rbac.create` to `false`. + +### Backup + +Adds a backup CronJob for jenkins, along with required RBAC resources. See additional `backup` values using [configuration commands](#configuration). + +#### Example: Backup to Google Cloud Storage Bucket + +Let's look at a quick example. Let's pretend we are backing up Jenkins to a **Google Cloud Storage (GCS) Bucket**. Here is what the process would look like: + +##### 1. Create a Google Cloud Platform Account + +If you don't have a GCP account, you can create a Free Account with the link below: + +- + +##### 2. Create a GCS bucket with a unique name + +You need to create a GCS bucket with a unique name, which you can do by following the guide below: + +- + +##### 3. Create a GCP Service Account + +In order for the backup job to upload Jenkins data to the GCS bucket, you need to provide it with a Google Service Account, which you can create by following the guide below: + +- + +##### 4. Bind `roles/storage.admin` role to Service Account + +Now you need to provide your GCP Service Account with the `roles/storage.admin` role, which has permissions to read/write content to a GCS bucket. You can do this by following the guide below: + +- + +##### 5. Create a Service Account Key + +Now that you have a Service Account (SA), you need to create a Service Account Key, which is a file that represents the GCP Service Account that will get passed to the Backup Job (and later on to the Recovery Job). You can create it by following the guide below: + +- + +##### 6. Create a Kubernetes Secret from the Service Account key + +In order for the Backup Job to access the GCP Service Account Key you need to create Kubernetes Secret, which you can create using the command below: + +```bash +# Replace with the path to the SA Key +kubectl -n jenkins create secret generic jenkinsgcp --from-file=sa-credentials.json=/path/to/sa_key.json +``` + +**NOTE**: This assumes that you will deploy the Jenkins chart in the `jenkins` namespace. + +##### 7. Deploy the Jenkins Helm Chart using a modified values file + +Rather than using a long command to pass on all the new Chart values, create a values file called `values.yaml`, then put the following content on it, then save it: + +```yaml +backup: + enabled: true + schedule: "0 2 * * *" # Runs every day at 2 am, change it to whatever interval works for you + existingSecret: + jenkinsgcp: # This is the secret name + gcpcredentials: sa-credentials.json # The service account file in the secret + destination: "gcs://BUCKET_NAME/jenkins-k8s-backup" # Replace with Bucket Name from previous step +controller: + initializeOnce: true # Installs latest plugins as soon as Jenkins starts + installLatestPlugins: true +persistence: + enabled: true # So that we have a PVC that we can backup +``` + +**NOTE**: The [`gcpcredentials`](https://github.com/fabiogomezdiaz/helm-charts-1/blob/main/charts/jenkins/values.yaml#L829) key in the [`jenkinsgcp`](https://github.com/fabiogomezdiaz/helm-charts-1/blob/main/charts/jenkins/values.yaml#L827) field tells the Helm chart that we will be using a GCS bucket as our backup. + +##### 8. Deploy Jenkins Chart with new values + +Now that we have everything in place, let's deploy the Jenkins Chart with the new values file: + +```bash +helm upgrade --install jenkins --namespace jenkins \ + -f values.yaml \ + jenkinsci/jenkins; +``` + +**NOTE**: Save the password from this installation as it will be needed in the [Restore from Backup in Google Cloud Storage Bucket](#example-restore-from-backup-in-google-cloud-storage-bucket) section. + +##### 9. Create resources to backup in Jenkins + +Once Jenkins is available, go to Jenkins and create jobs, download plugins, and create credentials so that we have something to backup other than the default Jenkins installation. + +##### 10. Trigger the backup job + +The values file we used to deploy Jenkins runs the backup job every day at 2 AM. + +If you don't want to wait that long for the job to start running, then patch the CronJob to run in the next minute with the following commands: + +```bash +# Update CronJob to run every minute +kubectl -n jenkins patch cronjob.batch/jenkins-backup --patch '{"spec": {"schedule": "* * * * *"}}' + +# Run this command until the "jenkins-backup-*" container is running +kubectl get pods | grep backup; + +# To prevent multiple jobs from spanning every minute, change the CronJob back to original schedule +kubectl -n jenkins patch cronjob.batch/jenkins-backup --patch '{"spec": {"schedule": "0 2 * * *"}}' +``` + +##### 11. Verify that the backup job completed successfully + +Once the job is running, then query the backup pod logs to monitor progress as follows: + +```bash +# Get backup container name +BACKUP_CONTAINER=$(kubectl get pods | grep backup | awk '{print $1}'); + +# Stream logs of backup container until job is finished +kubectl logs -f ${BACKUP_CONTAINER}; +``` + +**NOTE**: The backup job will create a time-stamped folder in the GCS bucket each time the backup job runs. + +If you can see a success message from the backup job and can see the contents of the backup on your GCS bucket, then the backup was successful! + +A similar process would work for AWS S3. See additional `backup` values using [configuration commands](#configuration). + +**NOTE**: If an environmental variable `AWS_REGION` is not provided, the region of the AWS S3 bucket will be assumed to be `eu-central-1`. If you want to use an S3 bucket in another region, you need to provide the bucket's region as an environmental variable as below: + +```yaml +backup: + env: # The region of your S3 bucket. + - name: AWS_REGION + value: us-east-1 +``` + +### Restore From Backup + +To restore a backup, you can use the `kube-tasks` underlying tool called [skbn](https://github.com/maorfr/skbn), which copies files from cloud storage to Kubernetes. +The best way to do it would be using a `Job` to copy files from the desired backup tag to the Jenkins pod. + +See the following example for more details. + +#### Example: Restore from Backup in Google Cloud Storage Bucket + +**NOTE**: This section assumes that you ran the steps in [Example: Backup to Google Cloud Storage Bucket](#example-backup-to-google-cloud-storage-bucket) beforehand and that you **saved the password** for that Jenkins installation, which you will need at the end of this section. + +Let's pretend you are restoring a backup from a Google Cloud Storage Bucket because you completely lost your Jenkins installation and you are starting from scratch. + +In the following steps, we will explain what this process would look like: + +##### 1. Reinstall the Jenkins Helm Chart + +First, we need to remove the old Jenkins installation that we backed up previously, then we can install a clean Jenkins instance to restore from GCS backup. + +To do so, run the following commands: + +```bash +# Delete old Jenkins installation +helm delete jenkins + +# Install Jenkins Chart +helm upgrade --install jenkins --namespace jenkins \ + -f values.yaml \ + jenkinsci/jenkins; +``` + +**NOTE**: This Command uses the same values file that was created in the [7. Deploy the Jenkins Helm Chart using a modified values file](#7-deploy-the-jenkins-helm-chart-using-a-modified-values-file) section. + +Now verify that Jenkins is up and running and it DOES NOT have any of the resources you created earlier. + +##### 2. Create a Kubernetes Service Account for the Restore Job + +In order for the Restore job to pull backup data from the GCS bucket and put it in the jenkins `/var/jenkins_home` folder in the Jenkins pod, you need to create the following: + +- A [Kubernetes Service Account](https://kubernetes.io/docs/reference/access-authn-authz/service-accounts-admin/) (not to be confused with a GCP Service Account) for the Restore job. +- A [Kubernetes ClusterRole](https://kubernetes.io/docs/reference/access-authn-authz/rbac/#role-and-clusterrole) that lists the necessary permissions to update the data in the volumes of other pods. +- A [Kubernetes ClusterRoleBinding](https://kubernetes.io/docs/reference/access-authn-authz/rbac/#rolebinding-and-clusterrolebinding) that binds the above ClusterRole to the Service Account. + +To do so, create a file called `restore-rbac.yaml` and enter the following content, then save it: + +```yaml +apiVersion: v1 +kind: ServiceAccount +metadata: + labels: + app: skbn + name: skbn + namespace: jenkins +--- +apiVersion: rbac.authorization.k8s.io/v1 +kind: ClusterRole +metadata: + labels: + app: skbn + name: skbn +rules: +- apiGroups: [""] + resources: ["pods", "pods/log"] + verbs: ["get", "list"] +- apiGroups: [""] + resources: ["pods/exec"] + verbs: ["create"] +--- +apiVersion: rbac.authorization.k8s.io/v1 +kind: ClusterRoleBinding +metadata: + labels: + app: skbn + name: skbn +roleRef: + apiGroup: rbac.authorization.k8s.io + kind: ClusterRole + name: skbn +subjects: +- kind: ServiceAccount + name: skbn + namespace: jenkins +``` + +To apply the above manifest, run the following command: + +```bash +kubectl apply -f restore-rbac.yaml +``` + +##### 3. Create a Kubernetes Job to restore Jenkins + +The logic that will execute the Jenkins restoration from a GCS backup will be done through a +[Kubernetes Job](https://kubernetes.io/docs/concepts/workloads/controllers/job/), which will run only once as needed. + +To create the job, create a manifest file called `restore.yaml` with the following content, then save it: + +```yaml +apiVersion: batch/v1 +kind: Job +metadata: + labels: + app: skbn + name: skbn + namespace: jenkins +spec: + template: + metadata: + labels: + app: skbn + spec: + restartPolicy: OnFailure + serviceAccountName: skbn + containers: + - name: skbn + image: maorfr/skbn + command: ["skbn"] + args: + - "cp" + - "--src" + - "gcs://BUCKET_NAME/jenkins-k8s-backup/BACKUP_NAME" + - "--dst" + - "k8s://jenkins/jenkins-0/jenkins/var/jenkins_home" + imagePullPolicy: IfNotPresent + env: + - name: GOOGLE_APPLICATION_CREDENTIALS + value: /var/run/secrets/jenkinsgcp/sa-credentials.json + volumeMounts: + - mountPath: /var/run/secrets/jenkinsgcp + name: jenkinsgcp + volumes: + - name: jenkinsgcp + secret: + secretName: jenkinsgcp +``` + +While the above Job manifest is mostly complete, you need to replace a couple of things, as follows: + +- Replace `BUCKET_NAME` with the GCS Bucket name created in [Create a GCS bucket with a unique name](#2-create-a-gcs-bucket-with-a-unique-name). +- Go to your GCS bucket and find the name of the latest timestamped folder (i.e. `20210717154947`), then replace `BACKUP_NAME` with it, then save the file. + +Notice that we are using the `jenkinsgcp` Kubernetes Secret that holds the `sa-credentials.json` key file for the GCP Service Account that we created in [Create a Service Account Key](#5-create-a-service-account-key). + +Having the Kubernetes Secret provide the GCP Service Account Key to the Restore Kubernetes Job is what will allow the Job to download the contents of the backup from the GCS bucket and put it into the `/var/jenkins_home` folder in the Persistent Volume Claim of the `jenkins-0` pod. + +##### 4. Deploy the Restore Job + +Deploy the Restore Job using the following command: + +```bash +kubectl apply -f restore.yaml +``` + +Wait about a minute for the Job to start, then query the logs using the following commands: + +```bash +# Get restore container name +RESTORE_CONTAINER=$(kubectl get pods | grep skbn | awk '{print $1}'); + +# Stream logs of restore container until job is finished +kubectl logs -f ${RESTORE_CONTAINER}; +``` + +Watch the logs until the job is done. This usually takes a few minutes. + +##### 5. Verify that Jenkins was restored from GCS Backup + +Login to Jenkins, then click on `Manage Jenkins-> Reload Configuration from Disk`, then press `OK`. + +Jenkins is now going to reload the backup content from disk and restart. Now, if you performed this on a new Jenkins installation, you will **not be able to login** using the password for the new installation of Jenkins. + +Because we are restoring from the backup of a previous installation, we need to login using the password for the old Jenkins installation. + +So, refresh your browser and login to Jenkins using the password from the backup. + +Now, verify that all your jobs, plugins, and credentials from that backup are showing up, and if they are, then CONGRATULATIONS on successfully restoring Jenkins from a GCS Backup! + +A similar process would work for AWS S3. See additional `backup` values using [configuration commands](#configuration) to figure out how what fields to put in the Restore Job manifest. + +### Adding Custom Pod Templates + +It is possible to add custom pod templates for the default configured kubernetes cloud. +Add a key under `agent.podTemplates` for each pod template. Each key (prior to `|` character) is just a label, and can be any value. +Keys are only used to give the pod template a meaningful name. The only restriction is they may only contain RFC 1123 \ DNS label characters: lowercase letters, numbers, and hyphens. Each pod template can contain multiple containers. +There's no need to add the _jnlp_ container since the kubernetes plugin will automatically inject it into the pod. +For this pod templates configuration to be loaded the following values must be set: + +```yaml +controller.JCasC.defaultConfig: true +``` + +The example below creates a python pod template in the kubernetes cloud: + +```yaml +agent: + podTemplates: + python: | + - name: python + label: jenkins-python + serviceAccount: jenkins + containers: + - name: python + image: python:3 + command: "/bin/sh -c" + args: "cat" + ttyEnabled: true + privileged: true + resourceRequestCpu: "400m" + resourceRequestMemory: "512Mi" + resourceLimitCpu: "1" + resourceLimitMemory: "1024Mi" +``` + +Best reference is `https:///configuration-as-code/reference#Cloud-kubernetes`. + +### Adding Pod Templates Using additionalAgents + +`additionalAgents` may be used to configure additional kubernetes pod templates. +Each additional agent corresponds to `agent` in terms of the configurable values and inherits all values from `agent` so you only need to specify values which differ. +For example: + +```yaml +agent: + podName: default + customJenkinsLabels: default + # set resources for additional agents to inherit + resources: + limits: + cpu: "1" + memory: "2048Mi" + +additionalAgents: + maven: + podName: maven + customJenkinsLabels: maven + # An example of overriding the jnlp container + # sideContainerName: jnlp + image: jenkins/jnlp-agent-maven + tag: latest + python: + podName: python + customJenkinsLabels: python + sideContainerName: python + image: python + tag: "3" + command: "/bin/sh -c" + args: "cat" + TTYEnabled: true +``` + +### Ingress Configuration + +This chart provides ingress resources configurable via the `controller.ingress` block. + +The simplest configuration looks like the following: + +```yaml +controller: + ingress: + enabled: true + paths: [] + apiVersion: "extensions/v1beta1" + hostName: jenkins.example.com +``` + +This snippet configures an ingress rule for exposing jenkins at `jenkins.example.com` + +You can define labels and annotations via `controller.ingress.labels` and `controller.ingress.annotations` respectively. +Additionally, you can configure the ingress tls via `controller.ingress.tls`. +By default, this ingress rule exposes all paths. +If needed this can be overwritten by specifying the wanted paths in `controller.ingress.paths` + +If you want to configure a secondary ingress e.g. you don't want the jenkins instance exposed but still want to receive webhooks you can configure `controller.secondaryingress`. +The secondaryingress doesn't expose anything by default and has to be configured via `controller.secondaryingress.paths`: + +```yaml +controller: + ingress: + enabled: true + apiVersion: "extensions/v1beta1" + hostName: "jenkins.internal.example.com" + annotations: + kubernetes.io/ingress.class: "internal" + secondaryingress: + enabled: true + apiVersion: "extensions/v1beta1" + hostName: "jenkins-scm.example.com" + annotations: + kubernetes.io/ingress.class: "public" + paths: + - /github-webhook +``` + +## Prometheus Metrics + +If you want to expose Prometheus metrics you need to install the [Jenkins Prometheus Metrics Plugin](https://github.com/jenkinsci/prometheus-plugin). +It will expose an endpoint (default `/prometheus`) with metrics where a Prometheus Server can scrape. + +If you have implemented [Prometheus Operator](https://github.com/prometheus-operator/prometheus-operator), you can set `master.prometheus.enabled` to `true` to configure a `ServiceMonitor` and `PrometheusRule`. +If you want to further adjust alerting rules you can do so by configuring `master.prometheus.alertingrules` + +If you have implemented Prometheus without using the operator, you can leave `master.prometheus.enabled` set to `false`. + +### Running Behind a Forward Proxy + +The controller pod uses an Init Container to install plugins etc. If you are behind a corporate proxy it may be useful to set `controller.initContainerEnv` to add environment variables such as `http_proxy`, so that these can be downloaded. + +Additionally, you may want to add env vars for the init container, the Jenkins container, and the JVM (`controller.javaOpts`): + +```yaml +controller: + initContainerEnv: + - name: http_proxy + value: "http://192.168.64.1:3128" + - name: https_proxy + value: "http://192.168.64.1:3128" + - name: no_proxy + value: "" + - name: JAVA_OPTS + value: "-Dhttps.proxyHost=proxy_host_name_without_protocol -Dhttps.proxyPort=3128" + containerEnv: + - name: http_proxy + value: "http://192.168.64.1:3128" + - name: https_proxy + value: "http://192.168.64.1:3128" + javaOpts: >- + -Dhttp.proxyHost=192.168.64.1 + -Dhttp.proxyPort=3128 + -Dhttps.proxyHost=192.168.64.1 + -Dhttps.proxyPort=3128 +``` + +### HTTPS Keystore Configuration + +[This configuration](https://wiki.jenkins.io/pages/viewpage.action?pageId=135468777) enables jenkins to use keystore in order to serve https. +Here is the [value file section](https://wiki.jenkins.io/pages/viewpage.action?pageId=135468777#RunningJenkinswithnativeSSL/HTTPS-ConfigureJenkinstouseHTTPSandtheJKSkeystore) related to keystore configuration. +Keystore itself should be placed in front of `jenkinsKeyStoreBase64Encoded` key and in base64 encoded format. To achieve that after having `keystore.jks` file simply do this: `cat keystore.jks | base64` and paste the output in front of `jenkinsKeyStoreBase64Encoded`. +After enabling `httpsKeyStore.enable` make sure that `httpPort` and `targetPort` are not the same, as `targetPort` will serve https. +Do not set `controller.httpsKeyStore.httpPort` to `-1` because it will cause readiness and liveliness prob to fail. +If you already have a kubernetes secret that has keystore and its password you can specify its' name in front of `jenkinsHttpsJksSecretName`, You need to remember that your secret should have proper data key names `jenkins-jks-file` (or override the key name using `jenkinsHttpsJksSecretKey`) +and `https-jks-password` (or override the key name using `jenkinsHttpsJksPasswordSecretKey`; additionally you can make it get the password from a different secret using `jenkinsHttpsJksPasswordSecretName`). Example: + +```yaml +controller: + httpsKeyStore: + enable: true + jenkinsHttpsJksSecretName: '' + httpPort: 8081 + path: "/var/jenkins_keystore" + fileName: "keystore.jks" + password: "changeit" + jenkinsKeyStoreBase64Encoded: '' +``` +### AWS Security Group Policies + +To create SecurityGroupPolicies set `awsSecurityGroupPolicies.enabled` to true and add your policies. Each policy requires a `name`, array of `securityGroupIds` and a `podSelector`. Example: + +```yaml +awsSecurityGroupPolicies: + enabled: true + policies: + - name: "jenkins-controller" + securityGroupIds: + - sg-123456789 + podSelector: + matchExpressions: + - key: app.kubernetes.io/component + operator: In + values: + - jenkins-controller +``` + +### Agent Direct Connection + +Set `directConnection` to `true` to allow agents to connect directly to a given TCP port without having to negotiate a HTTP(S) connection. This can allow you to have agent connections without an external HTTP(S) port. Example: + +```yaml +agent: + jenkinsTunnel: "jenkinsci-agent:50000" + directConnection: true +``` + +## Migration Guide + +### From stable repository + +Upgrade an existing release from `stable/jenkins` to `jenkins/jenkins` seamlessly by ensuring you have the latest [repository info](#get-repository-info) and running the [upgrade commands](#upgrade-chart) specifying the `jenkins/jenkins` chart. + +### Major Version Upgrades + +Chart release versions follow [SemVer](../../CONTRIBUTING.md#versioning), where a MAJOR version change (example `1.0.0` -> `2.0.0`) indicates an incompatible breaking change needing manual actions. + +### To 3.0.0 + +* Check `securityRealm` and `authorizationStrategy` and adjust it. + Otherwise, your configured users and permissions will be overridden. +* You need to use helm version 3 as the `Chart.yaml` uses `apiVersion: v2`. +* All XML configuration options have been removed. + In case those are still in use you need to migrate to configuration as code. + Upgrade guide to 2.0.0 contains pointers how to do that. +* Jenkins is now using a `StatefulSet` instead of a `Deployment` +* terminology has been adjusted that's also reflected in values.yaml + The following values from `values.yaml` have been renamed: + + * `master` => `controller` + * `master.useSecurity` => `controller.adminSecret` + * `master.slaveListenerPort` => `controller.agentListenerPort` + * `master.slaveHostPort` => `controller.agentListenerHostPort` + * `master.slaveKubernetesNamespace` => `agent.namespace` + * `master.slaveDefaultsProviderTemplate` => `agent.defaultsProviderTemplate` + * `master.slaveJenkinsUrl` => `agent.jenkinsUrl` + * `master.slaveJenkinsTunnel` => `agent.jenkinsTunnel` + * `master.slaveConnectTimeout` => `agent.kubernetesConnectTimeout` + * `master.slaveReadTimeout` => `agent.kubernetesReadTimeout` + * `master.slaveListenerServiceAnnotations` => `controller.agentListenerServiceAnnotations` + * `master.slaveListenerServiceType` => `controller.agentListenerServiceType` + * `master.slaveListenerLoadBalancerIP` => `controller.agentListenerLoadBalancerIP` + * `agent.slaveConnectTimeout` => `agent.connectTimeout` +* Removed values: + + * `master.imageTag`: use `controller.image` and `controller.tag` instead + * `slave.imageTag`: use `agent.image` and `agent.tag` instead + +### To 2.0.0 + +Configuration as Code is now default + container does not run as root anymore. + +#### Configuration as Code new default + +Configuration is done via [Jenkins Configuration as Code Plugin](https://github.com/jenkinsci/configuration-as-code-plugin) by default. +That means that changes in values which result in a configuration change are always applied. +In contrast, the XML configuration was only applied during the first start and never altered. + +:exclamation::exclamation::exclamation: +Attention: +This also means if you manually altered configuration then this will most likely be reset to what was configured by default. +It also applies to `securityRealm` and `authorizationStrategy` as they are also configured using configuration as code. +:exclamation::exclamation::exclamation: + +#### Image does not run as root anymore + +It's not recommended to run containers in Kubernetes as `root`. + +❗Attention: If you had not configured a different user before then you need to ensure that your image supports the user and group ID configured and also manually change permissions of all files so that Jenkins is still able to use them. + +#### Summary of updated values + +As version 2.0.0 only updates default values and nothing else it's still possible to migrate to this version and opt out of some or all new defaults. +All you have to do is ensure the old values are set in your installation. + +Here we show which values have changed and the previous default values: + +```yaml +controller: + runAsUser: 1000 # was unset before + fsGroup: 1000 # was unset before + JCasC: + enabled: true # was false + defaultConfig: true # was false + sidecars: + configAutoReload: + enabled: true # was false +``` + +#### Migration steps + +Migration instructions heavily depend on your current setup. +So think of the list below more as a general guideline of what should be done. + +- Ensure that the Jenkins image you are using contains a user with ID 1000 and a group with the same ID. + That's the case for `jenkins/jenkins:lts` image, which the chart uses by default +- Make a backup of your existing installation especially the persistent volume +- Ensure that you have the configuration as code plugin installed +- Export your current settings via the plugin: + `Manage Jenkins` -> `Configuration as Code` -> `Download Configuration` +- prepare your values file for the update e.g. add additional configuration as code setting that you need. + The export taken from above might be a good starting point for this. + In addition, the [demos](https://github.com/jenkinsci/configuration-as-code-plugin/tree/master/demos) from the plugin itself are quite useful. +- Test drive those setting on a separate installation +- Put Jenkins to Quiet Down mode so that it does not accept new jobs + `/quietDown` +- Change permissions of all files and folders to the new user and group id: + + ```console + kubectl exec -it -c jenkins /bin/bash + chown -R 1000:1000 /var/jenkins_home + ``` + +- Update Jenkins + +### To 1.0.0 + +Breaking changes: + +- Values have been renamed to follow [helm recommended naming conventions](https://helm.sh/docs/chart_best_practices/#naming-conventions) so that all variables start with a lowercase letter and words are separated with camelcase +- All resources are now using [helm recommended standard labels](https://helm.sh/docs/chart_best_practices/#standard-labels) + +As a result of the label changes also the selectors of the deployment have been updated. +Those are immutable so trying an updated will cause an error like: + +```console +Error: Deployment.apps "jenkins" is invalid: spec.selector: Invalid value: v1.LabelSelector{MatchLabels:map[string]string{"app.kubernetes.io/component":"jenkins-controller", "app.kubernetes.io/instance":"jenkins"}, MatchExpressions:[]v1.LabelSelectorRequirement(nil)}: field is immutable +``` + +In order to upgrade, [uninstall](#uninstall-chart) the Jenkins Deployment before upgrading: diff --git a/helm/whanos/charts/jenkins/VALUES_SUMMARY.md b/helm/whanos/charts/jenkins/VALUES_SUMMARY.md new file mode 100644 index 0000000..593fcb0 --- /dev/null +++ b/helm/whanos/charts/jenkins/VALUES_SUMMARY.md @@ -0,0 +1,421 @@ +# Jenkins + +## Configuration + +The following tables list the configurable parameters of the Jenkins chart and their default values. + +### Jenkins Controller + +| Parameter | Description | Default | +|---------------------------------------------|--------------------------------------------------------------------------|----------------------------------------------------------------------| +| `checkDeprecation` | Checks for deprecated values used | `true` | +| `clusterZone` | Override the cluster name for FQDN resolving | `cluster.local` | +| `kubernetesURL` | Override the Kubernetes API server URL | `https://kubernetes.default` | +| `nameOverride` | Override the resource name prefix | `jenkins` | +| `renderHelmLabels` | Enables rendering of the helm.sh/chart label to the annotations | `true` | +| `fullnameOverride` | Override the full resource names | `jenkins-{release-name}` (or `jenkins` if release-name is `jenkins`) | +| `namespaceOverride` | Override the deployment namespace | Not set (`Release.Namespace`) | +| `controller.componentName` | Jenkins controller name | `jenkins-controller` | +| `controller.testEnabled` | Can be used to disable rendering test resources when using helm template | `true` | +| `controller.cloudName` | Name of default cloud configuration | `kubernetes` | +| `controller.legacyRemotingSecurityEnabled` | Is remoting security enabled? | Not set (i.e. not enabled) | + +#### Jenkins Configuration as Code (JCasC) + +| Parameter | Description | Default | +|-----------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------| +| `controller.JCasC.defaultConfig` | Enables default Jenkins configuration via configuration as code plugin | `true` | +| `controller.JCasC.configScripts` | List of Jenkins Config as Code scripts | `{}` | +| `controller.JCasC.security` | Jenkins Config as Code for Security section | `legacy` | +| `controller.JCasC.securityRealm` | Jenkins Config as Code for Security Realm | `legacy` | +| `controller.JCasC.authorizationStrategy` | Jenkins Config as Code for Authorization Strategy | `loggedInUsersCanDoAnything` | +| `controller.sidecars.configAutoReload` | Jenkins Config as Code auto-reload settings | | +| `controller.sidecars.configAutoReload.enabled` | Jenkins Config as Code auto-reload settings (Attention: rbac needs to be enabled otherwise the sidecar can't read the config map) | `true` | +| `controller.sidecars.configAutoReload.image` | Image which triggers the reload | `kiwigrid/k8s-sidecar:1.24.4` | +| `controller.sidecars.configAutoReload.reqRetryConnect` | How many connection-related errors to retry on | `10` | +| `controller.sidecars.configAutoReload.sleepTime` | How many seconds to wait before updating config-maps/secrets (sets METHOD=SLEEP on the sidecar) | Not set | +| `controller.sidecars.configAutoReload.envFrom` | Environment variable sources for the Jenkins Config as Code auto-reload container | Not set | +| `controller.sidecars.configAutoReload.env` | Environment variables for the Jenkins Config as Code auto-reload container | Not set | +| `controller.sidecars.configAutoReload.containerSecurityContext` | Enable container security context | `{readOnlyRootFilesystem: true, allowPrivilegeEscalation: false}` | + +#### Jenkins Configuration Files & Scripts + +| Parameter | Description | Default | +| --------------------------------- | ------------------------------------ | ----------------------------------------- | +| `controller.initScripts` | List of Jenkins init scripts | `[]` | +| `controller.initConfigMap` | Pre-existing init scripts | Not set | + +#### Jenkins Global Security + +| Parameter | Description | Default | +| --------------------------------- | ---------------------------------------- | ----------------------------------------- | +| `controller.adminSecret` | Create secret for admin user | `true` | +| `controller.disableRememberMe` | Disable use of remember me | `false` | +| `controller.enableRawHtmlMarkupFormatter` | Enable HTML parsing using | false | +| `controller.markupFormatter` | Yaml of the markup formatter to use | `plainText` | +| `controller.disabledAgentProtocols` | Disabled agent protocols | `JNLP-connect JNLP2-connect` | +| `controller.csrf.defaultCrumbIssuer.enabled` | Enable the default CSRF Crumb issuer | `true` | +| `controller.csrf.defaultCrumbIssuer.proxyCompatability` | Enable proxy compatibility | `true` | + +#### Jenkins Global Settings + +| Parameter | Description | Default | +| --------------------------------- | ------------------------------------ | ----------------------------------------- | +| `controller.numExecutors` | Set Number of executors | 0 | +| `controller.executorMode` | Set executor mode of the Jenkins node. Possible values are: NORMAL or EXCLUSIVE | NORMAL | +| `controller.customJenkinsLabels` | Append Jenkins labels to the controller | `[]` | +| `controller.jenkinsHome` | Custom Jenkins home path | `/var/jenkins_home` | +| `controller.jenkinsRef` | Custom Jenkins reference path | `/usr/share/jenkins/ref` | +| `controller.jenkinsAdminEmail` | Email address for the administrator of the Jenkins instance | Not set | +| `controller.jenkinsUrl` | Set Jenkins URL if you are not using the ingress definitions provided by the chart | Not set | +| `controller.jenkinsUrlProtocol` | Set protocol for Jenkins URL | Set to `https` if `controller.ingress.tls`, `http` otherwise | +| `controller.jenkinsUriPrefix` | Root Uri Jenkins will be served on | Not set | +| `controller.jenkinsOpts` | Append to `JENKINS_OPTS` env var | Not set | +| `controller.javaOpts` | Append to `JAVA_OPTS` env var | Not set | + +#### Jenkins In-Process Script Approval + +| Parameter | Description | Default | +| --------------------------------- | ------------------------------------ | ----------------------------------------- | +| `controller.scriptApproval` | List of groovy functions to approve | `[]` | + +#### Jenkins Plugins + +| Parameter | Description | Default | +| --------------------------------- | ------------------------------------ | ----------------------------------------- | +| `controller.installPlugins` | List of Jenkins plugins to install. If you don't want to install plugins set it to `false` | `kubernetes:1.31.3 workflow-aggregator:2.6 git:4.10.2 configuration-as-code:1414.v878271fc496f` | +| `controller.additionalPlugins` | List of Jenkins plugins to install in addition to those listed in controller.installPlugins | `[]` | +| `controller.initializeOnce` | Initialize only on first install. Ensures plugins do not get updated inadvertently. Requires `persistence.enabled` to be set to `true`. | `false` | +| `controller.overwritePlugins` | Overwrite installed plugins on start.| `false` | +| `controller.overwritePluginsFromImage` | Keep plugins that are already installed in the controller image.| `true` | +| `controller.installLatestPlugins` | Set to false to download the minimum required version of all dependencies. | `true` | +| `controller.installLatestSpecifiedPlugins` | Set to true to download latest dependencies of any plugin that is requested to have the latest version. | `false` | + +#### Jenkins Agent Listener + +| Parameter | Description | Default | +| -------------------------------------------- | ----------------------------------------------- | ------------ | +| `controller.agentListenerEnabled` | Create Agent listener service | `true` | +| `controller.agentListenerPort` | Listening port for agents | `50000` | +| `controller.agentListenerHostPort` | Host port to listen for agents | Not set | +| `controller.agentListenerNodePort` | Node port to listen for agents | Not set | +| `controller.agentListenerServiceType` | Defines how to expose the agentListener service | `ClusterIP` | +| `controller.agentListenerServiceAnnotations` | Annotations for the agentListener service | `{}` | +| `controller.agentListenerLoadBalancerIP` | Static IP for the agentListener LoadBalancer | Not set | +| `controller.agentListenerExternalTrafficPolicy` | [Traffic Policy](https://kubernetes.io/docs/concepts/services-networking/service/#traffic-policies) of for the agentListener service | Not set | +| `controller.agentListenerLoadBalancerSourceRanges` | Allowed inbound IP for the agentListener service | `0.0.0.0/0` | + +#### Kubernetes StatefulSet & Service + +| Parameter | Description | Default | +| --------------------------------- | ------------------------------------ | ----------------------------------------- | +| `controller.image` | Controller image name | `jenkins/jenkins` | +| `controller.tagLabel` | Controller image tag label | `jdk11` | +| `controller.tag` | Controller image tag override | Not set | +| `controller.imagePullPolicy` | Controller image pull policy | `Always` | +| `controller.imagePullSecretName` | Controller image pull secret | Not set | +| `controller.resources` | Resources allocation (Requests and Limits) | `{requests: {cpu: 50m, memory: 256Mi}, limits: {cpu: 2000m, memory: 4096Mi}}`| +| `controller.initContainerResources` | Resources allocation (Requests and Limits) for Init Container | Not set | +| `controller.initContainerEnvFrom` | Environment variable sources for Init Container | Not set | +| `controller.initContainerEnv` | Environment variables for Init Container | Not set | +| `controller.containerEnvFrom` | Environment variable sources for Jenkins Container | Not set | +| `controller.containerEnv` | Environment variables for Jenkins Container | Not set | +| `controller.usePodSecurityContext` | Enable pod security context (must be `true` if `runAsUser`, `fsGroup`, or `podSecurityContextOverride` are set) | `true` | +| `controller.runAsUser` | Deprecated in favor of `controller.podSecurityContextOverride`. uid that jenkins runs with. | `1000` | +| `controller.fsGroup` | Deprecated in favor of `controller.podSecurityContextOverride`. uid that will be used for persistent volume. | `1000` | +| `controller.podSecurityContextOverride` | Completely overwrites the contents of the pod security context, ignoring the values provided for `runAsUser`, and `fsGroup`. | Not set | +| `controller.containerSecurityContext` | Allow to control securityContext for the jenkins container. | `{runAsUser: 1000, runAsGroup: 1000, readOnlyRootFilesystem: true, allowPrivilegeEscalation: false}` | +| `controller.hostAliases` | Aliases for IPs in `/etc/hosts` | `[]` | +| `controller.serviceAnnotations` | Service annotations | `{}` | +| `controller.serviceType` | k8s service type | `ClusterIP` | +| `controller.clusterIP` | k8s service clusterIP | Not set | +| `controller.servicePort` | k8s service port | `8080` | +| `controller.targetPort` | k8s target port | `8080` | +| `controller.nodePort` | k8s node port | Not set | +| `controller.jmxPort` | Open a port, for JMX stats | Not set | +| `controller.extraPorts` | Open extra ports, for other uses | `[]` | +| `controller.loadBalancerSourceRanges` | Allowed inbound IP addresses | `0.0.0.0/0` | +| `controller.loadBalancerIP` | Optional fixed external IP | Not set | +| `controller.statefulSetLabels` | Custom StatefulSet labels | Not set | +| `controller.serviceLabels` | Custom Service labels | Not set | +| `controller.podLabels` | Custom Pod labels (an object with `label-key: label-value` pairs) | Not set | +| `controller.nodeSelector` | Node labels for pod assignment | `{}` | +| `controller.affinity` | Affinity settings | `{}` | +| `controller.schedulerName` | Kubernetes scheduler name | Not set | +| `controller.terminationGracePeriodSeconds` | Set TerminationGracePeriodSeconds | Not set | +| `controller.terminationMessagePath` | Set the termination message path | Not set | +| `controller.terminationMessagePolicy` | Set the termination message policy | Not set | +| `controller.tolerations` | Toleration labels for pod assignment | `[]` | +| `controller.podAnnotations` | Annotations for controller pod | `{}` | +| `controller.statefulSetAnnotations` | Annotations for controller StatefulSet | `{}` | +| `controller.updateStrategy` | Update strategy for StatefulSet | `{}` | +| `controller.lifecycle` | Lifecycle specification for controller-container | Not set | +| `controller.priorityClassName` | The name of a `priorityClass` to apply to the controller pod | Not set | +| `controller.admin.existingSecret` | The name of an existing secret containing the admin credentials. | `""`| +| `controller.admin.userKey` | The key in the existing admin secret containing the username. | `jenkins-admin-user` | +| `controller.admin.passwordKey` | The key in the existing admin secret containing the password. | `jenkins-admin-password` | +| `controller.customInitContainers` | Custom init-container specification in raw-yaml format | Not set | +| `controller.sidecars.other` | Configures additional sidecar container(s) for Jenkins controller | `[]` | + +#### Kubernetes Pod Disruption Budget + +| Parameter | Description | Default | +| --------------------------------- | ------------------------------------ | ----------------------------------------- | +| `controller.podDisruptionBudget.enabled` | Enable [Kubernetes Pod Disruption Budget](https://kubernetes.io/docs/tasks/run-application/configure-pdb/) configuration from `controller.podDisruptionBudget` (see below) | `false` | +| `controller.podDisruptionBudget.apiVersion` | Policy API version | `policy/v1beta1` | +| `controller.podDisruptionBudget.maxUnavailable` | Number of pods that can be unavailable. Either an absolute number or a percentage. | Not set | + +#### Kubernetes Health Probes + +| Parameter | Description | Default | +| --------------------------------- | ------------------------------------ | ----------------------------------------- | +| `controller.healthProbes` | Enable [Kubernetes Probes](https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes) configuration from `controller.probes` (see below) | `true` | +| `controller.probes.livenessProbe.timeoutSeconds` | Set the timeout for the liveness probe in seconds | `5` | +| `controller.probes.livenessProbe.periodSeconds` | Set the time interval (in seconds) between two liveness probes executions | `10` | +| `controller.probes.livenessProbe.failureThreshold` | Set the failure threshold for the liveness probe | `5` | +| `controller.probes.livenessProbe.initialDelaySeconds` | Set the initial delay for the liveness probe | Not set | +| `controller.probes.livenessProbe.httpGet.port` | Set the Pod's HTTP port to use for the liveness probe | `http` | +| `controller.probes.livenessProbe.httpGet.path` | Set the HTTP's path for the liveness probe | `/login'` (or `${controller.jenkinsUriPrefix}/login` if `controller.jenkinsUriPrefix` is defined) | +| `controller.probes.readinessProbe.timeoutSeconds` | Set the timeout for the readiness probe in seconds | `5` | +| `controller.probes.readinessProbe.periodSeconds` | Set the time interval (in seconds) between two readiness probes executions | `10` | +| `controller.probes.readinessProbe.failureThreshold` | Set the failure threshold for the readiness probe | `3` | +| `controller.probes.readinessProbe.initialDelaySeconds` | Set the initial delay for the readiness probe | Not set | +| `controller.probes.readinessProbe.httpGet.port` | Set the Pod's HTTP port to use for the readiness probe | `http` | +| `controller.probes.readinessProbe.httpGet.path` | Set the HTTP's path for the readiness probe | `/login'` (or `${controller.jenkinsUriPrefix}/login` if `controller.jenkinsUriPrefix` is defined) | +| `controller.probes.startupProbe.timeoutSeconds` | Set the timeout for the startup probe in seconds | `5` | +| `controller.probes.startupProbe.periodSeconds` | Set the time interval (in seconds) between two startup probes executions | `10` | +| `controller.probes.startupProbe.failureThreshold` | Set the failure threshold for the startup probe | `12` | +| `controller.probes.startupProbe.initialDelaySeconds` | Set the initial delay for the startup probe | Not set | +| `controller.probes.startupProbe.httpGet.port` | Set the Pod's HTTP port to use for the startup probe | `http` | +| `controller.probes.startupProbe.httpGet.path` | Set the HTTP's path for the startup probe | `/login'` (or `${controller.jenkinsUriPrefix}/login` if `controller.jenkinsUriPrefix` is defined) | + +#### Kubernetes Ingress + +| Parameter | Description | Default | +| --------------------------------- | ------------------------------------ | ----------------------------------------- | +| `controller.ingress.enabled` | Enables ingress | `false` | +| `controller.ingress.apiVersion` | Ingress API version | `extensions/v1beta1` | +| `controller.ingress.hostName` | Ingress hostname | Not set | +| `controller.ingress.resourceRootUrl` | Hostname to serve assets from | Not set | +| `controller.ingress.annotations` | Ingress annotations | `{}` | +| `controller.ingress.labels` | Ingress labels | `{}` | +| `controller.ingress.path` | Ingress path | Not set | +| `controller.ingress.paths` | Override for the default Ingress paths | `[]` | +| `controller.ingress.tls` | Ingress TLS configuration | `[]` | + +#### GKE BackendConfig + +| Parameter | Description | Default | +| --------------------------------- | ------------------------------------ | ----------------------------------------- | +| `controller.backendconfig.enabled` | Enables backendconfig | `false` | +| `controller.backendconfig.apiVersion` | backendconfig API version | `extensions/v1beta1` | +| `controller.backendconfig.name` | backendconfig name | Not set | +| `controller.backendconfig.annotations` | backendconfig annotations | `{}` | +| `controller.backendconfig.labels` | backendconfig labels | `{}` | +| `controller.backendconfig.spec` | backendconfig spec | `{}` | + +#### OpenShift Route + +| Parameter | Description | Default | +| --------------------------------- | ------------------------------------ | ----------------------------------------- | +| `controller.route.enabled` | Enables openshift route | `false` | +| `controller.route.annotations` | Route annotations | `{}` | +| `controller.route.labels` | Route labels | `{}` | +| `controller.route.path` | Route path | Not set | + +#### Prometheus + +| Parameter | Description | Default | +| --------------------------------- | ------------------------------------ | ----------------------------------------- | +| `controller.prometheus.enabled` | Enables prometheus service monitor | `false` | +| `controller.prometheus.serviceMonitorAdditionalLabels` | Additional labels to add to the service monitor object | `{}` | +| `controller.prometheus.serviceMonitorNamespace` | Custom namespace for serviceMonitor | Not set (same ns where is Jenkins being deployed) | +| `controller.prometheus.scrapeInterval` | How often prometheus should scrape metrics | `60s` | +| `controller.prometheus.scrapeEndpoint` | The endpoint prometheus should get metrics from | `/prometheus` | +| `controller.prometheus.alertingrules` | Array of prometheus alerting rules | `[]` | +| `controller.prometheus.alertingRulesAdditionalLabels` | Additional labels to add to the prometheus rule object | `{}` | +| `controller.prometheus.prometheusRuleNamespace` | Custom namespace for PrometheusRule | `""` (same ns where Jenkins being deployed) | + +#### HTTPS Keystore + +| Parameter | Description | Default | +| --------------------------------- | ------------------------------------ | ----------------------------------------- | +| `controller.httpsKeyStore.enable` | Enables HTTPS keystore on jenkins controller | `false` | +| `controller.httpsKeyStore.jenkinsHttpsJksSecretName` | Name of the secret that already has ssl keystore | `` | +| `controller.httpsKeyStore.jenkinsHttpsJksSecretKey` | Name of the key in the secret that already has ssl keystore | `jenkins-jks-file` | +| `controller.httpsKeyStore.jenkinsHttpsJksPasswordSecretName` | Name of the secret that contains the JKS password, if it is not in the same secret as the JKS file | `` | +| `controller.httpsKeyStore.jenkinsHttpsJksPasswordSecretKey` | Name of the key in the secret that contains the JKS password | `https-jks-password` | +| `controller.httpsKeyStore.httpPort` | HTTP Port that Jenkins should listen on along with HTTPS, it also serves liveness and readiness probs port. When HTTPS keystore is enabled servicePort and targetPort will be used as HTTPS port | `8081` | +| `controller.httpsKeyStore.path` | Path of HTTPS keystore file | `/var/jenkins_keystore` | +| `controller.httpsKeyStore.fileName` | Jenkins keystore filename which will appear under controller.httpsKeyStore.path | `keystore.jks` | +| `controller.httpsKeyStore.password` | Jenkins keystore password | `password` | +| `controller.httpsKeyStore.jenkinsKeyStoreBase64Encoded` | Base64 encoded Keystore content. Keystore must be converted to base64 then being pasted here | a self signed cert | + +#### Kubernetes Secret + +| Parameter | Description | Default | +|----------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| ----------------------------------------- | +| `controller.adminUser` | Admin username (and password) created as a secret if adminSecret is true | `admin` | +| `controller.adminPassword` | Admin password (and user) created as a secret if adminSecret is true | Random value | +| `controller.existingSecret` | The name of an existing secret containing keys credentials. | `""`| +| `controller.additionalSecrets` | List of additional secrets to create and mount according to [JCasC docs](https://github.com/jenkinsci/configuration-as-code-plugin/blob/master/docs/features/secrets.adoc#kubernetes-secrets) | `[]` | +| `controller.additionalExistingSecrets` | List of additional existing secrets to mount according to [JCasC docs](https://github.com/jenkinsci/configuration-as-code-plugin/blob/master/docs/features/secrets.adoc#kubernetes-secrets) | `[]` | +| `controller.secretClaims` | List of `SecretClaim` resources to create | `[]` | + +#### Kubernetes NetworkPolicy + +| Parameter | Description | Default | +| --------------------------------- | ------------------------------------ | ----------------------------------------- | +| `networkPolicy.enabled` | Enable creation of NetworkPolicy resources. | `false` | +| `networkPolicy.apiVersion` | NetworkPolicy ApiVersion | `networking.k8s.io/v1` | +| `networkPolicy.internalAgents.allowed` | Allow internal agents (from the same cluster) to connect to controller. Agent pods would be filtered based on PodLabels. | `false` | +| `networkPolicy.internalAgents.podLabels` | A map of labels (keys/values) that agents pods must have to be able to connect to controller. | `{}` | +| `networkPolicy.internalAgents.namespaceLabels` | A map of labels (keys/values) that agents namespaces must have to be able to connect to controller. | `{}` | +| `networkPolicy.externalAgents.ipCIDR` | The IP range from which external agents are allowed to connect to controller. | `` | +| `networkPolicy.externalAgents.except` | A list of IP sub-ranges to be excluded from the whitelisted IP range. | `[]` | + +#### Kubernetes RBAC + +| Parameter | Description | Default | +| --------------------------------- | ------------------------------------ | ----------------------------------------- | +| `rbac.create` | Whether RBAC resources are created | `true` | +| `rbac.readSecrets` | Whether the Jenkins service account should be able to read Kubernetes secrets | `false` | + +#### Kubernetes ServiceAccount - Controller + +| Parameter | Description | Default | +| --------------------------------- | ------------------------------------ | ----------------------------------------- | +| `serviceAccount.name` | name of the ServiceAccount to be used by access-controlled resources | autogenerated | +| `serviceAccount.create` | Configures if a ServiceAccount with this name should be created | `true` | +| `serviceAccount.annotations` | Configures annotation for the ServiceAccount | `{}` | +| `serviceAccount.extraLabels` | Configures extra labels for the ServiceAccount | `{}` | +| `serviceAccount.imagePullSecretName` | Controller ServiceAccount image pull secret | Not set | + +#### Kubernetes ServiceAccount - Agent + +| Parameter | Description | Default | +| --------------------------------- | ------------------------------------ | ----------------------------------------- | +| `serviceAccountAgent.name` | name of the agent ServiceAccount to be used by access-controlled resources | autogenerated | +| `serviceAccountAgent.create` | Configures if an agent ServiceAccount with this name should be created | `false` | +| `serviceAccountAgent.annotations` | Configures annotation for the agent ServiceAccount | `{}` | +| `serviceAccountAgent.extraLabels` | Configures extra labels for the agent ServiceAccount | `{}` | +| `serviceAccountAgent.imagePullSecretName` | Agent ServiceAccount image pull secret | Not set | + +### Jenkins Agent(s) + +| Parameter | Description | Default | +| -------------------------- |------------------------------------------------------------------------------------------| ---------------------- | +| `agent.enabled` | Enable Kubernetes plugin jnlp-agent podTemplate | `true` | +| `agent.namespace` | Namespace in which the Kubernetes agents should be launched | Not set | +| `agent.containerCap` | Maximum number of agent | 10 | +| `agent.defaultsProviderTemplate` | The name of the pod template to use for providing default values | Not set | +| `agent.jenkinsUrl` | Overrides the Kubernetes Jenkins URL | Not set | +| `agent.jenkinsTunnel` | Overrides the Kubernetes Jenkins tunnel | Not set | +| `agent.kubernetesConnectTimeout` | The connection timeout in seconds for connections to Kubernetes API. Minimum value is 5. | 5 | +| `agent.kubernetesReadTimeout` | The read timeout in seconds for connections to Kubernetes API. Minimum value is 15. | 15 | +| `agent.maxRequestsPerHostStr` | The maximum concurrent connections to Kubernetes API | 32 | +| `agent.retentionTimeout` | Time in minutes after which the Kubernetes cloud plugin will clean up an idle worker that has not already terminated | 5 | +| `agent.waitForPodSec` | Seconds to wait for pod to be running | 600 | +| `agent.podLabels` | Custom Pod labels (an object with `label-key: label-value` pairs) | Not set | +| `agent.jnlpregistry` | Custom docker registry used for to get agent jnlp image | Not set | + +#### Pod Configuration + +| Parameter | Description | Default | +| -------------------------- | ----------------------------------------------- | ---------------------- | +| `agent.websocket` | Enables agent communication via websockets | false | +| `agent.podName` | Agent Pod base name | Not set | +| `agent.customJenkinsLabels`| Append Jenkins labels to the agent | `[]` | +| `agent.envVars` | Environment variables for the agent Pod | `[]` | +| `agent.idleMinutes` | Allows the Pod to remain active for reuse | 0 | +| `agent.imagePullSecretName` | Agent image pull secret | Not set | +| `agent.hostNetworking` | Enabled agent to use hostnetwork | false | +| `agent.nodeSelector` | Node labels for pod assignment | `{}` | +| `agent.connectTimeout` | Timeout in seconds for an agent to be online | 100 | +| `agent.volumes` | Additional volumes | `[]` | +| `agent.workspaceVolume` | Workspace volume (defaults to EmptyDir) | `{}` | +| `agent.yamlTemplate` | The raw yaml of a Pod API Object to merge into the agent spec | Not set | +| `agent.yamlMergeStrategy` | Defines how the raw yaml field gets merged with yaml definitions from inherited pod templates | `override` | +| `agent.annotations` | Annotations to apply to the pod | `{}` | +| `agent.additionalContainers` | Add additional containers to the agents. | `[]` | + +#### Side Container Configuration + +| Parameter | Description | Default | +| -------------------------- | ----------------------------------------------- |--------------------------------------------------------------------------------| +| `agent.sideContainerName` | Side container name in agent | jnlp | +| `agent.image` | Agent image name | `jenkins/inbound-agent` | +| `agent.tag` | Agent image tag | `3107.v665000b_51092-5` | +| `agent.alwaysPullImage` | Always pull agent container image before build | `false` | +| `agent.privileged` | Agent privileged container | `false` | +| `agent.resources` | Resources allocation (Requests and Limits) | `{requests: {cpu: 512m, memory: 512Mi}, limits: {cpu: 512m, memory: 512Mi}}` | +| `agent.runAsUser` | Configure container user | Not set | +| `agent.runAsGroup` | Configure container group | Not set | +| `agent.command` | Executed command when side container starts | Not set | +| `agent.args` | Arguments passed to executed command | `${computer.jnlpmac} ${computer.name}` | +| `agent.TTYEnabled` | Allocate pseudo tty to the side container | false | +| `agent.workingDir` | Configure working directory for default agent | `/home/jenkins/agent` | + +#### Other + +| Parameter | Description | Default | +| -------------------------- | ----------------------------------------------- | ---------------------- | +| `agent.disableDefaultAgent` | Ignore the default Jenkins Agent configuration | false | +| `agent.podTemplates` | Configures extra pod templates for the default kubernetes cloud | `{}` | +| `additionalAgents` | Configure additional agents which inherit values from `agent` | `{}` | + +### Persistence + +| Parameter | Description | Default | +| --------------------------- | -------------------------------------- | --------------- | +| `persistence.enabled` | Enable the use of a Jenkins PVC | `true` | +| `persistence.existingClaim` | Provide the name of a PVC | `nil` | +| `persistence.storageClass` | Storage class for the PVC | `nil` | +| `persistence.annotations` | Annotations for the PVC | `{}` | +| `persistence.labels` | Labels for the PVC | `{}` | +| `persistence.accessMode` | The PVC access mode | `ReadWriteOnce` | +| `persistence.size` | The size of the PVC | `8Gi` | +| `persistence.dataSource` | Existing data source to clone PVC from | `nil` | +| `persistence.subPath` | SubPath for jenkins-home mount | `nil` | +| `persistence.volumes` | Additional volumes | `nil` | +| `persistence.mounts` | Additional mounts | `nil` | + +### Backup + +| Parameter | Description | Default | +| ---------------------------------------- | ----------------------------------------------------------------- | --------------------------------- | +| `backup.enabled` | Enable the use of a backup CronJob | `false` | +| `backup.schedule` | Schedule to run jobs | `0 2 * * *` | +| `backup.labels` | Backup pod labels | `{}` | +| `backup.serviceAccount.create` | Specifies whether a ServiceAccount should be created | `true` | +| `backup.serviceAccount.name` | name of the backup ServiceAccount | autogenerated | +| `backup.serviceAccount.annotations` | Backup pod annotations | `{}` | +| `backup.image.repo` | Backup image repository | `maorfr/kube-tasks` | +| `backup.image.tag` | Backup image tag | `0.2.0` | +| `backup.image.imagePullSecretName` | Backup image pull secret | Not set | +| `backup.extraArgs` | Additional arguments for kube-tasks | `[]` | +| `backup.existingSecret` | Environment variables to add to the cronjob container | `{}` | +| `backup.existingSecret.*` | Specify the secret name containing the AWS or GCP credentials | `jenkinsaws` | +| `backup.existingSecret.*.awsaccesskey` | `secretKeyRef.key` used for `AWS_ACCESS_KEY_ID` | `jenkins_aws_access_key` | +| `backup.existingSecret.*.awssecretkey` | `secretKeyRef.key` used for `AWS_SECRET_ACCESS_KEY` | `jenkins_aws_secret_key` | +| `backup.existingSecret.*.azstorageaccount`| `secretKeyRef.key` used for `AZURE_STORAGE_ACCOUNT` | `""` | +| `backup.existingSecret.*.azstoragekey` | `secretKeyRef.key` used for `AZURE_STORAGE_ACCESS_KEY` | `""` | +| `backup.existingSecret.*.gcpcredentials` | Mounts secret as volume and sets `GOOGLE_APPLICATION_CREDENTIALS` | `credentials.json` | +| `backup.env` | Backup environment variables | `[]` | +| `backup.resources` | Backup CPU/Memory resource requests/limits | Memory: `1Gi`, CPU: `1` | +| `backup.destination` | Destination to store backup artifacts | `s3://jenkins-data/backup` | +| `backup.onlyJobs` | Only backup the job folder | `false` | +| `backup.usePodSecurityContext` | Enable backup pod's security context (must be `true` if `runAsUser`, `fsGroup`, or `podSecurityContextOverride` are set) | `true` | +| `backup.runAsUser` | Deprecated in favor of `backup.podSecurityContextOverride`. uid that jenkins runs with. | `1000` | +| `backup.fsGroup` | Deprecated in favor of `backup.podSecurityContextOverride`. uid that will be used for persistent volume. | `1000` | +| `backup.podSecurityContextOverride` | Completely overwrites the contents of the backup pod's security context, ignoring the values provided for `runAsUser`, and `fsGroup`. | Not set | +| `cronJob.apiVersion` | CronJob API version | 'batch/v1' | +| `awsSecurityGroupPolicies.enabled` | Enable the creation of SecurityGroupPolicy resources | `false` | +| `awsSecurityGroupPolicies.policies` | Security Group Policy definitions. `awsSecurityGroupPolicies.enabled` must be `true` | Not set | + +### Helm Tests + +| Parameter | Description | Default | +| --------------------- | --------------------------------- | --------------- | +| `helmtest.bats.image` | Image used to test the framework | `bats/bats` | +| `helmtest.bats.tag` | Test framework image tag override | `1.2.1` | diff --git a/helm/whanos/charts/jenkins/templates/NOTES.txt b/helm/whanos/charts/jenkins/templates/NOTES.txt new file mode 100644 index 0000000..0d2df0b --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/NOTES.txt @@ -0,0 +1,68 @@ +{{- $prefix := .Values.controller.jenkinsUriPrefix | default "" -}} +{{- $url := "" -}} +1. Get your '{{ .Values.controller.adminUser }}' user password by running: + kubectl exec --namespace {{ template "jenkins.namespace" . }} -it svc/{{ template "jenkins.fullname" . }} -c jenkins -- /bin/cat /run/secrets/additional/chart-admin-password && echo +{{- if .Values.controller.ingress.hostName -}} +{{- if .Values.controller.ingress.tls -}} +{{- $url = print "https://" .Values.controller.ingress.hostName $prefix -}} +{{- else -}} +{{- $url = print "http://" .Values.controller.ingress.hostName $prefix -}} +{{- end }} +2. Visit {{ $url }} +{{- else }} +2. Get the Jenkins URL to visit by running these commands in the same shell: +{{- if contains "NodePort" .Values.controller.serviceType }} + export NODE_PORT=$(kubectl get --namespace {{ template "jenkins.namespace" . }} -o jsonpath="{.spec.ports[0].nodePort}" services {{ template "jenkins.fullname" . }}) + export NODE_IP=$(kubectl get nodes --namespace {{ template "jenkins.namespace" . }} -o jsonpath="{.items[0].status.addresses[0].address}") +{{- if .Values.controller.httpsKeyStore.enable -}} +{{- $url = print "https://$NODE_IP:$NODE_PORT" $prefix -}} +{{- else -}} +{{- $url = print "http://$NODE_IP:$NODE_PORT" $prefix -}} +{{- end }} + echo {{ $url }} + +{{- else if contains "LoadBalancer" .Values.controller.serviceType }} + NOTE: It may take a few minutes for the LoadBalancer IP to be available. + You can watch the status of by running 'kubectl get svc --namespace {{ template "jenkins.namespace" . }} -w {{ template "jenkins.fullname" . }}' + export SERVICE_IP=$(kubectl get svc --namespace {{ template "jenkins.namespace" . }} {{ template "jenkins.fullname" . }} --template "{{ "{{ range (index .status.loadBalancer.ingress 0) }}{{ . }}{{ end }}" }}") +{{- if .Values.controller.httpsKeyStore.enable -}} +{{- $url = print "https://$SERVICE_IP:" .Values.controller.servicePort $prefix -}} +{{- else -}} +{{- $url = print "http://$SERVICE_IP:" .Values.controller.servicePort $prefix -}} +{{- end }} + echo {{ $url }} + +{{- else if contains "ClusterIP" .Values.controller.serviceType -}} +{{- if .Values.controller.httpsKeyStore.enable -}} +{{- $url = print "https://127.0.0.1:" .Values.controller.servicePort $prefix -}} +{{- else -}} +{{- $url = print "http://127.0.0.1:" .Values.controller.servicePort $prefix -}} +{{- end }} + echo {{ $url }} + kubectl --namespace {{ template "jenkins.namespace" . }} port-forward svc/{{template "jenkins.fullname" . }} {{ .Values.controller.servicePort }}:{{ .Values.controller.servicePort }} +{{- end }} +{{- end }} + +3. Login with the password from step 1 and the username: {{ .Values.controller.adminUser }} +4. Configure security realm and authorization strategy +5. Use Jenkins Configuration as Code by specifying configScripts in your values.yaml file, see documentation: {{ $url }}/configuration-as-code and examples: https://github.com/jenkinsci/configuration-as-code-plugin/tree/master/demos + +For more information on running Jenkins on Kubernetes, visit: +https://cloud.google.com/solutions/jenkins-on-container-engine + +For more information about Jenkins Configuration as Code, visit: +https://jenkins.io/projects/jcasc/ + +{{ if (eq .Values.controller.image "jenkins/jenkins") }} +NOTE: Consider using a custom image with pre-installed plugins +{{- else if .Values.controller.installPlugins }} +NOTE: Consider disabling `installPlugins` if your image already contains plugins. +{{- end }} + +{{- if .Values.persistence.enabled }} +{{- else }} +################################################################################# +###### WARNING: Persistence is disabled!!! You will lose your data when ##### +###### the Jenkins pod is terminated. ##### +################################################################################# +{{- end }} diff --git a/helm/whanos/charts/jenkins/templates/_helpers.tpl b/helm/whanos/charts/jenkins/templates/_helpers.tpl new file mode 100644 index 0000000..fd68ee7 --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/_helpers.tpl @@ -0,0 +1,554 @@ +{{/* vim: set filetype=mustache: */}} +{{/* +Expand the name of the chart. +*/}} +{{- define "jenkins.name" -}} +{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" -}} +{{- end -}} + +{{/* +Expand the label of the chart. +*/}} +{{- define "jenkins.label" -}} +{{- printf "%s-%s" (include "jenkins.name" .) .Chart.Version | replace "+" "_" | trunc 63 | trimSuffix "-" -}} +{{- end -}} + + +{{/* +Allow the release namespace to be overridden for multi-namespace deployments in combined charts. +*/}} +{{- define "jenkins.namespace" -}} + {{- if .Values.namespaceOverride -}} + {{- .Values.namespaceOverride -}} + {{- else -}} + {{- .Release.Namespace -}} + {{- end -}} +{{- end -}} + +{{- define "jenkins.agent.namespace" -}} + {{- if .Values.agent.namespace -}} + {{- tpl .Values.agent.namespace . -}} + {{- else -}} + {{- if .Values.namespaceOverride -}} + {{- .Values.namespaceOverride -}} + {{- else -}} + {{- .Release.Namespace -}} + {{- end -}} + {{- end -}} +{{- end -}} + + +{{/* +Create a default fully qualified app name. +We truncate at 63 chars because some Kubernetes name fields are limited to this (by the DNS naming spec). +If release name contains chart name it will be used as a full name. +*/}} +{{- define "jenkins.fullname" -}} +{{- if .Values.fullnameOverride -}} +{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" -}} +{{- else -}} +{{- $name := default .Chart.Name .Values.nameOverride -}} +{{- if contains $name .Release.Name -}} +{{- .Release.Name | trunc 63 | trimSuffix "-" -}} +{{- else -}} +{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" -}} +{{- end -}} +{{- end -}} +{{- end -}} + +{{/* +Returns the admin password +https://github.com/helm/charts/issues/5167#issuecomment-619137759 +*/}} +{{- define "jenkins.password" -}} + {{ if .Values.controller.adminPassword -}} + {{- .Values.controller.adminPassword | b64enc | quote }} + {{- else -}} + {{- $secret := (lookup "v1" "Secret" .Release.Namespace (include "jenkins.fullname" .)).data -}} + {{- if $secret -}} + {{/* + Reusing current password since secret exists + */}} + {{- index $secret ( .Values.controller.admin.passwordKey | default "jenkins-admin-password" ) -}} + {{- else -}} + {{/* + Generate new password + */}} + {{- randAlphaNum 22 | b64enc | quote }} + {{- end -}} + {{- end -}} +{{- end -}} + +{{/* +Returns the Jenkins URL +*/}} +{{- define "jenkins.url" -}} +{{- if .Values.controller.jenkinsUrl }} + {{- .Values.controller.jenkinsUrl }} +{{- else }} + {{- if .Values.controller.ingress.hostName }} + {{- if .Values.controller.ingress.tls }} + {{- default "https" .Values.controller.jenkinsUrlProtocol }}://{{ tpl .Values.controller.ingress.hostName $ }}{{ default "" .Values.controller.jenkinsUriPrefix }} + {{- else }} + {{- default "http" .Values.controller.jenkinsUrlProtocol }}://{{ tpl .Values.controller.ingress.hostName $ }}{{ default "" .Values.controller.jenkinsUriPrefix }} + {{- end }} + {{- else }} + {{- default "http" .Values.controller.jenkinsUrlProtocol }}://{{ template "jenkins.fullname" . }}:{{.Values.controller.servicePort}}{{ default "" .Values.controller.jenkinsUriPrefix }} + {{- end}} +{{- end}} +{{- end -}} + +{{/* +Returns configuration as code default config +*/}} +{{- define "jenkins.casc.defaults" -}} +jenkins: + {{- $configScripts := toYaml .Values.controller.JCasC.configScripts }} + {{- if and (.Values.controller.JCasC.authorizationStrategy) (not (contains "authorizationStrategy:" $configScripts)) }} + authorizationStrategy: + {{- tpl .Values.controller.JCasC.authorizationStrategy . | nindent 4 }} + {{- end }} + {{- if and (.Values.controller.JCasC.securityRealm) (not (contains "securityRealm:" $configScripts)) }} + securityRealm: + {{- tpl .Values.controller.JCasC.securityRealm . | nindent 4 }} + {{- end }} + disableRememberMe: {{ .Values.controller.disableRememberMe }} + {{- if .Values.controller.legacyRemotingSecurityEnabled }} + remotingSecurity: + enabled: true + {{- end }} + mode: {{ .Values.controller.executorMode }} + numExecutors: {{ .Values.controller.numExecutors }} + {{- if not (kindIs "invalid" .Values.controller.customJenkinsLabels) }} + labelString: "{{ join " " .Values.controller.customJenkinsLabels }}" + {{- end }} + {{- if .Values.controller.projectNamingStrategy }} + {{- if kindIs "string" .Values.controller.projectNamingStrategy }} + projectNamingStrategy: "{{ .Values.controller.projectNamingStrategy }}" + {{- else }} + projectNamingStrategy: + {{- toYaml .Values.controller.projectNamingStrategy | nindent 4 }} + {{- end }} + {{- end }} + markupFormatter: + {{- if .Values.controller.enableRawHtmlMarkupFormatter }} + rawHtml: + disableSyntaxHighlighting: true + {{- else }} + {{- toYaml .Values.controller.markupFormatter | nindent 4 }} + {{- end }} + clouds: + - kubernetes: + containerCapStr: "{{ .Values.agent.containerCap }}" + {{- if .Values.agent.jnlpregistry }} + jnlpregistry: "{{ .Values.agent.jnlpregistry }}" + {{- end }} + defaultsProviderTemplate: "{{ .Values.agent.defaultsProviderTemplate }}" + connectTimeout: "{{ .Values.agent.kubernetesConnectTimeout }}" + readTimeout: "{{ .Values.agent.kubernetesReadTimeout }}" + {{- if .Values.agent.directConnection }} + directConnection: true + {{- else }} + {{- if .Values.agent.jenkinsUrl }} + jenkinsUrl: "{{ tpl .Values.agent.jenkinsUrl . }}" + {{- else }} + jenkinsUrl: "http://{{ template "jenkins.fullname" . }}.{{ template "jenkins.namespace" . }}.svc.{{.Values.clusterZone}}:{{.Values.controller.servicePort}}{{ default "" .Values.controller.jenkinsUriPrefix }}" + {{- end }} + {{- if not .Values.agent.websocket }} + {{- if .Values.agent.jenkinsTunnel }} + jenkinsTunnel: "{{ tpl .Values.agent.jenkinsTunnel . }}" + {{- else }} + jenkinsTunnel: "{{ template "jenkins.fullname" . }}-agent.{{ template "jenkins.namespace" . }}.svc.{{.Values.clusterZone}}:{{ .Values.controller.agentListenerPort }}" + {{- end }} + {{- else }} + webSocket: true + {{- end }} + {{- end }} + maxRequestsPerHostStr: {{ .Values.agent.maxRequestsPerHostStr | quote }} + retentionTimeout: {{ .Values.agent.retentionTimeout | quote }} + waitForPodSec: {{ .Values.agent.waitForPodSec | quote }} + name: "{{ .Values.controller.cloudName }}" + namespace: "{{ template "jenkins.agent.namespace" . }}" + serverUrl: "{{ .Values.kubernetesURL }}" + {{- if .Values.agent.enabled }} + podLabels: + - key: "jenkins/{{ .Release.Name }}-{{ .Values.agent.componentName }}" + value: "true" + {{- range $key, $val := .Values.agent.podLabels }} + - key: {{ $key | quote }} + value: {{ $val | quote }} + {{- end }} + templates: + {{- if not .Values.agent.disableDefaultAgent }} + {{- include "jenkins.casc.podTemplate" . | nindent 8 }} + {{- end }} + {{- if .Values.additionalAgents }} + {{- /* save .Values.agent */}} + {{- $agent := .Values.agent }} + {{- range $name, $additionalAgent := .Values.additionalAgents }} + {{- $additionalContainersEmpty := and (hasKey $additionalAgent "additionalContainers") (empty $additionalAgent.additionalContainers) }} + {{- /* merge original .Values.agent into additional agent to ensure it at least has the default values */}} + {{- $additionalAgent := merge $additionalAgent $agent }} + {{- /* clear list of additional containers in case it is configured empty for this agent (merge might have overwritten that) */}} + {{- if $additionalContainersEmpty }} + {{- $_ := set $additionalAgent "additionalContainers" list }} + {{- end }} + {{- /* set .Values.agent to $additionalAgent */}} + {{- $_ := set $.Values "agent" $additionalAgent }} + {{- include "jenkins.casc.podTemplate" $ | nindent 8 }} + {{- end }} + {{- /* restore .Values.agent */}} + {{- $_ := set .Values "agent" $agent }} + {{- end }} + {{- if .Values.agent.podTemplates }} + {{- range $key, $val := .Values.agent.podTemplates }} + {{- tpl $val $ | nindent 8 }} + {{- end }} + {{- end }} + {{- end }} + {{- if .Values.controller.csrf.defaultCrumbIssuer.enabled }} + crumbIssuer: + standard: + excludeClientIPFromCrumb: {{ if .Values.controller.csrf.defaultCrumbIssuer.proxyCompatability }}true{{ else }}false{{- end }} + {{- end }} +{{- include "jenkins.casc.security" . }} +{{- if .Values.controller.scriptApproval }} + scriptApproval: + approvedSignatures: +{{- range $key, $val := .Values.controller.scriptApproval }} + - "{{ $val }}" +{{- end }} +{{- end }} +unclassified: + location: + adminAddress: {{ default "" .Values.controller.jenkinsAdminEmail }} + url: {{ template "jenkins.url" . }} +{{- end -}} + +{{/* +Returns a name template to be used for jcasc configmaps, using +suffix passed in at call as index 0 +*/}} +{{- define "jenkins.casc.configName" -}} +{{- $name := index . 0 -}} +{{- $root := index . 1 -}} +"{{- include "jenkins.fullname" $root -}}-jenkins-{{ $name }}" +{{- end -}} + +{{/* +Returns kubernetes pod template configuration as code +*/}} +{{- define "jenkins.casc.podTemplate" -}} +- name: "{{ .Values.agent.podName }}" + namespace: "{{ template "jenkins.agent.namespace" . }}" +{{- if .Values.agent.annotations }} + annotations: + {{- range $key, $value := .Values.agent.annotations }} + - key: {{ $key }} + value: {{ $value | quote }} + {{- end }} +{{- end }} + id: {{ sha256sum (toYaml .Values.agent) }} + containers: + - name: "{{ .Values.agent.sideContainerName }}" + alwaysPullImage: {{ .Values.agent.alwaysPullImage }} + args: "{{ .Values.agent.args | replace "$" "^$" }}" + command: {{ .Values.agent.command }} + envVars: + - envVar: + {{- if .Values.agent.directConnection }} + key: "JENKINS_DIRECT_CONNECTION" + {{- if .Values.agent.jenkinsTunnel }} + value: "{{ tpl .Values.agent.jenkinsTunnel . }}" + {{- else }} + value: "{{ template "jenkins.fullname" . }}-agent.{{ template "jenkins.namespace" . }}.svc.{{.Values.clusterZone}}:{{ .Values.controller.agentListenerPort }}" + {{- end }} + {{- else }} + key: "JENKINS_URL" + {{- if .Values.agent.jenkinsUrl }} + value: {{ tpl .Values.agent.jenkinsUrl . }} + {{- else }} + value: "http://{{ template "jenkins.fullname" . }}.{{ template "jenkins.namespace" . }}.svc.{{.Values.clusterZone}}:{{.Values.controller.servicePort}}{{ default "/" .Values.controller.jenkinsUriPrefix }}" + {{- end }} + {{- end }} + image: "{{ .Values.agent.image }}:{{ .Values.agent.tag }}" + {{- if .Values.agent.livenessProbe }} + livenessProbe: + execArgs: {{.Values.agent.livenessProbe.execArgs | quote}} + failureThreshold: {{.Values.agent.livenessProbe.failureThreshold}} + initialDelaySeconds: {{.Values.agent.livenessProbe.initialDelaySeconds}} + periodSeconds: {{.Values.agent.livenessProbe.periodSeconds}} + successThreshold: {{.Values.agent.livenessProbe.successThreshold}} + timeoutSeconds: {{.Values.agent.livenessProbe.timeoutSeconds}} + {{- end }} + privileged: "{{- if .Values.agent.privileged }}true{{- else }}false{{- end }}" + resourceLimitCpu: {{.Values.agent.resources.limits.cpu}} + resourceLimitMemory: {{.Values.agent.resources.limits.memory}} + {{- if .Values.agent.resources.limits.ephemeralStorage }} + resourceLimitEphemeralStorage: {{.Values.agent.resources.limits.ephemeralStorage}} + {{- end }} + resourceRequestCpu: {{.Values.agent.resources.requests.cpu}} + resourceRequestMemory: {{.Values.agent.resources.requests.memory}} + {{- if .Values.agent.resources.requests.ephemeralStorage }} + resourceRequestEphemeralStorage: {{.Values.agent.resources.requests.ephemeralStorage}} + {{- end }} + runAsUser: {{ .Values.agent.runAsUser }} + runAsGroup: {{ .Values.agent.runAsGroup }} + ttyEnabled: {{ .Values.agent.TTYEnabled }} + workingDir: {{ .Values.agent.workingDir }} +{{- range $additionalContainers := .Values.agent.additionalContainers }} + - name: "{{ $additionalContainers.sideContainerName }}" + alwaysPullImage: {{ $additionalContainers.alwaysPullImage | default $.Values.agent.alwaysPullImage }} + args: "{{ $additionalContainers.args | replace "$" "^$" }}" + command: {{ $additionalContainers.command }} + envVars: + - envVar: + key: "JENKINS_URL" + {{- if $additionalContainers.jenkinsUrl }} + value: {{ tpl ($additionalContainers.jenkinsUrl) . }} + {{- else }} + value: "http://{{ template "jenkins.fullname" $ }}.{{ template "jenkins.namespace" $ }}.svc.{{ $.Values.clusterZone }}:{{ $.Values.controller.servicePort }}{{ default "/" $.Values.controller.jenkinsUriPrefix }}" + {{- end }} + image: "{{ $additionalContainers.image }}:{{ $additionalContainers.tag }}" + {{- if $additionalContainers.livenessProbe }} + livenessProbe: + execArgs: {{$additionalContainers.livenessProbe.execArgs | quote}} + failureThreshold: {{$additionalContainers.livenessProbe.failureThreshold}} + initialDelaySeconds: {{$additionalContainers.livenessProbe.initialDelaySeconds}} + periodSeconds: {{$additionalContainers.livenessProbe.periodSeconds}} + successThreshold: {{$additionalContainers.livenessProbe.successThreshold}} + timeoutSeconds: {{$additionalContainers.livenessProbe.timeoutSeconds}} + {{- end }} + privileged: "{{- if $additionalContainers.privileged }}true{{- else }}false{{- end }}" + resourceLimitCpu: {{ if $additionalContainers.resources }}{{ $additionalContainers.resources.limits.cpu }}{{ else }}{{ $.Values.agent.resources.limits.cpu }}{{ end }} + resourceLimitMemory: {{ if $additionalContainers.resources }}{{ $additionalContainers.resources.limits.memory }}{{ else }}{{ $.Values.agent.resources.limits.memory }}{{ end }} + resourceRequestCpu: {{ if $additionalContainers.resources }}{{ $additionalContainers.resources.requests.cpu }}{{ else }}{{ $.Values.agent.resources.requests.cpu }}{{ end }} + resourceRequestMemory: {{ if $additionalContainers.resources }}{{ $additionalContainers.resources.requests.memory }}{{ else }}{{ $.Values.agent.resources.requests.memory }}{{ end }} + runAsUser: {{ $additionalContainers.runAsUser | default $.Values.agent.runAsUser }} + runAsGroup: {{ $additionalContainers.runAsGroup | default $.Values.agent.runAsGroup }} + ttyEnabled: {{ $additionalContainers.TTYEnabled | default $.Values.agent.TTYEnabled }} + workingDir: {{ $additionalContainers.workingDir | default $.Values.agent.workingDir }} +{{- end }} +{{- if or .Values.agent.envVars .Values.agent.secretEnvVars }} + envVars: + {{- range $index, $var := .Values.agent.envVars }} + - envVar: + key: {{ $var.name }} + value: {{ tpl $var.value $ }} + {{- end }} + {{- range $index, $var := .Values.agent.secretEnvVars }} + - secretEnvVar: + key: {{ $var.key }} + secretName: {{ $var.secretName }} + secretKey: {{ $var.secretKey }} + optional: {{ $var.optional | default false }} + {{- end }} +{{- end }} + idleMinutes: {{ .Values.agent.idleMinutes }} + instanceCap: 2147483647 + {{- if .Values.agent.hostNetworking }} + hostNetwork: {{ .Values.agent.hostNetworking }} + {{- end }} + {{- if .Values.agent.imagePullSecretName }} + imagePullSecrets: + - name: {{ .Values.agent.imagePullSecretName }} + {{- end }} + label: "{{ .Release.Name }}-{{ .Values.agent.componentName }} {{ .Values.agent.customJenkinsLabels | join " " }}" +{{- if .Values.agent.nodeSelector }} + nodeSelector: + {{- $local := dict "first" true }} + {{- range $key, $value := .Values.agent.nodeSelector }} + {{- if $local.first }} {{ else }},{{ end }} + {{- $key }}={{ tpl $value $ }} + {{- $_ := set $local "first" false }} + {{- end }} +{{- end }} + nodeUsageMode: {{ quote .Values.agent.nodeUsageMode }} + podRetention: {{ .Values.agent.podRetention }} + showRawYaml: {{ .Values.agent.showRawYaml }} + serviceAccount: "{{ include "jenkins.serviceAccountAgentName" . }}" + slaveConnectTimeoutStr: "{{ .Values.agent.connectTimeout }}" +{{- if .Values.agent.volumes }} + volumes: + {{- range $index, $volume := .Values.agent.volumes }} + -{{- if (eq $volume.type "ConfigMap") }} configMapVolume: + {{- else if (eq $volume.type "EmptyDir") }} emptyDirVolume: + {{- else if (eq $volume.type "HostPath") }} hostPathVolume: + {{- else if (eq $volume.type "Nfs") }} nfsVolume: + {{- else if (eq $volume.type "PVC") }} persistentVolumeClaim: + {{- else if (eq $volume.type "Secret") }} secretVolume: + {{- else }} {{ $volume.type }}: + {{- end }} + {{- range $key, $value := $volume }} + {{- if not (eq $key "type") }} + {{ $key }}: {{ if kindIs "string" $value }}{{ tpl $value $ | quote }}{{ else }}{{ $value }}{{ end }} + {{- end }} + {{- end }} + {{- end }} +{{- end }} +{{- if .Values.agent.workspaceVolume }} + workspaceVolume: + {{- if (eq .Values.agent.workspaceVolume.type "DynamicPVC") }} + dynamicPVC: + {{- else if (eq .Values.agent.workspaceVolume.type "EmptyDir") }} + emptyDirWorkspaceVolume: + {{- else if (eq .Values.agent.workspaceVolume.type "HostPath") }} + hostPathWorkspaceVolume: + {{- else if (eq .Values.agent.workspaceVolume.type "Nfs") }} + nfsWorkspaceVolume: + {{- else if (eq .Values.agent.workspaceVolume.type "PVC") }} + persistentVolumeClaimWorkspaceVolume: + {{- else }} + {{ .Values.agent.workspaceVolume.type }}: + {{- end }} + {{- range $key, $value := .Values.agent.workspaceVolume }} + {{- if not (eq $key "type") }} + {{ $key }}: {{ if kindIs "string" $value }}{{ tpl $value $ | quote }}{{ else }}{{ $value }}{{ end }} + {{- end }} + {{- end }} +{{- end }} +{{- if .Values.agent.yamlTemplate }} + yaml: |- + {{- tpl (trim .Values.agent.yamlTemplate) . | nindent 4 }} +{{- end }} + yamlMergeStrategy: {{ .Values.agent.yamlMergeStrategy }} +{{- end -}} + +{{- define "jenkins.kubernetes-version" -}} + {{- if .Values.controller.installPlugins -}} + {{- range .Values.controller.installPlugins -}} + {{ if hasPrefix "kubernetes:" . }} + {{- $split := splitList ":" . }} + {{- printf "%s" (index $split 1 ) -}} + {{- end -}} + {{- end -}} + {{- end -}} +{{- end -}} + +{{- define "jenkins.casc.security" }} +security: +{{- with .Values.controller.JCasC }} +{{- if .security }} + {{- .security | toYaml | nindent 2 }} +{{- end }} +{{- end }} +{{- end -}} + +{{/* +Create the name of the service account to use +*/}} +{{- define "jenkins.serviceAccountName" -}} +{{- if .Values.serviceAccount.create -}} + {{ default (include "jenkins.fullname" .) .Values.serviceAccount.name }} +{{- else -}} + {{ default "default" .Values.serviceAccount.name }} +{{- end -}} +{{- end -}} + +{{/* +Create the name of the service account for Jenkins agents to use +*/}} +{{- define "jenkins.serviceAccountAgentName" -}} +{{- if .Values.serviceAccountAgent.create -}} + {{ default (printf "%s-%s" (include "jenkins.fullname" .) "agent") .Values.serviceAccountAgent.name }} +{{- else -}} + {{ default "default" .Values.serviceAccountAgent.name }} +{{- end -}} +{{- end -}} + +{{/* +Create the name of the service account for Jenkins backup to use +*/}} +{{- define "backup.serviceAccountBackupName" -}} +{{- if .Values.backup.serviceAccount.create -}} + {{ default (printf "%s-%s" (include "jenkins.fullname" .) "backup") .Values.backup.serviceAccount.name }} +{{- else -}} + {{ default "default" .Values.backup.serviceAccount.name }} +{{- end -}} +{{- end -}} + +{{/* +Create a full tag name for controller image +*/}} +{{- define "controller.tag" -}} +{{- if .Values.controller.tagLabel -}} + {{- default (printf "%s-%s" .Chart.AppVersion .Values.controller.tagLabel) .Values.controller.tag -}} +{{- else -}} + {{- default .Chart.AppVersion .Values.controller.tag -}} +{{- end -}} +{{- end -}} + +{{/* +Create the HTTP port for interacting with the controller +*/}} +{{- define "controller.httpPort" -}} +{{- if .Values.controller.httpsKeyStore.enable -}} + {{- .Values.controller.httpsKeyStore.httpPort -}} +{{- else -}} + {{- .Values.controller.targetPort -}} +{{- end -}} +{{- end -}} + +{{- define "jenkins.configReloadContainer" -}} +{{- $root := index . 0 -}} +{{- $containerName := index . 1 -}} +{{- $containerType := index . 2 -}} +- name: {{ $containerName }} + image: "{{ $root.Values.controller.sidecars.configAutoReload.image }}" + imagePullPolicy: {{ $root.Values.controller.sidecars.configAutoReload.imagePullPolicy }} + {{- if $root.Values.controller.sidecars.configAutoReload.containerSecurityContext }} + securityContext: {{- toYaml $root.Values.controller.sidecars.configAutoReload.containerSecurityContext | nindent 4 }} + {{- end }} + {{- if $root.Values.controller.sidecars.configAutoReload.envFrom }} + envFrom: +{{ (tpl (toYaml $root.Values.controller.sidecars.configAutoReload.envFrom) $root) | indent 4 }} + {{- end }} + env: + - name: POD_NAME + valueFrom: + fieldRef: + fieldPath: metadata.name + - name: LABEL + value: "{{ template "jenkins.fullname" $root }}-jenkins-config" + - name: FOLDER + value: "{{ $root.Values.controller.sidecars.configAutoReload.folder }}" + - name: NAMESPACE + value: '{{ $root.Values.controller.sidecars.configAutoReload.searchNamespace | default (include "jenkins.namespace" $root) }}' + {{- if eq $containerType "init" }} + - name: METHOD + value: "LIST" + {{- else if $root.Values.controller.sidecars.configAutoReload.sleepTime }} + - name: METHOD + value: "SLEEP" + - name: SLEEP_TIME + value: "{{ $root.Values.controller.sidecars.configAutoReload.sleepTime }}" + {{- end }} + {{- if eq $containerType "sidecar" }} + - name: REQ_URL + value: "http://localhost:{{- include "controller.httpPort" $root -}}{{- $root.Values.controller.jenkinsUriPrefix -}}/reload-configuration-as-code/?casc-reload-token=$(POD_NAME)" + - name: REQ_METHOD + value: "POST" + - name: REQ_RETRY_CONNECT + value: "{{ $root.Values.controller.sidecars.configAutoReload.reqRetryConnect }}" + {{- end }} + + {{- if $root.Values.controller.sidecars.configAutoReload.env }} + {{- range $envVarItem := $root.Values.controller.sidecars.configAutoReload.env -}} + {{- if or (ne $containerType "init") (ne .name "METHOD") }} +{{- (tpl (toYaml (list $envVarItem)) $root) | nindent 4 }} + {{- end -}} + {{- end -}} + {{- end }} + + resources: +{{ toYaml $root.Values.controller.sidecars.configAutoReload.resources | indent 4 }} + volumeMounts: + - name: sc-config-volume + mountPath: {{ $root.Values.controller.sidecars.configAutoReload.folder | quote }} + - name: jenkins-home + mountPath: {{ $root.Values.controller.jenkinsHome }} + {{- if $root.Values.persistence.subPath }} + subPath: {{ $root.Values.persistence.subPath }} + {{- end }} + +{{- end -}} diff --git a/helm/whanos/charts/jenkins/templates/config-init-scripts.yaml b/helm/whanos/charts/jenkins/templates/config-init-scripts.yaml new file mode 100644 index 0000000..7dd253c --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/config-init-scripts.yaml @@ -0,0 +1,18 @@ +{{- if .Values.controller.initScripts -}} + +apiVersion: v1 +kind: ConfigMap +metadata: + name: {{ template "jenkins.fullname" . }}-init-scripts + namespace: {{ template "jenkins.namespace" . }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" +data: +{{- range $key, $val := .Values.controller.initScripts }} + init{{ $key }}.groovy: |- +{{ tpl $val $ | indent 4 }} +{{- end }} +{{- end }} diff --git a/helm/whanos/charts/jenkins/templates/config.yaml b/helm/whanos/charts/jenkins/templates/config.yaml new file mode 100644 index 0000000..b94c79f --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/config.yaml @@ -0,0 +1,86 @@ +{{- $jenkinsHome := .Values.controller.jenkinsHome -}} + +apiVersion: v1 +kind: ConfigMap +metadata: + name: {{ template "jenkins.fullname" . }} + namespace: {{ template "jenkins.namespace" . }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" +data: + apply_config.sh: |- + set -e +{{- if .Values.controller.initializeOnce }} + if [ -f {{ .Values.controller.jenkinsHome }}/initialization-completed ]; then + echo "controller was previously initialized, refusing to re-initialize" + exit 0 + fi +{{- end }} + echo "disable Setup Wizard" + # Prevent Setup Wizard when JCasC is enabled + echo $JENKINS_VERSION > {{ .Values.controller.jenkinsHome }}/jenkins.install.UpgradeWizard.state + echo $JENKINS_VERSION > {{ .Values.controller.jenkinsHome }}/jenkins.install.InstallUtil.lastExecVersion +{{- if .Values.controller.overwritePlugins }} + echo "remove all plugins from shared volume" + # remove all plugins from shared volume + rm -rf {{ .Values.controller.jenkinsHome }}/plugins/* +{{- end }} +{{- if .Values.controller.installPlugins }} + echo "download plugins" + # Install missing plugins + cp /var/jenkins_config/plugins.txt {{ .Values.controller.jenkinsHome }}; + rm -rf {{ .Values.controller.jenkinsRef }}/plugins/*.lock + version () { echo "$@" | awk -F. '{ printf("%d%03d%03d%03d\n", $1,$2,$3,$4); }'; } + if [ -f "{{ .Values.controller.jenkinsWar }}" ] && [ -n "$(command -v jenkins-plugin-cli)" 2>/dev/null ] && [ $(version $(jenkins-plugin-cli --version)) -ge $(version "2.1.1") ]; then + jenkins-plugin-cli --verbose --war "{{ .Values.controller.jenkinsWar }}" --plugin-file "{{ .Values.controller.jenkinsHome }}/plugins.txt" --latest {{ .Values.controller.installLatestPlugins }}{{- if .Values.controller.installLatestSpecifiedPlugins }} --latest-specified{{- end }}; + else + /usr/local/bin/install-plugins.sh `echo $(cat {{ .Values.controller.jenkinsHome }}/plugins.txt)`; + fi + echo "copy plugins to shared volume" + # Copy plugins to shared volume + yes n | cp -i {{ .Values.controller.jenkinsRef }}/plugins/* /var/jenkins_plugins/; +{{- end }} + {{- if not .Values.controller.sidecars.configAutoReload.enabled }} + echo "copy configuration as code files" + mkdir -p {{ .Values.controller.jenkinsHome }}/casc_configs; + rm -rf {{ .Values.controller.jenkinsHome }}/casc_configs/* + {{- if or .Values.controller.JCasC.defaultConfig .Values.controller.JCasC.configScripts }} + cp -v /var/jenkins_config/*.yaml {{ .Values.controller.jenkinsHome }}/casc_configs + {{- end }} + {{- end }} + echo "finished initialization" +{{- if .Values.controller.initializeOnce }} + touch {{ .Values.controller.jenkinsHome }}/initialization-completed +{{- end }} + {{- if not .Values.controller.sidecars.configAutoReload.enabled }} +# Only add config to this script if we aren't auto-reloading otherwise the pod will restart upon each config change: +{{- if .Values.controller.JCasC.defaultConfig }} + jcasc-default-config.yaml: |- + {{- include "jenkins.casc.defaults" . |nindent 4}} +{{- end }} +{{- range $key, $val := .Values.controller.JCasC.configScripts }} + {{ $key }}.yaml: |- +{{ tpl $val $| indent 4 }} +{{- end }} +{{- end }} + plugins.txt: |- +{{- if .Values.controller.installPlugins }} + {{- range $installPlugin := .Values.controller.installPlugins }} + {{- $installPlugin | nindent 4 }} + {{- end }} + {{- range $addlPlugin := .Values.controller.additionalPlugins }} + {{- /* duplicate plugin check */}} + {{- range $installPlugin := $.Values.controller.installPlugins }} + {{- if eq (splitList ":" $addlPlugin | first) (splitList ":" $installPlugin | first) }} + {{- $message := print "[PLUGIN CONFLICT] controller.additionalPlugins contains '" $addlPlugin "'" }} + {{- $message := print $message " but controller.installPlugins already contains '" $installPlugin "'." }} + {{- $message := print $message " Override controller.installPlugins to use '" $addlPlugin "' plugin." }} + {{- fail $message }} + {{- end }} + {{- end }} + {{- $addlPlugin | nindent 4 }} + {{- end }} +{{- end }} diff --git a/helm/whanos/charts/jenkins/templates/deprecation.yaml b/helm/whanos/charts/jenkins/templates/deprecation.yaml new file mode 100644 index 0000000..43a798d --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/deprecation.yaml @@ -0,0 +1,115 @@ +{{- if .Values.checkDeprecation }} + {{- if .Values.master }} + {{ fail "`master` does no longer exist. It has been renamed to `controller`" }} + {{- end }} + + {{- if .Values.controller.imageTag }} + {{ fail "`controller.imageTag` does no longer exist. Please use `controller.tag` instead" }} + {{- end }} + + {{- if .Values.controller.slaveListenerPort }} + {{ fail "`controller.slaveListenerPort` does no longer exist. It has been renamed to `controller.agentListenerPort`" }} + {{- end }} + + {{- if .Values.controller.slaveHostPort }} + {{ fail "`controller.slaveHostPort` does no longer exist. It has been renamed to `controller.agentListenerHostPort`" }} + {{- end }} + + {{- if .Values.controller.slaveKubernetesNamespace }} + {{ fail "`controller.slaveKubernetesNamespace` does no longer exist. It has been renamed to `agent.namespace`" }} + {{- end }} + + {{- if .Values.controller.slaveDefaultsProviderTemplate }} + {{ fail "`controller.slaveDefaultsProviderTemplate` does no longer exist. It has been renamed to `agent.defaultsProviderTemplate`" }} + {{- end }} + + {{- if .Values.controller.useSecurity }} + {{ fail "`controller.useSecurity` does no longer exist. It has been renamed to `controller.adminSecret`" }} + {{- end }} + + {{- if .Values.controller.slaveJenkinsUrl }} + {{ fail "`controller.slaveJenkinsUrl` does no longer exist. It has been renamed to `agent.jenkinsUrl`" }} + {{- end }} + + {{- if .Values.controller.slaveJenkinsTunnel }} + {{ fail "`controller.slaveJenkinsTunnel` does no longer exist. It has been renamed to `agent.jenkinsTunnel`" }} + {{- end }} + + {{- if .Values.controller.slaveConnectTimeout }} + {{ fail "`controller.slaveConnectTimeout` does no longer exist. It has been renamed to `agent.kubernetesConnectTimeout`" }} + {{- end }} + + {{- if .Values.controller.slaveReadTimeout }} + {{ fail "`controller.slaveReadTimeout` does no longer exist. It has been renamed to `agent.kubernetesReadTimeout`" }} + {{- end }} + + {{- if .Values.controller.slaveListenerServiceType }} + {{ fail "`controller.slaveListenerServiceType` does no longer exist. It has been renamed to `controller.agentListenerServiceType`" }} + {{- end }} + + {{- if .Values.controller.slaveListenerLoadBalancerIP }} + {{ fail "`controller.slaveListenerLoadBalancerIP` does no longer exist. It has been renamed to `controller.agentListenerLoadBalancerIP`" }} + {{- end }} + + {{- if .Values.controller.slaveListenerServiceAnnotations }} + {{ fail "`controller.slaveListenerServiceAnnotations` does no longer exist. It has been renamed to `controller.agentListenerServiceAnnotations`" }} + {{- end }} + + {{- if .Values.agent.slaveConnectTimeout }} + {{ fail "`agent.slaveConnectTimeout` does no longer exist. It has been renamed to `agent.connectTimeout`" }} + {{- end }} + + {{- if .Values.NetworkPolicy }} + + {{- if .Values.NetworkPolicy.Enabled }} + {{ fail "`NetworkPolicy.Enabled` does no longer exist. It has been renamed to `networkPolicy.enabled`" }} + {{- end }} + + {{- if .Values.NetworkPolicy.ApiVersion }} + {{ fail "`NetworkPolicy.ApiVersion` does no longer exist. It has been renamed to `networkPolicy.apiVersion`" }} + {{- end }} + + {{ fail "NetworkPolicy.* values have been renamed, please check the documentation" }} + {{- end }} + + + {{- if .Values.rbac.install }} + {{ fail "`rbac.install` does no longer exist. It has been renamed to `rbac.create` and is enabled by default!" }} + {{- end }} + + {{- if .Values.rbac.serviceAccountName }} + {{ fail "`rbac.serviceAccountName` does no longer exist. It has been renamed to `serviceAccount.name`" }} + {{- end }} + + {{- if .Values.rbac.serviceAccountAnnotations }} + {{ fail "`rbac.serviceAccountAnnotations` does no longer exist. It has been renamed to `serviceAccount.annotations`" }} + {{- end }} + + {{- if .Values.rbac.roleRef }} + {{ fail "`rbac.roleRef` does no longer exist. RBAC roles are now generated, please check the documentation" }} + {{- end }} + + {{- if .Values.rbac.roleKind }} + {{ fail "`rbac.roleKind` does no longer exist. RBAC roles are now generated, please check the documentation" }} + {{- end }} + + {{- if .Values.rbac.roleBindingKind }} + {{ fail "`rbac.roleBindingKind` does no longer exist. RBAC roles are now generated, please check the documentation" }} + {{- end }} + + {{- if .Values.controller.JCasC.pluginVersion }} + {{ fail "controller.JCasC.pluginVersion has been deprecated, please use controller.installPlugins instead" }} + {{- end }} + + {{- if .Values.controller.deploymentLabels }} + {{ fail "`controller.deploymentLabels` does no longer exist. It has been renamed to `controller.statefulSetLabels`" }} + {{- end }} + + {{- if .Values.controller.deploymentAnnotations }} + {{ fail "`controller.deploymentAnnotations` does no longer exist. It has been renamed to `controller.statefulSetAnnotations`" }} + {{- end }} + + {{- if .Values.controller.rollingUpdate }} + {{ fail "`controller.rollingUpdate` does no longer exist. It is no longer relevant, since a StatefulSet is used for the Jenkins controller" }} + {{- end }} +{{- end }} diff --git a/helm/whanos/charts/jenkins/templates/home-pvc.yaml b/helm/whanos/charts/jenkins/templates/home-pvc.yaml new file mode 100644 index 0000000..f417d23 --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/home-pvc.yaml @@ -0,0 +1,41 @@ +{{- if not (contains "jenkins-home" (quote .Values.persistence.volumes)) }} +{{- if and .Values.persistence.enabled (not .Values.persistence.existingClaim) -}} +kind: PersistentVolumeClaim +apiVersion: v1 +metadata: +{{- if .Values.persistence.annotations }} + annotations: +{{ toYaml .Values.persistence.annotations | indent 4 }} +{{- end }} + name: {{ template "jenkins.fullname" . }} + namespace: {{ template "jenkins.namespace" . }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" +{{- if .Values.persistence.labels }} +{{ toYaml .Values.persistence.labels | indent 4 }} +{{- end }} +spec: +{{- if .Values.persistence.dataSource }} + dataSource: +{{ toYaml .Values.persistence.dataSource | indent 4 }} +{{- end }} + accessModes: + - {{ .Values.persistence.accessMode | quote }} + resources: + requests: + storage: {{ .Values.persistence.size | quote }} +{{- if .Values.persistence.storageClass }} +{{- if (eq "-" .Values.persistence.storageClass) }} + storageClassName: "" +{{- else }} + storageClassName: "{{ .Values.persistence.storageClass }}" +{{- end }} +{{- end }} +{{- end }} +{{- end }} diff --git a/helm/whanos/charts/jenkins/templates/jcasc-config.yaml b/helm/whanos/charts/jenkins/templates/jcasc-config.yaml new file mode 100644 index 0000000..684c985 --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/jcasc-config.yaml @@ -0,0 +1,45 @@ +{{- $root := . }} +{{- if .Values.controller.sidecars.configAutoReload.enabled }} +{{- range $key, $val := .Values.controller.JCasC.configScripts }} +{{- if $val }} +--- +apiVersion: v1 +kind: ConfigMap +metadata: + name: {{ template "jenkins.casc.configName" (list (printf "config-%s" $key) $ )}} + namespace: {{ template "jenkins.namespace" $root }} + labels: + "app.kubernetes.io/name": {{ template "jenkins.name" $root}} + {{- if $root.Values.renderHelmLabels }} + "helm.sh/chart": "{{ $root.Chart.Name }}-{{ $root.Chart.Version }}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ $.Release.Service }}" + "app.kubernetes.io/instance": "{{ $.Release.Name }}" + "app.kubernetes.io/component": "{{ $.Values.controller.componentName }}" + {{ template "jenkins.fullname" $root }}-jenkins-config: "true" +data: + {{ $key }}.yaml: |- +{{ tpl $val $| indent 4 }} +{{- end }} +{{- end }} +{{- if .Values.controller.JCasC.defaultConfig }} +--- +apiVersion: v1 +kind: ConfigMap +metadata: + name: {{ template "jenkins.casc.configName" (list "jcasc-config" $ )}} + namespace: {{ template "jenkins.namespace" $root }} + labels: + "app.kubernetes.io/name": {{ template "jenkins.name" $root}} + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ $root.Chart.Name }}-{{ $root.Chart.Version }}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ $.Release.Service }}" + "app.kubernetes.io/instance": "{{ $.Release.Name }}" + "app.kubernetes.io/component": "{{ $.Values.controller.componentName }}" + {{ template "jenkins.fullname" $root }}-jenkins-config: "true" +data: + jcasc-default-config.yaml: |- + {{- include "jenkins.casc.defaults" . |nindent 4 }} +{{- end}} +{{- end }} diff --git a/helm/whanos/charts/jenkins/templates/jenkins-agent-svc.yaml b/helm/whanos/charts/jenkins/templates/jenkins-agent-svc.yaml new file mode 100644 index 0000000..4440b91 --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/jenkins-agent-svc.yaml @@ -0,0 +1,43 @@ +{{- if .Values.controller.agentListenerEnabled }} +apiVersion: v1 +kind: Service +metadata: + name: {{ template "jenkins.fullname" . }}-agent + namespace: {{ template "jenkins.namespace" . }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" + {{- if .Values.controller.agentListenerServiceAnnotations }} + annotations: + {{- toYaml .Values.controller.agentListenerServiceAnnotations | nindent 4 }} + {{- end }} +spec: + {{- if .Values.controller.agentListenerExternalTrafficPolicy }} + externalTrafficPolicy: {{.Values.controller.agentListenerExternalTrafficPolicy}} + {{- end }} + ports: + - port: {{ .Values.controller.agentListenerPort }} + targetPort: {{ .Values.controller.agentListenerPort }} + {{- if (and (eq .Values.controller.agentListenerServiceType "NodePort") (not (empty .Values.controller.agentListenerNodePort))) }} + nodePort: {{ .Values.controller.agentListenerNodePort }} + {{- end }} + name: agent-listener + selector: + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + type: {{ .Values.controller.agentListenerServiceType }} + {{if eq .Values.controller.agentListenerServiceType "LoadBalancer"}} +{{- if .Values.controller.agentListenerLoadBalancerSourceRanges }} + loadBalancerSourceRanges: +{{ toYaml .Values.controller.agentListenerLoadBalancerSourceRanges | indent 4 }} +{{- end }} + {{- end }} + {{- if and (eq .Values.controller.agentListenerServiceType "LoadBalancer") (.Values.controller.agentListenerLoadBalancerIP) }} + loadBalancerIP: {{ .Values.controller.agentListenerLoadBalancerIP }} + {{- end }} + {{- end }} diff --git a/helm/whanos/charts/jenkins/templates/jenkins-aws-security-group-policies.yaml b/helm/whanos/charts/jenkins/templates/jenkins-aws-security-group-policies.yaml new file mode 100644 index 0000000..2f6e7a1 --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/jenkins-aws-security-group-policies.yaml @@ -0,0 +1,16 @@ +{{- if .Values.awsSecurityGroupPolicies.enabled -}} +{{- range .Values.awsSecurityGroupPolicies.policies -}} +apiVersion: vpcresources.k8s.aws/v1beta1 +kind: SecurityGroupPolicy +metadata: + name: {{ .name }} + namespace: {{ template "jenkins.namespace" $ }} +spec: + podSelector: + {{- toYaml .podSelector | nindent 6}} + securityGroups: + groupIds: + {{- toYaml .securityGroupIds | nindent 6}} +--- +{{- end -}} +{{- end -}} diff --git a/helm/whanos/charts/jenkins/templates/jenkins-backup-cronjob.yaml b/helm/whanos/charts/jenkins/templates/jenkins-backup-cronjob.yaml new file mode 100644 index 0000000..d710dd5 --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/jenkins-backup-cronjob.yaml @@ -0,0 +1,168 @@ +{{- if .Values.backup.enabled }} +apiVersion: {{ .Values.cronJob.apiVersion }} +kind: CronJob +metadata: + name: {{ template "jenkins.fullname" . }}-backup + namespace: {{ template "jenkins.namespace" . }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.backup.componentName }}" +spec: + schedule: {{ .Values.backup.schedule | quote }} + concurrencyPolicy: Forbid + startingDeadlineSeconds: 120 + jobTemplate: + spec: +{{- if .Values.backup.activeDeadlineSeconds }} + activeDeadlineSeconds: {{ .Values.backup.activeDeadlineSeconds }} +{{- end }} + template: + metadata: + {{- if .Values.backup.labels }} + labels: + {{- toYaml .Values.backup.labels | trim | nindent 12 }} + {{- end }} + {{- if .Values.backup.annotations }} + annotations: + {{- toYaml .Values.backup.annotations | trim | nindent 12 }} + {{- end }} + spec: + restartPolicy: OnFailure + serviceAccountName: {{ include "backup.serviceAccountBackupName" . }} + {{- if .Values.backup.usePodSecurityContext }} + securityContext: + {{- if hasKey .Values.backup "podSecurityContextOverride" }} + {{- tpl (toYaml .Values.backup.podSecurityContextOverride | nindent 12) . }} + {{- else }} + runAsUser: {{ default 0 .Values.backup.runAsUser }} + {{- if and (.Values.backup.runAsUser) (.Values.backup.fsGroup) }} + {{- if not (eq (int .Values.backup.runAsUser) 0) }} + fsGroup: {{ .Values.backup.fsGroup }} + {{- end }} + {{- end }} + {{- if .Values.backup.securityContextCapabilities }} + capabilities: + {{- toYaml .Values.backup.securityContextCapabilities | nindent 12 }} + {{- end }} + {{- end }} + {{- end }} + containers: + - name: jenkins-backup + image: "{{ .Values.backup.image.repository }}:{{ .Values.backup.image.tag }}" + command: ["kube-tasks"] + args: + - simple-backup + - -n + - {{ template "jenkins.namespace" . }} + - -l + - app.kubernetes.io/instance={{ .Release.Name }} + - --container + - jenkins + - --path + {{- if .Values.backup.onlyJobs }} + - {{ .Values.controller.jenkinsHome }}/jobs + {{- else}} + - {{ .Values.controller.jenkinsHome }} + {{- end}} + - --dst + - {{ .Values.backup.destination }} + {{- with .Values.backup.extraArgs }} + {{- toYaml . | nindent 12 }} + {{- end }} + env: + {{- with .Values.backup.env }} + {{- toYaml . | trim | nindent 12 }} + {{- end }} + {{- if .Values.backup.existingSecret }} + {{- range $key,$value := .Values.backup.existingSecret }} + {{- if $value.awsaccesskey }} + - name: AWS_ACCESS_KEY_ID + valueFrom: + secretKeyRef: + name: {{ $key }} + key: {{ $value.awsaccesskey | quote }} + {{- end }} + {{- if $value.awssecretkey }} + - name: AWS_SECRET_ACCESS_KEY + valueFrom: + secretKeyRef: + name: {{ $key }} + key: {{ $value.awssecretkey | quote}} + {{- end }} + {{- if $value.azstorageaccount }} + - name: AZURE_STORAGE_ACCOUNT + valueFrom: + secretKeyRef: + name: {{ $key }} + key: {{ $value.azstorageaccount | quote}} + {{- end }} + {{- if $value.azstoragekey }} + - name: AZURE_STORAGE_ACCESS_KEY + valueFrom: + secretKeyRef: + name: {{ $key }} + key: {{ $value.azstoragekey | quote}} + {{- end }} + {{- if $value.gcpcredentials }} + - name: GOOGLE_APPLICATION_CREDENTIALS + value: "/var/run/secrets/{{ $key }}/{{ $value.gcpcredentials }}" + {{- end }} + {{- end }} + {{- end }} + {{- with .Values.backup.resources }} + resources: + {{- toYaml . | trim | nindent 14 }} + {{- end }} + volumeMounts: + {{- if .Values.backup.existingSecret }} + {{- range $key,$value := .Values.backup.existingSecret }} + {{- if $value.gcpcredentials }} + - mountPath: /var/run/secrets/{{ $key }} + name: {{ $key }} + {{- end }} + {{- end }} + {{- end }} + volumes: + {{- if .Values.backup.existingSecret }} + {{- range $key,$value := .Values.backup.existingSecret }} + {{- if $value.gcpcredentials }} + - name: {{ $key }} + secret: + secretName: {{ $key }} + {{- end }} + {{- end }} + {{- end }} + affinity: + podAffinity: + preferredDuringSchedulingIgnoredDuringExecution: + - weight: 100 + podAffinityTerm: + topologyKey: "kubernetes.io/hostname" + labelSelector: + matchExpressions: + - key: app + operator: In + values: + - {{ template "jenkins.fullname" . }} + - key: release + operator: In + values: + - {{ .Release.Name }} + {{- with .Values.controller.tolerations }} + tolerations: + {{- toYaml . | nindent 10 }} + {{- end }} + {{- with .Values.controller.nodeSelector }} + nodeSelector: + {{- toYaml . | nindent 12 }} + {{- end }} + {{- if .Values.backup.imagePullSecretName }} + imagePullSecrets: + - name: {{ .Values.backup.imagePullSecretName }} + {{- end -}} +{{- end }} diff --git a/helm/whanos/charts/jenkins/templates/jenkins-backup-rbac.yaml b/helm/whanos/charts/jenkins/templates/jenkins-backup-rbac.yaml new file mode 100644 index 0000000..0f94fa8 --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/jenkins-backup-rbac.yaml @@ -0,0 +1,64 @@ +{{- if .Values.backup.enabled }} +{{- if .Values.backup.serviceAccount.create }} +apiVersion: v1 +kind: ServiceAccount +metadata: + name: {{ include "backup.serviceAccountBackupName" . }} + namespace: {{ template "jenkins.namespace" . }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" + {{- if .Values.backup.serviceAccount.annotations }} + annotations: + {{- toYaml .Values.backup.serviceAccount.annotations | nindent 4 }} + {{- end }} +{{- end }} +--- +apiVersion: rbac.authorization.k8s.io/v1 +kind: Role +metadata: + name: {{ template "jenkins.fullname" . }}-backup + namespace: {{ template "jenkins.namespace" . }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" +rules: +- apiGroups: [""] + resources: ["pods", "pods/log"] + verbs: ["get", "list"] +- apiGroups: [""] + resources: ["pods/exec"] + verbs: ["create"] +--- +apiVersion: rbac.authorization.k8s.io/v1 +kind: RoleBinding +metadata: + name: {{ template "jenkins.fullname" . }}-backup + namespace: {{ template "jenkins.namespace" . }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" +roleRef: + apiGroup: rbac.authorization.k8s.io + kind: Role + name: {{ template "jenkins.fullname" . }}-backup +subjects: +- kind: ServiceAccount + name: {{ include "backup.serviceAccountBackupName" . }} + namespace: {{ template "jenkins.namespace" . }} +{{- end }} diff --git a/helm/whanos/charts/jenkins/templates/jenkins-controller-alerting-rules.yaml b/helm/whanos/charts/jenkins/templates/jenkins-controller-alerting-rules.yaml new file mode 100644 index 0000000..3fd8061 --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/jenkins-controller-alerting-rules.yaml @@ -0,0 +1,26 @@ +{{- if and .Values.controller.prometheus.enabled .Values.controller.prometheus.alertingrules }} +--- +apiVersion: monitoring.coreos.com/v1 +kind: PrometheusRule +metadata: + name: {{ template "jenkins.fullname" . }} +{{- if .Values.controller.prometheus.prometheusRuleNamespace }} + namespace: {{ .Values.controller.prometheus.prometheusRuleNamespace }} +{{- else }} + namespace: {{ template "jenkins.namespace" . }} +{{- end }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" + {{- range $key, $val := .Values.controller.prometheus.alertingRulesAdditionalLabels }} + {{ $key }}: {{ $val | quote }} + {{- end}} +spec: + groups: +{{ toYaml .Values.controller.prometheus.alertingrules | indent 2 }} +{{- end }} diff --git a/helm/whanos/charts/jenkins/templates/jenkins-controller-backendconfig.yaml b/helm/whanos/charts/jenkins/templates/jenkins-controller-backendconfig.yaml new file mode 100644 index 0000000..0e8a566 --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/jenkins-controller-backendconfig.yaml @@ -0,0 +1,24 @@ +{{- if .Values.controller.backendconfig.enabled }} +apiVersion: {{ .Values.controller.backendconfig.apiVersion }} +kind: BackendConfig +metadata: + name: {{ .Values.controller.backendconfig.name }} + namespace: {{ template "jenkins.namespace" . }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" +{{- if .Values.controller.backendconfig.labels }} +{{ toYaml .Values.controller.backendconfig.labels | indent 4 }} +{{- end }} +{{- if .Values.controller.backendconfig.annotations }} + annotations: +{{ toYaml .Values.controller.backendconfig.annotations | indent 4 }} +{{- end }} +spec: +{{ toYaml .Values.controller.backendconfig.spec | indent 2 }} +{{- end }} diff --git a/helm/whanos/charts/jenkins/templates/jenkins-controller-ingress.yaml b/helm/whanos/charts/jenkins/templates/jenkins-controller-ingress.yaml new file mode 100644 index 0000000..b3b344f --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/jenkins-controller-ingress.yaml @@ -0,0 +1,77 @@ +{{- $kubeTargetVersion := default .Capabilities.KubeVersion.GitVersion .Values.kubeTargetVersionOverride }} +{{- if .Values.controller.ingress.enabled }} +{{- if semverCompare ">=1.19-0" $kubeTargetVersion -}} +apiVersion: networking.k8s.io/v1 +{{- else if semverCompare ">=1.14-0" $kubeTargetVersion -}} +apiVersion: networking.k8s.io/v1beta1 +{{- else -}} +apiVersion: {{ .Values.controller.ingress.apiVersion }} +{{- end }} +kind: Ingress +metadata: + namespace: {{ template "jenkins.namespace" . }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" +{{- if .Values.controller.ingress.labels }} +{{ toYaml .Values.controller.ingress.labels | indent 4 }} +{{- end }} +{{- if .Values.controller.ingress.annotations }} + annotations: +{{ toYaml .Values.controller.ingress.annotations | indent 4 }} +{{- end }} + name: {{ template "jenkins.fullname" . }} +spec: +{{- if .Values.controller.ingress.ingressClassName }} + ingressClassName: {{ .Values.controller.ingress.ingressClassName | quote }} +{{- end }} + rules: + - http: + paths: +{{- if empty (.Values.controller.ingress.paths) }} + - backend: +{{- if semverCompare ">=1.19-0" $kubeTargetVersion }} + service: + name: {{ template "jenkins.fullname" . }} + port: + number: {{ .Values.controller.servicePort }} + pathType: ImplementationSpecific +{{- else }} + serviceName: {{ template "jenkins.fullname" . }} + servicePort: {{ .Values.controller.servicePort }} +{{- end }} +{{- if .Values.controller.ingress.path }} + path: {{ .Values.controller.ingress.path }} +{{- end -}} +{{- else }} +{{ tpl (toYaml .Values.controller.ingress.paths | indent 6) . }} +{{- end -}} +{{- if .Values.controller.ingress.hostName }} + host: {{ tpl .Values.controller.ingress.hostName . | quote }} +{{- end }} +{{- if .Values.controller.ingress.resourceRootUrl }} + - http: + paths: + - backend: +{{- if semverCompare ">=1.19-0" $kubeTargetVersion }} + service: + name: {{ template "jenkins.fullname" . }} + port: + number: {{ .Values.controller.servicePort }} + pathType: ImplementationSpecific +{{- else }} + serviceName: {{ template "jenkins.fullname" . }} + servicePort: {{ .Values.controller.servicePort }} +{{- end }} + host: {{ tpl .Values.controller.ingress.resourceRootUrl . | quote }} +{{- end }} +{{- if .Values.controller.ingress.tls }} + tls: +{{ tpl (toYaml .Values.controller.ingress.tls ) . | indent 4 }} +{{- end -}} +{{- end }} diff --git a/helm/whanos/charts/jenkins/templates/jenkins-controller-networkpolicy.yaml b/helm/whanos/charts/jenkins/templates/jenkins-controller-networkpolicy.yaml new file mode 100644 index 0000000..91cf6db --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/jenkins-controller-networkpolicy.yaml @@ -0,0 +1,76 @@ +{{- if .Values.networkPolicy.enabled }} +kind: NetworkPolicy +apiVersion: {{ .Values.networkPolicy.apiVersion }} +metadata: + name: "{{ .Release.Name }}-{{ .Values.controller.componentName }}" + namespace: {{ template "jenkins.namespace" . }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" +spec: + podSelector: + matchLabels: + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + ingress: + # Allow web access to the UI + - ports: + - port: {{ .Values.controller.targetPort }} + {{- if .Values.controller.agentListenerEnabled }} + # Allow inbound connections from agents + - from: + {{- if .Values.networkPolicy.internalAgents.allowed }} + - podSelector: + matchLabels: + "jenkins/{{ .Release.Name }}-{{ .Values.agent.componentName }}": "true" + {{- range $k,$v:= .Values.networkPolicy.internalAgents.podLabels }} + {{ $k }}: {{ $v }} + {{- end }} + {{- if .Values.networkPolicy.internalAgents.namespaceLabels }} + namespaceSelector: + matchLabels: + {{- range $k,$v:= .Values.networkPolicy.internalAgents.namespaceLabels }} + {{ $k }}: {{ $v }} + {{- end }} + {{- end }} + {{- end }} + {{- if .Values.networkPolicy.externalAgents }} + - ipBlock: + cidr: {{ required "ipCIDR is required if you wish to allow external agents to connect to Jenkins Controller." .Values.networkPolicy.externalAgents.ipCIDR }} + {{- if .Values.networkPolicy.externalAgents.except }} + except: + {{- range .Values.networkPolicy.externalAgents.except }} + - {{ . }} + {{- end }} + {{- end }} + {{- end }} + ports: + - port: {{ .Values.controller.agentListenerPort }} + {{- end }} +{{- if .Values.agent.enabled }} +--- +kind: NetworkPolicy +apiVersion: {{ .Values.networkPolicy.apiVersion }} +metadata: + name: "{{ .Release.Name }}-{{ .Values.agent.componentName }}" + namespace: {{ template "jenkins.namespace" . }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" +spec: + podSelector: + matchLabels: + # DefaultDeny + "jenkins/{{ .Release.Name }}-{{ .Values.agent.componentName }}": "true" +{{- end }} +{{- end }} diff --git a/helm/whanos/charts/jenkins/templates/jenkins-controller-pdb.yaml b/helm/whanos/charts/jenkins/templates/jenkins-controller-pdb.yaml new file mode 100644 index 0000000..9dc1faf --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/jenkins-controller-pdb.yaml @@ -0,0 +1,34 @@ +{{- if .Values.controller.podDisruptionBudget.enabled }} +{{- $kubeTargetVersion := default .Capabilities.KubeVersion.GitVersion .Values.kubeTargetVersionOverride }} +{{- if semverCompare ">=1.21-0" $kubeTargetVersion -}} +apiVersion: policy/v1 +{{- else if semverCompare ">=1.5-0" $kubeTargetVersion -}} +apiVersion: policy/v1beta1 +{{- else -}} +apiVersion: {{ .Values.controller.podDisruptionBudget.apiVersion }} +{{- end }} +kind: PodDisruptionBudget +metadata: + name: {{ template "jenkins.fullname" . }}-pdb + namespace: {{ template "jenkins.namespace" . }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" + {{- if .Values.controller.podDisruptionBudget.labels -}} + {{ toYaml .Values.controller.podDisruptionBudget.labels | nindent 4 }} + {{- end }} + {{- if .Values.controller.podDisruptionBudget.annotations }} + annotations: {{ toYaml .Values.controller.podDisruptionBudget.annotations | nindent 4 }} + {{- end }} +spec: + maxUnavailable: {{ .Values.controller.podDisruptionBudget.maxUnavailable }} + selector: + matchLabels: + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' +{{- end }} diff --git a/helm/whanos/charts/jenkins/templates/jenkins-controller-podmonitor.yaml b/helm/whanos/charts/jenkins/templates/jenkins-controller-podmonitor.yaml new file mode 100644 index 0000000..9a04019 --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/jenkins-controller-podmonitor.yaml @@ -0,0 +1,30 @@ +{{- if .Values.controller.googlePodMonitor.enabled }} +apiVersion: monitoring.googleapis.com/v1 +kind: PodMonitoring + +metadata: + name: {{ template "jenkins.fullname" . }} +{{- if .Values.controller.googlePodMonitor.serviceMonitorNamespace }} + namespace: {{ .Values.controller.googlePodMonitor.serviceMonitorNamespace }} +{{- else }} + namespace: {{ template "jenkins.namespace" . }} +{{- end }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" + +spec: + endpoints: + - interval: {{ .Values.controller.googlePodMonitor.scrapeInterval }} + port: http + path: {{ .Values.controller.jenkinsUriPrefix }}{{ .Values.controller.googlePodMonitor.scrapeEndpoint }} + selector: + matchLabels: + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" +{{- end }} diff --git a/helm/whanos/charts/jenkins/templates/jenkins-controller-route.yaml b/helm/whanos/charts/jenkins/templates/jenkins-controller-route.yaml new file mode 100644 index 0000000..3550380 --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/jenkins-controller-route.yaml @@ -0,0 +1,34 @@ +{{- if .Values.controller.route.enabled }} +apiVersion: route.openshift.io/v1 +kind: Route +metadata: + namespace: {{ template "jenkins.namespace" . }} + labels: + app: {{ template "jenkins.fullname" . }} + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + release: "{{ .Release.Name }}" + heritage: "{{ .Release.Service }}" + component: "{{ .Release.Name }}-{{ .Values.controller.componentName }}" +{{- if .Values.controller.route.labels }} +{{ toYaml .Values.controller.route.labels | indent 4 }} +{{- end }} +{{- if .Values.controller.route.annotations }} + annotations: +{{ toYaml .Values.controller.route.annotations | indent 4 }} +{{- end }} + name: {{ template "jenkins.fullname" . }} +spec: + host: {{ .Values.controller.route.path }} + port: + targetPort: http + tls: + insecureEdgeTerminationPolicy: Redirect + termination: edge + to: + kind: Service + name: {{ template "jenkins.fullname" . }} + weight: 100 + wildcardPolicy: None +{{- end }} diff --git a/helm/whanos/charts/jenkins/templates/jenkins-controller-secondary-ingress.yaml b/helm/whanos/charts/jenkins/templates/jenkins-controller-secondary-ingress.yaml new file mode 100644 index 0000000..c63e482 --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/jenkins-controller-secondary-ingress.yaml @@ -0,0 +1,56 @@ +{{- if .Values.controller.secondaryingress.enabled }} +{{- $kubeTargetVersion := default .Capabilities.KubeVersion.GitVersion .Values.kubeTargetVersionOverride }} +{{- $serviceName := include "jenkins.fullname" . -}} +{{- $servicePort := .Values.controller.servicePort -}} +{{- if semverCompare ">=1.19-0" $kubeTargetVersion -}} +apiVersion: networking.k8s.io/v1 +{{- else if semverCompare ">=1.14-0" $kubeTargetVersion -}} +apiVersion: networking.k8s.io/v1beta1 +{{- else -}} +apiVersion: {{ .Values.controller.secondaryingress.apiVersion }} +{{- end }} +kind: Ingress +metadata: + namespace: {{ template "jenkins.namespace" . }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" + {{- if .Values.controller.secondaryingress.labels -}} + {{ toYaml .Values.controller.secondaryingress.labels | nindent 4 }} + {{- end }} + {{- if .Values.controller.secondaryingress.annotations }} + annotations: {{ toYaml .Values.controller.secondaryingress.annotations | nindent 4 }} + {{- end }} + name: {{ template "jenkins.fullname" . }}-secondary +spec: +{{- if .Values.controller.secondaryingress.ingressClassName }} + ingressClassName: {{ .Values.controller.secondaryingress.ingressClassName | quote }} +{{- end }} + rules: + - host: {{ .Values.controller.secondaryingress.hostName }} + http: + paths: + {{- range .Values.controller.secondaryingress.paths }} + - path: {{ . | quote }} + backend: +{{ if semverCompare ">=1.19-0" $kubeTargetVersion }} + service: + name: {{ $serviceName }} + port: + number: {{ $servicePort }} + pathType: ImplementationSpecific +{{ else }} + serviceName: {{ $serviceName }} + servicePort: {{ $servicePort }} +{{ end }} + {{- end}} +{{- if .Values.controller.secondaryingress.tls }} + tls: +{{ toYaml .Values.controller.secondaryingress.tls | indent 4 }} +{{- end -}} +{{- end }} diff --git a/helm/whanos/charts/jenkins/templates/jenkins-controller-servicemonitor.yaml b/helm/whanos/charts/jenkins/templates/jenkins-controller-servicemonitor.yaml new file mode 100644 index 0000000..8710b2b --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/jenkins-controller-servicemonitor.yaml @@ -0,0 +1,45 @@ +{{- if and .Values.controller.prometheus.enabled }} +apiVersion: monitoring.coreos.com/v1 +kind: ServiceMonitor + +metadata: + name: {{ template "jenkins.fullname" . }} +{{- if .Values.controller.prometheus.serviceMonitorNamespace }} + namespace: {{ .Values.controller.prometheus.serviceMonitorNamespace }} +{{- else }} + namespace: {{ template "jenkins.namespace" . }} +{{- end }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" + {{- range $key, $val := .Values.controller.prometheus.serviceMonitorAdditionalLabels }} + {{ $key }}: {{ $val | quote }} + {{- end}} + +spec: + endpoints: + - interval: {{ .Values.controller.prometheus.scrapeInterval }} + port: http + path: {{ .Values.controller.jenkinsUriPrefix }}{{ .Values.controller.prometheus.scrapeEndpoint }} + {{- with .Values.controller.prometheus.relabelings }} + relabelings: + {{- toYaml . | nindent 6 }} + {{- end }} + {{- with .Values.controller.prometheus.metricRelabelings }} + metricRelabelings: + {{- toYaml . | nindent 6 }} + {{- end }} + jobLabel: {{ template "jenkins.fullname" . }} + namespaceSelector: + matchNames: + - "{{ template "jenkins.namespace" $ }}" + selector: + matchLabels: + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" +{{- end }} diff --git a/helm/whanos/charts/jenkins/templates/jenkins-controller-statefulset.yaml b/helm/whanos/charts/jenkins/templates/jenkins-controller-statefulset.yaml new file mode 100644 index 0000000..9cfe936 --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/jenkins-controller-statefulset.yaml @@ -0,0 +1,413 @@ +{{- if .Capabilities.APIVersions.Has "apps/v1" }} +apiVersion: apps/v1 +{{- else }} +apiVersion: apps/v1beta1 +{{- end }} +kind: StatefulSet +metadata: + name: {{ template "jenkins.fullname" . }} + namespace: {{ template "jenkins.namespace" . }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" + {{- range $key, $val := .Values.controller.statefulSetLabels }} + {{ $key }}: {{ $val | quote }} + {{- end}} + {{- if .Values.controller.statefulSetAnnotations }} + annotations: +{{ toYaml .Values.controller.statefulSetAnnotations | indent 4 }} + {{- end }} +spec: + serviceName: {{ template "jenkins.fullname" . }} + replicas: 1 + selector: + matchLabels: + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + {{- if .Values.controller.updateStrategy }} + updateStrategy: +{{ toYaml .Values.controller.updateStrategy | indent 4 }} + {{- end }} + template: + metadata: + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" + {{- range $key, $val := .Values.controller.podLabels }} + {{ $key }}: {{ $val | quote }} + {{- end}} + annotations: + checksum/config: {{ include (print $.Template.BasePath "/config.yaml") . | sha256sum }} + {{- if .Values.controller.initScripts }} + checksum/config-init-scripts: {{ include (print $.Template.BasePath "/config-init-scripts.yaml") . | sha256sum }} + {{- end }} + {{- if .Values.controller.podAnnotations }} +{{ tpl (toYaml .Values.controller.podAnnotations | indent 8) . }} + {{- end }} + spec: + {{- if .Values.controller.schedulerName }} + schedulerName: {{ .Values.controller.schedulerName }} + {{- end }} + {{- if .Values.controller.nodeSelector }} + nodeSelector: +{{ toYaml .Values.controller.nodeSelector | indent 8 }} + {{- end }} + {{- if .Values.controller.tolerations }} + tolerations: +{{ toYaml .Values.controller.tolerations | indent 8 }} + {{- end }} + {{- if .Values.controller.affinity }} + affinity: +{{ toYaml .Values.controller.affinity | indent 8 }} + {{- end }} + {{- if quote .Values.controller.terminationGracePeriodSeconds }} + terminationGracePeriodSeconds: {{ .Values.controller.terminationGracePeriodSeconds }} + {{- end }} + {{- if .Values.controller.priorityClassName }} + priorityClassName: {{ .Values.controller.priorityClassName }} + {{- end }} + {{- if .Values.controller.shareProcessNamespace }} + shareProcessNamespace: true + {{- end }} +{{- if .Values.controller.usePodSecurityContext }} + securityContext: + {{- if hasKey .Values.controller "podSecurityContextOverride" }} + {{- tpl (toYaml .Values.controller.podSecurityContextOverride | nindent 8) . -}} + {{- else }} + {{/* The rest of this section should be replaced with the contents of this comment one the runAsUser, fsGroup, and securityContextCapabilities Helm chart values have been removed: + runAsUser: 1000 + fsGroup: 1000 + runAsNonRoot: true + */}} + runAsUser: {{ default 0 .Values.controller.runAsUser }} + {{- if and (.Values.controller.runAsUser) (.Values.controller.fsGroup) }} + {{- if not (eq (int .Values.controller.runAsUser) 0) }} + fsGroup: {{ .Values.controller.fsGroup }} + runAsNonRoot: true + {{- end }} + {{- if .Values.controller.securityContextCapabilities }} + capabilities: + {{- toYaml .Values.controller.securityContextCapabilities | nindent 10 }} + {{- end }} + {{- end }} + {{- end }} +{{- end }} + serviceAccountName: "{{ template "jenkins.serviceAccountName" . }}" +{{- if .Values.controller.hostNetworking }} + hostNetwork: true + dnsPolicy: ClusterFirstWithHostNet +{{- end }} + {{- if .Values.controller.hostAliases }} + hostAliases: + {{- toYaml .Values.controller.hostAliases | nindent 8 }} + {{- end }} + initContainers: +{{- if .Values.controller.customInitContainers }} +{{ tpl (toYaml .Values.controller.customInitContainers) . | indent 8 }} +{{- end }} + +{{- if .Values.controller.sidecars.configAutoReload.enabled }} +{{- include "jenkins.configReloadContainer" (list $ "config-reload-init" "init") | nindent 8 }} +{{- end}} + + - name: "init" + image: "{{ .Values.controller.image }}:{{- include "controller.tag" . -}}" + imagePullPolicy: "{{ .Values.controller.imagePullPolicy }}" + {{- if .Values.controller.containerSecurityContext }} + securityContext: {{- toYaml .Values.controller.containerSecurityContext | nindent 12 }} + {{- end }} + command: [ "sh", "/var/jenkins_config/apply_config.sh" ] + {{- if .Values.controller.initContainerEnvFrom }} + envFrom: +{{ (tpl (toYaml .Values.controller.initContainerEnvFrom) .) | indent 12 }} + {{- end }} + {{- if .Values.controller.initContainerEnv }} + env: +{{ (tpl (toYaml .Values.controller.initContainerEnv) .) | indent 12 }} + {{- end }} + resources: +{{- if .Values.controller.initContainerResources }} +{{ toYaml .Values.controller.initContainerResources | indent 12 }} +{{- else }} +{{ toYaml .Values.controller.resources | indent 12 }} +{{- end }} + volumeMounts: + {{- if .Values.persistence.mounts }} +{{ toYaml .Values.persistence.mounts | indent 12 }} + {{- end }} + - mountPath: {{ .Values.controller.jenkinsHome }} + name: jenkins-home + {{- if .Values.persistence.subPath }} + subPath: {{ .Values.persistence.subPath }} + {{- end }} + - mountPath: /var/jenkins_config + name: jenkins-config + {{- if .Values.controller.installPlugins }} + {{- if .Values.controller.overwritePluginsFromImage }} + - mountPath: {{ .Values.controller.jenkinsRef }}/plugins + name: plugins + {{- end }} + - mountPath: /var/jenkins_plugins + name: plugin-dir + - mountPath: /tmp + name: tmp-volume + {{- end }} + {{- if or .Values.controller.initScripts .Values.controller.initConfigMap }} + - mountPath: {{ .Values.controller.jenkinsHome }}/init.groovy.d + name: init-scripts + {{- end }} + {{- if and .Values.controller.httpsKeyStore.enable (not .Values.controller.httpsKeyStore.disableSecretMount) }} + {{- $httpsJKSDirPath := printf "%s" .Values.controller.httpsKeyStore.path }} + - mountPath: {{ $httpsJKSDirPath }} + name: jenkins-https-keystore + {{- end }} + containers: + - name: jenkins + image: "{{ .Values.controller.image }}:{{- include "controller.tag" . -}}" + imagePullPolicy: "{{ .Values.controller.imagePullPolicy }}" + {{- if .Values.controller.containerSecurityContext }} + securityContext: {{- toYaml .Values.controller.containerSecurityContext | nindent 12 }} + {{- end }} + {{- if .Values.controller.overrideArgs }} + args: [ + {{- range $overrideArg := .Values.controller.overrideArgs }} + "{{- tpl $overrideArg $ }}", + {{- end }} + ] + {{- else if .Values.controller.httpsKeyStore.enable }} + {{- $httpsJKSFilePath := printf "%s/%s" .Values.controller.httpsKeyStore.path .Values.controller.httpsKeyStore.fileName }} + args: [ "--httpPort={{.Values.controller.httpsKeyStore.httpPort}}", "--httpsPort={{.Values.controller.targetPort}}", '--httpsKeyStore={{ $httpsJKSFilePath }}', "--httpsKeyStorePassword=$(JENKINS_HTTPS_KEYSTORE_PASSWORD)" ] + {{- else }} + args: [ "--httpPort={{.Values.controller.targetPort}}"] + {{- end }} + {{- if .Values.controller.lifecycle }} + lifecycle: +{{ toYaml .Values.controller.lifecycle | indent 12 }} + {{- end }} +{{- if .Values.controller.terminationMessagePath }} + terminationMessagePath: {{ .Values.controller.terminationMessagePath }} +{{- end }} +{{- if .Values.controller.terminationMessagePolicy }} + terminationMessagePolicy: {{ .Values.controller.terminationMessagePolicy }} +{{- end }} + {{- if .Values.controller.containerEnvFrom }} + envFrom: +{{ (tpl ( toYaml .Values.controller.containerEnvFrom) .) | indent 12 }} + {{- end }} + env: + {{- if .Values.controller.containerEnv }} +{{ (tpl ( toYaml .Values.controller.containerEnv) .) | indent 12 }} + {{- end }} + {{- if or .Values.controller.additionalSecrets .Values.controller.existingSecret .Values.controller.additionalExistingSecrets .Values.controller.adminSecret }} + - name: SECRETS + value: /run/secrets/additional + {{- end }} + - name: POD_NAME + valueFrom: + fieldRef: + fieldPath: metadata.name + - name: JAVA_OPTS + value: >- + {{ if .Values.controller.sidecars.configAutoReload.enabled }} -Dcasc.reload.token=$(POD_NAME) {{ end }}{{ default "" .Values.controller.javaOpts }} + - name: JENKINS_OPTS + value: >- + {{ if .Values.controller.jenkinsUriPrefix }}--prefix={{ .Values.controller.jenkinsUriPrefix }} {{ end }} --webroot=/var/jenkins_cache/war {{ default "" .Values.controller.jenkinsOpts}} + - name: JENKINS_SLAVE_AGENT_PORT + value: "{{ .Values.controller.agentListenerPort }}" + {{- if .Values.controller.httpsKeyStore.enable }} + - name: JENKINS_HTTPS_KEYSTORE_PASSWORD + {{- if not .Values.controller.httpsKeyStore.disableSecretMount }} + valueFrom: + secretKeyRef: + name: {{ if .Values.controller.httpsKeyStore.jenkinsHttpsJksPasswordSecretName }} {{ .Values.controller.httpsKeyStore.jenkinsHttpsJksPasswordSecretName }} {{ else if .Values.controller.httpsKeyStore.jenkinsHttpsJksSecretName }} {{ .Values.controller.httpsKeyStore.jenkinsHttpsJksSecretName }} {{ else }} {{ template "jenkins.fullname" . }}-https-jks {{ end }} + key: "{{ .Values.controller.httpsKeyStore.jenkinsHttpsJksPasswordSecretKey }}" + {{- else }} + value: {{ .Values.controller.httpsKeyStore.password }} + {{- end }} + {{- end }} + + - name: CASC_JENKINS_CONFIG + value: {{ .Values.controller.sidecars.configAutoReload.folder | default (printf "%s/casc_configs" (.Values.controller.jenkinsRef)) }}{{- if .Values.controller.JCasC.configUrls }},{{ join "," .Values.controller.JCasC.configUrls }}{{- end }} + ports: + {{- if .Values.controller.httpsKeyStore.enable }} + - containerPort: {{.Values.controller.httpsKeyStore.httpPort}} + {{- else }} + - containerPort: {{.Values.controller.targetPort}} + {{- end }} + name: http + - containerPort: {{ .Values.controller.agentListenerPort }} + name: agent-listener + {{- if .Values.controller.agentListenerHostPort }} + hostPort: {{ .Values.controller.agentListenerHostPort }} + {{- end }} + {{- if .Values.controller.jmxPort }} + - containerPort: {{ .Values.controller.jmxPort }} + name: jmx + {{- end }} +{{- range $index, $port := .Values.controller.extraPorts }} + - containerPort: {{ $port.port }} + name: {{ $port.name }} +{{- end }} +{{- if and .Values.controller.healthProbes .Values.controller.probes}} + {{- if semverCompare ">=1.16-0" .Capabilities.KubeVersion.GitVersion }} + startupProbe: +{{ tpl (toYaml .Values.controller.probes.startupProbe | indent 12) .}} + {{- end }} + livenessProbe: +{{ tpl (toYaml .Values.controller.probes.livenessProbe | indent 12) .}} + readinessProbe: +{{ tpl (toYaml .Values.controller.probes.readinessProbe | indent 12) .}} +{{- end }} + resources: +{{ toYaml .Values.controller.resources | indent 12 }} + volumeMounts: +{{- if .Values.persistence.mounts }} +{{ toYaml .Values.persistence.mounts | indent 12 }} +{{- end }} + {{- if and .Values.controller.httpsKeyStore.enable (not .Values.controller.httpsKeyStore.disableSecretMount) }} + {{- $httpsJKSDirPath := printf "%s" .Values.controller.httpsKeyStore.path }} + - mountPath: {{ $httpsJKSDirPath }} + name: jenkins-https-keystore + {{- end }} + - mountPath: {{ .Values.controller.jenkinsHome }} + name: jenkins-home + readOnly: false + {{- if .Values.persistence.subPath }} + subPath: {{ .Values.persistence.subPath }} + {{- end }} + - mountPath: /var/jenkins_config + name: jenkins-config + readOnly: true + {{- if .Values.controller.installPlugins }} + - mountPath: {{ .Values.controller.jenkinsRef }}/plugins/ + name: plugin-dir + readOnly: false + {{- end }} + {{- if or .Values.controller.initScripts .Values.controller.initConfigMap }} + - mountPath: {{ .Values.controller.jenkinsHome }}/init.groovy.d + name: init-scripts + {{- end }} + {{- if .Values.controller.sidecars.configAutoReload.enabled }} + - name: sc-config-volume + mountPath: {{ .Values.controller.sidecars.configAutoReload.folder | default (printf "%s/casc_configs" (.Values.controller.jenkinsRef)) }} + {{- end }} + {{- if or .Values.controller.additionalSecrets .Values.controller.existingSecret .Values.controller.additionalExistingSecrets .Values.controller.adminSecret }} + - name: jenkins-secrets + mountPath: /run/secrets/additional + readOnly: true + {{- end }} + - name: jenkins-cache + mountPath: /var/jenkins_cache + - mountPath: /tmp + name: tmp-volume + +{{- if .Values.controller.sidecars.configAutoReload.enabled }} +{{- include "jenkins.configReloadContainer" (list $ "config-reload" "sidecar") | nindent 8 }} +{{- end}} + + +{{- if .Values.controller.sidecars.other}} +{{ tpl (toYaml .Values.controller.sidecars.other | indent 8) .}} +{{- end }} + + volumes: +{{- if .Values.persistence.volumes }} +{{ tpl (toYaml .Values.persistence.volumes | indent 6) . }} +{{- end }} + {{- if .Values.controller.installPlugins }} + {{- if .Values.controller.overwritePluginsFromImage }} + - name: plugins + emptyDir: {} + {{- end }} + {{- end }} + {{- if and .Values.controller.initScripts .Values.controller.initConfigMap }} + - name: init-scripts + projected: + sources: + - configMap: + name: {{ template "jenkins.fullname" . }}-init-scripts + - configMap: + name: {{ .Values.controller.initConfigMap }} + {{- else if .Values.controller.initConfigMap }} + - name: init-scripts + configMap: + name: {{ .Values.controller.initConfigMap }} + {{- else if .Values.controller.initScripts }} + - name: init-scripts + configMap: + name: {{ template "jenkins.fullname" . }}-init-scripts + {{- end }} + - name: jenkins-config + configMap: + name: {{ template "jenkins.fullname" . }} + {{- if .Values.controller.installPlugins }} + - name: plugin-dir + emptyDir: {} + {{- end }} + {{- if or .Values.controller.additionalSecrets .Values.controller.existingSecret .Values.controller.additionalExistingSecrets .Values.controller.adminSecret }} + - name: jenkins-secrets + projected: + sources: + {{- if .Values.controller.additionalSecrets }} + - secret: + name: {{ template "jenkins.fullname" . }}-additional-secrets + {{- end }} + {{- if .Values.controller.additionalExistingSecrets }} + {{- range $key, $value := .Values.controller.additionalExistingSecrets }} + - secret: + name: {{ tpl $value.name $ }} + items: + - key: {{ tpl $value.keyName $ }} + path: {{ tpl $value.name $ }}-{{ tpl $value.keyName $ }} + {{- end }} + {{- end }} + {{- if .Values.controller.adminSecret }} + - secret: + name: {{ .Values.controller.admin.existingSecret | default (include "jenkins.fullname" .) }} + items: + - key: {{ .Values.controller.admin.userKey | default "jenkins-admin-user" }} + path: chart-admin-username + - key: {{ .Values.controller.admin.passwordKey | default "jenkins-admin-password" }} + path: chart-admin-password + {{- end }} + {{- if .Values.controller.existingSecret }} + - secret: + name: {{ .Values.controller.existingSecret }} + {{- end }} + {{- end }} + - name: jenkins-cache + emptyDir: {} + {{- if not (contains "jenkins-home" (quote .Values.persistence.volumes)) }} + - name: jenkins-home + {{- if .Values.persistence.enabled }} + persistentVolumeClaim: + claimName: {{ .Values.persistence.existingClaim | default (include "jenkins.fullname" .) }} + {{- else }} + emptyDir: {} + {{- end -}} + {{- end }} + - name: sc-config-volume + emptyDir: {} + - name: tmp-volume + emptyDir: {} + + {{- if and .Values.controller.httpsKeyStore.enable (not .Values.controller.httpsKeyStore.disableSecretMount) }} + - name: jenkins-https-keystore + secret: + secretName: {{ if .Values.controller.httpsKeyStore.jenkinsHttpsJksSecretName }} {{ .Values.controller.httpsKeyStore.jenkinsHttpsJksSecretName }} {{ else }} {{ template "jenkins.fullname" . }}-https-jks {{ end }} + items: + - key: {{ .Values.controller.httpsKeyStore.jenkinsHttpsJksSecretKey }} + path: {{ .Values.controller.httpsKeyStore.fileName }} + {{- end }} + +{{- if .Values.controller.imagePullSecretName }} + imagePullSecrets: + - name: {{ .Values.controller.imagePullSecretName }} +{{- end -}} diff --git a/helm/whanos/charts/jenkins/templates/jenkins-controller-svc.yaml b/helm/whanos/charts/jenkins/templates/jenkins-controller-svc.yaml new file mode 100644 index 0000000..a83466c --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/jenkins-controller-svc.yaml @@ -0,0 +1,56 @@ +apiVersion: v1 +kind: Service +metadata: + name: {{template "jenkins.fullname" . }} + namespace: {{ template "jenkins.namespace" . }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" + {{- if .Values.controller.serviceLabels }} +{{ toYaml .Values.controller.serviceLabels | indent 4 }} + {{- end }} +{{- if .Values.controller.serviceAnnotations }} + annotations: +{{ toYaml .Values.controller.serviceAnnotations | indent 4 }} +{{- end }} +spec: + {{- if .Values.controller.serviceExternalTrafficPolicy }} + externalTrafficPolicy: {{.Values.controller.serviceExternalTrafficPolicy}} + {{- end }} + {{- if (and (eq .Values.controller.serviceType "ClusterIP") (not (empty .Values.controller.clusterIP))) }} + clusterIP: {{.Values.controller.clusterIP}} + {{- end }} + ports: + - port: {{.Values.controller.servicePort}} + name: http + targetPort: {{ .Values.controller.targetPort }} + {{- if (and (eq .Values.controller.serviceType "NodePort") (not (empty .Values.controller.nodePort))) }} + nodePort: {{.Values.controller.nodePort}} + {{- end }} +{{- range $index, $port := .Values.controller.extraPorts }} + - port: {{ $port.port }} + name: {{ $port.name }} + {{- if $port.targetPort }} + targetPort: {{ $port.targetPort }} + {{- else }} + targetPort: {{ $port.port }} + {{- end -}} +{{- end }} + selector: + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + type: {{.Values.controller.serviceType}} + {{if eq .Values.controller.serviceType "LoadBalancer"}} +{{- if .Values.controller.loadBalancerSourceRanges }} + loadBalancerSourceRanges: +{{ toYaml .Values.controller.loadBalancerSourceRanges | indent 4 }} +{{- end }} + {{if .Values.controller.loadBalancerIP}} + loadBalancerIP: {{.Values.controller.loadBalancerIP}} + {{end}} + {{end}} diff --git a/helm/whanos/charts/jenkins/templates/rbac.yaml b/helm/whanos/charts/jenkins/templates/rbac.yaml new file mode 100644 index 0000000..581cb8d --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/rbac.yaml @@ -0,0 +1,149 @@ +{{ if .Values.rbac.create }} +{{- $serviceName := include "jenkins.fullname" . -}} + +# This role is used to allow Jenkins scheduling of agents via Kubernetes plugin. +apiVersion: rbac.authorization.k8s.io/v1 +kind: Role +metadata: + name: {{ $serviceName }}-schedule-agents + namespace: {{ template "jenkins.agent.namespace" . }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" +rules: +- apiGroups: [""] + resources: ["pods", "pods/exec", "pods/log", "persistentvolumeclaims", "events"] + verbs: ["get", "list", "watch"] +- apiGroups: [""] + resources: ["pods", "pods/exec", "persistentvolumeclaims"] + verbs: ["create", "delete", "deletecollection", "patch", "update"] + +--- + +# We bind the role to the Jenkins service account. The role binding is created in the namespace +# where the agents are supposed to run. +apiVersion: rbac.authorization.k8s.io/v1 +kind: RoleBinding +metadata: + name: {{ $serviceName }}-schedule-agents + namespace: {{ template "jenkins.agent.namespace" . }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" +roleRef: + apiGroup: rbac.authorization.k8s.io + kind: Role + name: {{ $serviceName }}-schedule-agents +subjects: +- kind: ServiceAccount + name: {{ template "jenkins.serviceAccountName" .}} + namespace: {{ template "jenkins.namespace" . }} + +--- + +{{- if .Values.rbac.readSecrets }} +# This is needed if you want to use https://jenkinsci.github.io/kubernetes-credentials-provider-plugin/ +# as it needs permissions to get/watch/list Secrets +apiVersion: rbac.authorization.k8s.io/v1 +kind: Role +metadata: + name: {{ template "jenkins.fullname" . }}-read-secrets + namespace: {{ template "jenkins.namespace" . }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" +rules: + - apiGroups: [""] + resources: ["secrets"] + verbs: ["get", "watch", "list"] + +--- + +apiVersion: rbac.authorization.k8s.io/v1 +kind: RoleBinding +metadata: + name: {{ $serviceName }}-read-secrets + namespace: {{ template "jenkins.namespace" . }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" +roleRef: + apiGroup: rbac.authorization.k8s.io + kind: Role + name: {{ template "jenkins.fullname" . }}-read-secrets +subjects: + - kind: ServiceAccount + name: {{ template "jenkins.serviceAccountName" . }} + namespace: {{ template "jenkins.namespace" . }} + +--- +{{- end}} + +{{- if .Values.controller.sidecars.configAutoReload.enabled }} +# The sidecar container which is responsible for reloading configuration changes +# needs permissions to watch ConfigMaps +apiVersion: rbac.authorization.k8s.io/v1 +kind: Role +metadata: + name: {{ template "jenkins.fullname" . }}-casc-reload + namespace: {{ template "jenkins.namespace" . }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" +rules: +- apiGroups: [""] + resources: ["configmaps"] + verbs: ["get", "watch", "list"] + +--- + +apiVersion: rbac.authorization.k8s.io/v1 +kind: RoleBinding +metadata: + name: {{ $serviceName }}-watch-configmaps + namespace: {{ template "jenkins.namespace" . }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" +roleRef: + apiGroup: rbac.authorization.k8s.io + kind: Role + name: {{ template "jenkins.fullname" . }}-casc-reload +subjects: +- kind: ServiceAccount + name: {{ template "jenkins.serviceAccountName" . }} + namespace: {{ template "jenkins.namespace" . }} + +{{- end}} + +{{ end }} diff --git a/helm/whanos/charts/jenkins/templates/secret-additional.yaml b/helm/whanos/charts/jenkins/templates/secret-additional.yaml new file mode 100644 index 0000000..d1908aa --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/secret-additional.yaml @@ -0,0 +1,21 @@ +{{- if .Values.controller.additionalSecrets -}} +--- +apiVersion: v1 +kind: Secret +metadata: + name: {{ template "jenkins.fullname" . }}-additional-secrets + namespace: {{ template "jenkins.namespace" . }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" +type: Opaque +data: +{{- range .Values.controller.additionalSecrets }} + {{ .name }}: {{ .value | b64enc }} +{{- end }} +{{- end }} diff --git a/helm/whanos/charts/jenkins/templates/secret-claims.yaml b/helm/whanos/charts/jenkins/templates/secret-claims.yaml new file mode 100644 index 0000000..e8b6d6c --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/secret-claims.yaml @@ -0,0 +1,29 @@ +{{- if .Values.controller.secretClaims -}} +{{- $r := .Release -}} +{{- $v := .Values -}} +{{- $chart := printf "%s-%s" .Chart.Name .Chart.Version -}} +{{- $namespace := include "jenkins.namespace" . -}} +{{- $serviceName := include "jenkins.fullname" . -}} +{{ range .Values.controller.secretClaims }} +--- +kind: SecretClaim +apiVersion: vaultproject.io/v1 +metadata: + name: {{ $serviceName }}-{{ .name | default .path | lower }} + namespace: {{ $namespace }} + labels: + "app.kubernetes.io/name": '{{ $serviceName }}' + {{- if $v.renderHelmLabels }} + "helm.sh/chart": "{{ $chart }}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ $r.Service }}" + "app.kubernetes.io/instance": "{{ $r.Name }}" + "app.kubernetes.io/component": "{{ $v.controller.componentName }}" +spec: + type: {{ .type | default "Opaque" }} + path: {{ .path }} +{{- if .renew }} + renew: {{ .renew }} +{{- end }} +{{- end }} +{{- end }} \ No newline at end of file diff --git a/helm/whanos/charts/jenkins/templates/secret-https-jks.yaml b/helm/whanos/charts/jenkins/templates/secret-https-jks.yaml new file mode 100644 index 0000000..5348de4 --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/secret-https-jks.yaml @@ -0,0 +1,20 @@ +{{- if and .Values.controller.httpsKeyStore.enable ( not .Values.controller.httpsKeyStore.jenkinsHttpsJksSecretName ) (not .Values.controller.httpsKeyStore.disableSecretMount) -}} +apiVersion: v1 +kind: Secret +metadata: + name: {{ template "jenkins.fullname" . }}-https-jks + namespace: {{ template "jenkins.namespace" . }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" +type: Opaque +data: + jenkins-jks-file: | +{{ .Values.controller.httpsKeyStore.jenkinsKeyStoreBase64Encoded | indent 4 }} + https-jks-password: {{ .Values.controller.httpsKeyStore.password | b64enc }} +{{- end }} diff --git a/helm/whanos/charts/jenkins/templates/secret.yaml b/helm/whanos/charts/jenkins/templates/secret.yaml new file mode 100644 index 0000000..4feb52f --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/secret.yaml @@ -0,0 +1,20 @@ +{{- if and (not .Values.controller.admin.existingSecret) (.Values.controller.adminSecret) -}} + +apiVersion: v1 +kind: Secret +metadata: + name: {{ template "jenkins.fullname" . }} + namespace: {{ template "jenkins.namespace" . }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" +type: Opaque +data: + jenkins-admin-password: {{ template "jenkins.password" . }} + jenkins-admin-user: {{ .Values.controller.adminUser | b64enc | quote }} +{{- end }} diff --git a/helm/whanos/charts/jenkins/templates/service-account-agent.yaml b/helm/whanos/charts/jenkins/templates/service-account-agent.yaml new file mode 100644 index 0000000..48f08ba --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/service-account-agent.yaml @@ -0,0 +1,26 @@ +{{ if .Values.serviceAccountAgent.create }} +apiVersion: v1 +kind: ServiceAccount +metadata: + name: {{ include "jenkins.serviceAccountAgentName" . }} + namespace: {{ template "jenkins.agent.namespace" . }} +{{- if .Values.serviceAccountAgent.annotations }} + annotations: +{{ tpl (toYaml .Values.serviceAccountAgent.annotations) . | indent 4 }} +{{- end }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" +{{- if .Values.serviceAccountAgent.extraLabels }} +{{ tpl (toYaml .Values.serviceAccountAgent.extraLabels) . | indent 4 }} +{{- end }} +{{- if .Values.serviceAccountAgent.imagePullSecretName }} +imagePullSecrets: + - name: {{ .Values.serviceAccountAgent.imagePullSecretName }} +{{- end -}} +{{ end }} diff --git a/helm/whanos/charts/jenkins/templates/service-account.yaml b/helm/whanos/charts/jenkins/templates/service-account.yaml new file mode 100644 index 0000000..b44eb48 --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/service-account.yaml @@ -0,0 +1,26 @@ +{{ if .Values.serviceAccount.create }} +apiVersion: v1 +kind: ServiceAccount +metadata: + name: {{ include "jenkins.serviceAccountName" . }} + namespace: {{ template "jenkins.namespace" . }} +{{- if .Values.serviceAccount.annotations }} + annotations: +{{ tpl (toYaml .Values.serviceAccount.annotations) . | indent 4 }} +{{- end }} + labels: + "app.kubernetes.io/name": '{{ template "jenkins.name" .}}' + {{- if .Values.renderHelmLabels }} + "helm.sh/chart": "{{ template "jenkins.label" .}}" + {{- end }} + "app.kubernetes.io/managed-by": "{{ .Release.Service }}" + "app.kubernetes.io/instance": "{{ .Release.Name }}" + "app.kubernetes.io/component": "{{ .Values.controller.componentName }}" +{{- if .Values.serviceAccount.extraLabels }} +{{ tpl (toYaml .Values.serviceAccount.extraLabels) . | indent 4 }} +{{- end }} +{{- if .Values.serviceAccount.imagePullSecretName }} +imagePullSecrets: + - name: {{ .Values.serviceAccount.imagePullSecretName }} +{{- end -}} +{{ end }} diff --git a/helm/whanos/charts/jenkins/templates/tests/jenkins-test.yaml b/helm/whanos/charts/jenkins/templates/tests/jenkins-test.yaml new file mode 100644 index 0000000..20e06b5 --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/tests/jenkins-test.yaml @@ -0,0 +1,49 @@ +{{- if .Values.controller.testEnabled }} +apiVersion: v1 +kind: Pod +metadata: + name: "{{ .Release.Name }}-ui-test-{{ randAlphaNum 5 | lower }}" + namespace: {{ template "jenkins.namespace" . }} + annotations: + "helm.sh/hook": test-success +spec: + {{- if .Values.controller.nodeSelector }} + nodeSelector: +{{ toYaml .Values.controller.nodeSelector | indent 4 }} + {{- end }} + {{- if .Values.controller.tolerations }} + tolerations: +{{ toYaml .Values.controller.tolerations | indent 4 }} + {{- end }} + initContainers: + - name: "test-framework" + image: {{ .Values.helmtest.bats.image }}:{{ .Values.helmtest.bats.tag }} + command: + - "bash" + - "-c" + args: + - | + # copy bats to tools dir + set -ex + cp -R /opt/bats /tools/bats/ + volumeMounts: + - mountPath: /tools + name: tools + containers: + - name: {{ .Release.Name }}-ui-test + image: "{{ .Values.controller.image }}:{{- include "controller.tag" . -}}" + command: ["/tools/bats/bin/bats", "-t", "/tests/run.sh"] + volumeMounts: + - mountPath: /tests + name: tests + readOnly: true + - mountPath: /tools + name: tools + volumes: + - name: tests + configMap: + name: {{ template "jenkins.fullname" . }}-tests + - name: tools + emptyDir: {} + restartPolicy: Never +{{- end }} diff --git a/helm/whanos/charts/jenkins/templates/tests/test-config.yaml b/helm/whanos/charts/jenkins/templates/tests/test-config.yaml new file mode 100644 index 0000000..12c5b3a --- /dev/null +++ b/helm/whanos/charts/jenkins/templates/tests/test-config.yaml @@ -0,0 +1,14 @@ +{{- if .Values.controller.testEnabled }} +apiVersion: v1 +kind: ConfigMap +metadata: + name: {{ template "jenkins.fullname" . }}-tests + namespace: {{ template "jenkins.namespace" . }} + annotations: + "helm.sh/hook": test +data: + run.sh: |- + @test "Testing Jenkins UI is accessible" { + curl --retry 48 --retry-delay 10 {{ template "jenkins.fullname" . }}:{{ .Values.controller.servicePort }}{{ default "" .Values.controller.jenkinsUriPrefix }}/login + } +{{- end }} diff --git a/helm/whanos/charts/jenkins/values.yaml b/helm/whanos/charts/jenkins/values.yaml new file mode 100644 index 0000000..bde5056 --- /dev/null +++ b/helm/whanos/charts/jenkins/values.yaml @@ -0,0 +1,999 @@ +# Default values for jenkins. +# This is a YAML-formatted file. +# Declare name/value pairs to be passed into your templates. +# name: value + +## Overrides for generated resource names +# See templates/_helpers.tpl +# nameOverride: +# fullnameOverride: +# namespaceOverride: + +# For FQDN resolving of the controller service. Change this value to match your existing configuration. +# ref: https://github.com/kubernetes/dns/blob/master/docs/specification.md +clusterZone: "cluster.local" + +# The URL of the Kubernetes API server +kubernetesURL: "https://kubernetes.default" + +renderHelmLabels: true + +controller: + # Used for label app.kubernetes.io/component + componentName: "jenkins-controller" + image: "jenkins/jenkins" + # tag: "2.426.1-jdk11" + tagLabel: jdk11 + imagePullPolicy: "Always" + imagePullSecretName: + # Optionally configure lifetime for controller-container + lifecycle: + # postStart: + # exec: + # command: + # - "uname" + # - "-a" + disableRememberMe: false + numExecutors: 0 + # configures the executor mode of the Jenkins node. Possible values are: NORMAL or EXCLUSIVE + executorMode: "NORMAL" + # This is ignored if enableRawHtmlMarkupFormatter is true + markupFormatter: plainText + customJenkinsLabels: [] + # The default configuration uses this secret to configure an admin user + # If you don't need that user or use a different security realm then you can disable it + adminSecret: true + + hostNetworking: false + # When enabling LDAP or another non-Jenkins identity source, the built-in admin account will no longer exist. + # If you disable the non-Jenkins identity store and instead use the Jenkins internal one, + # you should revert controller.adminUser to your preferred admin user: + adminUser: "admin" + # adminPassword: + admin: + existingSecret: "" + userKey: jenkins-admin-user + passwordKey: jenkins-admin-password + # This values should not be changed unless you use your custom image of jenkins or any devired from. If you want to use + # Cloudbees Jenkins Distribution docker, you should set jenkinsHome: "/var/cloudbees-jenkins-distribution" + jenkinsHome: "/var/jenkins_home" + # This values should not be changed unless you use your custom image of jenkins or any devired from. If you want to use + # Cloudbees Jenkins Distribution docker, you should set jenkinsRef: "/usr/share/cloudbees-jenkins-distribution/ref" + jenkinsRef: "/usr/share/jenkins/ref" + # Path to the jenkins war file which is used by jenkins-plugin-cli. + jenkinsWar: "/usr/share/jenkins/jenkins.war" + # Overrides the default arguments passed to the war + # overrideArgs: + # - --httpPort=8080 + resources: + requests: + cpu: "50m" + memory: "256Mi" + limits: + cpu: "2000m" + memory: "4096Mi" + # Share process namespace to allow sidecar containers to interact with processes in other containers in the same pod + shareProcessNamespace: false + # Overrides the init container default values + # initContainerResources: + # requests: + # cpu: "50m" + # memory: "256Mi" + # limits: + # cpu: "2000m" + # memory: "4096Mi" + # Environment variables that get added to the init container (useful for e.g. http_proxy) + # initContainerEnv: + # - name: http_proxy + # value: "http://192.168.64.1:3128" + # containerEnv: + # - name: http_proxy + # value: "http://192.168.64.1:3128" + # Set min/max heap here if needed with: + # javaOpts: "-Xms512m -Xmx512m" + # jenkinsOpts: "" + # If you are using the ingress definitions provided by this chart via the `controller.ingress` block the configured hostname will be the ingress hostname starting with `https://` or `http://` depending on the `tls` configuration. + # The Protocol can be overwritten by specifying `controller.jenkinsUrlProtocol`. + # jenkinsUrlProtocol: "https" + # If you are not using the provided ingress you can specify `controller.jenkinsUrl` to change the url definition. + # jenkinsUrl: "" + # If you set this prefix and use ingress controller then you might want to set the ingress path below + # jenkinsUriPrefix: "/jenkins" + # Enable pod security context (must be `true` if podSecurityContextOverride, runAsUser or fsGroup are set) + usePodSecurityContext: true + # Note that `runAsUser`, `fsGroup`, and `securityContextCapabilities` are + # being deprecated and replaced by `podSecurityContextOverride`. + # Set runAsUser to 1000 to let Jenkins run as non-root user 'jenkins' which exists in 'jenkins/jenkins' docker image. + # When setting runAsUser to a different value than 0 also set fsGroup to the same value: + runAsUser: 1000 + fsGroup: 1000 + # If you have PodSecurityPolicies that require dropping of capabilities as suggested by CIS K8s benchmark, put them here + securityContextCapabilities: {} + # drop: + # - NET_RAW + # Completely overwrites the contents of the `securityContext`, ignoring the + # values provided for the deprecated fields: `runAsUser`, `fsGroup`, and + # `securityContextCapabilities`. In the case of mounting an ext4 filesystem, + # it might be desirable to use `supplementalGroups` instead of `fsGroup` in + # the `securityContext` block: https://github.com/kubernetes/kubernetes/issues/67014#issuecomment-589915496 + # podSecurityContextOverride: + # runAsUser: 1000 + # runAsNonRoot: true + # supplementalGroups: [1000] + # # capabilities: {} + # Container securityContext + containerSecurityContext: + runAsUser: 1000 + runAsGroup: 1000 + readOnlyRootFilesystem: true + allowPrivilegeEscalation: false + servicePort: 8080 + targetPort: 8080 + # For minikube, set this to NodePort, elsewhere use LoadBalancer + # Use ClusterIP if your setup includes ingress controller + serviceType: ClusterIP + # Use Local to preserve the client source IP and avoids a second hop for LoadBalancer and Nodeport type services, + # but risks potentially imbalanced traffic spreading. + serviceExternalTrafficPolicy: + # Jenkins controller service annotations + serviceAnnotations: {} + # Jenkins controller custom labels + statefulSetLabels: {} + # foo: bar + # bar: foo + # Jenkins controller service labels + serviceLabels: {} + # service.beta.kubernetes.io/aws-load-balancer-backend-protocol: https + # Put labels on Jenkins controller pod + podLabels: {} + # Used to create Ingress record (should be used with ServiceType: ClusterIP) + # nodePort: + # -Dcom.sun.management.jmxremote.port=4000 + # -Dcom.sun.management.jmxremote.authenticate=false + # -Dcom.sun.management.jmxremote.ssl=false + # jmxPort: 4000 + # Optionally configure other ports to expose in the controller container + extraPorts: [] + # - name: BuildInfoProxy + # port: 9000 + # targetPort: 9010 (Optional: Use to explicitly set targetPort if different from port) + + # List of plugins to be install during Jenkins controller start + installPlugins: + - kubernetes:4029.v5712230ccb_f8 + - workflow-aggregator:596.v8c21c963d92d + - git:5.1.0 + - configuration-as-code:1670.v564dc8b_982d0 + + # Set to false to download the minimum required version of all dependencies. + installLatestPlugins: true + + # Set to true to download latest dependencies of any plugin that is requested to have the latest version. + installLatestSpecifiedPlugins: false + + # List of plugins to install in addition to those listed in controller.installPlugins + additionalPlugins: [] + + # Enable to initialize the Jenkins controller only once on initial installation. + # Without this, whenever the controller gets restarted (Evicted, etc.) it will fetch plugin updates which has the potential to cause breakage. + # Note that for this to work, `persistence.enabled` needs to be set to `true` + initializeOnce: false + + # Enable to always override the installed plugins with the values of 'controller.installPlugins' on upgrade or redeployment. + # overwritePlugins: true + + # Configures if plugins bundled with `controller.image` should be overwritten with the values of 'controller.installPlugins' on upgrade or redeployment. + overwritePluginsFromImage: true + + # Configures the restrictions for naming projects. Set this key to null or empty to skip it in the default config. + projectNamingStrategy: standard + + # Enable HTML parsing using OWASP Markup Formatter Plugin (antisamy-markup-formatter), useful with ghprb plugin. + # The plugin is not installed by default, please update controller.installPlugins. + enableRawHtmlMarkupFormatter: false + # Used to approve a list of groovy functions in pipelines used the script-security plugin. Can be viewed under /scriptApproval + scriptApproval: [] + # - "method groovy.json.JsonSlurperClassic parseText java.lang.String" + # - "new groovy.json.JsonSlurperClassic" + # List of groovy init scripts to be executed during Jenkins controller start + initScripts: [] + # - | + # print 'adding global pipeline libraries, register properties, bootstrap jobs...' + + # 'name' is a name of an existing secret in same namespace as jenkins, + # 'keyName' is the name of one of the keys inside current secret. + # the 'name' and 'keyName' are concatenated with a '-' in between, so for example: + # an existing secret "secret-credentials" and a key inside it named "github-password" should be used in Jcasc as ${secret-credentials-github-password} + # 'name' and 'keyName' must be lowercase RFC 1123 label must consist of lower case alphanumeric characters or '-', + # and must start and end with an alphanumeric character (e.g. 'my-name', or '123-abc') + # existingSecret existing secret "secret-credentials" and a key inside it named "github-username" should be used in Jcasc as ${github-username} + # When using existingSecret no need to specify the keyName under additionalExistingSecrets. + existingSecret: + + additionalExistingSecrets: [] + # - name: secret-name-1 + # keyName: username + # - name: secret-name-1 + # keyName: password + + additionalSecrets: [] + # - name: nameOfSecret + # value: secretText + + # Generate SecretClaim resources in order to create Kubernetes secrets from HashiCorp Vault using kube-vault-controller. + # 'name' is name of the secret that will be created in Kubernetes. The Jenkins fullname is prepended to this value. + # 'path' is the fully qualified path to the secret in Vault + # 'type' is an optional Kubernetes secret type. Defaults to 'Opaque' + # 'renew' is an optional secret renewal time in seconds + secretClaims: [] + # - name: secretName # required + # path: testPath # required + # type: kubernetes.io/tls # optional + # renew: 60 # optional + + # Name of default cloud configuration. + cloudName: "kubernetes" + + # Below is the implementation of Jenkins Configuration as Code. Add a key under configScripts for each configuration area, + # where each corresponds to a plugin or section of the UI. Each key (prior to | character) is just a label, and can be any value. + # Keys are only used to give the section a meaningful name. The only restriction is they may only contain RFC 1123 \ DNS label + # characters: lowercase letters, numbers, and hyphens. The keys become the name of a configuration yaml file on the controller in + # /var/jenkins_home/casc_configs (by default) and will be processed by the Configuration as Code Plugin. The lines after each | + # become the content of the configuration yaml file. The first line after this is a JCasC root element, eg jenkins, credentials, + # etc. Best reference is https:///configuration-as-code/reference. The example below creates a welcome message: + JCasC: + defaultConfig: true + configUrls: [] + # - https://acme.org/jenkins.yaml + # Remote URL:s for configuration files. + configScripts: {} + # welcome-message: | + # jenkins: + # systemMessage: Welcome to our CI\CD server. This Jenkins is configured and managed 'as code'. + # Allows adding to the top-level security JCasC section. For legacy, default the chart includes apiToken configurations + security: + apiToken: + creationOfLegacyTokenEnabled: false + tokenGenerationOnCreationEnabled: false + usageStatisticsEnabled: true + # Ignored if securityRealm is defined in controller.JCasC.configScripts + securityRealm: |- + local: + allowsSignup: false + enableCaptcha: false + users: + - id: "${chart-admin-username}" + name: "Jenkins Admin" + password: "${chart-admin-password}" + # Ignored if authorizationStrategy is defined in controller.JCasC.configScripts + authorizationStrategy: |- + loggedInUsersCanDoAnything: + allowAnonymousRead: false + # Optionally specify additional init-containers + customInitContainers: [] + # - name: custom-init + # image: "alpine:3.7" + # imagePullPolicy: Always + # command: [ "uname", "-a" ] + + sidecars: + configAutoReload: + # If enabled: true, Jenkins Configuration as Code will be reloaded on-the-fly without a reboot. If false or not-specified, + # jcasc changes will cause a reboot and will only be applied at the subsequent start-up. Auto-reload uses the + # http:///reload-configuration-as-code endpoint to reapply config when changes to the configScripts are detected. + enabled: true + image: kiwigrid/k8s-sidecar:1.24.4 + imagePullPolicy: IfNotPresent + resources: {} + # limits: + # cpu: 100m + # memory: 100Mi + # requests: + # cpu: 50m + # memory: 50Mi + # How many connection-related errors to retry on + reqRetryConnect: 10 + # env: + # - name: REQ_TIMEOUT + # value: "30" + # SSH port value can be set to any unused TCP port. The default, 1044, is a non-standard SSH port that has been chosen at random. + # Is only used to reload jcasc config from the sidecar container running in the Jenkins controller pod. + # This TCP port will not be open in the pod (unless you specifically configure this), so Jenkins will not be + # accessible via SSH from outside of the pod. Note if you use non-root pod privileges (runAsUser & fsGroup), + # this must be > 1024: + sshTcpPort: 1044 + # folder in the pod that should hold the collected dashboards: + folder: "/var/jenkins_home/casc_configs" + # If specified, the sidecar will search for JCasC config-maps inside this namespace. + # Otherwise the namespace in which the sidecar is running will be used. + # It's also possible to specify ALL to search in all namespaces: + # searchNamespace: + containerSecurityContext: + readOnlyRootFilesystem: true + allowPrivilegeEscalation: false + + # Allows you to inject additional/other sidecars + other: [] + ## The example below runs the client for https://smee.io as sidecar container next to Jenkins, + ## that allows to trigger build behind a secure firewall. + ## https://jenkins.io/blog/2019/01/07/webhook-firewalls/#triggering-builds-with-webhooks-behind-a-secure-firewall + ## + ## Note: To use it you should go to https://smee.io/new and update the url to the generete one. + # - name: smee + # image: docker.io/twalter/smee-client:1.0.2 + # args: ["--port", "{{ .Values.controller.servicePort }}", "--path", "/github-webhook/", "--url", "https://smee.io/new"] + # resources: + # limits: + # cpu: 50m + # memory: 128Mi + # requests: + # cpu: 10m + # memory: 32Mi + # Name of the Kubernetes scheduler to use + schedulerName: "" + # Node labels and tolerations for pod assignment + # ref: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/#nodeselector + # ref: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/#taints-and-tolerations-beta-feature + nodeSelector: {} + + terminationGracePeriodSeconds: + + terminationMessagePath: + terminationMessagePolicy: + + tolerations: [] + + affinity: {} + # Leverage a priorityClass to ensure your pods survive resource shortages + # ref: https://kubernetes.io/docs/concepts/configuration/pod-priority-preemption/ + priorityClassName: + + podAnnotations: {} + # Add StatefulSet annotations + statefulSetAnnotations: {} + + # StatefulSet updateStrategy + # ref: https://kubernetes.io/docs/concepts/workloads/controllers/statefulset/#update-strategies + updateStrategy: {} + + ingress: + enabled: false + # Override for the default paths that map requests to the backend + paths: [] + # - backend: + # serviceName: ssl-redirect + # servicePort: use-annotation + # - backend: + # serviceName: >- + # {{ template "jenkins.fullname" . }} + # # Don't use string here, use only integer value! + # servicePort: 8080 + # For Kubernetes v1.14+, use 'networking.k8s.io/v1beta1' + # For Kubernetes v1.19+, use 'networking.k8s.io/v1' + apiVersion: "extensions/v1beta1" + labels: {} + annotations: {} + # kubernetes.io/ingress.class: nginx + # kubernetes.io/tls-acme: "true" + # For Kubernetes >= 1.18 you should specify the ingress-controller via the field ingressClassName + # See https://kubernetes.io/blog/2020/04/02/improvements-to-the-ingress-api-in-kubernetes-1.18/#specifying-the-class-of-an-ingress + # ingressClassName: nginx + # Set this path to jenkinsUriPrefix above or use annotations to rewrite path + # path: "/jenkins" + # configures the hostname e.g. jenkins.example.com + hostName: + tls: + # - secretName: jenkins.cluster.local + # hosts: + # - jenkins.cluster.local + + # often you want to have your controller all locked down and private + # but you still want to get webhooks from your SCM + # A secondary ingress will let you expose different urls + # with a differnt configuration + secondaryingress: + enabled: false + # paths you want forwarded to the backend + # ex /github-webhook + paths: [] + # For Kubernetes v1.14+, use 'networking.k8s.io/v1beta1' + # For Kubernetes v1.19+, use 'networking.k8s.io/v1' + apiVersion: "extensions/v1beta1" + labels: {} + annotations: {} + # kubernetes.io/ingress.class: nginx + # kubernetes.io/tls-acme: "true" + # For Kubernetes >= 1.18 you should specify the ingress-controller via the field ingressClassName + # See https://kubernetes.io/blog/2020/04/02/improvements-to-the-ingress-api-in-kubernetes-1.18/#specifying-the-class-of-an-ingress + # ingressClassName: nginx + # configures the hostname e.g. jenkins-external.example.com + hostName: + tls: + # - secretName: jenkins-external.example.com + # hosts: + # - jenkins-external.example.com + + # If you're running on GKE and need to configure a backendconfig + # to finish ingress setup, use the following values. + # Docs: https://cloud.google.com/kubernetes-engine/docs/concepts/backendconfig + backendconfig: + enabled: false + apiVersion: "extensions/v1beta1" + name: + labels: {} + annotations: {} + spec: {} + + # Openshift route + route: + enabled: false + labels: {} + annotations: {} + # path: "/jenkins" + + # controller.hostAliases allows for adding entries to Pod /etc/hosts: + # https://kubernetes.io/docs/concepts/services-networking/add-entries-to-pod-etc-hosts-with-host-aliases/ + hostAliases: [] + # - ip: 192.168.50.50 + # hostnames: + # - something.local + # - ip: 10.0.50.50 + # hostnames: + # - other.local + + # Expose Prometheus metrics + prometheus: + # If enabled, add the prometheus plugin to the list of plugins to install + # https://plugins.jenkins.io/prometheus + enabled: false + # Additional labels to add to the ServiceMonitor object + serviceMonitorAdditionalLabels: {} + # Set a custom namespace where to deploy ServiceMonitor resource + # serviceMonitorNamespace: monitoring + scrapeInterval: 60s + # This is the default endpoint used by the prometheus plugin + scrapeEndpoint: /prometheus + # Additional labels to add to the PrometheusRule object + alertingRulesAdditionalLabels: {} + # An array of prometheus alerting rules + # See here: https://prometheus.io/docs/prometheus/latest/configuration/alerting_rules/ + # The `groups` root object is added by default, simply add the rule entries + alertingrules: [] + # Set a custom namespace where to deploy PrometheusRule resource + prometheusRuleNamespace: "" + + # RelabelConfigs to apply to samples before scraping. Prometheus Operator automatically adds + # relabelings for a few standard Kubernetes fields. The original scrape job’s name + # is available via the __tmp_prometheus_job_name label. + # More info: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config + relabelings: [] + # MetricRelabelConfigs to apply to samples before ingestion. + metricRelabelings: [] + + googlePodMonitor: + # If enabled, It creates Google Managed Prometheus scraping config + enabled: false + # Set a custom namespace where to deploy PodMonitoring resource + # serviceMonitorNamespace: "" + scrapeInterval: 60s + # This is the default endpoint used by the prometheus plugin + scrapeEndpoint: /prometheus + + # Can be used to disable rendering controller test resources when using helm template + testEnabled: true + + httpsKeyStore: + jenkinsHttpsJksSecretName: '' + jenkinsHttpsJksSecretKey: "jenkins-jks-file" + jenkinsHttpsJksPasswordSecretName: "" + jenkinsHttpsJksPasswordSecretKey: "https-jks-password" + enable: false + disableSecretMount: false + httpPort: 8081 + path: "/var/jenkins_keystore" + fileName: "keystore.jks" + password: "password" + # Convert keystore.jks files content to base64 ( cat keystore.jks | base64 ) and put the output here + jenkinsKeyStoreBase64Encoded: | + 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 + +agent: + enabled: true + defaultsProviderTemplate: "" + # URL for connecting to the Jenkins controller + jenkinsUrl: + # connect to the specified host and port, instead of connecting directly to the Jenkins controller + jenkinsTunnel: + kubernetesConnectTimeout: 5 + kubernetesReadTimeout: 15 + maxRequestsPerHostStr: "32" + retentionTimeout: 5 + waitForPodSec: 600 + namespace: + # private registry for agent image + jnlpregistry: + image: "jenkins/inbound-agent" + tag: "3107.v665000b_51092-15" + workingDir: "/home/jenkins/agent" + nodeUsageMode: "NORMAL" + customJenkinsLabels: [] + # name of the secret to be used for image pulling + imagePullSecretName: + componentName: "jenkins-agent" + websocket: false + directConnection: false + privileged: false + runAsUser: + runAsGroup: + hostNetworking: false + resources: + requests: + cpu: "512m" + memory: "512Mi" + # ephemeralStorage: + limits: + cpu: "512m" + memory: "512Mi" + # ephemeralStorage: + livenessProbe: {} +# execArgs: "cat /tmp/healthy" +# failureThreshold: 3 +# initialDelaySeconds: 0 +# periodSeconds: 10 +# successThreshold: 1 +# timeoutSeconds: 1 + # You may want to change this to true while testing a new image + alwaysPullImage: false + # Controls how agent pods are retained after the Jenkins build completes + # Possible values: Always, Never, OnFailure + podRetention: "Never" + # Disable if you do not want the Yaml the agent pod template to show up + # in the job Console Output. This can be helpful for either security reasons + # or simply to clean up the output to make it easier to read. + showRawYaml: true + # You can define the volumes that you want to mount for this container + # Allowed types are: ConfigMap, EmptyDir, HostPath, Nfs, PVC, Secret + # Configure the attributes as they appear in the corresponding Java class for that type + # https://github.com/jenkinsci/kubernetes-plugin/tree/master/src/main/java/org/csanchez/jenkins/plugins/kubernetes/volumes + volumes: [] + # - type: ConfigMap + # configMapName: myconfigmap + # mountPath: /var/myapp/myconfigmap + # - type: EmptyDir + # mountPath: /var/myapp/myemptydir + # memory: false + # - type: HostPath + # hostPath: /var/lib/containers + # mountPath: /var/myapp/myhostpath + # - type: Nfs + # mountPath: /var/myapp/mynfs + # readOnly: false + # serverAddress: "192.0.2.0" + # serverPath: /var/lib/containers + # - type: PVC + # claimName: mypvc + # mountPath: /var/myapp/mypvc + # readOnly: false + # - type: Secret + # defaultMode: "600" + # mountPath: /var/myapp/mysecret + # secretName: mysecret + # Pod-wide environment, these vars are visible to any container in the agent pod + + # You can define the workspaceVolume that you want to mount for this container + # Allowed types are: DynamicPVC, EmptyDir, HostPath, Nfs, PVC + # Configure the attributes as they appear in the corresponding Java class for that type + # https://github.com/jenkinsci/kubernetes-plugin/tree/master/src/main/java/org/csanchez/jenkins/plugins/kubernetes/volumes/workspace + workspaceVolume: {} + ## DynamicPVC example + # type: DynamicPVC + # configMapName: myconfigmap + ## EmptyDir example + # type: EmptyDir + # memory: false + ## HostPath example + # type: HostPath + # hostPath: /var/lib/containers + ## NFS example + # type: Nfs + # readOnly: false + # serverAddress: "192.0.2.0" + # serverPath: /var/lib/containers + ## PVC example + # type: PVC + # claimName: mypvc + # readOnly: false + # + # Pod-wide environment, these vars are visible to any container in the agent pod + envVars: [] + # - name: PATH + # value: /usr/local/bin + # Mount a secret as environment variable + secretEnvVars: [] + # - key: PATH + # optional: false # default: false + # secretKey: MY-K8S-PATH + # secretName: my-k8s-secret + nodeSelector: {} + # Key Value selectors. Ex: + # jenkins-agent: v1 + + # Executed command when side container gets started + command: + args: "${computer.jnlpmac} ${computer.name}" + # Side container name + sideContainerName: "jnlp" + # Doesn't allocate pseudo TTY by default + TTYEnabled: false + # Max number of spawned agent + containerCap: 10 + # Pod name + podName: "default" + # Allows the Pod to remain active for reuse until the configured number of + # minutes has passed since the last step was executed on it. + idleMinutes: 0 + # Raw yaml template for the Pod. For example this allows usage of toleration for agent pods. + # https://github.com/jenkinsci/kubernetes-plugin#using-yaml-to-define-pod-templates + # https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/ + yamlTemplate: "" + # yamlTemplate: |- + # apiVersion: v1 + # kind: Pod + # spec: + # tolerations: + # - key: "key" + # operator: "Equal" + # value: "value" + # Defines how the raw yaml field gets merged with yaml definitions from inherited pod templates: merge or override + yamlMergeStrategy: "override" + # Timeout in seconds for an agent to be online + connectTimeout: 100 + # Annotations to apply to the pod. + annotations: {} + + # Add additional containers to the agents. + # Containers specified here are added to all agents. Set key empty to remove container from additional agents. + additionalContainers: [] + # - sideContainerName: dind + # image: docker + # tag: dind + # command: dockerd-entrypoint.sh + # args: "" + # privileged: true + # resources: + # requests: + # cpu: 500m + # memory: 1Gi + # limits: + # cpu: 1 + # memory: 2Gi + + # Disable the default Jenkins Agent configuration. + # Useful when configuring agents only with the podTemplates value, since the default podTemplate populated by values mentioned above will be excluded in the rendered template. + disableDefaultAgent: false + + # Below is the implementation of custom pod templates for the default configured kubernetes cloud. + # Add a key under podTemplates for each pod template. Each key (prior to | character) is just a label, and can be any value. + # Keys are only used to give the pod template a meaningful name. The only restriction is they may only contain RFC 1123 \ DNS label + # characters: lowercase letters, numbers, and hyphens. Each pod template can contain multiple containers. + # For this pod templates configuration to be loaded the following values must be set: + # controller.JCasC.defaultConfig: true + # Best reference is https:///configuration-as-code/reference#Cloud-kubernetes. The example below creates a python pod template. + podTemplates: {} + # python: | + # - name: python + # label: jenkins-python + # serviceAccount: jenkins + # containers: + # - name: python + # image: python:3 + # command: "/bin/sh -c" + # args: "cat" + # ttyEnabled: true + # privileged: true + # resourceRequestCpu: "400m" + # resourceRequestMemory: "512Mi" + # resourceLimitCpu: "1" + # resourceLimitMemory: "1024Mi" + +# Here you can add additional agents +# They inherit all values from `agent` so you only need to specify values which differ +additionalAgents: {} +# maven: +# podName: maven +# customJenkinsLabels: maven +# # An example of overriding the jnlp container +# # sideContainerName: jnlp +# image: jenkins/jnlp-agent-maven +# tag: latest +# python: +# podName: python +# customJenkinsLabels: python +# sideContainerName: python +# image: python +# tag: "3" +# command: "/bin/sh -c" +# args: "cat" +# TTYEnabled: true + +persistence: + enabled: true + ## A manually managed Persistent Volume and Claim + ## Requires persistence.enabled: true + ## If defined, PVC must be created manually before volume will be bound + existingClaim: + ## jenkins data Persistent Volume Storage Class + ## If defined, storageClassName: + ## If set to "-", storageClassName: "", which disables dynamic provisioning + ## If undefined (the default) or set to null, no storageClassName spec is + ## set, choosing the default provisioner. (gp2 on AWS, standard on + ## GKE, AWS & OpenStack) + ## + storageClass: + annotations: {} + labels: {} + accessMode: "ReadWriteOnce" + size: "8Gi" + # Existing data source to clone PVC from + # ref: https://kubernetes.io/docs/concepts/storage/volume-pvc-datasource/ + dataSource: + # name: PVC-NAME + # kind: PersistentVolumeClaim + volumes: + # - name: nothing + # emptyDir: {} + mounts: + # - mountPath: /var/nothing + # name: nothing + # readOnly: true + +networkPolicy: + # Enable creation of NetworkPolicy resources. + enabled: false + # For Kubernetes v1.4, v1.5 and v1.6, use 'extensions/v1beta1' + # For Kubernetes v1.7, use 'networking.k8s.io/v1' + apiVersion: networking.k8s.io/v1 + # You can allow agents to connect from both within the cluster (from within specific/all namespaces) AND/OR from a given external IP range + internalAgents: + allowed: true + podLabels: {} + namespaceLabels: {} + # project: myproject + externalAgents: {} + # ipCIDR: 172.17.0.0/16 + # except: + # - 172.17.1.0/24 + +## Install Default RBAC roles and bindings +rbac: + create: true + readSecrets: false + +serviceAccount: + create: true + # The name of the service account is autogenerated by default + name: + annotations: {} + extraLabels: {} + imagePullSecretName: + + +serviceAccountAgent: + # Specifies whether a ServiceAccount should be created + create: false + # The name of the ServiceAccount to use. + # If not set and create is true, a name is generated using the fullname template + name: + annotations: {} + extraLabels: {} + imagePullSecretName: + +## Backup cronjob configuration +## Ref: https://github.com/maorfr/kube-tasks +backup: + # Backup must use RBAC + # So by enabling backup you are enabling RBAC specific for backup + enabled: false + # Used for label app.kubernetes.io/component + componentName: "backup" + # Schedule to run jobs. Must be in cron time format + # Ref: https://crontab.guru/ + schedule: "0 2 * * *" + labels: {} + serviceAccount: + create: true + name: + annotations: {} + # Example for authorization to AWS S3 using kube2iam or IRSA + # Can also be done using environment variables + # iam.amazonaws.com/role: "jenkins" + # "eks.amazonaws.com/role-arn": "arn:aws:iam::123456789012:role/jenkins-backup" + # Set this to terminate the job that is running/failing continously and set the job status to "Failed" + activeDeadlineSeconds: "" + image: + repository: "maorfr/kube-tasks" + tag: "0.2.0" + imagePullSecretName: + # Additional arguments for kube-tasks + # Ref: https://github.com/maorfr/kube-tasks#simple-backup + extraArgs: [] + # Add existingSecret for AWS credentials + existingSecret: {} + ## Example for using an existing secret + # jenkinsaws: + ## Use this key for AWS access key ID + # awsaccesskey: jenkins_aws_access_key + ## Use this key for AWS secret access key + # awssecretkey: jenkins_aws_secret_key + # Add additional environment variables + # jenkinsgcp: + ## Use this key for GCP credentials + # gcpcredentials: credentials.json + env: [] + # Example environment variable required for AWS credentials chain + # - name: "AWS_REGION" + # value: "us-east-1" + resources: + requests: + memory: 1Gi + cpu: 1 + limits: + memory: 1Gi + cpu: 1 + # Destination to store the backup artifacts + # Supported cloud storage services: AWS S3, Minio S3, Azure Blob Storage, Google Cloud Storage + # Additional support can added. Visit this repository for details + # Ref: https://github.com/maorfr/skbn + destination: "s3://jenkins-data/backup" + # By enabling only the jenkins_home/jobs folder gets backed up, not the whole jenkins instance + onlyJobs: false + # Enable backup pod security context (must be `true` if runAsUser or fsGroup are set) + usePodSecurityContext: true + # When setting runAsUser to a different value than 0 also set fsGroup to the same value: + runAsUser: 1000 + fsGroup: 1000 + securityContextCapabilities: {} + # drop: + # - NET_RAW +cronJob: + apiVersion: batch/v1 + +checkDeprecation: true + +awsSecurityGroupPolicies: + enabled: false + policies: + - name: "" + securityGroupIds: [] + podSelector: {} + +# Here you can configure unit tests values when executing the helm unittest in the CONTRIBUTING.md +helmtest: + # A testing framework for bash + bats: + # Bash Automated Testing System (BATS) + image: "bats/bats" + tag: "1.9.0" diff --git a/helm/whanos/templates/_helpers.tpl b/helm/whanos/templates/_helpers.tpl new file mode 100644 index 0000000..e6872ee --- /dev/null +++ b/helm/whanos/templates/_helpers.tpl @@ -0,0 +1,62 @@ +{{/* +Expand the name of the chart. +*/}} +{{- define "whanos.name" -}} +{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" }} +{{- end }} + +{{/* +Create a default fully qualified app name. +We truncate at 63 chars because some Kubernetes name fields are limited to this (by the DNS naming spec). +If release name contains chart name it will be used as a full name. +*/}} +{{- define "whanos.fullname" -}} +{{- if .Values.fullnameOverride }} +{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" }} +{{- else }} +{{- $name := default .Chart.Name .Values.nameOverride }} +{{- if contains $name .Release.Name }} +{{- .Release.Name | trunc 63 | trimSuffix "-" }} +{{- else }} +{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" }} +{{- end }} +{{- end }} +{{- end }} + +{{/* +Create chart name and version as used by the chart label. +*/}} +{{- define "whanos.chart" -}} +{{- printf "%s-%s" .Chart.Name .Chart.Version | replace "+" "_" | trunc 63 | trimSuffix "-" }} +{{- end }} + +{{/* +Common labels +*/}} +{{- define "whanos.labels" -}} +helm.sh/chart: {{ include "whanos.chart" . }} +{{ include "whanos.selectorLabels" . }} +{{- if .Chart.AppVersion }} +app.kubernetes.io/version: {{ .Chart.AppVersion | quote }} +{{- end }} +app.kubernetes.io/managed-by: {{ .Release.Service }} +{{- end }} + +{{/* +Selector labels +*/}} +{{- define "whanos.selectorLabels" -}} +app.kubernetes.io/name: {{ include "whanos.name" . }} +app.kubernetes.io/instance: {{ .Release.Name }} +{{- end }} + +{{/* +Create the name of the service account to use +*/}} +{{- define "whanos.serviceAccountName" -}} +{{- if .Values.serviceAccount.create }} +{{- default (include "whanos.fullname" .) .Values.serviceAccount.name }} +{{- else }} +{{- default "default" .Values.serviceAccount.name }} +{{- end }} +{{- end }} diff --git a/helm/whanos/templates/jenkins-namespace.yaml b/helm/whanos/templates/jenkins-namespace.yaml new file mode 100644 index 0000000..5eb2c27 --- /dev/null +++ b/helm/whanos/templates/jenkins-namespace.yaml @@ -0,0 +1,4 @@ +apiVersion: v1 +kind: Namespace +metadata: + name: jenkins diff --git a/helm/whanos/templates/jenkins-sa.yaml b/helm/whanos/templates/jenkins-sa.yaml new file mode 100644 index 0000000..6ac55e5 --- /dev/null +++ b/helm/whanos/templates/jenkins-sa.yaml @@ -0,0 +1,82 @@ +--- +apiVersion: v1 +kind: ServiceAccount +metadata: + name: jenkins + namespace: jenkins +--- +apiVersion: rbac.authorization.k8s.io/v1 +kind: ClusterRole +metadata: + annotations: + rbac.authorization.kubernetes.io/autoupdate: "true" + "helm.sh/hook": pre-install + "helm.sh/hook-weight": "-8" + "helm.sh/hook-delete-policy": hook-succeeded + labels: + kubernetes.io/bootstrapping: rbac-defaults + name: jenkins +rules: +- apiGroups: + - '*' + resources: + - statefulsets + - services + - replicationcontrollers + - replicasets + - podtemplates + - podsecuritypolicies + - pods + - pods/log + - pods/exec + - podpreset + - poddisruptionbudget + - persistentvolumes + - persistentvolumeclaims + - jobs + - endpoints + - deployments + - deployments/scale + - daemonsets + - cronjobs + - configmaps + - namespaces + - events + - secrets + verbs: + - create + - get + - watch + - delete + - list + - patch + - update +- apiGroups: + - "" + resources: + - nodes + verbs: + - get + - list + - watch + - update +--- +apiVersion: rbac.authorization.k8s.io/v1 +kind: ClusterRoleBinding +metadata: + annotations: + rbac.authorization.kubernetes.io/autoupdate: "true" + "helm.sh/hook": pre-install + "helm.sh/hook-weight": "-7" + "helm.sh/hook-delete-policy": hook-succeeded + labels: + kubernetes.io/bootstrapping: rbac-defaults + name: jenkins +roleRef: + apiGroup: rbac.authorization.k8s.io + kind: ClusterRole + name: jenkins +subjects: +- apiGroup: rbac.authorization.k8s.io + kind: Group + name: system:serviceaccounts:jenkins diff --git a/helm/whanos/templates/jenkins-volume.yaml b/helm/whanos/templates/jenkins-volume.yaml new file mode 100644 index 0000000..ead0668 --- /dev/null +++ b/helm/whanos/templates/jenkins-volume.yaml @@ -0,0 +1,30 @@ +apiVersion: v1 +kind: PersistentVolume +metadata: + name: jenkins-pv + namespace: jenkins + annotations: + "helm.sh/hook": pre-install + "helm.sh/hook-weight": "-10" + "helm.sh/hook-delete-policy": hook-succeeded +spec: + storageClassName: jenkins-pv + accessModes: + - ReadWriteOnce + capacity: + storage: 8Gi + persistentVolumeReclaimPolicy: Retain + hostPath: + path: /data/jenkins-volume/ + +--- +apiVersion: storage.k8s.io/v1 +kind: StorageClass +metadata: + name: jenkins-pv + annotations: + "helm.sh/hook": pre-install + "helm.sh/hook-weight": "-9" + "helm.sh/hook-delete-policy": hook-succeeded +provisioner: kubernetes.io/no-provisioner +volumeBindingMode: WaitForFirstConsumer diff --git a/helm/whanos/values.yaml b/helm/whanos/values.yaml new file mode 100644 index 0000000..31d61c4 --- /dev/null +++ b/helm/whanos/values.yaml @@ -0,0 +1,130 @@ +jenkins: + controller: + # When enabling LDAP or another non-Jenkins identity source, the built-in admin account will no longer exist. + # If you disable the non-Jenkins identity store and instead use the Jenkins internal one, + # you should revert controller.adminUser to your preferred admin user: + adminUser: "admin" + adminPassword: "admin" + servicePort: 32000 # The port the service listens on (32000 for NodePort, 8080 for LoadBalancer and ClusterIP) + # For minikube, set this to NodePort, elsewhere use LoadBalancer + # Use ClusterIP if your setup includes ingress controller + serviceType: NodePort + + installPlugins: + - kubernetes:4029.v5712230ccb_f8 + - workflow-aggregator:596.v8c21c963d92d + - git:5.2.0 + - configuration-as-code:1670.v564dc8b_982d0 + + # List of plugins to install in addition to those listed in controller.installPlugins + additionalPlugins: + - role-strategy:689.v731678c3e0eb_ + - job-dsl:1.87 + - parameterized-trigger:2.46 + - github:1.37.3.1 + - ws-cleanup:0.45 + + JCasC: + defaultConfig: true + configScripts: + welcome-message: | + jenkins: + systemMessage: Welcome to our CI\CD server. This Jenkins is Whanos-powered instance!. + security-dsl: | + security: + globalJobDslSecurityConfiguration: + useScriptSecurity: false + job-config: | + jobs: + - script: | + import java.io.File + + // Utility function to clone the repository and return the directory path + def cloneRepoAndGetImagesDir() { + def workspace = new File('/tmp/whanos_repo') + def cloneCommand = "git clone https://github.com/Tux-Inc/Whanos.git /tmp/whanos_repo" + + // Execute the git clone command + def process = cloneCommand.execute() + process.waitFor() + + // Check for errors in cloning + if (process.exitValue() != 0) { + println "Error cloning repository: " + process.err.text + return null + } + + // Return the directory path of the cloned repository + return new File(workspace, "images") + } + + def imagesDir = cloneRepoAndGetImagesDir() + def languages = [] + + if (imagesDir.exists() && imagesDir.isDirectory()) { + def directories = imagesDir.listFiles().findAll { it.isDirectory() } + languages = directories.collect { it.name } + println "Available languages: " + languages + } else { + println "Images directory not found or is not a directory, no languages available" + } + + folder("Whanos base images") { + description("Whanos base images folder") + } + + folder("Projects") { + description("Projects folder") + } + + languages.each { language -> + println "Creating job for language: " + language + freeStyleJob("Whanos base images/whanos-$language") { + steps { + shell("docker build $imagesDir/$language -t whanos-$language -f $imagesDir/$language/Dockerfile.base") + } + } + } + + freeStyleJob("link-project") { + parameters { + stringParam("GITHUB_NAME", null, "GitHub repository owner/repo_name (e.g.: 'EpitechIT31000/chocolatine')") + stringParam("DISPLAY_NAME", null, "Display name for the job") + } + steps { + dsl { + text(''' + freeStyleJob("Projects/$DISPLAY_NAME") { + wrappers { + preBuildCleanup() + } + scm { + github("$GITHUB_NAME") + } + triggers { + githubPush() + } + steps { + shell("echo 'TODO: BUILD IMAGE'") + } + } + ''') + } + } + } + + agent: + additionalContainers: + - sideContainerName: dind + image: docker + tag: dind + command: dockerd-entrypoint.sh + args: "" + privileged: true + resources: + requests: + cpu: 500m + memory: 1Gi + limits: + cpu: 1 + memory: 2Gi diff --git a/jenkins/init.sh b/jenkins/init.sh new file mode 100644 index 0000000..e69de29 diff --git a/jenkins/job_dsl.groovy b/jenkins/job_dsl.groovy index 91ccfb8..63a0c21 100644 --- a/jenkins/job_dsl.groovy +++ b/jenkins/job_dsl.groovy @@ -1,37 +1,59 @@ import java.io.File +import hudson.plugins.git.GitSCM +import hudson.plugins.git.extensions.impl.RelativeTargetDirectory +import hudson.plugins.git.extensions.impl.CloneOption -def imagesDir = new File('/images') +// Constants +final String REPO_URL = "https://github.com/Tux-Inc/Whanos.git" +final String IMAGES_DIR_RELATIVE_PATH = "images" +final String BASE_FOLDER_NAME = "Whanos base images" +final String PROJECTS_FOLDER_NAME = "Projects" + +// Utility function to clone the repository and return the directory path +def cloneRepoAndGetImagesDir() { + def workspace = new File('/tmp/whanos_repo') + def scm = new GitSCM(REPO_URL) + scm.extensions.add(new CloneOption(false, false, "", 10)) + scm.extensions.add(new RelativeTargetDirectory(workspace.getAbsolutePath())) + + // Clone the repo + scm.checkout(null, workspace, null, null, null, null) + + // Return path to images directory + return new File(workspace, IMAGES_DIR_RELATIVE_PATH) +} + +def imagesDir = cloneRepoAndGetImagesDir() def languages = [] if (imagesDir.exists() && imagesDir.isDirectory()) { - File[] files = imagesDir.listFiles() - def directories = files.findAll { it.isDirectory() } + def directories = imagesDir.listFiles().findAll { it.isDirectory() } languages = directories.collect { it.name.capitalize() } println "Available languages: " + languages } else { println "Images directory not found or is not a directory, no languages available" } -folder("Whanos base images") { +folder(BASE_FOLDER_NAME) { description("Whanos base images folder") } -folder("Projets") { - description("Projets folder") +folder(PROJECTS_FOLDER_NAME) { + description("Projects folder") } languages.each { language -> - freeStyleJob("Whanos base images/whanos-$language") { + freeStyleJob("$BASE_FOLDER_NAME/whanos-$language") { steps { - shell("docker build /images/$language -t whanos-$language -f /images/$language/Dockerfile.base") + shell("docker build ${imagesDir.absolutePath}/$language -t whanos-$language -f ${imagesDir.absolutePath}/$language/Dockerfile.base") } } } -freeStyleJob("Whanos base images/Build all base images") { +freeStyleJob("$BASE_FOLDER_NAME/Build all base images") { publishers { downstreamParameterized { - trigger("Whanos base images/whanos-$language", false) + trigger("$BASE_FOLDER_NAME/whanos-$language", false) condition("SUCCESS") parameters { predefinedProp("language", languages.join(',')) @@ -62,7 +84,6 @@ freeStyleJob("link-project") { shell("echo 'TODO: BUILD IMAGE'") } } - ''') } }