index.html 98 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222422342244225422642274228422942304231423242334234423542364237423842394240424142424243424442454246424742484249425042514252425342544255425642574258425942604261426242634264426542664267426842694270427142724273427442754276427742784279428042814282428342844285428642874288428942904291429242934294429542964297429842994300430143024303430443054306430743084309431043114312431343144315431643174318431943204321432243234324432543264327432843294330433143324333433443354336433743384339434043414342434343444345434643474348434943504351435243534354435543564357435843594360436143624363436443654366436743684369437043714372437343744375437643774378437943804381438243834384438543864387438843894390439143924393439443954396439743984399440044014402440344044405440644074408440944104411441244134414441544164417441844194420442144224423442444254426442744284429443044314432443344344435443644374438443944404441444244434444444544464447444844494450445144524453445444554456445744584459446044614462446344644465446644674468446944704471447244734474447544764477447844794480448144824483448444854486448744884489449044914492449344944495449644974498449945004501450245034504450545064507450845094510451145124513451445154516451745184519452045214522452345244525452645274528452945304531453245334534453545364537453845394540454145424543454445454546454745484549455045514552455345544555455645574558455945604561456245634564456545664567456845694570457145724573457445754576457745784579458045814582458345844585458645874588458945904591459245934594459545964597459845994600460146024603460446054606460746084609461046114612461346144615461646174618461946204621462246234624462546264627462846294630463146324633463446354636463746384639464046414642464346444645464646474648464946504651465246534654465546564657465846594660466146624663466446654666466746684669467046714672467346744675467646774678467946804681468246834684468546864687468846894690469146924693469446954696469746984699470047014702470347044705470647074708470947104711471247134714471547164717471847194720472147224723472447254726472747284729473047314732473347344735473647374738473947404741474247434744474547464747474847494750475147524753475447554756475747584759476047614762476347644765476647674768476947704771477247734774477547764777477847794780478147824783478447854786478747884789479047914792479347944795479647974798479948004801480248034804480548064807480848094810481148124813481448154816481748184819482048214822482348244825482648274828482948304831483248334834483548364837483848394840484148424843484448454846484748484849485048514852485348544855485648574858485948604861486248634864486548664867486848694870487148724873487448754876487748784879488048814882488348844885488648874888488948904891489248934894489548964897489848994900490149024903490449054906490749084909491049114912491349144915491649174918491949204921492249234924492549264927492849294930493149324933493449354936493749384939494049414942494349444945494649474948494949504951495249534954495549564957495849594960496149624963496449654966496749684969497049714972497349744975497649774978497949804981498249834984498549864987498849894990499149924993499449954996499749984999500050015002500350045005500650075008500950105011501250135014501550165017501850195020502150225023502450255026502750285029503050315032503350345035503650375038503950405041504250435044504550465047504850495050505150525053505450555056505750585059506050615062506350645065506650675068506950705071507250735074507550765077507850795080508150825083508450855086508750885089509050915092509350945095509650975098509951005101510251035104510551065107510851095110511151125113511451155116511751185119512051215122512351245125512651275128512951305131513251335134513551365137513851395140514151425143514451455146514751485149515051515152515351545155515651575158515951605161516251635164516551665167516851695170517151725173517451755176517751785179518051815182518351845185518651875188518951905191519251935194519551965197519851995200520152025203520452055206520752085209521052115212521352145215521652175218521952205221522252235224522552265227522852295230523152325233523452355236523752385239524052415242524352445245524652475248524952505251525252535254525552565257525852595260526152625263526452655266526752685269527052715272527352745275527652775278527952805281528252835284528552865287528852895290529152925293529452955296529752985299530053015302530353045305530653075308530953105311531253135314531553165317531853195320532153225323532453255326532753285329533053315332533353345335533653375338533953405341534253435344534553465347534853495350535153525353535453555356535753585359536053615362536353645365536653675368536953705371537253735374537553765377537853795380538153825383538453855386538753885389539053915392539353945395539653975398539954005401540254035404540554065407540854095410541154125413541454155416541754185419542054215422542354245425542654275428542954305431543254335434543554365437543854395440544154425443544454455446544754485449545054515452545354545455545654575458545954605461546254635464546554665467
  1. <!doctype html>
  2. <html lang="en" class="no-js">
  3. <head>
  4. <meta charset="utf-8">
  5. <meta name="viewport" content="width=device-width,initial-scale=1">
  6. <link rel="prev" href="../yandex-lockbox/">
  7. <link rel="next" href="../github/">
  8. <link rel="icon" href="../../pictures/eso-round-logo.svg">
  9. <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.6">
  10. <title>GitLab Variables - External Secrets Operator</title>
  11. <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
  12. <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
  13. <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
  14. <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
  15. <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
  16. <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
  17. <script id="__analytics">function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-QP38TD8K7V"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-QP38TD8K7V",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-QP38TD8K7V",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script>
  18. <script>"undefined"!=typeof __md_analytics&&__md_analytics()</script>
  19. </head>
  20. <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo">
  21. <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
  22. <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
  23. <label class="md-overlay" for="__drawer"></label>
  24. <div data-md-component="skip">
  25. <a href="#gitlab-variables" class="md-skip">
  26. Skip to content
  27. </a>
  28. </div>
  29. <div data-md-component="announce">
  30. </div>
  31. <div data-md-color-scheme="default" data-md-component="outdated" hidden>
  32. <aside class="md-banner md-banner--warning">
  33. <div class="md-banner__inner md-grid md-typeset">
  34. You're not viewing the latest version.
  35. <a href="../../..">
  36. <strong>Click here to go to latest.</strong>
  37. </a>
  38. </div>
  39. <script>var el=document.querySelector("[data-md-component=outdated]"),base=new URL("../.."),outdated=__md_get("__outdated",sessionStorage,base);!0===outdated&&el&&(el.hidden=!1)</script>
  40. </aside>
  41. </div>
  42. <header class="md-header" data-md-component="header">
  43. <nav class="md-header__inner md-grid" aria-label="Header">
  44. <a href="../.." title="External Secrets Operator" class="md-header__button md-logo" aria-label="External Secrets Operator" data-md-component="logo">
  45. <img src="../../pictures/eso-round-logo.svg" alt="logo">
  46. </a>
  47. <label class="md-header__button md-icon" for="__drawer">
  48. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
  49. </label>
  50. <div class="md-header__title" data-md-component="header-title">
  51. <div class="md-header__ellipsis">
  52. <div class="md-header__topic">
  53. <span class="md-ellipsis">
  54. External Secrets Operator
  55. </span>
  56. </div>
  57. <div class="md-header__topic" data-md-component="header-topic">
  58. <span class="md-ellipsis">
  59. GitLab Variables
  60. </span>
  61. </div>
  62. </div>
  63. </div>
  64. <form class="md-header__option" data-md-component="palette">
  65. <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_0">
  66. <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
  67. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
  68. </label>
  69. <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="indigo" data-md-color-accent="indigo" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_1">
  70. <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_0" hidden>
  71. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
  72. </label>
  73. </form>
  74. <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
  75. <label class="md-header__button md-icon" for="__search">
  76. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
  77. </label>
  78. <div class="md-search" data-md-component="search" role="dialog">
  79. <label class="md-search__overlay" for="__search"></label>
  80. <div class="md-search__inner" role="search">
  81. <form class="md-search__form" name="search">
  82. <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
  83. <label class="md-search__icon md-icon" for="__search">
  84. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
  85. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
  86. </label>
  87. <nav class="md-search__options" aria-label="Search">
  88. <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
  89. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
  90. </button>
  91. </nav>
  92. </form>
  93. <div class="md-search__output">
  94. <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
  95. <div class="md-search-result" data-md-component="search-result">
  96. <div class="md-search-result__meta">
  97. Initializing search
  98. </div>
  99. <ol class="md-search-result__list" role="presentation"></ol>
  100. </div>
  101. </div>
  102. </div>
  103. </div>
  104. </div>
  105. <div class="md-header__source">
  106. <a href="https://github.com/external-secrets/external-secrets" title="Go to repository" class="md-source" data-md-component="source">
  107. <div class="md-source__icon md-icon">
  108. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M439.6 236.1 244 40.5c-5.4-5.5-12.8-8.5-20.4-8.5s-15 3-20.4 8.4L162.5 81l51.5 51.5c27.1-9.1 52.7 16.8 43.4 43.7l49.7 49.7c34.2-11.8 61.2 31 35.5 56.7-26.5 26.5-70.2-2.9-56-37.3L240.3 199v121.9c25.3 12.5 22.3 41.8 9.1 55-6.4 6.4-15.2 10.1-24.3 10.1s-17.8-3.6-24.3-10.1c-17.6-17.6-11.1-46.9 11.2-56v-123c-20.8-8.5-24.6-30.7-18.6-45L142.6 101 8.5 235.1C3 240.6 0 247.9 0 255.5s3 15 8.5 20.4l195.6 195.7c5.4 5.4 12.7 8.4 20.4 8.4s15-3 20.4-8.4l194.7-194.7c5.4-5.4 8.4-12.8 8.4-20.4s-3-15-8.4-20.4"/></svg>
  109. </div>
  110. <div class="md-source__repository">
  111. External Secrets Operator
  112. </div>
  113. </a>
  114. </div>
  115. </nav>
  116. </header>
  117. <div class="md-container" data-md-component="container">
  118. <nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
  119. <div class="md-grid">
  120. <ul class="md-tabs__list">
  121. <li class="md-tabs__item">
  122. <a href="../.." class="md-tabs__link">
  123. Introduction
  124. </a>
  125. </li>
  126. <li class="md-tabs__item">
  127. <a href="../../api/components/" class="md-tabs__link">
  128. API
  129. </a>
  130. </li>
  131. <li class="md-tabs__item">
  132. <a href="../../guides/introduction/" class="md-tabs__link">
  133. Guides
  134. </a>
  135. </li>
  136. <li class="md-tabs__item md-tabs__item--active">
  137. <a href="../aws-secrets-manager/" class="md-tabs__link">
  138. Provider
  139. </a>
  140. </li>
  141. <li class="md-tabs__item">
  142. <a href="../../examples/gitops-using-fluxcd/" class="md-tabs__link">
  143. Examples
  144. </a>
  145. </li>
  146. <li class="md-tabs__item">
  147. <a href="../../contributing/devguide/" class="md-tabs__link">
  148. Community
  149. </a>
  150. </li>
  151. </ul>
  152. </div>
  153. </nav>
  154. <main class="md-main" data-md-component="main">
  155. <div class="md-main__inner md-grid">
  156. <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
  157. <div class="md-sidebar__scrollwrap">
  158. <div class="md-sidebar__inner">
  159. <nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
  160. <label class="md-nav__title" for="__drawer">
  161. <a href="../.." title="External Secrets Operator" class="md-nav__button md-logo" aria-label="External Secrets Operator" data-md-component="logo">
  162. <img src="../../pictures/eso-round-logo.svg" alt="logo">
  163. </a>
  164. External Secrets Operator
  165. </label>
  166. <div class="md-nav__source">
  167. <a href="https://github.com/external-secrets/external-secrets" title="Go to repository" class="md-source" data-md-component="source">
  168. <div class="md-source__icon md-icon">
  169. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M439.6 236.1 244 40.5c-5.4-5.5-12.8-8.5-20.4-8.5s-15 3-20.4 8.4L162.5 81l51.5 51.5c27.1-9.1 52.7 16.8 43.4 43.7l49.7 49.7c34.2-11.8 61.2 31 35.5 56.7-26.5 26.5-70.2-2.9-56-37.3L240.3 199v121.9c25.3 12.5 22.3 41.8 9.1 55-6.4 6.4-15.2 10.1-24.3 10.1s-17.8-3.6-24.3-10.1c-17.6-17.6-11.1-46.9 11.2-56v-123c-20.8-8.5-24.6-30.7-18.6-45L142.6 101 8.5 235.1C3 240.6 0 247.9 0 255.5s3 15 8.5 20.4l195.6 195.7c5.4 5.4 12.7 8.4 20.4 8.4s15-3 20.4-8.4l194.7-194.7c5.4-5.4 8.4-12.8 8.4-20.4s-3-15-8.4-20.4"/></svg>
  170. </div>
  171. <div class="md-source__repository">
  172. External Secrets Operator
  173. </div>
  174. </a>
  175. </div>
  176. <ul class="md-nav__list" data-md-scrollfix>
  177. <li class="md-nav__item md-nav__item--nested">
  178. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_1" >
  179. <div class="md-nav__link md-nav__container">
  180. <a href="../.." class="md-nav__link ">
  181. <span class="md-ellipsis">
  182. Introduction
  183. </span>
  184. </a>
  185. <label class="md-nav__link " for="__nav_1" id="__nav_1_label" tabindex="0">
  186. <span class="md-nav__icon md-icon"></span>
  187. </label>
  188. </div>
  189. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_1_label" aria-expanded="false">
  190. <label class="md-nav__title" for="__nav_1">
  191. <span class="md-nav__icon md-icon"></span>
  192. Introduction
  193. </label>
  194. <ul class="md-nav__list" data-md-scrollfix>
  195. <li class="md-nav__item">
  196. <a href="../../introduction/overview/" class="md-nav__link">
  197. <span class="md-ellipsis">
  198. Overview
  199. </span>
  200. </a>
  201. </li>
  202. <li class="md-nav__item">
  203. <a href="../../introduction/glossary/" class="md-nav__link">
  204. <span class="md-ellipsis">
  205. Glossary
  206. </span>
  207. </a>
  208. </li>
  209. <li class="md-nav__item">
  210. <a href="../../introduction/prerequisites/" class="md-nav__link">
  211. <span class="md-ellipsis">
  212. Prerequisites
  213. </span>
  214. </a>
  215. </li>
  216. <li class="md-nav__item">
  217. <a href="../../introduction/getting-started/" class="md-nav__link">
  218. <span class="md-ellipsis">
  219. Getting started
  220. </span>
  221. </a>
  222. </li>
  223. <li class="md-nav__item">
  224. <a href="../../introduction/faq/" class="md-nav__link">
  225. <span class="md-ellipsis">
  226. FAQ
  227. </span>
  228. </a>
  229. </li>
  230. <li class="md-nav__item">
  231. <a href="../../introduction/stability-support/" class="md-nav__link">
  232. <span class="md-ellipsis">
  233. Stability and Support
  234. </span>
  235. </a>
  236. </li>
  237. <li class="md-nav__item">
  238. <a href="../../introduction/deprecation-policy/" class="md-nav__link">
  239. <span class="md-ellipsis">
  240. Deprecation Policy
  241. </span>
  242. </a>
  243. </li>
  244. </ul>
  245. </nav>
  246. </li>
  247. <li class="md-nav__item md-nav__item--nested">
  248. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
  249. <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
  250. <span class="md-ellipsis">
  251. API
  252. </span>
  253. <span class="md-nav__icon md-icon"></span>
  254. </label>
  255. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
  256. <label class="md-nav__title" for="__nav_2">
  257. <span class="md-nav__icon md-icon"></span>
  258. API
  259. </label>
  260. <ul class="md-nav__list" data-md-scrollfix>
  261. <li class="md-nav__item">
  262. <a href="../../api/components/" class="md-nav__link">
  263. <span class="md-ellipsis">
  264. Components
  265. </span>
  266. </a>
  267. </li>
  268. <li class="md-nav__item md-nav__item--nested">
  269. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_2" >
  270. <label class="md-nav__link" for="__nav_2_2" id="__nav_2_2_label" tabindex="0">
  271. <span class="md-ellipsis">
  272. Core Resources
  273. </span>
  274. <span class="md-nav__icon md-icon"></span>
  275. </label>
  276. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_2_label" aria-expanded="false">
  277. <label class="md-nav__title" for="__nav_2_2">
  278. <span class="md-nav__icon md-icon"></span>
  279. Core Resources
  280. </label>
  281. <ul class="md-nav__list" data-md-scrollfix>
  282. <li class="md-nav__item">
  283. <a href="../../api/externalsecret/" class="md-nav__link">
  284. <span class="md-ellipsis">
  285. ExternalSecret
  286. </span>
  287. </a>
  288. </li>
  289. <li class="md-nav__item">
  290. <a href="../../api/secretstore/" class="md-nav__link">
  291. <span class="md-ellipsis">
  292. SecretStore
  293. </span>
  294. </a>
  295. </li>
  296. <li class="md-nav__item">
  297. <a href="../../api/clustersecretstore/" class="md-nav__link">
  298. <span class="md-ellipsis">
  299. ClusterSecretStore
  300. </span>
  301. </a>
  302. </li>
  303. <li class="md-nav__item">
  304. <a href="../../api/clusterexternalsecret/" class="md-nav__link">
  305. <span class="md-ellipsis">
  306. ClusterExternalSecret
  307. </span>
  308. </a>
  309. </li>
  310. <li class="md-nav__item">
  311. <a href="../../api/clusterpushsecret/" class="md-nav__link">
  312. <span class="md-ellipsis">
  313. ClusterPushSecret
  314. </span>
  315. </a>
  316. </li>
  317. <li class="md-nav__item">
  318. <a href="../../api/pushsecret/" class="md-nav__link">
  319. <span class="md-ellipsis">
  320. PushSecret
  321. </span>
  322. </a>
  323. </li>
  324. </ul>
  325. </nav>
  326. </li>
  327. <li class="md-nav__item md-nav__item--nested">
  328. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_3" >
  329. <div class="md-nav__link md-nav__container">
  330. <a href="../../api/generator/" class="md-nav__link ">
  331. <span class="md-ellipsis">
  332. Generators
  333. </span>
  334. </a>
  335. <label class="md-nav__link " for="__nav_2_3" id="__nav_2_3_label" tabindex="0">
  336. <span class="md-nav__icon md-icon"></span>
  337. </label>
  338. </div>
  339. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_3_label" aria-expanded="false">
  340. <label class="md-nav__title" for="__nav_2_3">
  341. <span class="md-nav__icon md-icon"></span>
  342. Generators
  343. </label>
  344. <ul class="md-nav__list" data-md-scrollfix>
  345. <li class="md-nav__item">
  346. <a href="../../api/generator/acr/" class="md-nav__link">
  347. <span class="md-ellipsis">
  348. Azure Container Registry
  349. </span>
  350. </a>
  351. </li>
  352. <li class="md-nav__item">
  353. <a href="../../api/generator/ecr/" class="md-nav__link">
  354. <span class="md-ellipsis">
  355. AWS Elastic Container Registry
  356. </span>
  357. </a>
  358. </li>
  359. <li class="md-nav__item">
  360. <a href="../../api/generator/sts/" class="md-nav__link">
  361. <span class="md-ellipsis">
  362. AWS STS Session Token
  363. </span>
  364. </a>
  365. </li>
  366. <li class="md-nav__item">
  367. <a href="../../api/generator/cloudsmith/" class="md-nav__link">
  368. <span class="md-ellipsis">
  369. Cloudsmith
  370. </span>
  371. </a>
  372. </li>
  373. <li class="md-nav__item">
  374. <a href="../../api/generator/cluster/" class="md-nav__link">
  375. <span class="md-ellipsis">
  376. Cluster Generator
  377. </span>
  378. </a>
  379. </li>
  380. <li class="md-nav__item">
  381. <a href="../../api/generator/gcr/" class="md-nav__link">
  382. <span class="md-ellipsis">
  383. Google Container Registry
  384. </span>
  385. </a>
  386. </li>
  387. <li class="md-nav__item">
  388. <a href="../../api/generator/grafana/" class="md-nav__link">
  389. <span class="md-ellipsis">
  390. Grafana
  391. </span>
  392. </a>
  393. </li>
  394. <li class="md-nav__item">
  395. <a href="../../api/generator/quay/" class="md-nav__link">
  396. <span class="md-ellipsis">
  397. Quay
  398. </span>
  399. </a>
  400. </li>
  401. <li class="md-nav__item">
  402. <a href="../../api/generator/vault/" class="md-nav__link">
  403. <span class="md-ellipsis">
  404. Vault Dynamic Secret
  405. </span>
  406. </a>
  407. </li>
  408. <li class="md-nav__item">
  409. <a href="../../api/generator/password/" class="md-nav__link">
  410. <span class="md-ellipsis">
  411. Password
  412. </span>
  413. </a>
  414. </li>
  415. <li class="md-nav__item">
  416. <a href="../../api/generator/fake/" class="md-nav__link">
  417. <span class="md-ellipsis">
  418. Fake
  419. </span>
  420. </a>
  421. </li>
  422. <li class="md-nav__item">
  423. <a href="../../api/generator/webhook/" class="md-nav__link">
  424. <span class="md-ellipsis">
  425. Webhook
  426. </span>
  427. </a>
  428. </li>
  429. <li class="md-nav__item">
  430. <a href="../../api/generator/github/" class="md-nav__link">
  431. <span class="md-ellipsis">
  432. Github
  433. </span>
  434. </a>
  435. </li>
  436. <li class="md-nav__item">
  437. <a href="../../api/generator/uuid/" class="md-nav__link">
  438. <span class="md-ellipsis">
  439. UUID
  440. </span>
  441. </a>
  442. </li>
  443. <li class="md-nav__item">
  444. <a href="../../api/generator/mfa/" class="md-nav__link">
  445. <span class="md-ellipsis">
  446. MFA
  447. </span>
  448. </a>
  449. </li>
  450. <li class="md-nav__item">
  451. <a href="../../api/generator/sshkey/" class="md-nav__link">
  452. <span class="md-ellipsis">
  453. SSHKey
  454. </span>
  455. </a>
  456. </li>
  457. </ul>
  458. </nav>
  459. </li>
  460. <li class="md-nav__item md-nav__item--nested">
  461. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_4" >
  462. <label class="md-nav__link" for="__nav_2_4" id="__nav_2_4_label" tabindex="0">
  463. <span class="md-ellipsis">
  464. Reference Docs
  465. </span>
  466. <span class="md-nav__icon md-icon"></span>
  467. </label>
  468. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_4_label" aria-expanded="false">
  469. <label class="md-nav__title" for="__nav_2_4">
  470. <span class="md-nav__icon md-icon"></span>
  471. Reference Docs
  472. </label>
  473. <ul class="md-nav__list" data-md-scrollfix>
  474. <li class="md-nav__item">
  475. <a href="../../api/spec/" class="md-nav__link">
  476. <span class="md-ellipsis">
  477. API specification
  478. </span>
  479. </a>
  480. </li>
  481. <li class="md-nav__item">
  482. <a href="../../api/controller-options/" class="md-nav__link">
  483. <span class="md-ellipsis">
  484. Controller Options
  485. </span>
  486. </a>
  487. </li>
  488. <li class="md-nav__item">
  489. <a href="../../api/metrics/" class="md-nav__link">
  490. <span class="md-ellipsis">
  491. Metrics
  492. </span>
  493. </a>
  494. </li>
  495. <li class="md-nav__item">
  496. <a href="../../api/selectable-fields/" class="md-nav__link">
  497. <span class="md-ellipsis">
  498. Selectable Fields
  499. </span>
  500. </a>
  501. </li>
  502. </ul>
  503. </nav>
  504. </li>
  505. </ul>
  506. </nav>
  507. </li>
  508. <li class="md-nav__item md-nav__item--nested">
  509. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
  510. <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
  511. <span class="md-ellipsis">
  512. Guides
  513. </span>
  514. <span class="md-nav__icon md-icon"></span>
  515. </label>
  516. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
  517. <label class="md-nav__title" for="__nav_3">
  518. <span class="md-nav__icon md-icon"></span>
  519. Guides
  520. </label>
  521. <ul class="md-nav__list" data-md-scrollfix>
  522. <li class="md-nav__item">
  523. <a href="../../guides/introduction/" class="md-nav__link">
  524. <span class="md-ellipsis">
  525. Introduction
  526. </span>
  527. </a>
  528. </li>
  529. <li class="md-nav__item md-nav__item--nested">
  530. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_2" >
  531. <label class="md-nav__link" for="__nav_3_2" id="__nav_3_2_label" tabindex="0">
  532. <span class="md-ellipsis">
  533. External Secrets
  534. </span>
  535. <span class="md-nav__icon md-icon"></span>
  536. </label>
  537. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_2_label" aria-expanded="false">
  538. <label class="md-nav__title" for="__nav_3_2">
  539. <span class="md-nav__icon md-icon"></span>
  540. External Secrets
  541. </label>
  542. <ul class="md-nav__list" data-md-scrollfix>
  543. <li class="md-nav__item">
  544. <a href="../../guides/all-keys-one-secret/" class="md-nav__link">
  545. <span class="md-ellipsis">
  546. Extract structured data
  547. </span>
  548. </a>
  549. </li>
  550. <li class="md-nav__item">
  551. <a href="../../guides/getallsecrets/" class="md-nav__link">
  552. <span class="md-ellipsis">
  553. Find Secrets by Name or Metadata
  554. </span>
  555. </a>
  556. </li>
  557. <li class="md-nav__item">
  558. <a href="../../guides/datafrom-rewrite/" class="md-nav__link">
  559. <span class="md-ellipsis">
  560. Rewriting Keys
  561. </span>
  562. </a>
  563. </li>
  564. <li class="md-nav__item md-nav__item--nested">
  565. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_2_4" >
  566. <label class="md-nav__link" for="__nav_3_2_4" id="__nav_3_2_4_label" tabindex="0">
  567. <span class="md-ellipsis">
  568. Advanced Templating
  569. </span>
  570. <span class="md-nav__icon md-icon"></span>
  571. </label>
  572. <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_3_2_4_label" aria-expanded="false">
  573. <label class="md-nav__title" for="__nav_3_2_4">
  574. <span class="md-nav__icon md-icon"></span>
  575. Advanced Templating
  576. </label>
  577. <ul class="md-nav__list" data-md-scrollfix>
  578. <li class="md-nav__item">
  579. <a href="../../guides/templating/" class="md-nav__link">
  580. <span class="md-ellipsis">
  581. v2
  582. </span>
  583. </a>
  584. </li>
  585. <li class="md-nav__item">
  586. <a href="../../guides/templating-v1/" class="md-nav__link">
  587. <span class="md-ellipsis">
  588. v1
  589. </span>
  590. </a>
  591. </li>
  592. </ul>
  593. </nav>
  594. </li>
  595. <li class="md-nav__item">
  596. <a href="../../guides/common-k8s-secret-types/" class="md-nav__link">
  597. <span class="md-ellipsis">
  598. Kubernetes Secret Types
  599. </span>
  600. </a>
  601. </li>
  602. <li class="md-nav__item">
  603. <a href="../../guides/ownership-deletion-policy/" class="md-nav__link">
  604. <span class="md-ellipsis">
  605. Lifecycle: ownership & deletion
  606. </span>
  607. </a>
  608. </li>
  609. <li class="md-nav__item">
  610. <a href="../../guides/decoding-strategy/" class="md-nav__link">
  611. <span class="md-ellipsis">
  612. Decoding Strategies
  613. </span>
  614. </a>
  615. </li>
  616. <li class="md-nav__item">
  617. <a href="../../guides/controller-class/" class="md-nav__link">
  618. <span class="md-ellipsis">
  619. Controller Classes
  620. </span>
  621. </a>
  622. </li>
  623. </ul>
  624. </nav>
  625. </li>
  626. <li class="md-nav__item">
  627. <a href="../../guides/targeting-custom-resources/" class="md-nav__link">
  628. <span class="md-ellipsis">
  629. Targeting Custom Resources
  630. </span>
  631. </a>
  632. </li>
  633. <li class="md-nav__item">
  634. <a href="../../guides/generator/" class="md-nav__link">
  635. <span class="md-ellipsis">
  636. Generators
  637. </span>
  638. </a>
  639. </li>
  640. <li class="md-nav__item">
  641. <a href="../../guides/pushsecrets/" class="md-nav__link">
  642. <span class="md-ellipsis">
  643. Push Secrets
  644. </span>
  645. </a>
  646. </li>
  647. <li class="md-nav__item md-nav__item--nested">
  648. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_6" >
  649. <label class="md-nav__link" for="__nav_3_6" id="__nav_3_6_label" tabindex="0">
  650. <span class="md-ellipsis">
  651. Operations
  652. </span>
  653. <span class="md-nav__icon md-icon"></span>
  654. </label>
  655. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_6_label" aria-expanded="false">
  656. <label class="md-nav__title" for="__nav_3_6">
  657. <span class="md-nav__icon md-icon"></span>
  658. Operations
  659. </label>
  660. <ul class="md-nav__list" data-md-scrollfix>
  661. <li class="md-nav__item">
  662. <a href="../../guides/multi-tenancy/" class="md-nav__link">
  663. <span class="md-ellipsis">
  664. Multi Tenancy
  665. </span>
  666. </a>
  667. </li>
  668. <li class="md-nav__item">
  669. <a href="../../guides/security-best-practices/" class="md-nav__link">
  670. <span class="md-ellipsis">
  671. Security Best Practices
  672. </span>
  673. </a>
  674. </li>
  675. <li class="md-nav__item">
  676. <a href="../../guides/threat-model/" class="md-nav__link">
  677. <span class="md-ellipsis">
  678. Threat Model
  679. </span>
  680. </a>
  681. </li>
  682. <li class="md-nav__item">
  683. <a href="../../guides/v1beta1/" class="md-nav__link">
  684. <span class="md-ellipsis">
  685. Upgrading to v1beta1
  686. </span>
  687. </a>
  688. </li>
  689. <li class="md-nav__item">
  690. <a href="../../guides/using-latest-image/" class="md-nav__link">
  691. <span class="md-ellipsis">
  692. Using Latest Image
  693. </span>
  694. </a>
  695. </li>
  696. <li class="md-nav__item">
  697. <a href="../../guides/disable-cluster-features/" class="md-nav__link">
  698. <span class="md-ellipsis">
  699. Disable Cluster Features
  700. </span>
  701. </a>
  702. </li>
  703. </ul>
  704. </nav>
  705. </li>
  706. <li class="md-nav__item md-nav__item--nested">
  707. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_7" >
  708. <label class="md-nav__link" for="__nav_3_7" id="__nav_3_7_label" tabindex="0">
  709. <span class="md-ellipsis">
  710. Tooling
  711. </span>
  712. <span class="md-nav__icon md-icon"></span>
  713. </label>
  714. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_7_label" aria-expanded="false">
  715. <label class="md-nav__title" for="__nav_3_7">
  716. <span class="md-nav__icon md-icon"></span>
  717. Tooling
  718. </label>
  719. <ul class="md-nav__list" data-md-scrollfix>
  720. <li class="md-nav__item">
  721. <a href="../../guides/using-esoctl-tool/" class="md-nav__link">
  722. <span class="md-ellipsis">
  723. Using the esoctl tool
  724. </span>
  725. </a>
  726. </li>
  727. </ul>
  728. </nav>
  729. </li>
  730. </ul>
  731. </nav>
  732. </li>
  733. <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
  734. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" checked>
  735. <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="">
  736. <span class="md-ellipsis">
  737. Provider
  738. </span>
  739. <span class="md-nav__icon md-icon"></span>
  740. </label>
  741. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="true">
  742. <label class="md-nav__title" for="__nav_4">
  743. <span class="md-nav__icon md-icon"></span>
  744. Provider
  745. </label>
  746. <ul class="md-nav__list" data-md-scrollfix>
  747. <li class="md-nav__item">
  748. <a href="../aws-secrets-manager/" class="md-nav__link">
  749. <span class="md-ellipsis">
  750. AWS Secrets Manager
  751. </span>
  752. </a>
  753. </li>
  754. <li class="md-nav__item">
  755. <a href="../aws-parameter-store/" class="md-nav__link">
  756. <span class="md-ellipsis">
  757. AWS Parameter Store
  758. </span>
  759. </a>
  760. </li>
  761. <li class="md-nav__item">
  762. <a href="../aws-access/" class="md-nav__link">
  763. <span class="md-ellipsis">
  764. AWS Access
  765. </span>
  766. </a>
  767. </li>
  768. <li class="md-nav__item">
  769. <a href="../azure-key-vault/" class="md-nav__link">
  770. <span class="md-ellipsis">
  771. Azure Key Vault
  772. </span>
  773. </a>
  774. </li>
  775. <li class="md-nav__item">
  776. <a href="../barbican/" class="md-nav__link">
  777. <span class="md-ellipsis">
  778. Barbican
  779. </span>
  780. </a>
  781. </li>
  782. <li class="md-nav__item">
  783. <a href="../beyondtrust/" class="md-nav__link">
  784. <span class="md-ellipsis">
  785. BeyondTrust
  786. </span>
  787. </a>
  788. </li>
  789. <li class="md-nav__item">
  790. <a href="../bitwarden-secrets-manager/" class="md-nav__link">
  791. <span class="md-ellipsis">
  792. Bitwarden Secrets Manager
  793. </span>
  794. </a>
  795. </li>
  796. <li class="md-nav__item">
  797. <a href="../chef/" class="md-nav__link">
  798. <span class="md-ellipsis">
  799. Chef
  800. </span>
  801. </a>
  802. </li>
  803. <li class="md-nav__item">
  804. <a href="../cloudru/" class="md-nav__link">
  805. <span class="md-ellipsis">
  806. Cloud.ru Secret Manager
  807. </span>
  808. </a>
  809. </li>
  810. <li class="md-nav__item">
  811. <a href="../conjur/" class="md-nav__link">
  812. <span class="md-ellipsis">
  813. CyberArk Conjur
  814. </span>
  815. </a>
  816. </li>
  817. <li class="md-nav__item">
  818. <a href="../google-secrets-manager/" class="md-nav__link">
  819. <span class="md-ellipsis">
  820. Google Cloud Secret Manager
  821. </span>
  822. </a>
  823. </li>
  824. <li class="md-nav__item">
  825. <a href="../hashicorp-vault/" class="md-nav__link">
  826. <span class="md-ellipsis">
  827. HashiCorp Vault
  828. </span>
  829. </a>
  830. </li>
  831. <li class="md-nav__item">
  832. <a href="../kubernetes/" class="md-nav__link">
  833. <span class="md-ellipsis">
  834. Kubernetes
  835. </span>
  836. </a>
  837. </li>
  838. <li class="md-nav__item">
  839. <a href="../ibm-secrets-manager/" class="md-nav__link">
  840. <span class="md-ellipsis">
  841. IBM Secrets Manager
  842. </span>
  843. </a>
  844. </li>
  845. <li class="md-nav__item">
  846. <a href="../akeyless/" class="md-nav__link">
  847. <span class="md-ellipsis">
  848. Akeyless
  849. </span>
  850. </a>
  851. </li>
  852. <li class="md-nav__item">
  853. <a href="../yandex-certificate-manager/" class="md-nav__link">
  854. <span class="md-ellipsis">
  855. Yandex Certificate Manager
  856. </span>
  857. </a>
  858. </li>
  859. <li class="md-nav__item">
  860. <a href="../yandex-lockbox/" class="md-nav__link">
  861. <span class="md-ellipsis">
  862. Yandex Lockbox
  863. </span>
  864. </a>
  865. </li>
  866. <li class="md-nav__item md-nav__item--active">
  867. <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
  868. <label class="md-nav__link md-nav__link--active" for="__toc">
  869. <span class="md-ellipsis">
  870. GitLab Variables
  871. </span>
  872. <span class="md-nav__icon md-icon"></span>
  873. </label>
  874. <a href="./" class="md-nav__link md-nav__link--active">
  875. <span class="md-ellipsis">
  876. GitLab Variables
  877. </span>
  878. </a>
  879. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  880. <label class="md-nav__title" for="__toc">
  881. <span class="md-nav__icon md-icon"></span>
  882. Table of contents
  883. </label>
  884. <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
  885. <li class="md-nav__item">
  886. <a href="#gitlab-variables" class="md-nav__link">
  887. <span class="md-ellipsis">
  888. GitLab Variables
  889. </span>
  890. </a>
  891. <nav class="md-nav" aria-label="GitLab Variables">
  892. <ul class="md-nav__list">
  893. <li class="md-nav__item">
  894. <a href="#configuring-gitlab" class="md-nav__link">
  895. <span class="md-ellipsis">
  896. Configuring GitLab
  897. </span>
  898. </a>
  899. </li>
  900. <li class="md-nav__item">
  901. <a href="#access-token-secret" class="md-nav__link">
  902. <span class="md-ellipsis">
  903. Access Token secret
  904. </span>
  905. </a>
  906. </li>
  907. <li class="md-nav__item">
  908. <a href="#configuring-the-secret-store" class="md-nav__link">
  909. <span class="md-ellipsis">
  910. Configuring the secret store
  911. </span>
  912. </a>
  913. <nav class="md-nav" aria-label="Configuring the secret store">
  914. <ul class="md-nav__list">
  915. <li class="md-nav__item">
  916. <a href="#environment-scope-fallback-behavior" class="md-nav__link">
  917. <span class="md-ellipsis">
  918. Environment Scope Fallback Behavior
  919. </span>
  920. </a>
  921. </li>
  922. <li class="md-nav__item">
  923. <a href="#custom-tls-certificates" class="md-nav__link">
  924. <span class="md-ellipsis">
  925. Custom TLS certificates
  926. </span>
  927. </a>
  928. </li>
  929. </ul>
  930. </nav>
  931. </li>
  932. <li class="md-nav__item">
  933. <a href="#creating-external-secret" class="md-nav__link">
  934. <span class="md-ellipsis">
  935. Creating external secret
  936. </span>
  937. </a>
  938. <nav class="md-nav" aria-label="Creating external secret">
  939. <ul class="md-nav__list">
  940. <li class="md-nav__item">
  941. <a href="#key-normalisation" class="md-nav__link">
  942. <span class="md-ellipsis">
  943. Key normalisation
  944. </span>
  945. </a>
  946. </li>
  947. <li class="md-nav__item">
  948. <a href="#extracting-a-json-sub-key-with-remoterefproperty" class="md-nav__link">
  949. <span class="md-ellipsis">
  950. Extracting a JSON sub-key with remoteRef.property
  951. </span>
  952. </a>
  953. </li>
  954. <li class="md-nav__item">
  955. <a href="#using-datafrom" class="md-nav__link">
  956. <span class="md-ellipsis">
  957. Using DataFrom
  958. </span>
  959. </a>
  960. </li>
  961. </ul>
  962. </nav>
  963. </li>
  964. <li class="md-nav__item">
  965. <a href="#getting-the-kubernetes-secret" class="md-nav__link">
  966. <span class="md-ellipsis">
  967. Getting the Kubernetes secret
  968. </span>
  969. </a>
  970. </li>
  971. </ul>
  972. </nav>
  973. </li>
  974. </ul>
  975. </nav>
  976. </li>
  977. <li class="md-nav__item">
  978. <a href="../github/" class="md-nav__link">
  979. <span class="md-ellipsis">
  980. Github Actions Secrets
  981. </span>
  982. </a>
  983. </li>
  984. <li class="md-nav__item">
  985. <a href="../oracle-vault/" class="md-nav__link">
  986. <span class="md-ellipsis">
  987. Oracle Vault
  988. </span>
  989. </a>
  990. </li>
  991. <li class="md-nav__item">
  992. <a href="../ovhcloud/" class="md-nav__link">
  993. <span class="md-ellipsis">
  994. OVHcloud
  995. </span>
  996. </a>
  997. </li>
  998. <li class="md-nav__item">
  999. <a href="../1password-automation/" class="md-nav__link">
  1000. <span class="md-ellipsis">
  1001. 1Password Connect Server
  1002. </span>
  1003. </a>
  1004. </li>
  1005. <li class="md-nav__item">
  1006. <a href="../1password-sdk/" class="md-nav__link">
  1007. <span class="md-ellipsis">
  1008. 1Password SDK
  1009. </span>
  1010. </a>
  1011. </li>
  1012. <li class="md-nav__item">
  1013. <a href="../webhook/" class="md-nav__link">
  1014. <span class="md-ellipsis">
  1015. Webhook
  1016. </span>
  1017. </a>
  1018. </li>
  1019. <li class="md-nav__item">
  1020. <a href="../fake/" class="md-nav__link">
  1021. <span class="md-ellipsis">
  1022. Fake
  1023. </span>
  1024. </a>
  1025. </li>
  1026. <li class="md-nav__item">
  1027. <a href="../senhasegura-dsm/" class="md-nav__link">
  1028. <span class="md-ellipsis">
  1029. senhasegura DevOps Secrets Management (DSM)
  1030. </span>
  1031. </a>
  1032. </li>
  1033. <li class="md-nav__item">
  1034. <a href="../doppler/" class="md-nav__link">
  1035. <span class="md-ellipsis">
  1036. Doppler
  1037. </span>
  1038. </a>
  1039. </li>
  1040. <li class="md-nav__item">
  1041. <a href="../keeper-security/" class="md-nav__link">
  1042. <span class="md-ellipsis">
  1043. Keeper Security
  1044. </span>
  1045. </a>
  1046. </li>
  1047. <li class="md-nav__item">
  1048. <a href="../cloak/" class="md-nav__link">
  1049. <span class="md-ellipsis">
  1050. Cloak End 2 End Encrypted Secrets
  1051. </span>
  1052. </a>
  1053. </li>
  1054. <li class="md-nav__item">
  1055. <a href="../scaleway/" class="md-nav__link">
  1056. <span class="md-ellipsis">
  1057. Scaleway
  1058. </span>
  1059. </a>
  1060. </li>
  1061. <li class="md-nav__item">
  1062. <a href="../delinea/" class="md-nav__link">
  1063. <span class="md-ellipsis">
  1064. Delinea
  1065. </span>
  1066. </a>
  1067. </li>
  1068. <li class="md-nav__item">
  1069. <a href="../secretserver/" class="md-nav__link">
  1070. <span class="md-ellipsis">
  1071. Secret Server
  1072. </span>
  1073. </a>
  1074. </li>
  1075. <li class="md-nav__item">
  1076. <a href="../passbolt/" class="md-nav__link">
  1077. <span class="md-ellipsis">
  1078. Passbolt
  1079. </span>
  1080. </a>
  1081. </li>
  1082. <li class="md-nav__item">
  1083. <a href="../pulumi/" class="md-nav__link">
  1084. <span class="md-ellipsis">
  1085. Pulumi ESC
  1086. </span>
  1087. </a>
  1088. </li>
  1089. <li class="md-nav__item">
  1090. <a href="../onboardbase/" class="md-nav__link">
  1091. <span class="md-ellipsis">
  1092. Onboardbase
  1093. </span>
  1094. </a>
  1095. </li>
  1096. <li class="md-nav__item">
  1097. <a href="../../provider-passworddepot/" class="md-nav__link">
  1098. <span class="md-ellipsis">
  1099. Password Depot
  1100. </span>
  1101. </a>
  1102. </li>
  1103. <li class="md-nav__item">
  1104. <a href="../fortanix/" class="md-nav__link">
  1105. <span class="md-ellipsis">
  1106. Fortanix
  1107. </span>
  1108. </a>
  1109. </li>
  1110. <li class="md-nav__item">
  1111. <a href="../infisical/" class="md-nav__link">
  1112. <span class="md-ellipsis">
  1113. Infisical
  1114. </span>
  1115. </a>
  1116. </li>
  1117. <li class="md-nav__item">
  1118. <a href="../previder/" class="md-nav__link">
  1119. <span class="md-ellipsis">
  1120. Previder
  1121. </span>
  1122. </a>
  1123. </li>
  1124. <li class="md-nav__item">
  1125. <a href="../openbao/" class="md-nav__link">
  1126. <span class="md-ellipsis">
  1127. OpenBao
  1128. </span>
  1129. </a>
  1130. </li>
  1131. <li class="md-nav__item">
  1132. <a href="../volcengine/" class="md-nav__link">
  1133. <span class="md-ellipsis">
  1134. Volcengine
  1135. </span>
  1136. </a>
  1137. </li>
  1138. <li class="md-nav__item">
  1139. <a href="../ngrok/" class="md-nav__link">
  1140. <span class="md-ellipsis">
  1141. ngrok
  1142. </span>
  1143. </a>
  1144. </li>
  1145. <li class="md-nav__item">
  1146. <a href="../devolutions-server/" class="md-nav__link">
  1147. <span class="md-ellipsis">
  1148. Devolutions Server
  1149. </span>
  1150. </a>
  1151. </li>
  1152. <li class="md-nav__item">
  1153. <a href="../nebius-mysterybox/" class="md-nav__link">
  1154. <span class="md-ellipsis">
  1155. Nebius MysteryBox
  1156. </span>
  1157. </a>
  1158. </li>
  1159. </ul>
  1160. </nav>
  1161. </li>
  1162. <li class="md-nav__item md-nav__item--nested">
  1163. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
  1164. <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
  1165. <span class="md-ellipsis">
  1166. Examples
  1167. </span>
  1168. <span class="md-nav__icon md-icon"></span>
  1169. </label>
  1170. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
  1171. <label class="md-nav__title" for="__nav_5">
  1172. <span class="md-nav__icon md-icon"></span>
  1173. Examples
  1174. </label>
  1175. <ul class="md-nav__list" data-md-scrollfix>
  1176. <li class="md-nav__item">
  1177. <a href="../../examples/gitops-using-fluxcd/" class="md-nav__link">
  1178. <span class="md-ellipsis">
  1179. FluxCD
  1180. </span>
  1181. </a>
  1182. </li>
  1183. <li class="md-nav__item">
  1184. <a href="../../examples/anchore-engine-credentials/" class="md-nav__link">
  1185. <span class="md-ellipsis">
  1186. Anchore Engine
  1187. </span>
  1188. </a>
  1189. </li>
  1190. <li class="md-nav__item">
  1191. <a href="../../examples/jenkins-kubernetes-credentials/" class="md-nav__link">
  1192. <span class="md-ellipsis">
  1193. Jenkins
  1194. </span>
  1195. </a>
  1196. </li>
  1197. <li class="md-nav__item">
  1198. <a href="../../examples/bitwarden/" class="md-nav__link">
  1199. <span class="md-ellipsis">
  1200. Bitwarden
  1201. </span>
  1202. </a>
  1203. </li>
  1204. </ul>
  1205. </nav>
  1206. </li>
  1207. <li class="md-nav__item md-nav__item--nested">
  1208. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
  1209. <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
  1210. <span class="md-ellipsis">
  1211. Community
  1212. </span>
  1213. <span class="md-nav__icon md-icon"></span>
  1214. </label>
  1215. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
  1216. <label class="md-nav__title" for="__nav_6">
  1217. <span class="md-nav__icon md-icon"></span>
  1218. Community
  1219. </label>
  1220. <ul class="md-nav__list" data-md-scrollfix>
  1221. <li class="md-nav__item md-nav__item--nested">
  1222. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6_1" >
  1223. <label class="md-nav__link" for="__nav_6_1" id="__nav_6_1_label" tabindex="0">
  1224. <span class="md-ellipsis">
  1225. Contributing
  1226. </span>
  1227. <span class="md-nav__icon md-icon"></span>
  1228. </label>
  1229. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_1_label" aria-expanded="false">
  1230. <label class="md-nav__title" for="__nav_6_1">
  1231. <span class="md-nav__icon md-icon"></span>
  1232. Contributing
  1233. </label>
  1234. <ul class="md-nav__list" data-md-scrollfix>
  1235. <li class="md-nav__item">
  1236. <a href="../../contributing/devguide/" class="md-nav__link">
  1237. <span class="md-ellipsis">
  1238. Developer guide
  1239. </span>
  1240. </a>
  1241. </li>
  1242. <li class="md-nav__item">
  1243. <a href="../../contributing/process/" class="md-nav__link">
  1244. <span class="md-ellipsis">
  1245. Contributing Process
  1246. </span>
  1247. </a>
  1248. </li>
  1249. <li class="md-nav__item">
  1250. <a href="../../contributing/release/" class="md-nav__link">
  1251. <span class="md-ellipsis">
  1252. Release Process
  1253. </span>
  1254. </a>
  1255. </li>
  1256. <li class="md-nav__item">
  1257. <a href="../../contributing/coc/" class="md-nav__link">
  1258. <span class="md-ellipsis">
  1259. Code of Conduct
  1260. </span>
  1261. </a>
  1262. </li>
  1263. <li class="md-nav__item">
  1264. <a href="../../contributing/calendar/" class="md-nav__link">
  1265. <span class="md-ellipsis">
  1266. Community meetings calendar
  1267. </span>
  1268. </a>
  1269. </li>
  1270. <li class="md-nav__item">
  1271. <a href="../../contributing/roadmap/" class="md-nav__link">
  1272. <span class="md-ellipsis">
  1273. Roadmap
  1274. </span>
  1275. </a>
  1276. </li>
  1277. <li class="md-nav__item">
  1278. <a href="../../contributing/burnout-mitigation/" class="md-nav__link">
  1279. <span class="md-ellipsis">
  1280. Burnout Prevention
  1281. </span>
  1282. </a>
  1283. </li>
  1284. <li class="md-nav__item">
  1285. <a href="../../contributing/llm-policy/" class="md-nav__link">
  1286. <span class="md-ellipsis">
  1287. LLM Policy
  1288. </span>
  1289. </a>
  1290. </li>
  1291. </ul>
  1292. </nav>
  1293. </li>
  1294. <li class="md-nav__item md-nav__item--nested">
  1295. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6_2" >
  1296. <label class="md-nav__link" for="__nav_6_2" id="__nav_6_2_label" tabindex="0">
  1297. <span class="md-ellipsis">
  1298. External Resources
  1299. </span>
  1300. <span class="md-nav__icon md-icon"></span>
  1301. </label>
  1302. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_2_label" aria-expanded="false">
  1303. <label class="md-nav__title" for="__nav_6_2">
  1304. <span class="md-nav__icon md-icon"></span>
  1305. External Resources
  1306. </label>
  1307. <ul class="md-nav__list" data-md-scrollfix>
  1308. <li class="md-nav__item">
  1309. <a href="../../eso-talks/" class="md-nav__link">
  1310. <span class="md-ellipsis">
  1311. Talks
  1312. </span>
  1313. </a>
  1314. </li>
  1315. <li class="md-nav__item">
  1316. <a href="../../eso-demos/" class="md-nav__link">
  1317. <span class="md-ellipsis">
  1318. Demos
  1319. </span>
  1320. </a>
  1321. </li>
  1322. <li class="md-nav__item">
  1323. <a href="../../eso-blogs/" class="md-nav__link">
  1324. <span class="md-ellipsis">
  1325. Blogs
  1326. </span>
  1327. </a>
  1328. </li>
  1329. <li class="md-nav__item">
  1330. <a href="../../eso-tools/" class="md-nav__link">
  1331. <span class="md-ellipsis">
  1332. Tools
  1333. </span>
  1334. </a>
  1335. </li>
  1336. </ul>
  1337. </nav>
  1338. </li>
  1339. </ul>
  1340. </nav>
  1341. </li>
  1342. </ul>
  1343. </nav>
  1344. </div>
  1345. </div>
  1346. </div>
  1347. <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
  1348. <div class="md-sidebar__scrollwrap">
  1349. <div class="md-sidebar__inner">
  1350. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  1351. <label class="md-nav__title" for="__toc">
  1352. <span class="md-nav__icon md-icon"></span>
  1353. Table of contents
  1354. </label>
  1355. <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
  1356. <li class="md-nav__item">
  1357. <a href="#gitlab-variables" class="md-nav__link">
  1358. <span class="md-ellipsis">
  1359. GitLab Variables
  1360. </span>
  1361. </a>
  1362. <nav class="md-nav" aria-label="GitLab Variables">
  1363. <ul class="md-nav__list">
  1364. <li class="md-nav__item">
  1365. <a href="#configuring-gitlab" class="md-nav__link">
  1366. <span class="md-ellipsis">
  1367. Configuring GitLab
  1368. </span>
  1369. </a>
  1370. </li>
  1371. <li class="md-nav__item">
  1372. <a href="#access-token-secret" class="md-nav__link">
  1373. <span class="md-ellipsis">
  1374. Access Token secret
  1375. </span>
  1376. </a>
  1377. </li>
  1378. <li class="md-nav__item">
  1379. <a href="#configuring-the-secret-store" class="md-nav__link">
  1380. <span class="md-ellipsis">
  1381. Configuring the secret store
  1382. </span>
  1383. </a>
  1384. <nav class="md-nav" aria-label="Configuring the secret store">
  1385. <ul class="md-nav__list">
  1386. <li class="md-nav__item">
  1387. <a href="#environment-scope-fallback-behavior" class="md-nav__link">
  1388. <span class="md-ellipsis">
  1389. Environment Scope Fallback Behavior
  1390. </span>
  1391. </a>
  1392. </li>
  1393. <li class="md-nav__item">
  1394. <a href="#custom-tls-certificates" class="md-nav__link">
  1395. <span class="md-ellipsis">
  1396. Custom TLS certificates
  1397. </span>
  1398. </a>
  1399. </li>
  1400. </ul>
  1401. </nav>
  1402. </li>
  1403. <li class="md-nav__item">
  1404. <a href="#creating-external-secret" class="md-nav__link">
  1405. <span class="md-ellipsis">
  1406. Creating external secret
  1407. </span>
  1408. </a>
  1409. <nav class="md-nav" aria-label="Creating external secret">
  1410. <ul class="md-nav__list">
  1411. <li class="md-nav__item">
  1412. <a href="#key-normalisation" class="md-nav__link">
  1413. <span class="md-ellipsis">
  1414. Key normalisation
  1415. </span>
  1416. </a>
  1417. </li>
  1418. <li class="md-nav__item">
  1419. <a href="#extracting-a-json-sub-key-with-remoterefproperty" class="md-nav__link">
  1420. <span class="md-ellipsis">
  1421. Extracting a JSON sub-key with remoteRef.property
  1422. </span>
  1423. </a>
  1424. </li>
  1425. <li class="md-nav__item">
  1426. <a href="#using-datafrom" class="md-nav__link">
  1427. <span class="md-ellipsis">
  1428. Using DataFrom
  1429. </span>
  1430. </a>
  1431. </li>
  1432. </ul>
  1433. </nav>
  1434. </li>
  1435. <li class="md-nav__item">
  1436. <a href="#getting-the-kubernetes-secret" class="md-nav__link">
  1437. <span class="md-ellipsis">
  1438. Getting the Kubernetes secret
  1439. </span>
  1440. </a>
  1441. </li>
  1442. </ul>
  1443. </nav>
  1444. </li>
  1445. </ul>
  1446. </nav>
  1447. </div>
  1448. </div>
  1449. </div>
  1450. <div class="md-content" data-md-component="content">
  1451. <article class="md-content__inner md-typeset">
  1452. <h1>GitLab Variables</h1>
  1453. <h2 id="gitlab-variables">GitLab Variables</h2>
  1454. <p>External Secrets Operator integrates with GitLab to sync <a href="https://docs.gitlab.com/ee/api/project_level_variables.html">GitLab Project Variables API</a> and/or <a href="https://docs.gitlab.com/ee/api/group_level_variables.html">GitLab Group Variables API</a> to secrets held on the Kubernetes cluster.</p>
  1455. <blockquote>
  1456. <p><strong>Note</strong>: The GitLab provider is read-only. PushSecret is not supported.</p>
  1457. </blockquote>
  1458. <h3 id="configuring-gitlab">Configuring GitLab</h3>
  1459. <p>The GitLab API requires an access token, project ID and/or groupIDs.</p>
  1460. <p>To create a new access token, go to your user settings and select 'access tokens'. Give your token a name, expiration date, and select the permissions required (Note 'api' is required).</p>
  1461. <p><img alt="token-details" src="../../pictures/screenshot_gitlab_token.png" /></p>
  1462. <p>Click 'Create personal access token', and your token will be generated and displayed on screen. Copy or save this token since you can't access it again.
  1463. <img alt="token-created" src="../../pictures/screenshot_gitlab_token_created.png" /></p>
  1464. <blockquote>
  1465. <p><strong>Note</strong>: Project access tokens and group access tokens are also accepted in place of a personal access token.</p>
  1466. </blockquote>
  1467. <h3 id="access-token-secret">Access Token secret</h3>
  1468. <p>Create a secret containing your access token:</p>
  1469. <div class="highlight"><pre><span></span><code><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">v1</span>
  1470. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Secret</span>
  1471. <span class="nt">metadata</span><span class="p">:</span>
  1472. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gitlab-secret</span>
  1473. <span class="w"> </span><span class="nt">labels</span><span class="p">:</span><span class="w"> </span>
  1474. <span class="w"> </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gitlab</span>
  1475. <span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Opaque</span><span class="w"> </span>
  1476. <span class="nt">stringData</span><span class="p">:</span>
  1477. <span class="w"> </span><span class="nt">token</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;**access</span><span class="nv"> </span><span class="s">token</span><span class="nv"> </span><span class="s">goes</span><span class="nv"> </span><span class="s">here**&quot;</span>
  1478. </code></pre></div>
  1479. <h3 id="configuring-the-secret-store">Configuring the secret store</h3>
  1480. <p>Be sure the <code>gitlab</code> provider is listed in the <code>Kind=SecretStore</code> and the ProjectID is set. If you are not using <code>https://gitlab.com</code>, you must set the <code>url</code> field as well.</p>
  1481. <p>In order to sync group variables <code>inheritFromGroups</code> must be true or <code>groupIDs</code> have to be defined.</p>
  1482. <blockquote>
  1483. <p><strong>Note</strong>: <code>inheritFromGroups</code> and <code>groupIDs</code> are mutually exclusive. Setting both fields at the same time causes a validation error. Use <code>groupIDs</code> to sync from a fixed list of groups, or <code>inheritFromGroups: true</code> to automatically discover all parent groups of the project.</p>
  1484. </blockquote>
  1485. <p>The values in <code>groupIDs</code> must be the numeric group ID, not the group path or slug. You can find the numeric ID on the group's General Settings page.</p>
  1486. <p>When <code>inheritFromGroups: true</code> is set, parent groups are discovered at secret-fetch time via the GitLab Projects API and sorted by full path length, shortest first. This gives the project's direct parent the highest priority among groups. Project variables always take precedence over group variables regardless of this order.</p>
  1487. <p>In case you have defined multiple environments in Gitlab, the secret store should be constrained to a specific <code>environment_scope</code>.</p>
  1488. <h4 id="environment-scope-fallback-behavior">Environment Scope Fallback Behavior</h4>
  1489. <p>The GitLab provider implements an intelligent fallback mechanism for environment scopes:</p>
  1490. <ol>
  1491. <li><strong>Primary lookup</strong>: When you configure a specific <code>environment</code> in your SecretStore (example: <code>environment: "production"</code>), the provider first tries to find variables with that exact environment scope.</li>
  1492. <li><strong>Automatic fallback</strong>: If no variable is found with the specific environment scope, the provider automatically falls back to variables with "All environments" scope (<code>*</code> wildcard).</li>
  1493. <li><strong>Priority order</strong>: Variables with specific environment scopes take precedence over wildcard variables when both exist.</li>
  1494. </ol>
  1495. <p><strong>Example</strong>: If your SecretStore has <code>environment: "production"</code> but your GitLab variable is set to "All environments", the variable will still be successfully retrieved through the fallback mechanism.</p>
  1496. <blockquote>
  1497. <p><strong>Implementation Note</strong>: This fallback behavior is implemented in the <code>getVariables</code> function in <code>providers/v1/gitlab/provider.go</code>, where the provider automatically retries with <code>EnvironmentScope: "*"</code> when the initial lookup with the specific environment scope returns a 404 Not Found response. The same fallback applies to group variable lookups in <code>getGroupVariables</code>.</p>
  1498. </blockquote>
  1499. <p><div class="highlight"><pre><span></span><code><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets.io/v1</span>
  1500. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">SecretStore</span>
  1501. <span class="nt">metadata</span><span class="p">:</span>
  1502. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gitlab-secret-store</span>
  1503. <span class="nt">spec</span><span class="p">:</span>
  1504. <span class="w"> </span><span class="nt">provider</span><span class="p">:</span>
  1505. <span class="w"> </span><span class="c1"># provider type: gitlab</span>
  1506. <span class="w"> </span><span class="nt">gitlab</span><span class="p">:</span>
  1507. <span class="w"> </span><span class="c1"># url: https://gitlab.mydomain.com/</span>
  1508. <span class="w"> </span><span class="nt">auth</span><span class="p">:</span>
  1509. <span class="w"> </span><span class="nt">SecretRef</span><span class="p">:</span>
  1510. <span class="w"> </span><span class="nt">accessToken</span><span class="p">:</span>
  1511. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gitlab-secret</span>
  1512. <span class="w"> </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">token</span>
  1513. <span class="w"> </span><span class="nt">projectID</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;**project</span><span class="nv"> </span><span class="s">ID</span><span class="nv"> </span><span class="s">goes</span><span class="nv"> </span><span class="s">here**&quot;</span>
  1514. <span class="w"> </span><span class="c1"># To sync variables from specific groups, provide their numeric IDs</span>
  1515. <span class="w"> </span><span class="c1"># (visible on the group&#39;s General Settings page).</span>
  1516. <span class="w"> </span><span class="c1"># groupIDs and inheritFromGroups are mutually exclusive: set only one.</span>
  1517. <span class="w"> </span><span class="nt">groupIDs</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="s">&quot;12345&quot;</span><span class="p p-Indicator">,</span><span class="w"> </span><span class="s">&quot;67890&quot;</span><span class="p p-Indicator">]</span>
  1518. <span class="w"> </span><span class="c1"># Alternatively, automatically inherit variables from all parent groups:</span>
  1519. <span class="w"> </span><span class="c1"># inheritFromGroups: true</span>
  1520. <span class="w"> </span><span class="nt">environment</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;**environment</span><span class="nv"> </span><span class="s">scope</span><span class="nv"> </span><span class="s">goes</span><span class="nv"> </span><span class="s">here**&quot;</span>
  1521. </code></pre></div>
  1522. <strong>NOTE:</strong> In case of a <code>ClusterSecretStore</code>, Be sure to provide <code>namespace</code> in <code>accessToken</code> with the namespace where the secret resides.</p>
  1523. <p>Your project ID can be found on your project's page.
  1524. <img alt="projectID" src="../../pictures/screenshot_gitlab_projectID.png" /></p>
  1525. <h4 id="custom-tls-certificates">Custom TLS certificates</h4>
  1526. <p>If your GitLab instance uses a self-signed or private CA certificate, configure the provider to trust it using one of two options.</p>
  1527. <p><strong>Option 1 -- inline PEM via <code>caBundle</code></strong>: base64-encode your CA certificate and set it directly in the store spec.</p>
  1528. <div class="highlight"><pre><span></span><code><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets.io/v1</span>
  1529. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">SecretStore</span>
  1530. <span class="nt">metadata</span><span class="p">:</span>
  1531. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gitlab-secret-store</span>
  1532. <span class="nt">spec</span><span class="p">:</span>
  1533. <span class="w"> </span><span class="nt">provider</span><span class="p">:</span>
  1534. <span class="w"> </span><span class="nt">gitlab</span><span class="p">:</span>
  1535. <span class="w"> </span><span class="nt">url</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">https://gitlab.example.com</span>
  1536. <span class="w"> </span><span class="nt">auth</span><span class="p">:</span>
  1537. <span class="w"> </span><span class="nt">SecretRef</span><span class="p">:</span>
  1538. <span class="w"> </span><span class="nt">accessToken</span><span class="p">:</span>
  1539. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gitlab-secret</span>
  1540. <span class="w"> </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">token</span>
  1541. <span class="w"> </span><span class="nt">projectID</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;12345&quot;</span>
  1542. <span class="w"> </span><span class="nt">caBundle</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">LS0tLS1CRUdJTi...</span><span class="w"> </span><span class="c1"># base64-encoded PEM certificate</span>
  1543. </code></pre></div>
  1544. <p><strong>Option 2 -- reference a Secret or ConfigMap via <code>caProvider</code></strong>: store the PEM certificate in a Kubernetes resource and point the store at it. This avoids embedding the certificate in the store spec and works well with cert-manager or manually provisioned CA bundles.</p>
  1545. <div class="highlight"><pre><span></span><code><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets.io/v1</span>
  1546. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">SecretStore</span>
  1547. <span class="nt">metadata</span><span class="p">:</span>
  1548. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gitlab-secret-store</span>
  1549. <span class="nt">spec</span><span class="p">:</span>
  1550. <span class="w"> </span><span class="nt">provider</span><span class="p">:</span>
  1551. <span class="w"> </span><span class="nt">gitlab</span><span class="p">:</span>
  1552. <span class="w"> </span><span class="nt">url</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">https://gitlab.example.com</span>
  1553. <span class="w"> </span><span class="nt">auth</span><span class="p">:</span>
  1554. <span class="w"> </span><span class="nt">SecretRef</span><span class="p">:</span>
  1555. <span class="w"> </span><span class="nt">accessToken</span><span class="p">:</span>
  1556. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gitlab-secret</span>
  1557. <span class="w"> </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">token</span>
  1558. <span class="w"> </span><span class="nt">projectID</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;12345&quot;</span>
  1559. <span class="w"> </span><span class="nt">caProvider</span><span class="p">:</span>
  1560. <span class="w"> </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Secret</span><span class="w"> </span><span class="c1"># or ConfigMap</span>
  1561. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gitlab-ca</span><span class="w"> </span><span class="c1"># name of the Secret or ConfigMap</span>
  1562. <span class="w"> </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ca.crt</span><span class="w"> </span><span class="c1"># key inside the resource that holds the PEM certificate</span>
  1563. <span class="w"> </span><span class="c1"># namespace: ... # required only for ClusterSecretStore</span>
  1564. </code></pre></div>
  1565. <h3 id="creating-external-secret">Creating external secret</h3>
  1566. <p>To sync a GitLab variable to a secret on the Kubernetes cluster, a <code>Kind=ExternalSecret</code> is needed.</p>
  1567. <div class="highlight"><pre><span></span><code><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets.io/v1</span>
  1568. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ExternalSecret</span>
  1569. <span class="nt">metadata</span><span class="p">:</span>
  1570. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gitlab-external-secret-example</span>
  1571. <span class="nt">spec</span><span class="p">:</span>
  1572. <span class="w"> </span><span class="nt">refreshInterval</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1h0m0s</span>
  1573. <span class="w"> </span><span class="nt">secretStoreRef</span><span class="p">:</span>
  1574. <span class="w"> </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">SecretStore</span>
  1575. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gitlab-secret-store</span><span class="w"> </span><span class="c1"># Must match SecretStore on the cluster</span>
  1576. <span class="w"> </span><span class="nt">target</span><span class="p">:</span>
  1577. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gitlab-secret-to-create</span><span class="w"> </span><span class="c1"># Name for the secret to be created on the cluster</span>
  1578. <span class="w"> </span><span class="nt">creationPolicy</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Owner</span>
  1579. <span class="w"> </span><span class="nt">data</span><span class="p">:</span>
  1580. <span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">secretKey</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">secretKey</span><span class="w"> </span><span class="c1"># Key given to the secret to be created on the cluster</span>
  1581. <span class="w"> </span><span class="nt">remoteRef</span><span class="p">:</span><span class="w"> </span>
  1582. <span class="w"> </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">myGitlabVariable</span><span class="w"> </span><span class="c1"># Key of the variable on Gitlab</span>
  1583. </code></pre></div>
  1584. <h4 id="key-normalisation">Key normalisation</h4>
  1585. <p>When using <code>data:</code> to look up a single variable by name, hyphens in <code>remoteRef.key</code> are silently replaced with underscores before the GitLab API call. For example, <code>key: my-secret</code> will look up the GitLab variable named <code>my_secret</code>. This normalisation does not apply to <code>dataFrom</code>.</p>
  1586. <h4 id="extracting-a-json-sub-key-with-remoterefproperty">Extracting a JSON sub-key with <code>remoteRef.property</code></h4>
  1587. <p>If a GitLab variable holds a JSON string, you can extract a single nested value using <code>remoteRef.property</code>. The value is resolved using <a href="https://github.com/tidwall/gjson#path-syntax">GJSON path syntax</a>, so dot-separated paths and array indexing are both supported.</p>
  1588. <div class="highlight"><pre><span></span><code><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets.io/v1</span>
  1589. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ExternalSecret</span>
  1590. <span class="nt">metadata</span><span class="p">:</span>
  1591. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gitlab-json-property-example</span>
  1592. <span class="nt">spec</span><span class="p">:</span>
  1593. <span class="w"> </span><span class="nt">refreshInterval</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1h0m0s</span>
  1594. <span class="w"> </span><span class="nt">secretStoreRef</span><span class="p">:</span>
  1595. <span class="w"> </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">SecretStore</span>
  1596. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gitlab-secret-store</span>
  1597. <span class="w"> </span><span class="nt">target</span><span class="p">:</span>
  1598. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gitlab-secret-to-create</span>
  1599. <span class="w"> </span><span class="nt">creationPolicy</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Owner</span>
  1600. <span class="w"> </span><span class="nt">data</span><span class="p">:</span>
  1601. <span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">secretKey</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">db-password</span>
  1602. <span class="w"> </span><span class="nt">remoteRef</span><span class="p">:</span>
  1603. <span class="w"> </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">MY_JSON_CONFIG</span><span class="w"> </span><span class="c1"># GitLab variable whose value is a JSON string</span>
  1604. <span class="w"> </span><span class="nt">property</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">database.password</span><span class="w"> </span><span class="c1"># GJSON path into that JSON value</span>
  1605. </code></pre></div>
  1606. <h4 id="using-datafrom">Using DataFrom</h4>
  1607. <p>DataFrom can be used to get a variable as a JSON string and attempt to parse it, or to match multiple variables by name.</p>
  1608. <p><strong>Extracting all keys from a JSON variable</strong> (<code>dataFrom.extract</code>):</p>
  1609. <div class="highlight"><pre><span></span><code><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets.io/v1</span>
  1610. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ExternalSecret</span>
  1611. <span class="nt">metadata</span><span class="p">:</span>
  1612. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gitlab-external-secret-example</span>
  1613. <span class="nt">spec</span><span class="p">:</span>
  1614. <span class="w"> </span><span class="nt">refreshInterval</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1h0m0s</span>
  1615. <span class="w"> </span><span class="nt">secretStoreRef</span><span class="p">:</span>
  1616. <span class="w"> </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">SecretStore</span>
  1617. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gitlab-secret-store</span><span class="w"> </span><span class="c1"># Must match SecretStore on the cluster</span>
  1618. <span class="w"> </span><span class="nt">target</span><span class="p">:</span>
  1619. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gitlab-secret-to-create</span><span class="w"> </span><span class="c1"># Name for the secret to be created on the cluster</span>
  1620. <span class="w"> </span><span class="nt">creationPolicy</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Owner</span>
  1621. <span class="w"> </span><span class="c1"># each secret name in the KV will be used as the secret key in the SECRET k8s target object</span>
  1622. <span class="w"> </span><span class="nt">dataFrom</span><span class="p">:</span>
  1623. <span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">extract</span><span class="p">:</span>
  1624. <span class="w"> </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;myJsonVariable&quot;</span><span class="w"> </span><span class="c1"># Key of the variable on Gitlab</span>
  1625. </code></pre></div>
  1626. <p><strong>Matching multiple variables by name regex</strong> (<code>dataFrom.find</code>):</p>
  1627. <div class="highlight"><pre><span></span><code><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets.io/v1</span>
  1628. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ExternalSecret</span>
  1629. <span class="nt">metadata</span><span class="p">:</span>
  1630. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gitlab-find-example</span>
  1631. <span class="nt">spec</span><span class="p">:</span>
  1632. <span class="w"> </span><span class="nt">refreshInterval</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">1h0m0s</span>
  1633. <span class="w"> </span><span class="nt">secretStoreRef</span><span class="p">:</span>
  1634. <span class="w"> </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">SecretStore</span>
  1635. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gitlab-secret-store</span>
  1636. <span class="w"> </span><span class="nt">target</span><span class="p">:</span>
  1637. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">gitlab-secret-to-create</span>
  1638. <span class="w"> </span><span class="nt">creationPolicy</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Owner</span>
  1639. <span class="w"> </span><span class="nt">dataFrom</span><span class="p">:</span>
  1640. <span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">find</span><span class="p">:</span>
  1641. <span class="w"> </span><span class="nt">name</span><span class="p">:</span>
  1642. <span class="w"> </span><span class="nt">regexp</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;^PROD_.*&quot;</span><span class="w"> </span><span class="c1"># required: regexp matched against variable names</span>
  1643. <span class="w"> </span><span class="nt">tags</span><span class="p">:</span>
  1644. <span class="w"> </span><span class="nt">environment_scope</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">production</span><span class="w"> </span><span class="c1"># optional: also filter by environment scope</span>
  1645. </code></pre></div>
  1646. <p>The following restrictions apply when using <code>find</code>:</p>
  1647. <ul>
  1648. <li><code>find.name</code> is mandatory. The provider requires a name regexp to select which variables to sync.</li>
  1649. <li><code>find.tags</code> only supports the <code>environment_scope</code> key. Any other tag key causes an error. Setting <code>find.tags.environment_scope</code> while the SecretStore already has an <code>environment</code> configured also causes an error, as the two would conflict.</li>
  1650. <li><code>find.path</code> is not implemented in the GitLab provider and returns an error if set.</li>
  1651. </ul>
  1652. <h3 id="getting-the-kubernetes-secret">Getting the Kubernetes secret</h3>
  1653. <p>The operator will fetch the project variable and inject it as a <code>Kind=Secret</code>.
  1654. <div class="highlight"><pre><span></span><code>kubectl get secret gitlab-secret-to-create -o jsonpath=&#39;{.data.secretKey}&#39; | base64 -d
  1655. </code></pre></div></p>
  1656. </article>
  1657. </div>
  1658. <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
  1659. </div>
  1660. </main>
  1661. <img referrerpolicy="no-referrer-when-downgrade"
  1662. src="https://static.scarf.sh/a.png?x-pxid=6658a9eb-067d-49f1-94f2-b8b00f21451e" alt=""
  1663. hidden />
  1664. <footer class="md-footer">
  1665. <div class="md-footer-meta md-typeset">
  1666. <div class="md-footer-meta__inner md-grid">
  1667. <div class="md-copyright">
  1668. <div class="md-copyright__highlight">
  1669. &copy; 2025 The external-secrets Authors.<br/>
  1670. &copy; 2025 The Linux Foundation. All rights reserved.<br/><br/>
  1671. The Linux Foundation has registered trademarks and uses trademarks.<br/>
  1672. For a list of trademarks of The Linux Foundation, please see our <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage page</a>.
  1673. </div>
  1674. Made with
  1675. <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
  1676. Material for MkDocs
  1677. </a>
  1678. </div>
  1679. </div>
  1680. </div>
  1681. </footer>
  1682. </div>
  1683. <div class="md-dialog" data-md-component="dialog">
  1684. <div class="md-dialog__inner md-typeset"></div>
  1685. </div>
  1686. <script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["navigation.tabs", "navigation.indexes", "navigation.expand"], "search": "../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"provider": "mike"}}</script>
  1687. <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
  1688. </body>
  1689. </html>