index.html 87 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702370337043705370637073708370937103711371237133714371537163717371837193720372137223723372437253726372737283729373037313732373337343735373637373738373937403741374237433744374537463747374837493750375137523753375437553756375737583759376037613762376337643765376637673768376937703771377237733774377537763777377837793780378137823783378437853786378737883789379037913792379337943795379637973798379938003801380238033804380538063807380838093810381138123813381438153816381738183819382038213822382338243825382638273828382938303831383238333834383538363837383838393840384138423843384438453846384738483849385038513852385338543855385638573858385938603861386238633864386538663867386838693870387138723873387438753876387738783879388038813882388338843885388638873888388938903891389238933894389538963897389838993900390139023903390439053906390739083909391039113912391339143915391639173918391939203921392239233924392539263927392839293930393139323933393439353936393739383939394039413942394339443945394639473948394939503951395239533954395539563957395839593960396139623963396439653966396739683969397039713972397339743975397639773978397939803981398239833984398539863987398839893990399139923993399439953996399739983999400040014002400340044005400640074008400940104011401240134014401540164017401840194020402140224023402440254026402740284029403040314032403340344035403640374038403940404041404240434044404540464047404840494050405140524053405440554056405740584059406040614062406340644065406640674068406940704071407240734074407540764077407840794080408140824083408440854086408740884089409040914092409340944095409640974098409941004101410241034104410541064107410841094110411141124113411441154116411741184119412041214122412341244125412641274128412941304131413241334134413541364137413841394140414141424143414441454146414741484149415041514152415341544155415641574158415941604161416241634164416541664167416841694170417141724173417441754176417741784179418041814182418341844185418641874188418941904191419241934194419541964197419841994200420142024203420442054206420742084209421042114212421342144215421642174218421942204221422242234224422542264227422842294230423142324233423442354236423742384239424042414242424342444245424642474248424942504251425242534254425542564257425842594260426142624263426442654266426742684269427042714272427342744275427642774278427942804281428242834284428542864287428842894290429142924293429442954296429742984299430043014302430343044305430643074308430943104311431243134314431543164317431843194320432143224323432443254326432743284329433043314332433343344335433643374338433943404341434243434344434543464347434843494350435143524353435443554356435743584359436043614362436343644365436643674368436943704371437243734374437543764377437843794380438143824383438443854386438743884389439043914392439343944395439643974398439944004401440244034404440544064407440844094410441144124413441444154416441744184419442044214422442344244425
  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="../../provider/openbao/">
  7. <link rel="next" href="../anchore-engine-credentials/">
  8. <link rel="icon" href="../../pictures/eso-round-logo.svg">
  9. <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.6.18">
  10. <title>FluxCD - External Secrets Operator</title>
  11. <link rel="stylesheet" href="../../assets/stylesheets/main.7e37652d.min.css">
  12. <link rel="stylesheet" href="../../assets/stylesheets/palette.06af60db.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="#gitops-using-fluxcd-v2" 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. FluxCD
  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.0.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 fill="currentColor" 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">
  137. <a href="../../provider/aws-secrets-manager/" class="md-tabs__link">
  138. Provider
  139. </a>
  140. </li>
  141. <li class="md-tabs__item md-tabs__item--active">
  142. <a href="./" 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.0.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 fill="currentColor" 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/cluster/" class="md-nav__link">
  368. <span class="md-ellipsis">
  369. Cluster Generator
  370. </span>
  371. </a>
  372. </li>
  373. <li class="md-nav__item">
  374. <a href="../../api/generator/gcr/" class="md-nav__link">
  375. <span class="md-ellipsis">
  376. Google Container Registry
  377. </span>
  378. </a>
  379. </li>
  380. <li class="md-nav__item">
  381. <a href="../../api/generator/quay/" class="md-nav__link">
  382. <span class="md-ellipsis">
  383. Quay
  384. </span>
  385. </a>
  386. </li>
  387. <li class="md-nav__item">
  388. <a href="../../api/generator/vault/" class="md-nav__link">
  389. <span class="md-ellipsis">
  390. Vault Dynamic Secret
  391. </span>
  392. </a>
  393. </li>
  394. <li class="md-nav__item">
  395. <a href="../../api/generator/password/" class="md-nav__link">
  396. <span class="md-ellipsis">
  397. Password
  398. </span>
  399. </a>
  400. </li>
  401. <li class="md-nav__item">
  402. <a href="../../api/generator/fake/" class="md-nav__link">
  403. <span class="md-ellipsis">
  404. Fake
  405. </span>
  406. </a>
  407. </li>
  408. <li class="md-nav__item">
  409. <a href="../../api/generator/webhook/" class="md-nav__link">
  410. <span class="md-ellipsis">
  411. Webhook
  412. </span>
  413. </a>
  414. </li>
  415. <li class="md-nav__item">
  416. <a href="../../api/generator/github/" class="md-nav__link">
  417. <span class="md-ellipsis">
  418. Github
  419. </span>
  420. </a>
  421. </li>
  422. <li class="md-nav__item">
  423. <a href="../../api/generator/uuid/" class="md-nav__link">
  424. <span class="md-ellipsis">
  425. UUID
  426. </span>
  427. </a>
  428. </li>
  429. <li class="md-nav__item">
  430. <a href="../../api/generator/mfa/" class="md-nav__link">
  431. <span class="md-ellipsis">
  432. MFA
  433. </span>
  434. </a>
  435. </li>
  436. <li class="md-nav__item">
  437. <a href="../../api/generator/sshkey/" class="md-nav__link">
  438. <span class="md-ellipsis">
  439. SSHKey
  440. </span>
  441. </a>
  442. </li>
  443. </ul>
  444. </nav>
  445. </li>
  446. <li class="md-nav__item md-nav__item--nested">
  447. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_4" >
  448. <label class="md-nav__link" for="__nav_2_4" id="__nav_2_4_label" tabindex="0">
  449. <span class="md-ellipsis">
  450. Reference Docs
  451. </span>
  452. <span class="md-nav__icon md-icon"></span>
  453. </label>
  454. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_4_label" aria-expanded="false">
  455. <label class="md-nav__title" for="__nav_2_4">
  456. <span class="md-nav__icon md-icon"></span>
  457. Reference Docs
  458. </label>
  459. <ul class="md-nav__list" data-md-scrollfix>
  460. <li class="md-nav__item">
  461. <a href="../../api/spec/" class="md-nav__link">
  462. <span class="md-ellipsis">
  463. API specification
  464. </span>
  465. </a>
  466. </li>
  467. <li class="md-nav__item">
  468. <a href="../../api/controller-options/" class="md-nav__link">
  469. <span class="md-ellipsis">
  470. Controller Options
  471. </span>
  472. </a>
  473. </li>
  474. <li class="md-nav__item">
  475. <a href="../../api/metrics/" class="md-nav__link">
  476. <span class="md-ellipsis">
  477. Metrics
  478. </span>
  479. </a>
  480. </li>
  481. <li class="md-nav__item">
  482. <a href="../../api/selectable-fields/" class="md-nav__link">
  483. <span class="md-ellipsis">
  484. Selectable Fields
  485. </span>
  486. </a>
  487. </li>
  488. </ul>
  489. </nav>
  490. </li>
  491. </ul>
  492. </nav>
  493. </li>
  494. <li class="md-nav__item md-nav__item--nested">
  495. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
  496. <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
  497. <span class="md-ellipsis">
  498. Guides
  499. </span>
  500. <span class="md-nav__icon md-icon"></span>
  501. </label>
  502. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
  503. <label class="md-nav__title" for="__nav_3">
  504. <span class="md-nav__icon md-icon"></span>
  505. Guides
  506. </label>
  507. <ul class="md-nav__list" data-md-scrollfix>
  508. <li class="md-nav__item">
  509. <a href="../../guides/introduction/" class="md-nav__link">
  510. <span class="md-ellipsis">
  511. Introduction
  512. </span>
  513. </a>
  514. </li>
  515. <li class="md-nav__item md-nav__item--nested">
  516. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_2" >
  517. <label class="md-nav__link" for="__nav_3_2" id="__nav_3_2_label" tabindex="0">
  518. <span class="md-ellipsis">
  519. External Secrets
  520. </span>
  521. <span class="md-nav__icon md-icon"></span>
  522. </label>
  523. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_2_label" aria-expanded="false">
  524. <label class="md-nav__title" for="__nav_3_2">
  525. <span class="md-nav__icon md-icon"></span>
  526. External Secrets
  527. </label>
  528. <ul class="md-nav__list" data-md-scrollfix>
  529. <li class="md-nav__item">
  530. <a href="../../guides/all-keys-one-secret/" class="md-nav__link">
  531. <span class="md-ellipsis">
  532. Extract structured data
  533. </span>
  534. </a>
  535. </li>
  536. <li class="md-nav__item">
  537. <a href="../../guides/getallsecrets/" class="md-nav__link">
  538. <span class="md-ellipsis">
  539. Find Secrets by Name or Metadata
  540. </span>
  541. </a>
  542. </li>
  543. <li class="md-nav__item">
  544. <a href="../../guides/datafrom-rewrite/" class="md-nav__link">
  545. <span class="md-ellipsis">
  546. Rewriting Keys
  547. </span>
  548. </a>
  549. </li>
  550. <li class="md-nav__item md-nav__item--nested">
  551. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_2_4" >
  552. <label class="md-nav__link" for="__nav_3_2_4" id="__nav_3_2_4_label" tabindex="0">
  553. <span class="md-ellipsis">
  554. Advanced Templating
  555. </span>
  556. <span class="md-nav__icon md-icon"></span>
  557. </label>
  558. <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_3_2_4_label" aria-expanded="false">
  559. <label class="md-nav__title" for="__nav_3_2_4">
  560. <span class="md-nav__icon md-icon"></span>
  561. Advanced Templating
  562. </label>
  563. <ul class="md-nav__list" data-md-scrollfix>
  564. <li class="md-nav__item">
  565. <a href="../../guides/templating/" class="md-nav__link">
  566. <span class="md-ellipsis">
  567. v2
  568. </span>
  569. </a>
  570. </li>
  571. <li class="md-nav__item">
  572. <a href="../../guides/templating-v1/" class="md-nav__link">
  573. <span class="md-ellipsis">
  574. v1
  575. </span>
  576. </a>
  577. </li>
  578. </ul>
  579. </nav>
  580. </li>
  581. <li class="md-nav__item">
  582. <a href="../../guides/common-k8s-secret-types/" class="md-nav__link">
  583. <span class="md-ellipsis">
  584. Kubernetes Secret Types
  585. </span>
  586. </a>
  587. </li>
  588. <li class="md-nav__item">
  589. <a href="../../guides/ownership-deletion-policy/" class="md-nav__link">
  590. <span class="md-ellipsis">
  591. Lifecycle: ownership & deletion
  592. </span>
  593. </a>
  594. </li>
  595. <li class="md-nav__item">
  596. <a href="../../guides/decoding-strategy/" class="md-nav__link">
  597. <span class="md-ellipsis">
  598. Decoding Strategies
  599. </span>
  600. </a>
  601. </li>
  602. <li class="md-nav__item">
  603. <a href="../../guides/controller-class/" class="md-nav__link">
  604. <span class="md-ellipsis">
  605. Controller Classes
  606. </span>
  607. </a>
  608. </li>
  609. </ul>
  610. </nav>
  611. </li>
  612. <li class="md-nav__item">
  613. <a href="../../guides/generator/" class="md-nav__link">
  614. <span class="md-ellipsis">
  615. Generators
  616. </span>
  617. </a>
  618. </li>
  619. <li class="md-nav__item">
  620. <a href="../../guides/pushsecrets/" class="md-nav__link">
  621. <span class="md-ellipsis">
  622. Push Secrets
  623. </span>
  624. </a>
  625. </li>
  626. <li class="md-nav__item md-nav__item--nested">
  627. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_5" >
  628. <label class="md-nav__link" for="__nav_3_5" id="__nav_3_5_label" tabindex="0">
  629. <span class="md-ellipsis">
  630. Operations
  631. </span>
  632. <span class="md-nav__icon md-icon"></span>
  633. </label>
  634. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_5_label" aria-expanded="false">
  635. <label class="md-nav__title" for="__nav_3_5">
  636. <span class="md-nav__icon md-icon"></span>
  637. Operations
  638. </label>
  639. <ul class="md-nav__list" data-md-scrollfix>
  640. <li class="md-nav__item">
  641. <a href="../../guides/multi-tenancy/" class="md-nav__link">
  642. <span class="md-ellipsis">
  643. Multi Tenancy
  644. </span>
  645. </a>
  646. </li>
  647. <li class="md-nav__item">
  648. <a href="../../guides/security-best-practices/" class="md-nav__link">
  649. <span class="md-ellipsis">
  650. Security Best Practices
  651. </span>
  652. </a>
  653. </li>
  654. <li class="md-nav__item">
  655. <a href="../../guides/threat-model/" class="md-nav__link">
  656. <span class="md-ellipsis">
  657. Threat Model
  658. </span>
  659. </a>
  660. </li>
  661. <li class="md-nav__item">
  662. <a href="../../guides/v1beta1/" class="md-nav__link">
  663. <span class="md-ellipsis">
  664. Upgrading to v1beta1
  665. </span>
  666. </a>
  667. </li>
  668. <li class="md-nav__item">
  669. <a href="../../guides/using-latest-image/" class="md-nav__link">
  670. <span class="md-ellipsis">
  671. Using Latest Image
  672. </span>
  673. </a>
  674. </li>
  675. <li class="md-nav__item">
  676. <a href="../../guides/disable-cluster-features/" class="md-nav__link">
  677. <span class="md-ellipsis">
  678. Disable Cluster Features
  679. </span>
  680. </a>
  681. </li>
  682. </ul>
  683. </nav>
  684. </li>
  685. <li class="md-nav__item md-nav__item--nested">
  686. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_6" >
  687. <label class="md-nav__link" for="__nav_3_6" id="__nav_3_6_label" tabindex="0">
  688. <span class="md-ellipsis">
  689. Tooling
  690. </span>
  691. <span class="md-nav__icon md-icon"></span>
  692. </label>
  693. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_6_label" aria-expanded="false">
  694. <label class="md-nav__title" for="__nav_3_6">
  695. <span class="md-nav__icon md-icon"></span>
  696. Tooling
  697. </label>
  698. <ul class="md-nav__list" data-md-scrollfix>
  699. <li class="md-nav__item">
  700. <a href="../../guides/using-esoctl-tool/" class="md-nav__link">
  701. <span class="md-ellipsis">
  702. Using the esoctl tool
  703. </span>
  704. </a>
  705. </li>
  706. </ul>
  707. </nav>
  708. </li>
  709. </ul>
  710. </nav>
  711. </li>
  712. <li class="md-nav__item md-nav__item--nested">
  713. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
  714. <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
  715. <span class="md-ellipsis">
  716. Provider
  717. </span>
  718. <span class="md-nav__icon md-icon"></span>
  719. </label>
  720. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
  721. <label class="md-nav__title" for="__nav_4">
  722. <span class="md-nav__icon md-icon"></span>
  723. Provider
  724. </label>
  725. <ul class="md-nav__list" data-md-scrollfix>
  726. <li class="md-nav__item">
  727. <a href="../../provider/aws-secrets-manager/" class="md-nav__link">
  728. <span class="md-ellipsis">
  729. AWS Secrets Manager
  730. </span>
  731. </a>
  732. </li>
  733. <li class="md-nav__item">
  734. <a href="../../provider/aws-parameter-store/" class="md-nav__link">
  735. <span class="md-ellipsis">
  736. AWS Parameter Store
  737. </span>
  738. </a>
  739. </li>
  740. <li class="md-nav__item">
  741. <a href="../../provider/azure-key-vault/" class="md-nav__link">
  742. <span class="md-ellipsis">
  743. Azure Key Vault
  744. </span>
  745. </a>
  746. </li>
  747. <li class="md-nav__item">
  748. <a href="../../provider/beyondtrust/" class="md-nav__link">
  749. <span class="md-ellipsis">
  750. BeyondTrust
  751. </span>
  752. </a>
  753. </li>
  754. <li class="md-nav__item">
  755. <a href="../../provider/bitwarden-secrets-manager/" class="md-nav__link">
  756. <span class="md-ellipsis">
  757. Bitwarden Secrets Manager
  758. </span>
  759. </a>
  760. </li>
  761. <li class="md-nav__item">
  762. <a href="../../provider/chef/" class="md-nav__link">
  763. <span class="md-ellipsis">
  764. Chef
  765. </span>
  766. </a>
  767. </li>
  768. <li class="md-nav__item">
  769. <a href="../../provider/cloudru/" class="md-nav__link">
  770. <span class="md-ellipsis">
  771. Cloud.ru Secret Manager
  772. </span>
  773. </a>
  774. </li>
  775. <li class="md-nav__item">
  776. <a href="../../provider/conjur/" class="md-nav__link">
  777. <span class="md-ellipsis">
  778. CyberArk Conjur
  779. </span>
  780. </a>
  781. </li>
  782. <li class="md-nav__item">
  783. <a href="../../provider/device42/" class="md-nav__link">
  784. <span class="md-ellipsis">
  785. Device42
  786. </span>
  787. </a>
  788. </li>
  789. <li class="md-nav__item">
  790. <a href="../../provider/google-secrets-manager/" class="md-nav__link">
  791. <span class="md-ellipsis">
  792. Google Cloud Secret Manager
  793. </span>
  794. </a>
  795. </li>
  796. <li class="md-nav__item">
  797. <a href="../../provider/hashicorp-vault/" class="md-nav__link">
  798. <span class="md-ellipsis">
  799. HashiCorp Vault
  800. </span>
  801. </a>
  802. </li>
  803. <li class="md-nav__item">
  804. <a href="../../provider/kubernetes/" class="md-nav__link">
  805. <span class="md-ellipsis">
  806. Kubernetes
  807. </span>
  808. </a>
  809. </li>
  810. <li class="md-nav__item">
  811. <a href="../../provider/ibm-secrets-manager/" class="md-nav__link">
  812. <span class="md-ellipsis">
  813. IBM Secrets Manager
  814. </span>
  815. </a>
  816. </li>
  817. <li class="md-nav__item">
  818. <a href="../../provider/akeyless/" class="md-nav__link">
  819. <span class="md-ellipsis">
  820. Akeyless
  821. </span>
  822. </a>
  823. </li>
  824. <li class="md-nav__item">
  825. <a href="../../provider/yandex-certificate-manager/" class="md-nav__link">
  826. <span class="md-ellipsis">
  827. Yandex Certificate Manager
  828. </span>
  829. </a>
  830. </li>
  831. <li class="md-nav__item">
  832. <a href="../../provider/yandex-lockbox/" class="md-nav__link">
  833. <span class="md-ellipsis">
  834. Yandex Lockbox
  835. </span>
  836. </a>
  837. </li>
  838. <li class="md-nav__item">
  839. <a href="../../provider/alibaba/" class="md-nav__link">
  840. <span class="md-ellipsis">
  841. Alibaba Cloud
  842. </span>
  843. </a>
  844. </li>
  845. <li class="md-nav__item">
  846. <a href="../../provider/gitlab-variables/" class="md-nav__link">
  847. <span class="md-ellipsis">
  848. GitLab Variables
  849. </span>
  850. </a>
  851. </li>
  852. <li class="md-nav__item">
  853. <a href="../../provider/github/" class="md-nav__link">
  854. <span class="md-ellipsis">
  855. Github Actions Secrets
  856. </span>
  857. </a>
  858. </li>
  859. <li class="md-nav__item">
  860. <a href="../../provider/oracle-vault/" class="md-nav__link">
  861. <span class="md-ellipsis">
  862. Oracle Vault
  863. </span>
  864. </a>
  865. </li>
  866. <li class="md-nav__item">
  867. <a href="../../provider/1password-automation/" class="md-nav__link">
  868. <span class="md-ellipsis">
  869. 1Password Connect Server
  870. </span>
  871. </a>
  872. </li>
  873. <li class="md-nav__item">
  874. <a href="../../provider/1password-sdk/" class="md-nav__link">
  875. <span class="md-ellipsis">
  876. 1Password SDK
  877. </span>
  878. </a>
  879. </li>
  880. <li class="md-nav__item">
  881. <a href="../../provider/webhook/" class="md-nav__link">
  882. <span class="md-ellipsis">
  883. Webhook
  884. </span>
  885. </a>
  886. </li>
  887. <li class="md-nav__item">
  888. <a href="../../provider/fake/" class="md-nav__link">
  889. <span class="md-ellipsis">
  890. Fake
  891. </span>
  892. </a>
  893. </li>
  894. <li class="md-nav__item">
  895. <a href="../../provider/senhasegura-dsm/" class="md-nav__link">
  896. <span class="md-ellipsis">
  897. senhasegura DevOps Secrets Management (DSM)
  898. </span>
  899. </a>
  900. </li>
  901. <li class="md-nav__item">
  902. <a href="../../provider/doppler/" class="md-nav__link">
  903. <span class="md-ellipsis">
  904. Doppler
  905. </span>
  906. </a>
  907. </li>
  908. <li class="md-nav__item">
  909. <a href="../../provider/keeper-security/" class="md-nav__link">
  910. <span class="md-ellipsis">
  911. Keeper Security
  912. </span>
  913. </a>
  914. </li>
  915. <li class="md-nav__item">
  916. <a href="../../provider/cloak/" class="md-nav__link">
  917. <span class="md-ellipsis">
  918. Cloak End 2 End Encrypted Secrets
  919. </span>
  920. </a>
  921. </li>
  922. <li class="md-nav__item">
  923. <a href="../../provider/scaleway/" class="md-nav__link">
  924. <span class="md-ellipsis">
  925. Scaleway
  926. </span>
  927. </a>
  928. </li>
  929. <li class="md-nav__item">
  930. <a href="../../provider/delinea/" class="md-nav__link">
  931. <span class="md-ellipsis">
  932. Delinea
  933. </span>
  934. </a>
  935. </li>
  936. <li class="md-nav__item">
  937. <a href="../../provider/secretserver/" class="md-nav__link">
  938. <span class="md-ellipsis">
  939. Secret Server
  940. </span>
  941. </a>
  942. </li>
  943. <li class="md-nav__item">
  944. <a href="../../provider/passbolt/" class="md-nav__link">
  945. <span class="md-ellipsis">
  946. Passbolt
  947. </span>
  948. </a>
  949. </li>
  950. <li class="md-nav__item">
  951. <a href="../../provider/pulumi/" class="md-nav__link">
  952. <span class="md-ellipsis">
  953. Pulumi ESC
  954. </span>
  955. </a>
  956. </li>
  957. <li class="md-nav__item">
  958. <a href="../../provider/onboardbase/" class="md-nav__link">
  959. <span class="md-ellipsis">
  960. Onboardbase
  961. </span>
  962. </a>
  963. </li>
  964. <li class="md-nav__item">
  965. <a href="../../provider-passworddepot/" class="md-nav__link">
  966. <span class="md-ellipsis">
  967. Password Depot
  968. </span>
  969. </a>
  970. </li>
  971. <li class="md-nav__item">
  972. <a href="../../provider/fortanix/" class="md-nav__link">
  973. <span class="md-ellipsis">
  974. Fortanix
  975. </span>
  976. </a>
  977. </li>
  978. <li class="md-nav__item">
  979. <a href="../../provider/infisical/" class="md-nav__link">
  980. <span class="md-ellipsis">
  981. Infisical
  982. </span>
  983. </a>
  984. </li>
  985. <li class="md-nav__item">
  986. <a href="../../provider/previder/" class="md-nav__link">
  987. <span class="md-ellipsis">
  988. Previder
  989. </span>
  990. </a>
  991. </li>
  992. <li class="md-nav__item">
  993. <a href="../../provider/openbao/" class="md-nav__link">
  994. <span class="md-ellipsis">
  995. OpenBao
  996. </span>
  997. </a>
  998. </li>
  999. </ul>
  1000. </nav>
  1001. </li>
  1002. <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
  1003. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" checked>
  1004. <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="">
  1005. <span class="md-ellipsis">
  1006. Examples
  1007. </span>
  1008. <span class="md-nav__icon md-icon"></span>
  1009. </label>
  1010. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="true">
  1011. <label class="md-nav__title" for="__nav_5">
  1012. <span class="md-nav__icon md-icon"></span>
  1013. Examples
  1014. </label>
  1015. <ul class="md-nav__list" data-md-scrollfix>
  1016. <li class="md-nav__item md-nav__item--active">
  1017. <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
  1018. <label class="md-nav__link md-nav__link--active" for="__toc">
  1019. <span class="md-ellipsis">
  1020. FluxCD
  1021. </span>
  1022. <span class="md-nav__icon md-icon"></span>
  1023. </label>
  1024. <a href="./" class="md-nav__link md-nav__link--active">
  1025. <span class="md-ellipsis">
  1026. FluxCD
  1027. </span>
  1028. </a>
  1029. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  1030. <label class="md-nav__title" for="__toc">
  1031. <span class="md-nav__icon md-icon"></span>
  1032. Table of contents
  1033. </label>
  1034. <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
  1035. <li class="md-nav__item">
  1036. <a href="#advantages" class="md-nav__link">
  1037. <span class="md-ellipsis">
  1038. Advantages
  1039. </span>
  1040. </a>
  1041. </li>
  1042. <li class="md-nav__item">
  1043. <a href="#the-approach" class="md-nav__link">
  1044. <span class="md-ellipsis">
  1045. The approach
  1046. </span>
  1047. </a>
  1048. </li>
  1049. <li class="md-nav__item">
  1050. <a href="#the-problem" class="md-nav__link">
  1051. <span class="md-ellipsis">
  1052. The problem
  1053. </span>
  1054. </a>
  1055. </li>
  1056. <li class="md-nav__item">
  1057. <a href="#the-solution" class="md-nav__link">
  1058. <span class="md-ellipsis">
  1059. The solution
  1060. </span>
  1061. </a>
  1062. </li>
  1063. <li class="md-nav__item">
  1064. <a href="#create-the-main-kustomization" class="md-nav__link">
  1065. <span class="md-ellipsis">
  1066. Create the main kustomization
  1067. </span>
  1068. </a>
  1069. </li>
  1070. <li class="md-nav__item">
  1071. <a href="#create-the-secret" class="md-nav__link">
  1072. <span class="md-ellipsis">
  1073. Create the secret
  1074. </span>
  1075. </a>
  1076. </li>
  1077. <li class="md-nav__item">
  1078. <a href="#creating-the-references-to-repositories" class="md-nav__link">
  1079. <span class="md-ellipsis">
  1080. Creating the references to repositories
  1081. </span>
  1082. </a>
  1083. </li>
  1084. <li class="md-nav__item">
  1085. <a href="#deploy-the-crds" class="md-nav__link">
  1086. <span class="md-ellipsis">
  1087. Deploy the CRDs
  1088. </span>
  1089. </a>
  1090. </li>
  1091. <li class="md-nav__item">
  1092. <a href="#deploy-the-operator" class="md-nav__link">
  1093. <span class="md-ellipsis">
  1094. Deploy the operator
  1095. </span>
  1096. </a>
  1097. </li>
  1098. <li class="md-nav__item">
  1099. <a href="#deploy-the-crs" class="md-nav__link">
  1100. <span class="md-ellipsis">
  1101. Deploy the CRs
  1102. </span>
  1103. </a>
  1104. </li>
  1105. <li class="md-nav__item">
  1106. <a href="#results" class="md-nav__link">
  1107. <span class="md-ellipsis">
  1108. Results
  1109. </span>
  1110. </a>
  1111. </li>
  1112. </ul>
  1113. </nav>
  1114. </li>
  1115. <li class="md-nav__item">
  1116. <a href="../anchore-engine-credentials/" class="md-nav__link">
  1117. <span class="md-ellipsis">
  1118. Anchore Engine
  1119. </span>
  1120. </a>
  1121. </li>
  1122. <li class="md-nav__item">
  1123. <a href="../jenkins-kubernetes-credentials/" class="md-nav__link">
  1124. <span class="md-ellipsis">
  1125. Jenkins
  1126. </span>
  1127. </a>
  1128. </li>
  1129. <li class="md-nav__item">
  1130. <a href="../bitwarden/" class="md-nav__link">
  1131. <span class="md-ellipsis">
  1132. Bitwarden
  1133. </span>
  1134. </a>
  1135. </li>
  1136. </ul>
  1137. </nav>
  1138. </li>
  1139. <li class="md-nav__item md-nav__item--nested">
  1140. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
  1141. <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
  1142. <span class="md-ellipsis">
  1143. Community
  1144. </span>
  1145. <span class="md-nav__icon md-icon"></span>
  1146. </label>
  1147. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
  1148. <label class="md-nav__title" for="__nav_6">
  1149. <span class="md-nav__icon md-icon"></span>
  1150. Community
  1151. </label>
  1152. <ul class="md-nav__list" data-md-scrollfix>
  1153. <li class="md-nav__item md-nav__item--nested">
  1154. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6_1" >
  1155. <label class="md-nav__link" for="__nav_6_1" id="__nav_6_1_label" tabindex="0">
  1156. <span class="md-ellipsis">
  1157. Contributing
  1158. </span>
  1159. <span class="md-nav__icon md-icon"></span>
  1160. </label>
  1161. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_1_label" aria-expanded="false">
  1162. <label class="md-nav__title" for="__nav_6_1">
  1163. <span class="md-nav__icon md-icon"></span>
  1164. Contributing
  1165. </label>
  1166. <ul class="md-nav__list" data-md-scrollfix>
  1167. <li class="md-nav__item">
  1168. <a href="../../contributing/devguide/" class="md-nav__link">
  1169. <span class="md-ellipsis">
  1170. Developer guide
  1171. </span>
  1172. </a>
  1173. </li>
  1174. <li class="md-nav__item">
  1175. <a href="../../contributing/process/" class="md-nav__link">
  1176. <span class="md-ellipsis">
  1177. Contributing Process
  1178. </span>
  1179. </a>
  1180. </li>
  1181. <li class="md-nav__item">
  1182. <a href="../../contributing/release/" class="md-nav__link">
  1183. <span class="md-ellipsis">
  1184. Release Process
  1185. </span>
  1186. </a>
  1187. </li>
  1188. <li class="md-nav__item">
  1189. <a href="../../contributing/coc/" class="md-nav__link">
  1190. <span class="md-ellipsis">
  1191. Code of Conduct
  1192. </span>
  1193. </a>
  1194. </li>
  1195. <li class="md-nav__item">
  1196. <a href="../../contributing/calendar/" class="md-nav__link">
  1197. <span class="md-ellipsis">
  1198. Community meetings calendar
  1199. </span>
  1200. </a>
  1201. </li>
  1202. <li class="md-nav__item">
  1203. <a href="../../contributing/roadmap/" class="md-nav__link">
  1204. <span class="md-ellipsis">
  1205. Roadmap
  1206. </span>
  1207. </a>
  1208. </li>
  1209. </ul>
  1210. </nav>
  1211. </li>
  1212. <li class="md-nav__item md-nav__item--nested">
  1213. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6_2" >
  1214. <label class="md-nav__link" for="__nav_6_2" id="__nav_6_2_label" tabindex="0">
  1215. <span class="md-ellipsis">
  1216. External Resources
  1217. </span>
  1218. <span class="md-nav__icon md-icon"></span>
  1219. </label>
  1220. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_2_label" aria-expanded="false">
  1221. <label class="md-nav__title" for="__nav_6_2">
  1222. <span class="md-nav__icon md-icon"></span>
  1223. External Resources
  1224. </label>
  1225. <ul class="md-nav__list" data-md-scrollfix>
  1226. <li class="md-nav__item">
  1227. <a href="../../eso-talks/" class="md-nav__link">
  1228. <span class="md-ellipsis">
  1229. Talks
  1230. </span>
  1231. </a>
  1232. </li>
  1233. <li class="md-nav__item">
  1234. <a href="../../eso-demos/" class="md-nav__link">
  1235. <span class="md-ellipsis">
  1236. Demos
  1237. </span>
  1238. </a>
  1239. </li>
  1240. <li class="md-nav__item">
  1241. <a href="../../eso-blogs/" class="md-nav__link">
  1242. <span class="md-ellipsis">
  1243. Blogs
  1244. </span>
  1245. </a>
  1246. </li>
  1247. <li class="md-nav__item">
  1248. <a href="../../eso-tools/" class="md-nav__link">
  1249. <span class="md-ellipsis">
  1250. Tools
  1251. </span>
  1252. </a>
  1253. </li>
  1254. </ul>
  1255. </nav>
  1256. </li>
  1257. </ul>
  1258. </nav>
  1259. </li>
  1260. </ul>
  1261. </nav>
  1262. </div>
  1263. </div>
  1264. </div>
  1265. <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
  1266. <div class="md-sidebar__scrollwrap">
  1267. <div class="md-sidebar__inner">
  1268. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  1269. <label class="md-nav__title" for="__toc">
  1270. <span class="md-nav__icon md-icon"></span>
  1271. Table of contents
  1272. </label>
  1273. <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
  1274. <li class="md-nav__item">
  1275. <a href="#advantages" class="md-nav__link">
  1276. <span class="md-ellipsis">
  1277. Advantages
  1278. </span>
  1279. </a>
  1280. </li>
  1281. <li class="md-nav__item">
  1282. <a href="#the-approach" class="md-nav__link">
  1283. <span class="md-ellipsis">
  1284. The approach
  1285. </span>
  1286. </a>
  1287. </li>
  1288. <li class="md-nav__item">
  1289. <a href="#the-problem" class="md-nav__link">
  1290. <span class="md-ellipsis">
  1291. The problem
  1292. </span>
  1293. </a>
  1294. </li>
  1295. <li class="md-nav__item">
  1296. <a href="#the-solution" class="md-nav__link">
  1297. <span class="md-ellipsis">
  1298. The solution
  1299. </span>
  1300. </a>
  1301. </li>
  1302. <li class="md-nav__item">
  1303. <a href="#create-the-main-kustomization" class="md-nav__link">
  1304. <span class="md-ellipsis">
  1305. Create the main kustomization
  1306. </span>
  1307. </a>
  1308. </li>
  1309. <li class="md-nav__item">
  1310. <a href="#create-the-secret" class="md-nav__link">
  1311. <span class="md-ellipsis">
  1312. Create the secret
  1313. </span>
  1314. </a>
  1315. </li>
  1316. <li class="md-nav__item">
  1317. <a href="#creating-the-references-to-repositories" class="md-nav__link">
  1318. <span class="md-ellipsis">
  1319. Creating the references to repositories
  1320. </span>
  1321. </a>
  1322. </li>
  1323. <li class="md-nav__item">
  1324. <a href="#deploy-the-crds" class="md-nav__link">
  1325. <span class="md-ellipsis">
  1326. Deploy the CRDs
  1327. </span>
  1328. </a>
  1329. </li>
  1330. <li class="md-nav__item">
  1331. <a href="#deploy-the-operator" class="md-nav__link">
  1332. <span class="md-ellipsis">
  1333. Deploy the operator
  1334. </span>
  1335. </a>
  1336. </li>
  1337. <li class="md-nav__item">
  1338. <a href="#deploy-the-crs" class="md-nav__link">
  1339. <span class="md-ellipsis">
  1340. Deploy the CRs
  1341. </span>
  1342. </a>
  1343. </li>
  1344. <li class="md-nav__item">
  1345. <a href="#results" class="md-nav__link">
  1346. <span class="md-ellipsis">
  1347. Results
  1348. </span>
  1349. </a>
  1350. </li>
  1351. </ul>
  1352. </nav>
  1353. </div>
  1354. </div>
  1355. </div>
  1356. <div class="md-content" data-md-component="content">
  1357. <article class="md-content__inner md-typeset">
  1358. <h1 id="gitops-using-fluxcd-v2">GitOps using FluxCD (v2)</h1>
  1359. <p>FluxCD is a GitOps operator for Kubernetes. It synchronizes the status of the cluster from manifests allocated in
  1360. different repositories (Git or Helm). This approach fits perfectly with External Secrets on clusters which are dynamically
  1361. created, to get credentials with no manual intervention from the beginning.</p>
  1362. <h2 id="advantages">Advantages</h2>
  1363. <p>This approach has several advantages as follows:</p>
  1364. <ul>
  1365. <li><strong>Homogenize environments</strong> allowing developers to use the same toolset in Kind in the same way they do in the cloud
  1366. provider distributions such as EKS or GKE. This accelerates the development</li>
  1367. <li><strong>Reduce security risks</strong>, because credentials can be easily obtained, so temptation to store them locally is reduced.</li>
  1368. <li><strong>Application compatibility increase</strong>: Applications are deployed in different ways, and sometimes they need to share
  1369. credentials. This can be done using External Secrets as a wire for them at real time.</li>
  1370. <li><strong>Automation by default</strong> oh, come on!</li>
  1371. </ul>
  1372. <h2 id="the-approach">The approach</h2>
  1373. <p>FluxCD is composed by several controllers dedicated to manage different custom resources. The most important
  1374. ones are <strong>Kustomization</strong> (to clarify, Flux one, not Kubernetes' one) and <strong>HelmRelease</strong> to deploy using the approaches
  1375. of the same names.</p>
  1376. <p>External Secrets can be deployed using Helm <a href="../../introduction/getting-started/">as explained here</a>. The deployment includes the
  1377. CRDs if enabled on the <code>values.yaml</code>, but after this, you need to deploy some <code>SecretStore</code> to start
  1378. getting credentials from your secrets manager with External Secrets.</p>
  1379. <blockquote>
  1380. <p>The idea of this guide is to deploy the whole stack, using flux, needed by developers not to worry about the credentials,
  1381. but only about the application and its code.</p>
  1382. </blockquote>
  1383. <h2 id="the-problem">The problem</h2>
  1384. <p>This can sound easy, but External Secrets is deployed using Helm, which is managed by the HelmController,
  1385. and your custom resources, for example a <code>ClusterSecretStore</code> and the related <code>Secret</code>, are often deployed using a
  1386. <code>kustomization.yaml</code>, which is deployed by the KustomizeController.</p>
  1387. <p>Both controllers manage the resources independently, at different moments, with no possibility to wait each other.
  1388. This means that we have a wonderful race condition where sometimes the CRs (<code>SecretStore</code>,<code>ClusterSecretStore</code>...) tries
  1389. to be deployed before than the CRDs needed to recognize them.</p>
  1390. <h2 id="the-solution">The solution</h2>
  1391. <p>Let's see the conditions to start working on a solution:</p>
  1392. <ul>
  1393. <li>The External Secrets operator is deployed with Helm, and admits disabling the CRDs deployment</li>
  1394. <li>The race condition only affects the deployment of <code>CustomResourceDefinition</code> and the CRs needed later</li>
  1395. <li>CRDs can be deployed directly from the Git repository of the project using a Flux <code>Kustomization</code></li>
  1396. <li>Required CRs can be deployed using a Flux <code>Kustomization</code> too, allowing dependency between CRDs and CRs</li>
  1397. <li>All previous manifests can be applied with a Kubernetes <code>kustomization</code></li>
  1398. </ul>
  1399. <h2 id="create-the-main-kustomization">Create the main kustomization</h2>
  1400. <p>To have a better view of things needed later, the first manifest to be created is the <code>kustomization.yaml</code></p>
  1401. <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">kustomize.config.k8s.io/v1beta1</span>
  1402. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Kustomization</span>
  1403. <span class="nt">resources</span><span class="p">:</span>
  1404. <span class="c1"># Deploy the Vault access secret</span>
  1405. <span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">namespace.yaml</span>
  1406. <span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">secret-token.yaml</span>
  1407. <span class="c1"># Deploy the repositories</span>
  1408. <span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">repositories.yaml</span>
  1409. <span class="c1"># Deploy the CRDs</span>
  1410. <span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">deployment-crds.yaml</span>
  1411. <span class="c1"># Deploy the operator</span>
  1412. <span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">deployment.yaml</span>
  1413. <span class="c1"># Deploy default Custom Resources from &#39;crs&#39; directory</span>
  1414. <span class="c1"># INFO: This depends on the CRDs deployment. Will happen after it</span>
  1415. <span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">deployment-crs.yaml</span>
  1416. </code></pre></div>
  1417. <h2 id="create-the-secret">Create the secret</h2>
  1418. <p>To access your secret manager, External Secrets needs some credentials. They are stored inside a Secret, which is intended
  1419. to be deployed by automation as a good practise. This time, a placeholder called <code>secret-token.yaml</code> is show as an example:</p>
  1420. <div class="highlight"><pre><span></span><code><span class="c1"># The namespace.yaml first</span>
  1421. <span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">v1</span>
  1422. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Namespace</span>
  1423. <span class="nt">metadata</span><span class="p">:</span>
  1424. <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">external-secrets</span>
  1425. </code></pre></div>
  1426. <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>
  1427. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Secret</span>
  1428. <span class="nt">metadata</span><span class="p">:</span>
  1429. <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">vault-token-global</span>
  1430. <span class="w"> </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets</span>
  1431. <span class="nt">stringData</span><span class="p">:</span>
  1432. <span class="w"> </span><span class="c1"># This token must be patched by overlays. Not here for security reasons</span>
  1433. <span class="w"> </span><span class="nt">token</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">change-me-placeholder</span>
  1434. </code></pre></div>
  1435. <h2 id="creating-the-references-to-repositories">Creating the references to repositories</h2>
  1436. <p>Create a manifest called <code>repositories.yaml</code> to store the references to external repositories for Flux</p>
  1437. <div class="highlight"><pre><span></span><code><span class="c1"># Reference to Helm repository</span>
  1438. <span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">source.toolkit.fluxcd.io/v1</span>
  1439. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HelmRepository</span>
  1440. <span class="nt">metadata</span><span class="p">:</span>
  1441. <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">external-secrets</span>
  1442. <span class="w"> </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">flux-system</span>
  1443. <span class="nt">spec</span><span class="p">:</span>
  1444. <span class="w"> </span><span class="nt">interval</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10m</span>
  1445. <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://charts.external-secrets.io</span>
  1446. <span class="nn">---</span>
  1447. <span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">source.toolkit.fluxcd.io/v1</span>
  1448. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GitRepository</span>
  1449. <span class="nt">metadata</span><span class="p">:</span>
  1450. <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">external-secrets</span>
  1451. <span class="w"> </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">flux-system</span>
  1452. <span class="nt">spec</span><span class="p">:</span>
  1453. <span class="w"> </span><span class="nt">interval</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10m</span>
  1454. <span class="w"> </span><span class="nt">ref</span><span class="p">:</span>
  1455. <span class="w"> </span><span class="nt">tag</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">v0.10.3</span>
  1456. <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://github.com/external-secrets/external-secrets</span>
  1457. </code></pre></div>
  1458. <h2 id="deploy-the-crds">Deploy the CRDs</h2>
  1459. <p>As mentioned, CRDs can be deployed using the official Helm package, but to solve the race condition, they will be deployed
  1460. from our git repository using a Kustomization manifest called <code>deployment-crds.yaml</code> as follows:</p>
  1461. <div class="highlight"><pre><span></span><code><span class="nn">---</span>
  1462. <span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kustomize.toolkit.fluxcd.io/v1</span>
  1463. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Kustomization</span>
  1464. <span class="nt">metadata</span><span class="p">:</span>
  1465. <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">external-secrets-crds</span>
  1466. <span class="w"> </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">flux-system</span>
  1467. <span class="nt">spec</span><span class="p">:</span>
  1468. <span class="w"> </span><span class="nt">interval</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10m</span>
  1469. <span class="w"> </span><span class="nt">path</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">./deploy/crds</span>
  1470. <span class="w"> </span><span class="nt">prune</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
  1471. <span class="w"> </span><span class="nt">sourceRef</span><span class="p">:</span>
  1472. <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">GitRepository</span>
  1473. <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">external-secrets</span>
  1474. </code></pre></div>
  1475. <h2 id="deploy-the-operator">Deploy the operator</h2>
  1476. <p>The operator is deployed using a HelmRelease manifest to deploy the Helm package, but due to the special race condition,
  1477. the deployment must be disabled in the <code>values</code> of the manifest called <code>deployment.yaml</code>, as follows:</p>
  1478. <div class="highlight"><pre><span></span><code><span class="c1"># How to manage values files. Ref: https://fluxcd.io/docs/guides/helmreleases/#refer-to-values-inside-the-chart</span>
  1479. <span class="c1"># How to inject values: https://fluxcd.io/docs/guides/helmreleases/#cloud-storage</span>
  1480. <span class="nn">---</span>
  1481. <span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">helm.toolkit.fluxcd.io/v2</span>
  1482. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HelmRelease</span>
  1483. <span class="nt">metadata</span><span class="p">:</span>
  1484. <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">external-secrets</span>
  1485. <span class="w"> </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">flux-system</span>
  1486. <span class="nt">spec</span><span class="p">:</span>
  1487. <span class="w"> </span><span class="c1"># Override Release name to avoid the pattern Namespace-Release</span>
  1488. <span class="w"> </span><span class="c1"># Ref: https://fluxcd.io/flux/components/helm/api/v2/#helm.toolkit.fluxcd.io/v2.HelmRelease</span>
  1489. <span class="w"> </span><span class="nt">releaseName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets</span>
  1490. <span class="w"> </span><span class="nt">targetNamespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets</span>
  1491. <span class="w"> </span><span class="nt">interval</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10m</span>
  1492. <span class="w"> </span><span class="nt">chart</span><span class="p">:</span>
  1493. <span class="w"> </span><span class="nt">spec</span><span class="p">:</span>
  1494. <span class="w"> </span><span class="nt">chart</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets</span>
  1495. <span class="w"> </span><span class="nt">version</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">0.10.3</span>
  1496. <span class="w"> </span><span class="nt">sourceRef</span><span class="p">:</span>
  1497. <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">HelmRepository</span>
  1498. <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">external-secrets</span>
  1499. <span class="w"> </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">flux-system</span>
  1500. <span class="w"> </span><span class="nt">values</span><span class="p">:</span>
  1501. <span class="w"> </span><span class="nt">installCRDs</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">false</span>
  1502. <span class="w"> </span><span class="c1"># Ref: https://fluxcd.io/flux/components/helm/api/v2/#helm.toolkit.fluxcd.io/v2.Install</span>
  1503. <span class="w"> </span><span class="nt">install</span><span class="p">:</span>
  1504. <span class="w"> </span><span class="nt">createNamespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
  1505. </code></pre></div>
  1506. <h2 id="deploy-the-crs">Deploy the CRs</h2>
  1507. <p>Now, be ready for the arcane magic. Create a Kustomization manifest called <code>deployment-crs.yaml</code> with the following content:</p>
  1508. <div class="highlight"><pre><span></span><code><span class="nn">---</span>
  1509. <span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kustomize.toolkit.fluxcd.io/v1</span>
  1510. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Kustomization</span>
  1511. <span class="nt">metadata</span><span class="p">:</span>
  1512. <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">external-secrets-crs</span>
  1513. <span class="w"> </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">flux-system</span>
  1514. <span class="nt">spec</span><span class="p">:</span>
  1515. <span class="w"> </span><span class="nt">dependsOn</span><span class="p">:</span>
  1516. <span class="w"> </span><span class="p p-Indicator">-</span><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">external-secrets-crds</span>
  1517. <span class="w"> </span><span class="nt">interval</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10m</span>
  1518. <span class="w"> </span><span class="nt">path</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">./infrastructure/external-secrets/crs</span>
  1519. <span class="w"> </span><span class="nt">prune</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
  1520. <span class="w"> </span><span class="nt">sourceRef</span><span class="p">:</span>
  1521. <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">GitRepository</span>
  1522. <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">flux-system</span>
  1523. </code></pre></div>
  1524. <p>There are several interesting details to see here, that finally solves the race condition:</p>
  1525. <ol>
  1526. <li>First one is the field <code>dependsOn</code>, which points to a previous Kustomization called <code>external-secrets-crds</code>. This
  1527. dependency forces this deployment to wait for the other to be ready, before start being deployed.</li>
  1528. <li>The reference to the place where to find the CRs
  1529. <div class="highlight"><pre><span></span><code><span class="nt">path</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">./infrastructure/external-secrets/crs</span>
  1530. <span class="nt">sourceRef</span><span class="p">:</span>
  1531. <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">GitRepository</span>
  1532. <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">flux-system</span>
  1533. </code></pre></div>
  1534. Custom Resources will be searched in the relative path <code>./infrastructure/external-secrets/crs</code> of the GitRepository
  1535. called <code>flux-system</code>, which is a reference to the same repository that FluxCD watches to synchronize the cluster.
  1536. With fewer words, a reference to itself, but going to another directory called <code>crs</code></li>
  1537. </ol>
  1538. <p>Of course, allocate inside the mentioned path <code>./infrastructure/external-secrets/crs</code>, all the desired CRs to be deployed,
  1539. for example, a manifest <code>clusterSecretStore.yaml</code> to reach your Hashicorp Vault as follows:</p>
  1540. <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>
  1541. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ClusterSecretStore</span>
  1542. <span class="nt">metadata</span><span class="p">:</span>
  1543. <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">vault-backend-global</span>
  1544. <span class="nt">spec</span><span class="p">:</span>
  1545. <span class="w"> </span><span class="nt">provider</span><span class="p">:</span>
  1546. <span class="w"> </span><span class="nt">vault</span><span class="p">:</span>
  1547. <span class="w"> </span><span class="nt">server</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;https://vault.your-domain.com&quot;</span>
  1548. <span class="w"> </span><span class="nt">path</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">secret</span>
  1549. <span class="w"> </span><span class="nt">version</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">v2</span>
  1550. <span class="w"> </span><span class="nt">auth</span><span class="p">:</span>
  1551. <span class="w"> </span><span class="c1"># points to a secret that contains a vault token</span>
  1552. <span class="w"> </span><span class="c1"># https://www.vaultproject.io/docs/auth/token</span>
  1553. <span class="w"> </span><span class="nt">tokenSecretRef</span><span class="p">:</span>
  1554. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;vault-token-global&quot;</span>
  1555. <span class="w"> </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;token&quot;</span>
  1556. <span class="w"> </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets</span>
  1557. </code></pre></div>
  1558. <h2 id="results">Results</h2>
  1559. <p>At the end, the required files tree is shown in the following picture:</p>
  1560. <p><img alt="FluxCD files tree" src="../../pictures/screenshot_gitops_final_directory_tree.png" /></p>
  1561. </article>
  1562. </div>
  1563. <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
  1564. </div>
  1565. </main>
  1566. <img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=6658a9eb-067d-49f1-94f2-b8b00f21451e" alt=""/>
  1567. <footer class="md-footer">
  1568. <div class="md-footer-meta md-typeset">
  1569. <div class="md-footer-meta__inner md-grid">
  1570. <div class="md-copyright">
  1571. <div class="md-copyright__highlight">
  1572. &copy; 2025 The external-secrets Authors.<br/>
  1573. &copy; 2025 The Linux Foundation. All rights reserved.<br/><br/>
  1574. The Linux Foundation has registered trademarks and uses trademarks.<br/>
  1575. For a list of trademarks of The Linux Foundation, please see our <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage page</a>.
  1576. </div>
  1577. Made with
  1578. <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
  1579. Material for MkDocs
  1580. </a>
  1581. </div>
  1582. </div>
  1583. </div>
  1584. </footer>
  1585. </div>
  1586. <div class="md-dialog" data-md-component="dialog">
  1587. <div class="md-dialog__inner md-typeset"></div>
  1588. </div>
  1589. <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.tabs", "navigation.indexes", "navigation.expand"], "search": "../../assets/javascripts/workers/search.973d3a69.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>
  1590. <script src="../../assets/javascripts/bundle.92b07e13.min.js"></script>
  1591. </body>
  1592. </html>