From 0ee4e8d8dd36a73e8d41e33fad7241678a652d1a Mon Sep 17 00:00:00 2001
From: Pierre Smeyers <pierre.smeyers@gmail.com>
Date: Sat, 27 Jan 2024 00:07:03 +0100
Subject: [PATCH] feat: migrate to CI/CD component
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

⚠ requires GitLab 16.6 or later
---
 .gitlab-ci.yml                   |   2 +-
 README.md                        |  22 +++++++++++++++++++---
 bumpversion.sh                   |   4 ++--
 kicker.json                      |   2 ++
 logo.png                         | Bin 5364 -> 26458 bytes
 templates/gitlab-ci-renovate.yml |  16 ++++++++++++----
 6 files changed, 36 insertions(+), 10 deletions(-)

diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index 2226e8c..3b4b915 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -10,7 +10,7 @@ include:
     file: '/templates/validation.yml'
   - project: 'to-be-continuous/bash'
     ref: '3.3'
-    file: 'templates/gitlab-ci-bash.yml'
+    file: '/templates/gitlab-ci-bash.yml'
   - project: 'to-be-continuous/semantic-release'
     ref: '3.7'
     file: '/templates/gitlab-ci-semrel.yml'
diff --git a/README.md b/README.md
index 1392bcb..abaa152 100644
--- a/README.md
+++ b/README.md
@@ -4,10 +4,26 @@ Automate your dependency updates with [Renovate](https://www.mend.io/renovate/).
 
 ## Usage
 
-In order to include this template in your project, add the following to your `gitlab-ci.yml`:
+This template can be used both as a [CI/CD component](https://docs.gitlab.com/ee/ci/components/#use-a-component-in-a-cicd-configuration) 
+or using the legacy [`include:project`](https://docs.gitlab.com/ee/ci/yaml/index.html#includeproject) syntax.
+
+### Use as a CI/CD component
+
+Add the following to your `gitlab-ci.yml`:
+
+```yaml
+include:
+  # include the component
+  - component: gitlab.com/to-be-continuous/renovate/gitlab-ci-renovate@1.1.0
+```
+
+### Use as a CI/CD template (legacy)
+
+Add the following to your `gitlab-ci.yml`:
 
 ```yaml
 include:
+  # include the template
   - project: 'to-be-continuous/renovate'
     ref: '1.1.0'
     file: '/templates/gitlab-ci-renovate.yml'
@@ -17,9 +33,9 @@ include:
 
 The Renovate template uses some global configuration used throughout all jobs.
 
-| Name                   | Description                                                                     | Default value     |
+| Input / Variable | Description                                                                     | Default value     |
 |------------------------|---------------------------------------------------------------------------------|-------------------|
-| `RENOVATE_IMAGE`       | The Docker image used to run Renovate                                           | `registry.hub.docker.com/renovate/renovate:latest` |
+| `image` / `RENOVATE_IMAGE` | The Docker image used to run Renovate                                           | `registry.hub.docker.com/renovate/renovate:latest` |
 | :lock: `RENOVATE_TOKEN`| A GitLab access token to allow Renovate crawl your projects. [See doc](https://docs.renovatebot.com/modules/platform/gitlab/#authentication) | _none_ |
 | :lock: `GITHUB_COM_TOKEN`| A GitHub access token to allow Renovate fetch changelogs. [See doc](https://docs.renovatebot.com/getting-started/running/#githubcom-token-for-changelogs) | _none_ |
 
diff --git a/bumpversion.sh b/bumpversion.sh
index f06829a..ed44d7b 100755
--- a/bumpversion.sh
+++ b/bumpversion.sh
@@ -27,13 +27,13 @@ if [[ "$curVer" ]]; then
   log_info "Bump version from \\e[33;1m${curVer}\\e[0m to \\e[33;1m${nextVer}\\e[0m (release type: $relType)..."
 
   # replace in README
-  sed -e "s/ref: '$curVer'/ref: '$nextVer'/" README.md > README.md.next
+  sed -e "s/ref: *'$curVer'/ref: '$nextVer'/" -e "s/ref: *\"$curVer\”/ref: \”$nextVer\”/" -e "s/component: *\(.*\)@$curVer/component: \1@$nextVer/" README.md > README.md.next
   mv -f README.md.next README.md
 
   # replace in template and variants
   for tmpl in templates/*.yml
   do
-    sed -e "s/\"$curVer\"/\"$nextVer\"/" "$tmpl" > "$tmpl.next"
+    sed -e "s/command: *\[\"--service\", \"\(.*\)\", \"$curVer\"\]/command: [\"--service\", \"\1\", \"$nextVer\"]/" "$tmpl" > "$tmpl.next"
     mv -f "$tmpl.next" "$tmpl"
   done
 else
diff --git a/kicker.json b/kicker.json
index c1cb213..2442ccf 100644
--- a/kicker.json
+++ b/kicker.json
@@ -3,6 +3,8 @@
   "description": "Automate your dependency updates with [Renovate](https://www.mend.io/renovate/)",
   "template_path": "templates/gitlab-ci-renovate.yml",
   "kind": "misc",
+  "prefix": "renovate",
+  "is_component": true,
   "variables": [
     {
       "name": "RENOVATE_IMAGE",
diff --git a/logo.png b/logo.png
index 70753a173ed09089752a12e8a2006dc8dfc927c2..9fb664b1c2bd5957ea907c27c264e943ce7ee7d0 100644
GIT binary patch
literal 26458
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

literal 5364
zcmeAS@N?(olHy`uVBq!ia0y~yU^ofF9Bd2>44ucsSQ!{Zc6+)whE&XXGdDgbB)sZ?
zz4Yw~4mrt_4mgXSQL|_Xebu?k#p9;#<gk;ALazGV|7A9L`l_`d5BGf4HGe<VXirG=
zR-t+Ad7p#cF3<@26!b=GVn$f*F(=h2Q!>t^1;3bfgt<+Mea2PE`OMQ#?tMOQ|Mxq^
z@4ipgk?wzfPO_x_^W67;ex8fif1jPj@seceT?Q6SD-F)3l!i$P9&B(%@;Ye&Bjvzs
zF@{I+ml*;&|8oAU^!iYAdgJ`vU$S`_te#ZcuPWy;mtWZPKwyJiNSoK2?myM{9D~DF
z+IWAdW`BB-T{SR4B}-6n)tBx+H3v#(TYSmbqWDPX>*8ONUbFpV^HO5y6>;g1`m1-#
zRZDBh>ubv{B`i6~pz7J!<+von;+56YqgtYAf~}rxs-1yKhL;=?g&aJ$JxNIVbEPzz
z>j)QvNvFx*75kp;GSt&ttD+p3EyW<VLdMl^PweHz7gb-me_i+b*p3AylP>6mvM`ih
z&;2+dRm*#&+X*ja&Qpm~f=&wUQPF4*^-}cSFlm9zPN$Sej#3vL3(q9ZpH2*u>-Jq-
zw28%3N^FWsiN^NM#i4#LFX}~HE_L=1Y*E>gef3CXpVLMrhF*bP3HQ8>gtm%hylaeI
zomAB2CYHZD;hvY%;^RsTGUa#0R3?WqtoSJvy64VJkK%qlu1CBo?te;DvRv0mFKP;(
z*wPncS{QLXds=45$7R2t_Nr{DzN+`~)tw730t5HVX!){ex9ID*g$juVtPJTd7kEF^
ztWjC`f8zTcdF>q5^7q-Q=g(@;5Bq<=G`MEb2jK~=(^6Ejbbn2%7jTTT*u;HoTknDY
z|L&{B?5eq4I=Lo^m0^{u=+X(3F0j;|oc=B}Mu4qL$v3gRlUv=BqsbsZB(ut7k%-q6
zC)IabLi)`)t^5TJUH11oaL2g+`8~aUMb5vMJg%(TmFF?%kcSg%<fqiaq-hE~BCb+q
zpRN|%6>w8j>EwKL^p|#^ql8A6(DH7ju3}Fo@s`F#8i5>vbJX6Y3aap_efHY(sHp5-
zq{_m@5#8HZZ*H!RdA+Q!I3;iSx2+y7mG2^ZG$w6%$-YW>j>n|y2Ji1JS9|bt=iFQK
z|MhTB&pUXxx@zM0cX#b<wzBVzo3tTNUwzSzE|qKIT0)L|we_#vOfLE=-Pu*ke=a^E
zT&$JD$ZXqHwljfCW-by;wR$gpE>>vQl_Rh0ChSn)xxVNKYvKZpOEL=tRl@^|rndBj
zM8tMaRpB^1Rl^e;7|&kLTXg3{Zb|pKMf0})l(KPr^rCFGgwmytES=4Z<1X!)8SXkQ
zMrGl{joHO2-XQ{Ra*H~+4mkuaIhmSavHsn(t2+fE9TnQwO<$wX5UVd*<oRT+x0Ct*
zXz7zdf-Q;OBBG#B5(zF@az!g_cl5T;6Kr=MXaB6QYr^b5mp_|tU2pvLh=fgfhPqGB
z>+>gj?%iYiU-fU-w^FY|xBsrlTPxJP)kA1@;C8q7$L=2FU3WS>{C!4zv&-W5=k3e{
zp8Tub%RetrqOrc>>+uZ{zbBUM_Bs@8rY@CRwp}b&zgqpS^rf>G1)qM_&pW*Jeoofb
zW)7!axl4Y#NyvtZrz)H{ef;5tCn8t0&o9t;q;u<({~8ac)w7=jO%Hb$k!~^wap~kf
z<Pg|0bGbUF#PJHhNyiKFg)+^vrOa46om~_UrA$=um=pHg$mEuM=GN^hdorqiukZDE
zw4`FIkIPAK0f8Qk$R-9i5y_tC2i;T`E{;_9jSFTI4E!Y0a!}aS1(YU_?0LDUe3^3R
z=jP~&MLPsqCaQGxfD&5Ai4>uHAE8|p8wEoBCb<-9awzL{bt&*Dow~p0oAXk$DJ`0l
z<!`tNm4~0K5__`j-(C4PP4WNF%jP<A=<oZ`vPq$E+gJC8@9V$(_G%Ikv;NP^E&oTT
zO8VD(&4M14kI8Abg3dVGY|oc(?d%MkF-yi+iL=vZ*Cd`rx4#BfR6R0W`drxYUPk?z
zt8Es&r#1&z?~z|t?sMSd&Al6nzGg?<{vmctd_7NG_St+vPm_!59xj#j?2>YAyPi5T
zD$)A;na9mvL$!`vuL%8i_CU~Mb%U+Wf1=b_6_ZT-Wm=gp?+*Ik=CbP9&hrXUS|N_E
zkz2yKW}oon5_g>>rZ+3f!ox-R&`F~`9Gi;2X0Onz)3}prr0Mbbi1&wX``T7*jz*3@
zVWs!JH!{67jg6YPq$5xzJ9T|`$D!N1m4pH-nkMKyy{E38aQ=+Nn)|!VBifHiGyT79
zZ^c$$_{DNz+3}AxM#0*%UbsziauuAo^nIoKlr?8#BL!R4IV$(-@B6^==Kow-{&Q}M
z|DT=wUH-q$Q}g_XnirAUvozc%EpipSxmU5$MP%mPeosMFZ-INipL*K($7e?=$tP9F
z1WsAp>8GOUBNBMiCe?b;i9CL}J`JlThqgW1U$(X>bN#Fh>w8k@5;(8*dZ)@=rI3c}
zcVjb@7rl5hUtRF&`MUQ4f1dvSKkdhkH@`(YHCAW84ygXFQ*!+p`^BY!m16fS3#U}a
z`YWG0SQqmCl%1!ikk#(Gs9&8^WN*7CK0a4_b-De4E8n6gFPdOBQ^R0l%d6i{JB_xd
z3$0t5@9_TI;(p;kzw2?&;;uUf`h8uztHdSnZJuWMFSV0T`L!oEzjsYctGeTHeRcU`
zy_(Y8%>hjgZr5L5`YL^2kcFjvj_sQ&(~xT=p59L9gTq%HkkG&7u<vzO(jpxJ?OO|G
zFW&II?8Sp*gU!`3Kdn4xbj;A2ynwOGsp!S5H<Lq@I)j*|gj_wcRpW4|Z-}d8UB3IX
zGAZGsA=8BdMBMc5>b_hjw*F1OcHpH`|4wvG`gYH!BPmFLt;^^}zLEB47ER9=_exhL
z#!uW8QQ18yRNOmc%9`)Xl)HFA#Yv3G#9o!4zm_u(6;^gCMOo;1i(LG^OsUJ)QNqkM
zb6$n#=F)2uclEFJToe>}aht}bsiK!%Cf4Q~EqbEJad?`BdcQ6IX31`K*<y!fe$zLo
z7{%(&y|j3nOQ5c;l}^{IYGFZDe@BTYdwqRR<!TEFs;;uK-s>y!@J^K4Bo0?WSw{&q
z*PZ3-*N4s)Pg?Y1-*#IW&lrwFGpd~G-p5YUxO#K%thJl^3f7<4q2k)qQS@+s9;3vL
z_up)H%J!Xm8&>yk>-`+QZ#UH+1_{V^Xk@0m4b@~|cX8j@qO$O>`NDN#@6!a1x?E&)
zd;cu<EvI|fmWT6K)pHm>wq7znKE?6G|I?<ezA23gUk>U^c`jMh(Wjxtn)t%U;@Ik0
zZ=~eg>uvtA2Q3nb75MbO==cFED}TXT|Mj#wzob=(2Ig=a3J_FX`KG@|!;WK7aL%5<
zO0%zq{#rXZuC5lF>XNy3T91YqYvPHHL#w-0mAoWb9<CLNdleVFuWa6hRf}VcR0Vf(
z@Cych5@=CW>hgGKF;62^yyb#Tx#Q1YmW%Z}J9oM6nXTsUC}9(rqNT0Y+0?`^XXg*?
zh*xo;b-i;=&bc5s@yLla0hi7`b`o%#q@lIc{qdp&3enLGwzoS%dpr(x+;`DqO+4ay
zaphTWm&)4jI$V=BmG67tlX`Y~!Sbk=dU}hG%5_NWl`h}9{r#p#SL0)^uKw(uH%I#V
z`@`q||2Q7CwetU;y~UmV3l-u57EY}fI@zTXCiY;4P|KZ$UEUEViqq%aV_R-#&2PT{
zZ`iM&yFz_)nwmHc?>)a+#qioyBiBnG*;g$(ay_ZGZZW&M{m%$55fK#*M~85sm9jD0
z9?s=g()PNP<SH2$Fd>1Zan0{L(w;7S7X(FHx6cZ95fM?*a8!8xK~vqbQ^!c%C$&>)
z)1A5MTwFqP6qqZNV<IP6=qIl#Vu_xmVf5Q^l8d9`A(0j({mwJr+@fF13AE7ZI@Pvv
zhlYm7g(e1np?fx+8!vl@Ua&nPyh6j%{<MQj<=(%FHDBgm7nXN-Y;yDzTJHJ#%99xr
zoo(t13WVPE-D&>4VB1Ts>9eLd2|QqBjq`gHGU@gGn$>#`7gpEvoZIv3R>IDcD-OxU
zi7YW`V#uFx>W1YzvkNyLdaz{f|8*-N_UgiunwfzC6M{GoExj<QVUb3mqlD3-1qvD-
zGV@egBPS^-dreZ{5ey8NaEWV?jen4Yi_1gKLk~Kenx=#aJeYgyS+B~3Lg8+XLmon`
zteRUDV)jg83Cc^8bd)Fz3=j}$X)m92V1kBLlR<~ZdVhHr#{dDnPp%2vOoFLtzsr6s
z`L}D5g2VNszhB$`Py8Xl)nu@zN2TZdzCE1vU;n9loj<xYLZd??&YP*}IKv4Wc2>u>
zk8wg1L|9oJ9aA`+gap8>kO!WdrX^eV9GJ|&>gZ?`;aT0F?s?oV`pqO2=NC;O-_9;j
z__c(sHDOnD;iI4}`f;A3Eggp6&peLfW@36Syhx#{!rFflt6=Kqd$kq+KkEz2n{WIa
z$R6Bu#_xU8e7S#duO4f37_6MwqTV_E?ph0b`~R+w-a8Aju(4OX^RCS)&6Q;pRR3DX
zuT?0nsN&e*HpygH_Vxe)<_{{Kx(aWM+4*h6dK5YWpD26UuVU9cIZtwHY22;_3a##y
zCD~VNqVGI<v?OwN(+9sPtKQtUm5_652{`4ca76F=($m|wo-3Jtw2Vb@(vrC))?1UA
zrb*d52C}?xFMaCq=r6~01FQ61rzeGrudaNz`O5JC5yfeh{L}O%IruGlGPBv_e5}No
z_9cyrQV#7szgbPVxm$%tt*cj6vr_$Kw)E@^8TB>-jT{qMgqQC6p;(gSbk^^E)2)Yp
zo8P-A73qGe`2A?A`#-&c9g}*#{Ql#AdE$zx@$B~)mtD`>DRWfG+|pl!>12F|#@(%7
z4;D?Ee0-k&-`h{$nMVA0FxlwDColU|`b%v!lswg6PY}LusOlxyR_W@pvoKwF-Mah(
zcjkF6%-(nLU&V$q>Ir49Ro)2{P47-ra@TB9XyJ=pJ=N@y>x?^giaHz*OWr;`81%;>
z@+l{i#!2TA7tJnEN=)I5m~tgg%-LnqneLXRE)7@VmW4{EPF-EUvtE9M#!N?r;7N5M
z>f$dYvx5#!6kNKZ$zX<t3j4#tXOGrDI68kX`_%b+**Bl9Z!@?5k^1UBn?~0}52ccY
z69fd8zGyPomHoO|#kM!>xzUw-f2Xr6M`TOSZmyheU->;JD}>WyN~jdejs+^3A6!1V
z3LHALQF*1OmEe+#|1>^s{B~6P&buguMI3jpFPgOF>#axXo{N5{aPX*j&SQVbdFaHc
zY$k!Db5u%h)?}G>PEa(esrsiD^Rp=VgKOP4*9ouQ>^t&PNYGKDv0LfOL;YZmMJ2I%
z$L3mpe|T!WIa|Emv|FnuZP_~g&Kqv|6I0uGL#8}k^HZ>`N2UAKTgNV^=daAYqN|ui
zTrFA!rnU4jv25pDofGoyZCG7i!lD_|UA`UasGd}&J4r@$wV!yugG=PZoAdOvIm>q1
zDCJ&%6n(XFt+XXW;4Gth9aYY^MN^BWoDRQKru*vNiFw^hSCxY_i@Po!QLfl6=B?%B
zT@upWIEm$))ZLWUMK%t<{!N|M5_Mxzt=uC%k*AES_sDi+t_YiYJmZn1#wmuCEpr#D
zaBiI#-NvdZrz*a5`LBoTitRYvg!wf$YIJYnw04f1R2LF|M6$wObESq?tgb=9rO+im
zYmNx23NKw6%n;`-)T34xtQ5G#?u_r8nH?98Bzq}zg^4f<Pf9TPIA5tFX`|o9Z|yr)
zUM@GBRneCnI7>Y)XrEbouo~ZDBPGsWHH-X5mU^z1cDt{an7o|%>w{TkpS9a$h7;aX
zRI=K?YsZ^6dX&bcNF-0X5Lpp(S(Kr&<I<~`f9Kv;9?$jObgTc>sn1G>XY{DFv>Jt0
z^GM!aRC4{AY1DMj!%vR(csU)GF5As?aGA!|!}oumd(YEZ?3TJzpa1eimW&yPRqO<E
zIyM!&;W(qN@{)~@`_;@or37c8u8(a>?+i4#e(o;!lku%tQ~R+i%=+Y0U)9%zYdoBe
zFT1~`F!u<rnu}up<o(`FDxYTE)xC6fQ_$JtVJZjn!W&+691>0`&5hl)>WM(uu1KEj
zNdZz8w?xI17Mb|(F|jx+{^I4nC-*a(zL=RU{Pr$#>8eSFS!TN;d(JewZjD#Sy2|iC
zJS?8&<lM}vC#6A5=OW(4NuOD={GcDxHJ=;)Ul;#sI>)+cgC1v2r_-)D^|kv2CTS}z
zT9W87VQO7SxW2n)$J=+;7_zLywsQBZSr;zV#-e!l$EtIzE+<`uyhJ}w{xCtbRplic
z3*+rdk2!Z#7UpY+f1X&AxM+@-=E_qUrF#5)`lbpeq?e^%t$Z?RvdyQaz}1Wl%ZqCR
zRm?r+1zGQ@H&_)q_pZ6dt-G<&^&jpstgQ<<U%JVv+%v&@3J1fzQ-50p?^|B(f3<Z_
zyvg}FPZ<BMkbAhP%4L#h`02TGJeZ;vnFNTq2q<}&u6L=GP`|s@T}oi92UFRdOyvnm
zk3$3sBt4U^6!5WnE=<o(UC(n)wUd{3v4+PSxn2d?>%4_}oHklq>!jQo>Jq}b6gWf_
z)g{wZvUHgo?v`2$q+6VKY}0g60d<O(E-Pqq5L9h!U$p1#E?JLtTe>tjL^kdgWuLxb
z3ft>yrxJ}VDjQV2SQ(}<B%CUZ7SP_~c>0Ohv_sxZ(TjY71E0liXEi*g75gr(Lr_O9
z&g0Ml*}j7t<~*+xh}|=ZMeg0q_#^M8Z{Oo9zN4zSeA0nw8k<8zVm?3RzgM!p?PHM8
zF^?-z3%0f!t`eCYtk&;zLVCR_V~>_=`c%DuGr6nR^6r`5(iph3U=J^YZ~S8SISDF_
z?aoJiV}3uKlFAVA!SK6>vWBOGa^PyO#av|vKP68+mAEuxt9R3s7RUB(&lJlCyL1^Z
zFTSg_zO6KsBT9%ZmRW3}j@!$N{0kI5@yRWn(9*a`VxdWqftM<0^QlV*=D2o+{$jkW
z*Dcc%<aKC)c8_?0NzZ9Xh6o-*Me(IqCK<fAVA!p<<5GoomQIl6u65FnrKY5CNX1HR
zxe_?DNPJTEmX#85=O@f&Q++5Pyi6*iC30z!&eWaOQ(3)~IAWE<mI^L=_3_hm;}YiE
zK^~hQnK^ojEDT)c)Vfl{<kAF>i;kLK96WiPrXN0YN&nO562DIZlDk4UzU>X(wlFGs
zfr_Pr`}rG;GeoucFT7V`PcC~Y-mH2pR;G3nzgLrjq{t=<*(MRrDJ+gg4xR!k%rHjt
feKrP$|Nj@IsIIIlV%26~U|{fc^>bP0l+XkKf6|n*

diff --git a/templates/gitlab-ci-renovate.yml b/templates/gitlab-ci-renovate.yml
index a499b4c..9e70df7 100644
--- a/templates/gitlab-ci-renovate.yml
+++ b/templates/gitlab-ci-renovate.yml
@@ -14,6 +14,12 @@
 # Floor, Boston, MA  02110-1301, USA.
 # =========================================================================================
 # default workflow rules: Merge Request pipelines
+spec:
+  inputs:
+    image:
+      description: The Docker image used to run Renovate
+      default: registry.hub.docker.com/renovate/renovate:latest
+---
 workflow:
   rules:
     # prevent branch pipeline when an MR is open (prefer MR pipeline)
@@ -38,13 +44,15 @@ workflow:
 
 variables:
   # variabilized tracking image
-  TBC_TRACKING_IMAGE: "registry.gitlab.com/to-be-continuous/tools/tracking:master"
+  TBC_TRACKING_IMAGE: registry.gitlab.com/to-be-continuous/tools/tracking:master
 
-  RENOVATE_IMAGE: "registry.hub.docker.com/renovate/renovate:latest"
+  RENOVATE_IMAGE: $[[ inputs.image ]]
+
+  # those are native Renovate configuration variables
+  # see: https://docs.renovatebot.com/self-hosted-configuration
   RENOVATE_ENDPOINT: $CI_API_V4_URL
-  
   RENOVATE_LOG_FILE: renovate-log.ndjson
-  RENOVATE_AUTODISCOVER_FILTER: '${CI_PROJECT_ROOT_NAMESPACE}/**'
+  RENOVATE_AUTODISCOVER_FILTER: ${CI_PROJECT_ROOT_NAMESPACE}/**
   RENOVATE_BINARY_SOURCE: install
   RENOVATE_LOG_FILE_LEVEL: debug
   LOG_LEVEL: info
-- 
GitLab