index.html 67 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566356735683569357035713572357335743575357635773578357935803581358235833584358535863587358835893590359135923593359435953596359735983599
  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="../devguide/">
  7. <link rel="next" href="../release/">
  8. <link rel="icon" href="../../pictures/eso-round-logo.svg">
  9. <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
  10. <title>Contributing Process - External Secrets Operator</title>
  11. <link rel="stylesheet" href="../../assets/stylesheets/main.6543a935.min.css">
  12. <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
  13. <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">
  14. <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
  15. <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>
  16. <script id="__analytics">function __md_analytics(){function n(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],n("js",new Date),n("config","G-QP38TD8K7V"),document.addEventListener("DOMContentLoaded",function(){document.forms.search&&document.forms.search.query.addEventListener("blur",function(){this.value&&n("event","search",{search_term:this.value})}),document$.subscribe(function(){var a=document.forms.feedback;if(void 0!==a)for(var e of a.querySelectorAll("[type=submit]"))e.addEventListener("click",function(e){e.preventDefault();var t=document.location.pathname,e=this.getAttribute("data-md-value");n("event","feedback",{page:t,data:e}),a.firstElementChild.disabled=!0;e=a.querySelector(".md-feedback__note [data-md-value='"+e+"']");e&&(e.hidden=!1)}),a.hidden=!1}),location$.subscribe(function(e){n("config","G-QP38TD8K7V",{page_path:e.pathname})})});var e=document.createElement("script");e.async=!0,e.src="https://www.googletagmanager.com/gtag/js?id=G-QP38TD8K7V",document.getElementById("__analytics").insertAdjacentElement("afterEnd",e)}</script>
  17. <script>"undefined"!=typeof __md_analytics&&__md_analytics()</script>
  18. </head>
  19. <body dir="ltr">
  20. <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
  21. <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
  22. <label class="md-overlay" for="__drawer"></label>
  23. <div data-md-component="skip">
  24. <a href="#project-management" class="md-skip">
  25. Skip to content
  26. </a>
  27. </div>
  28. <div data-md-component="announce">
  29. </div>
  30. <div data-md-color-scheme="default" data-md-component="outdated" hidden>
  31. <aside class="md-banner md-banner--warning">
  32. <div class="md-banner__inner md-grid md-typeset">
  33. You're not viewing the latest version.
  34. <a href="../../..">
  35. <strong>Click here to go to latest.</strong>
  36. </a>
  37. </div>
  38. <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
  39. </aside>
  40. </div>
  41. <header class="md-header" data-md-component="header">
  42. <nav class="md-header__inner md-grid" aria-label="Header">
  43. <a href="../.." title="External Secrets Operator" class="md-header__button md-logo" aria-label="External Secrets Operator" data-md-component="logo">
  44. <img src="../../pictures/eso-round-logo.svg" alt="logo">
  45. </a>
  46. <label class="md-header__button md-icon" for="__drawer">
  47. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
  48. </label>
  49. <div class="md-header__title" data-md-component="header-title">
  50. <div class="md-header__ellipsis">
  51. <div class="md-header__topic">
  52. <span class="md-ellipsis">
  53. External Secrets Operator
  54. </span>
  55. </div>
  56. <div class="md-header__topic" data-md-component="header-topic">
  57. <span class="md-ellipsis">
  58. Contributing Process
  59. </span>
  60. </div>
  61. </div>
  62. </div>
  63. <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(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([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
  64. <label class="md-header__button md-icon" for="__search">
  65. <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.516 6.516 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 5Z"/></svg>
  66. </label>
  67. <div class="md-search" data-md-component="search" role="dialog">
  68. <label class="md-search__overlay" for="__search"></label>
  69. <div class="md-search__inner" role="search">
  70. <form class="md-search__form" name="search">
  71. <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>
  72. <label class="md-search__icon md-icon" for="__search">
  73. <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.516 6.516 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 5Z"/></svg>
  74. <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 11h12Z"/></svg>
  75. </label>
  76. <nav class="md-search__options" aria-label="Search">
  77. <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
  78. <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 12 19 6.41Z"/></svg>
  79. </button>
  80. </nav>
  81. </form>
  82. <div class="md-search__output">
  83. <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
  84. <div class="md-search-result" data-md-component="search-result">
  85. <div class="md-search-result__meta">
  86. Initializing search
  87. </div>
  88. <ol class="md-search-result__list" role="presentation"></ol>
  89. </div>
  90. </div>
  91. </div>
  92. </div>
  93. </div>
  94. <div class="md-header__source">
  95. <a href="https://github.com/external-secrets/external-secrets" title="Go to repository" class="md-source" data-md-component="source">
  96. <div class="md-source__icon md-icon">
  97. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.2 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 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
  98. </div>
  99. <div class="md-source__repository">
  100. External Secrets Operator
  101. </div>
  102. </a>
  103. </div>
  104. </nav>
  105. </header>
  106. <div class="md-container" data-md-component="container">
  107. <nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
  108. <div class="md-grid">
  109. <ul class="md-tabs__list">
  110. <li class="md-tabs__item">
  111. <a href="../.." class="md-tabs__link">
  112. Introduction
  113. </a>
  114. </li>
  115. <li class="md-tabs__item">
  116. <a href="../../api/components/" class="md-tabs__link">
  117. API
  118. </a>
  119. </li>
  120. <li class="md-tabs__item">
  121. <a href="../../guides/introduction/" class="md-tabs__link">
  122. Guides
  123. </a>
  124. </li>
  125. <li class="md-tabs__item">
  126. <a href="../../provider/aws-secrets-manager/" class="md-tabs__link">
  127. Provider
  128. </a>
  129. </li>
  130. <li class="md-tabs__item">
  131. <a href="../../examples/gitops-using-fluxcd/" class="md-tabs__link">
  132. Examples
  133. </a>
  134. </li>
  135. <li class="md-tabs__item md-tabs__item--active">
  136. <a href="../devguide/" class="md-tabs__link">
  137. Community
  138. </a>
  139. </li>
  140. <li class="md-tabs__item">
  141. <a href="../../spec/" class="md-tabs__link">
  142. References
  143. </a>
  144. </li>
  145. </ul>
  146. </div>
  147. </nav>
  148. <main class="md-main" data-md-component="main">
  149. <div class="md-main__inner md-grid">
  150. <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
  151. <div class="md-sidebar__scrollwrap">
  152. <div class="md-sidebar__inner">
  153. <nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
  154. <label class="md-nav__title" for="__drawer">
  155. <a href="../.." title="External Secrets Operator" class="md-nav__button md-logo" aria-label="External Secrets Operator" data-md-component="logo">
  156. <img src="../../pictures/eso-round-logo.svg" alt="logo">
  157. </a>
  158. External Secrets Operator
  159. </label>
  160. <div class="md-nav__source">
  161. <a href="https://github.com/external-secrets/external-secrets" title="Go to repository" class="md-source" data-md-component="source">
  162. <div class="md-source__icon md-icon">
  163. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.2 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 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
  164. </div>
  165. <div class="md-source__repository">
  166. External Secrets Operator
  167. </div>
  168. </a>
  169. </div>
  170. <ul class="md-nav__list" data-md-scrollfix>
  171. <li class="md-nav__item md-nav__item--nested">
  172. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_1" >
  173. <div class="md-nav__link md-nav__container">
  174. <a href="../.." class="md-nav__link ">
  175. <span class="md-ellipsis">
  176. Introduction
  177. </span>
  178. </a>
  179. <label class="md-nav__link " for="__nav_1" id="__nav_1_label" tabindex="0">
  180. <span class="md-nav__icon md-icon"></span>
  181. </label>
  182. </div>
  183. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_1_label" aria-expanded="false">
  184. <label class="md-nav__title" for="__nav_1">
  185. <span class="md-nav__icon md-icon"></span>
  186. Introduction
  187. </label>
  188. <ul class="md-nav__list" data-md-scrollfix>
  189. <li class="md-nav__item">
  190. <a href="../../introduction/overview/" class="md-nav__link">
  191. <span class="md-ellipsis">
  192. Overview
  193. </span>
  194. </a>
  195. </li>
  196. <li class="md-nav__item">
  197. <a href="../../introduction/getting-started/" class="md-nav__link">
  198. <span class="md-ellipsis">
  199. Getting started
  200. </span>
  201. </a>
  202. </li>
  203. <li class="md-nav__item">
  204. <a href="../../introduction/faq/" class="md-nav__link">
  205. <span class="md-ellipsis">
  206. FAQ
  207. </span>
  208. </a>
  209. </li>
  210. <li class="md-nav__item">
  211. <a href="../../introduction/stability-support/" class="md-nav__link">
  212. <span class="md-ellipsis">
  213. Stability and Support
  214. </span>
  215. </a>
  216. </li>
  217. <li class="md-nav__item">
  218. <a href="../../introduction/deprecation-policy/" class="md-nav__link">
  219. <span class="md-ellipsis">
  220. Deprecation Policy
  221. </span>
  222. </a>
  223. </li>
  224. </ul>
  225. </nav>
  226. </li>
  227. <li class="md-nav__item md-nav__item--nested">
  228. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
  229. <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
  230. <span class="md-ellipsis">
  231. API
  232. </span>
  233. <span class="md-nav__icon md-icon"></span>
  234. </label>
  235. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
  236. <label class="md-nav__title" for="__nav_2">
  237. <span class="md-nav__icon md-icon"></span>
  238. API
  239. </label>
  240. <ul class="md-nav__list" data-md-scrollfix>
  241. <li class="md-nav__item">
  242. <a href="../../api/components/" class="md-nav__link">
  243. <span class="md-ellipsis">
  244. Components
  245. </span>
  246. </a>
  247. </li>
  248. <li class="md-nav__item md-nav__item--nested">
  249. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_2" >
  250. <label class="md-nav__link" for="__nav_2_2" id="__nav_2_2_label" tabindex="0">
  251. <span class="md-ellipsis">
  252. Core Resources
  253. </span>
  254. <span class="md-nav__icon md-icon"></span>
  255. </label>
  256. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_2_label" aria-expanded="false">
  257. <label class="md-nav__title" for="__nav_2_2">
  258. <span class="md-nav__icon md-icon"></span>
  259. Core Resources
  260. </label>
  261. <ul class="md-nav__list" data-md-scrollfix>
  262. <li class="md-nav__item">
  263. <a href="../../api/externalsecret/" class="md-nav__link">
  264. <span class="md-ellipsis">
  265. ExternalSecret
  266. </span>
  267. </a>
  268. </li>
  269. <li class="md-nav__item">
  270. <a href="../../api/secretstore/" class="md-nav__link">
  271. <span class="md-ellipsis">
  272. SecretStore
  273. </span>
  274. </a>
  275. </li>
  276. <li class="md-nav__item">
  277. <a href="../../api/clustersecretstore/" class="md-nav__link">
  278. <span class="md-ellipsis">
  279. ClusterSecretStore
  280. </span>
  281. </a>
  282. </li>
  283. <li class="md-nav__item">
  284. <a href="../../api/clusterexternalsecret/" class="md-nav__link">
  285. <span class="md-ellipsis">
  286. ClusterExternalSecret
  287. </span>
  288. </a>
  289. </li>
  290. <li class="md-nav__item">
  291. <a href="../../api/pushsecret/" class="md-nav__link">
  292. <span class="md-ellipsis">
  293. PushSecret
  294. </span>
  295. </a>
  296. </li>
  297. </ul>
  298. </nav>
  299. </li>
  300. <li class="md-nav__item md-nav__item--nested">
  301. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_3" >
  302. <div class="md-nav__link md-nav__container">
  303. <a href="../../api/generator/" class="md-nav__link ">
  304. <span class="md-ellipsis">
  305. Generators
  306. </span>
  307. </a>
  308. <label class="md-nav__link " for="__nav_2_3" id="__nav_2_3_label" tabindex="0">
  309. <span class="md-nav__icon md-icon"></span>
  310. </label>
  311. </div>
  312. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_3_label" aria-expanded="false">
  313. <label class="md-nav__title" for="__nav_2_3">
  314. <span class="md-nav__icon md-icon"></span>
  315. Generators
  316. </label>
  317. <ul class="md-nav__list" data-md-scrollfix>
  318. <li class="md-nav__item">
  319. <a href="../../api/generator/acr/" class="md-nav__link">
  320. <span class="md-ellipsis">
  321. Azure Container Registry
  322. </span>
  323. </a>
  324. </li>
  325. <li class="md-nav__item">
  326. <a href="../../api/generator/ecr/" class="md-nav__link">
  327. <span class="md-ellipsis">
  328. AWS Elastic Container Registry
  329. </span>
  330. </a>
  331. </li>
  332. <li class="md-nav__item">
  333. <a href="../../api/generator/gcr/" class="md-nav__link">
  334. <span class="md-ellipsis">
  335. Google Container Registry
  336. </span>
  337. </a>
  338. </li>
  339. <li class="md-nav__item">
  340. <a href="../../api/generator/vault/" class="md-nav__link">
  341. <span class="md-ellipsis">
  342. Vault Dynamic Secret
  343. </span>
  344. </a>
  345. </li>
  346. <li class="md-nav__item">
  347. <a href="../../api/generator/password/" class="md-nav__link">
  348. <span class="md-ellipsis">
  349. Password
  350. </span>
  351. </a>
  352. </li>
  353. <li class="md-nav__item">
  354. <a href="../../api/generator/fake/" class="md-nav__link">
  355. <span class="md-ellipsis">
  356. Fake
  357. </span>
  358. </a>
  359. </li>
  360. <li class="md-nav__item">
  361. <a href="../../api/generator/webhook/" class="md-nav__link">
  362. <span class="md-ellipsis">
  363. Webhook
  364. </span>
  365. </a>
  366. </li>
  367. <li class="md-nav__item">
  368. <a href="../../api/generator/github/" class="md-nav__link">
  369. <span class="md-ellipsis">
  370. Github
  371. </span>
  372. </a>
  373. </li>
  374. </ul>
  375. </nav>
  376. </li>
  377. <li class="md-nav__item md-nav__item--nested">
  378. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_4" >
  379. <label class="md-nav__link" for="__nav_2_4" id="__nav_2_4_label" tabindex="0">
  380. <span class="md-ellipsis">
  381. Reference Docs
  382. </span>
  383. <span class="md-nav__icon md-icon"></span>
  384. </label>
  385. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_4_label" aria-expanded="false">
  386. <label class="md-nav__title" for="__nav_2_4">
  387. <span class="md-nav__icon md-icon"></span>
  388. Reference Docs
  389. </label>
  390. <ul class="md-nav__list" data-md-scrollfix>
  391. <li class="md-nav__item">
  392. <a href="../../api/spec/" class="md-nav__link">
  393. <span class="md-ellipsis">
  394. API specification
  395. </span>
  396. </a>
  397. </li>
  398. <li class="md-nav__item">
  399. <a href="../../api/controller-options/" class="md-nav__link">
  400. <span class="md-ellipsis">
  401. Controller Options
  402. </span>
  403. </a>
  404. </li>
  405. <li class="md-nav__item">
  406. <a href="../../api/metrics/" class="md-nav__link">
  407. <span class="md-ellipsis">
  408. Metrics
  409. </span>
  410. </a>
  411. </li>
  412. </ul>
  413. </nav>
  414. </li>
  415. </ul>
  416. </nav>
  417. </li>
  418. <li class="md-nav__item md-nav__item--nested">
  419. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
  420. <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
  421. <span class="md-ellipsis">
  422. Guides
  423. </span>
  424. <span class="md-nav__icon md-icon"></span>
  425. </label>
  426. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
  427. <label class="md-nav__title" for="__nav_3">
  428. <span class="md-nav__icon md-icon"></span>
  429. Guides
  430. </label>
  431. <ul class="md-nav__list" data-md-scrollfix>
  432. <li class="md-nav__item">
  433. <a href="../../guides/introduction/" class="md-nav__link">
  434. <span class="md-ellipsis">
  435. Introduction
  436. </span>
  437. </a>
  438. </li>
  439. <li class="md-nav__item md-nav__item--nested">
  440. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_2" >
  441. <label class="md-nav__link" for="__nav_3_2" id="__nav_3_2_label" tabindex="0">
  442. <span class="md-ellipsis">
  443. External Secrets
  444. </span>
  445. <span class="md-nav__icon md-icon"></span>
  446. </label>
  447. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_2_label" aria-expanded="false">
  448. <label class="md-nav__title" for="__nav_3_2">
  449. <span class="md-nav__icon md-icon"></span>
  450. External Secrets
  451. </label>
  452. <ul class="md-nav__list" data-md-scrollfix>
  453. <li class="md-nav__item">
  454. <a href="../../guides/all-keys-one-secret/" class="md-nav__link">
  455. <span class="md-ellipsis">
  456. Extract structured data
  457. </span>
  458. </a>
  459. </li>
  460. <li class="md-nav__item">
  461. <a href="../../guides/getallsecrets/" class="md-nav__link">
  462. <span class="md-ellipsis">
  463. Find Secrets by Name or Metadata
  464. </span>
  465. </a>
  466. </li>
  467. <li class="md-nav__item">
  468. <a href="../../guides/datafrom-rewrite/" class="md-nav__link">
  469. <span class="md-ellipsis">
  470. Rewriting Keys
  471. </span>
  472. </a>
  473. </li>
  474. <li class="md-nav__item md-nav__item--nested">
  475. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_2_4" >
  476. <label class="md-nav__link" for="__nav_3_2_4" id="__nav_3_2_4_label" tabindex="0">
  477. <span class="md-ellipsis">
  478. Advanced Templating
  479. </span>
  480. <span class="md-nav__icon md-icon"></span>
  481. </label>
  482. <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_3_2_4_label" aria-expanded="false">
  483. <label class="md-nav__title" for="__nav_3_2_4">
  484. <span class="md-nav__icon md-icon"></span>
  485. Advanced Templating
  486. </label>
  487. <ul class="md-nav__list" data-md-scrollfix>
  488. <li class="md-nav__item">
  489. <a href="../../guides/templating/" class="md-nav__link">
  490. <span class="md-ellipsis">
  491. v2
  492. </span>
  493. </a>
  494. </li>
  495. <li class="md-nav__item">
  496. <a href="../../guides/templating-v1/" class="md-nav__link">
  497. <span class="md-ellipsis">
  498. v1
  499. </span>
  500. </a>
  501. </li>
  502. </ul>
  503. </nav>
  504. </li>
  505. <li class="md-nav__item">
  506. <a href="../../guides/common-k8s-secret-types/" class="md-nav__link">
  507. <span class="md-ellipsis">
  508. Kubernetes Secret Types
  509. </span>
  510. </a>
  511. </li>
  512. <li class="md-nav__item">
  513. <a href="../../guides/ownership-deletion-policy/" class="md-nav__link">
  514. <span class="md-ellipsis">
  515. Lifecycle: ownership & deletion
  516. </span>
  517. </a>
  518. </li>
  519. <li class="md-nav__item">
  520. <a href="../../guides/decoding-strategy/" class="md-nav__link">
  521. <span class="md-ellipsis">
  522. Decoding Strategies
  523. </span>
  524. </a>
  525. </li>
  526. <li class="md-nav__item">
  527. <a href="../../guides/controller-class/" class="md-nav__link">
  528. <span class="md-ellipsis">
  529. Controller Classes
  530. </span>
  531. </a>
  532. </li>
  533. </ul>
  534. </nav>
  535. </li>
  536. <li class="md-nav__item">
  537. <a href="../../guides/generator/" class="md-nav__link">
  538. <span class="md-ellipsis">
  539. Generators
  540. </span>
  541. </a>
  542. </li>
  543. <li class="md-nav__item">
  544. <a href="../../guides/pushsecrets/" class="md-nav__link">
  545. <span class="md-ellipsis">
  546. Push Secrets
  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_5" >
  552. <label class="md-nav__link" for="__nav_3_5" id="__nav_3_5_label" tabindex="0">
  553. <span class="md-ellipsis">
  554. Operations
  555. </span>
  556. <span class="md-nav__icon md-icon"></span>
  557. </label>
  558. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_5_label" aria-expanded="false">
  559. <label class="md-nav__title" for="__nav_3_5">
  560. <span class="md-nav__icon md-icon"></span>
  561. Operations
  562. </label>
  563. <ul class="md-nav__list" data-md-scrollfix>
  564. <li class="md-nav__item">
  565. <a href="../../guides/multi-tenancy/" class="md-nav__link">
  566. <span class="md-ellipsis">
  567. Multi Tenancy
  568. </span>
  569. </a>
  570. </li>
  571. <li class="md-nav__item">
  572. <a href="../../guides/security-best-practices/" class="md-nav__link">
  573. <span class="md-ellipsis">
  574. Security Best Practices
  575. </span>
  576. </a>
  577. </li>
  578. <li class="md-nav__item">
  579. <a href="../../guides/threat-model/" class="md-nav__link">
  580. <span class="md-ellipsis">
  581. Threat Model
  582. </span>
  583. </a>
  584. </li>
  585. <li class="md-nav__item">
  586. <a href="../../guides/v1beta1/" class="md-nav__link">
  587. <span class="md-ellipsis">
  588. Upgrading to v1beta1
  589. </span>
  590. </a>
  591. </li>
  592. <li class="md-nav__item">
  593. <a href="../../guides/using-latest-image/" class="md-nav__link">
  594. <span class="md-ellipsis">
  595. Using Latest Image
  596. </span>
  597. </a>
  598. </li>
  599. <li class="md-nav__item">
  600. <a href="../../guides/disable-cluster-features/" class="md-nav__link">
  601. <span class="md-ellipsis">
  602. Disable Cluster Features
  603. </span>
  604. </a>
  605. </li>
  606. </ul>
  607. </nav>
  608. </li>
  609. </ul>
  610. </nav>
  611. </li>
  612. <li class="md-nav__item md-nav__item--nested">
  613. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
  614. <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
  615. <span class="md-ellipsis">
  616. Provider
  617. </span>
  618. <span class="md-nav__icon md-icon"></span>
  619. </label>
  620. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
  621. <label class="md-nav__title" for="__nav_4">
  622. <span class="md-nav__icon md-icon"></span>
  623. Provider
  624. </label>
  625. <ul class="md-nav__list" data-md-scrollfix>
  626. <li class="md-nav__item">
  627. <a href="../../provider/aws-secrets-manager/" class="md-nav__link">
  628. <span class="md-ellipsis">
  629. AWS Secrets Manager
  630. </span>
  631. </a>
  632. </li>
  633. <li class="md-nav__item">
  634. <a href="../../provider/aws-parameter-store/" class="md-nav__link">
  635. <span class="md-ellipsis">
  636. AWS Parameter Store
  637. </span>
  638. </a>
  639. </li>
  640. <li class="md-nav__item">
  641. <a href="../../provider/azure-key-vault/" class="md-nav__link">
  642. <span class="md-ellipsis">
  643. Azure Key Vault
  644. </span>
  645. </a>
  646. </li>
  647. <li class="md-nav__item">
  648. <a href="../../provider/chef/" class="md-nav__link">
  649. <span class="md-ellipsis">
  650. Chef
  651. </span>
  652. </a>
  653. </li>
  654. <li class="md-nav__item">
  655. <a href="../../provider/conjur/" class="md-nav__link">
  656. <span class="md-ellipsis">
  657. CyberArk Conjur
  658. </span>
  659. </a>
  660. </li>
  661. <li class="md-nav__item">
  662. <a href="../../provider/device42/" class="md-nav__link">
  663. <span class="md-ellipsis">
  664. Device42
  665. </span>
  666. </a>
  667. </li>
  668. <li class="md-nav__item">
  669. <a href="../../provider/google-secrets-manager/" class="md-nav__link">
  670. <span class="md-ellipsis">
  671. Google Cloud Secret Manager
  672. </span>
  673. </a>
  674. </li>
  675. <li class="md-nav__item">
  676. <a href="../../provider/hashicorp-vault/" class="md-nav__link">
  677. <span class="md-ellipsis">
  678. HashiCorp Vault
  679. </span>
  680. </a>
  681. </li>
  682. <li class="md-nav__item">
  683. <a href="../../provider/kubernetes/" class="md-nav__link">
  684. <span class="md-ellipsis">
  685. Kubernetes
  686. </span>
  687. </a>
  688. </li>
  689. <li class="md-nav__item">
  690. <a href="../../provider/ibm-secrets-manager/" class="md-nav__link">
  691. <span class="md-ellipsis">
  692. IBM Secrets Manager
  693. </span>
  694. </a>
  695. </li>
  696. <li class="md-nav__item">
  697. <a href="../../provider/akeyless/" class="md-nav__link">
  698. <span class="md-ellipsis">
  699. Akeyless
  700. </span>
  701. </a>
  702. </li>
  703. <li class="md-nav__item">
  704. <a href="../../provider/yandex-certificate-manager/" class="md-nav__link">
  705. <span class="md-ellipsis">
  706. Yandex Certificate Manager
  707. </span>
  708. </a>
  709. </li>
  710. <li class="md-nav__item">
  711. <a href="../../provider/yandex-lockbox/" class="md-nav__link">
  712. <span class="md-ellipsis">
  713. Yandex Lockbox
  714. </span>
  715. </a>
  716. </li>
  717. <li class="md-nav__item">
  718. <a href="../../provider/alibaba/" class="md-nav__link">
  719. <span class="md-ellipsis">
  720. Alibaba Cloud
  721. </span>
  722. </a>
  723. </li>
  724. <li class="md-nav__item">
  725. <a href="../../provider/gitlab-variables/" class="md-nav__link">
  726. <span class="md-ellipsis">
  727. GitLab Variables
  728. </span>
  729. </a>
  730. </li>
  731. <li class="md-nav__item">
  732. <a href="../../provider/oracle-vault/" class="md-nav__link">
  733. <span class="md-ellipsis">
  734. Oracle Vault
  735. </span>
  736. </a>
  737. </li>
  738. <li class="md-nav__item">
  739. <a href="../../provider/1password-automation/" class="md-nav__link">
  740. <span class="md-ellipsis">
  741. 1Password Secrets Automation
  742. </span>
  743. </a>
  744. </li>
  745. <li class="md-nav__item">
  746. <a href="../../provider/webhook/" class="md-nav__link">
  747. <span class="md-ellipsis">
  748. Webhook
  749. </span>
  750. </a>
  751. </li>
  752. <li class="md-nav__item">
  753. <a href="../../provider/fake/" class="md-nav__link">
  754. <span class="md-ellipsis">
  755. Fake
  756. </span>
  757. </a>
  758. </li>
  759. <li class="md-nav__item">
  760. <a href="../../provider/senhasegura-dsm/" class="md-nav__link">
  761. <span class="md-ellipsis">
  762. senhasegura DevOps Secrets Management (DSM)
  763. </span>
  764. </a>
  765. </li>
  766. <li class="md-nav__item">
  767. <a href="../../provider/doppler/" class="md-nav__link">
  768. <span class="md-ellipsis">
  769. Doppler
  770. </span>
  771. </a>
  772. </li>
  773. <li class="md-nav__item">
  774. <a href="../../provider/keeper-security/" class="md-nav__link">
  775. <span class="md-ellipsis">
  776. Keeper Security
  777. </span>
  778. </a>
  779. </li>
  780. <li class="md-nav__item">
  781. <a href="../../provider/cloak/" class="md-nav__link">
  782. <span class="md-ellipsis">
  783. Cloak End 2 End Encrypted Secrets
  784. </span>
  785. </a>
  786. </li>
  787. <li class="md-nav__item">
  788. <a href="../../provider/scaleway/" class="md-nav__link">
  789. <span class="md-ellipsis">
  790. Scaleway
  791. </span>
  792. </a>
  793. </li>
  794. <li class="md-nav__item">
  795. <a href="../../provider/delinea/" class="md-nav__link">
  796. <span class="md-ellipsis">
  797. Delinea
  798. </span>
  799. </a>
  800. </li>
  801. <li class="md-nav__item">
  802. <a href="../../provider/passbolt/" class="md-nav__link">
  803. <span class="md-ellipsis">
  804. Passbolt
  805. </span>
  806. </a>
  807. </li>
  808. <li class="md-nav__item">
  809. <a href="../../provider/pulumi/" class="md-nav__link">
  810. <span class="md-ellipsis">
  811. Pulumi ESC
  812. </span>
  813. </a>
  814. </li>
  815. <li class="md-nav__item">
  816. <a href="../../provider/onboardbase/" class="md-nav__link">
  817. <span class="md-ellipsis">
  818. Onboardbase
  819. </span>
  820. </a>
  821. </li>
  822. <li class="md-nav__item">
  823. <a href="../../provider-passworddepot/" class="md-nav__link">
  824. <span class="md-ellipsis">
  825. Password Depot
  826. </span>
  827. </a>
  828. </li>
  829. <li class="md-nav__item">
  830. <a href="../../provider/fortanix/" class="md-nav__link">
  831. <span class="md-ellipsis">
  832. Fortanix
  833. </span>
  834. </a>
  835. </li>
  836. <li class="md-nav__item">
  837. <a href="../../provider/infisical/" class="md-nav__link">
  838. <span class="md-ellipsis">
  839. Infisical
  840. </span>
  841. </a>
  842. </li>
  843. </ul>
  844. </nav>
  845. </li>
  846. <li class="md-nav__item md-nav__item--nested">
  847. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
  848. <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
  849. <span class="md-ellipsis">
  850. Examples
  851. </span>
  852. <span class="md-nav__icon md-icon"></span>
  853. </label>
  854. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
  855. <label class="md-nav__title" for="__nav_5">
  856. <span class="md-nav__icon md-icon"></span>
  857. Examples
  858. </label>
  859. <ul class="md-nav__list" data-md-scrollfix>
  860. <li class="md-nav__item">
  861. <a href="../../examples/gitops-using-fluxcd/" class="md-nav__link">
  862. <span class="md-ellipsis">
  863. FluxCD
  864. </span>
  865. </a>
  866. </li>
  867. <li class="md-nav__item">
  868. <a href="../../examples/anchore-engine-credentials/" class="md-nav__link">
  869. <span class="md-ellipsis">
  870. Anchore Engine
  871. </span>
  872. </a>
  873. </li>
  874. <li class="md-nav__item">
  875. <a href="../../examples/jenkins-kubernetes-credentials/" class="md-nav__link">
  876. <span class="md-ellipsis">
  877. Jenkins
  878. </span>
  879. </a>
  880. </li>
  881. <li class="md-nav__item">
  882. <a href="../../examples/bitwarden/" class="md-nav__link">
  883. <span class="md-ellipsis">
  884. BitWarden
  885. </span>
  886. </a>
  887. </li>
  888. </ul>
  889. </nav>
  890. </li>
  891. <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
  892. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
  893. <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="">
  894. <span class="md-ellipsis">
  895. Community
  896. </span>
  897. <span class="md-nav__icon md-icon"></span>
  898. </label>
  899. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
  900. <label class="md-nav__title" for="__nav_6">
  901. <span class="md-nav__icon md-icon"></span>
  902. Community
  903. </label>
  904. <ul class="md-nav__list" data-md-scrollfix>
  905. <li class="md-nav__item md-nav__item--active md-nav__item--nested">
  906. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_1" checked>
  907. <label class="md-nav__link" for="__nav_6_1" id="__nav_6_1_label" tabindex="0">
  908. <span class="md-ellipsis">
  909. Contributing
  910. </span>
  911. <span class="md-nav__icon md-icon"></span>
  912. </label>
  913. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_1_label" aria-expanded="true">
  914. <label class="md-nav__title" for="__nav_6_1">
  915. <span class="md-nav__icon md-icon"></span>
  916. Contributing
  917. </label>
  918. <ul class="md-nav__list" data-md-scrollfix>
  919. <li class="md-nav__item">
  920. <a href="../devguide/" class="md-nav__link">
  921. <span class="md-ellipsis">
  922. Developer guide
  923. </span>
  924. </a>
  925. </li>
  926. <li class="md-nav__item md-nav__item--active">
  927. <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
  928. <label class="md-nav__link md-nav__link--active" for="__toc">
  929. <span class="md-ellipsis">
  930. Contributing Process
  931. </span>
  932. <span class="md-nav__icon md-icon"></span>
  933. </label>
  934. <a href="./" class="md-nav__link md-nav__link--active">
  935. <span class="md-ellipsis">
  936. Contributing Process
  937. </span>
  938. </a>
  939. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  940. <label class="md-nav__title" for="__toc">
  941. <span class="md-nav__icon md-icon"></span>
  942. Table of contents
  943. </label>
  944. <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
  945. <li class="md-nav__item">
  946. <a href="#project-management" class="md-nav__link">
  947. <span class="md-ellipsis">
  948. Project Management
  949. </span>
  950. </a>
  951. </li>
  952. <li class="md-nav__item">
  953. <a href="#issues" class="md-nav__link">
  954. <span class="md-ellipsis">
  955. Issues
  956. </span>
  957. </a>
  958. </li>
  959. <li class="md-nav__item">
  960. <a href="#submitting-a-pull-request" class="md-nav__link">
  961. <span class="md-ellipsis">
  962. Submitting a Pull Request
  963. </span>
  964. </a>
  965. <nav class="md-nav" aria-label="Submitting a Pull Request">
  966. <ul class="md-nav__list">
  967. <li class="md-nav__item">
  968. <a href="#triggering-e2e-tests" class="md-nav__link">
  969. <span class="md-ellipsis">
  970. Triggering e2e tests
  971. </span>
  972. </a>
  973. <nav class="md-nav" aria-label="Triggering e2e tests">
  974. <ul class="md-nav__list">
  975. <li class="md-nav__item">
  976. <a href="#executing-e2e-tests-locally" class="md-nav__link">
  977. <span class="md-ellipsis">
  978. Executing e2e tests locally
  979. </span>
  980. </a>
  981. </li>
  982. <li class="md-nav__item">
  983. <a href="#managed-kubernetes-e2e-tests" class="md-nav__link">
  984. <span class="md-ellipsis">
  985. Managed Kubernetes e2e tests
  986. </span>
  987. </a>
  988. </li>
  989. </ul>
  990. </nav>
  991. </li>
  992. <li class="md-nav__item">
  993. <a href="#executing-managed-kubernetes-e2e-tests-locally" class="md-nav__link">
  994. <span class="md-ellipsis">
  995. Executing Managed Kubernetes e2e tests locally
  996. </span>
  997. </a>
  998. </li>
  999. </ul>
  1000. </nav>
  1001. </li>
  1002. <li class="md-nav__item">
  1003. <a href="#proposal-process" class="md-nav__link">
  1004. <span class="md-ellipsis">
  1005. Proposal Process
  1006. </span>
  1007. </a>
  1008. </li>
  1009. <li class="md-nav__item">
  1010. <a href="#release-planning" class="md-nav__link">
  1011. <span class="md-ellipsis">
  1012. Release Planning
  1013. </span>
  1014. </a>
  1015. </li>
  1016. <li class="md-nav__item">
  1017. <a href="#support-questions" class="md-nav__link">
  1018. <span class="md-ellipsis">
  1019. Support &amp; Questions
  1020. </span>
  1021. </a>
  1022. </li>
  1023. <li class="md-nav__item">
  1024. <a href="#cutting-releases" class="md-nav__link">
  1025. <span class="md-ellipsis">
  1026. Cutting Releases
  1027. </span>
  1028. </a>
  1029. </li>
  1030. </ul>
  1031. </nav>
  1032. </li>
  1033. <li class="md-nav__item">
  1034. <a href="../release/" class="md-nav__link">
  1035. <span class="md-ellipsis">
  1036. Release Process
  1037. </span>
  1038. </a>
  1039. </li>
  1040. <li class="md-nav__item">
  1041. <a href="../coc/" class="md-nav__link">
  1042. <span class="md-ellipsis">
  1043. Code of Conduct
  1044. </span>
  1045. </a>
  1046. </li>
  1047. <li class="md-nav__item">
  1048. <a href="../roadmap/" class="md-nav__link">
  1049. <span class="md-ellipsis">
  1050. Roadmap
  1051. </span>
  1052. </a>
  1053. </li>
  1054. </ul>
  1055. </nav>
  1056. </li>
  1057. <li class="md-nav__item md-nav__item--nested">
  1058. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6_2" >
  1059. <label class="md-nav__link" for="__nav_6_2" id="__nav_6_2_label" tabindex="0">
  1060. <span class="md-ellipsis">
  1061. External Resources
  1062. </span>
  1063. <span class="md-nav__icon md-icon"></span>
  1064. </label>
  1065. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_2_label" aria-expanded="false">
  1066. <label class="md-nav__title" for="__nav_6_2">
  1067. <span class="md-nav__icon md-icon"></span>
  1068. External Resources
  1069. </label>
  1070. <ul class="md-nav__list" data-md-scrollfix>
  1071. <li class="md-nav__item">
  1072. <a href="../../eso-talks/" class="md-nav__link">
  1073. <span class="md-ellipsis">
  1074. Talks
  1075. </span>
  1076. </a>
  1077. </li>
  1078. <li class="md-nav__item">
  1079. <a href="../../eso-demos/" class="md-nav__link">
  1080. <span class="md-ellipsis">
  1081. Demos
  1082. </span>
  1083. </a>
  1084. </li>
  1085. <li class="md-nav__item">
  1086. <a href="../../eso-blogs/" class="md-nav__link">
  1087. <span class="md-ellipsis">
  1088. Blogs
  1089. </span>
  1090. </a>
  1091. </li>
  1092. </ul>
  1093. </nav>
  1094. </li>
  1095. </ul>
  1096. </nav>
  1097. </li>
  1098. <li class="md-nav__item md-nav__item--nested">
  1099. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_7" >
  1100. <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">
  1101. <span class="md-ellipsis">
  1102. References
  1103. </span>
  1104. <span class="md-nav__icon md-icon"></span>
  1105. </label>
  1106. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
  1107. <label class="md-nav__title" for="__nav_7">
  1108. <span class="md-nav__icon md-icon"></span>
  1109. References
  1110. </label>
  1111. <ul class="md-nav__list" data-md-scrollfix>
  1112. <li class="md-nav__item">
  1113. <a href="../../spec/" class="md-nav__link">
  1114. <span class="md-ellipsis">
  1115. API specification
  1116. </span>
  1117. </a>
  1118. </li>
  1119. </ul>
  1120. </nav>
  1121. </li>
  1122. </ul>
  1123. </nav>
  1124. </div>
  1125. </div>
  1126. </div>
  1127. <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
  1128. <div class="md-sidebar__scrollwrap">
  1129. <div class="md-sidebar__inner">
  1130. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  1131. <label class="md-nav__title" for="__toc">
  1132. <span class="md-nav__icon md-icon"></span>
  1133. Table of contents
  1134. </label>
  1135. <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
  1136. <li class="md-nav__item">
  1137. <a href="#project-management" class="md-nav__link">
  1138. <span class="md-ellipsis">
  1139. Project Management
  1140. </span>
  1141. </a>
  1142. </li>
  1143. <li class="md-nav__item">
  1144. <a href="#issues" class="md-nav__link">
  1145. <span class="md-ellipsis">
  1146. Issues
  1147. </span>
  1148. </a>
  1149. </li>
  1150. <li class="md-nav__item">
  1151. <a href="#submitting-a-pull-request" class="md-nav__link">
  1152. <span class="md-ellipsis">
  1153. Submitting a Pull Request
  1154. </span>
  1155. </a>
  1156. <nav class="md-nav" aria-label="Submitting a Pull Request">
  1157. <ul class="md-nav__list">
  1158. <li class="md-nav__item">
  1159. <a href="#triggering-e2e-tests" class="md-nav__link">
  1160. <span class="md-ellipsis">
  1161. Triggering e2e tests
  1162. </span>
  1163. </a>
  1164. <nav class="md-nav" aria-label="Triggering e2e tests">
  1165. <ul class="md-nav__list">
  1166. <li class="md-nav__item">
  1167. <a href="#executing-e2e-tests-locally" class="md-nav__link">
  1168. <span class="md-ellipsis">
  1169. Executing e2e tests locally
  1170. </span>
  1171. </a>
  1172. </li>
  1173. <li class="md-nav__item">
  1174. <a href="#managed-kubernetes-e2e-tests" class="md-nav__link">
  1175. <span class="md-ellipsis">
  1176. Managed Kubernetes e2e tests
  1177. </span>
  1178. </a>
  1179. </li>
  1180. </ul>
  1181. </nav>
  1182. </li>
  1183. <li class="md-nav__item">
  1184. <a href="#executing-managed-kubernetes-e2e-tests-locally" class="md-nav__link">
  1185. <span class="md-ellipsis">
  1186. Executing Managed Kubernetes e2e tests locally
  1187. </span>
  1188. </a>
  1189. </li>
  1190. </ul>
  1191. </nav>
  1192. </li>
  1193. <li class="md-nav__item">
  1194. <a href="#proposal-process" class="md-nav__link">
  1195. <span class="md-ellipsis">
  1196. Proposal Process
  1197. </span>
  1198. </a>
  1199. </li>
  1200. <li class="md-nav__item">
  1201. <a href="#release-planning" class="md-nav__link">
  1202. <span class="md-ellipsis">
  1203. Release Planning
  1204. </span>
  1205. </a>
  1206. </li>
  1207. <li class="md-nav__item">
  1208. <a href="#support-questions" class="md-nav__link">
  1209. <span class="md-ellipsis">
  1210. Support &amp; Questions
  1211. </span>
  1212. </a>
  1213. </li>
  1214. <li class="md-nav__item">
  1215. <a href="#cutting-releases" class="md-nav__link">
  1216. <span class="md-ellipsis">
  1217. Cutting Releases
  1218. </span>
  1219. </a>
  1220. </li>
  1221. </ul>
  1222. </nav>
  1223. </div>
  1224. </div>
  1225. </div>
  1226. <div class="md-content" data-md-component="content">
  1227. <article class="md-content__inner md-typeset">
  1228. <h1>Contributing Process</h1>
  1229. <h2 id="project-management">Project Management</h2>
  1230. <p>The Code, our TODOs and Documentation is maintained on
  1231. <a href="https://github.com/external-secrets/external-secrets">GitHub</a>. All Issues
  1232. should be opened in that repository.
  1233. We have a <a href="../roadmap/">Roadmap</a> to track progress for our road towards GA.</p>
  1234. <h2 id="issues">Issues</h2>
  1235. <p>Features, bugs and any issues regarding the documentation should be filed as
  1236. <a href="https://github.com/external-secrets/external-secrets/issues">GitHub Issue</a> in
  1237. our repository. We use labels like <code>kind/feature</code>, <code>kind/bug</code>, <code>area/aws</code> to
  1238. organize the issues. Issues labeled <code>good first issue</code> and <code>help wanted</code> are
  1239. especially good for a first contribution. If you want to pick up an issue just
  1240. leave a comment.</p>
  1241. <h2 id="submitting-a-pull-request">Submitting a Pull Request</h2>
  1242. <p>This project uses the well-known pull request process from GitHub. To submit a
  1243. pull request, fork the repository and push any changes to a branch on the copy,
  1244. from there a pull request can be made in the main repo. Merging a pull request
  1245. requires the following steps to be completed before the pull request will
  1246. be merged:</p>
  1247. <ul>
  1248. <li>ideally, there is an issue that documents the problem or feature in depth.</li>
  1249. <li>code must have a reasonable amount of test coverage</li>
  1250. <li>tests must pass</li>
  1251. <li>PR needs be reviewed and approved</li>
  1252. </ul>
  1253. <p>Once these steps are completed the PR will be merged by a code owner.
  1254. We're using the pull request <code>assignee</code> feature to track who is responsible
  1255. for the lifecycle of the PR: review, merging, ping on inactivity, close.
  1256. We close pull requests or issues if there is no response from the author for
  1257. a period of time. Feel free to reopen if you want to get back on it.</p>
  1258. <h3 id="triggering-e2e-tests">Triggering e2e tests</h3>
  1259. <p>We have an extensive set of e2e tests that test the integration with <em>real</em> cloud provider APIs.
  1260. Maintainers must trigger these kind of tests manually for PRs that come from forked repositories. These tests run inside a <code>kind</code> cluster in the GitHub Actions runner:</p>
  1261. <div class="highlight"><pre><span></span><code>/ok-to-test sha=xxxxxx
  1262. </code></pre></div>
  1263. <h4 id="executing-e2e-tests-locally">Executing e2e tests locally</h4>
  1264. <p>You have to prepare your shell environment with the necessary variables so the e2e test
  1265. runner knows what credentials to use. See <code>e2e/run.sh</code> for the variables that are passed in.
  1266. If you e.g. want to test AWS integration make sure set all <code>AWS_*</code> variables mentioned
  1267. in that file.</p>
  1268. <p>Use <a href="https://onsi.github.io/ginkgo/#spec-labels">ginkgo labels</a> to select the tests
  1269. you want to execute. You have to specify <code>!managed</code> to ensure that you do not
  1270. run managed tests.</p>
  1271. <div class="highlight"><pre><span></span><code>make test.e2e GINKGO_LABELS=&#39;gcp&amp;&amp;!managed&#39;
  1272. </code></pre></div>
  1273. <h4 id="managed-kubernetes-e2e-tests">Managed Kubernetes e2e tests</h4>
  1274. <p>There's another suite of e2e tests that integrate with managed Kubernetes offerings.
  1275. They create real infrastructure at a cloud provider and deploy the controller
  1276. into that environment.
  1277. This is necessary to test the authentication integration
  1278. (<a href="https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity">GCP Workload Identity</a>,
  1279. <a href="https://docs.aws.amazon.com/eks/latest/userguide/iam-roles-for-service-accounts.html">EKS IRSA</a>...).</p>
  1280. <p>These tests are time intensive (~20-45min) and must be triggered manually by
  1281. a maintainer when a particular provider or authentication mechanism was changed:</p>
  1282. <div class="highlight"><pre><span></span><code>/ok-to-test-managed sha=xxxxxx provider=aws
  1283. # or
  1284. /ok-to-test-managed sha=xxxxxx provider=gcp
  1285. # or
  1286. /ok-to-test-managed sha=xxxxxx provider=azure
  1287. </code></pre></div>
  1288. <p>Both tests can run in parallel. Once started they add a dynamic GitHub check <code>integration-managed-(gcp|aws|azure)</code> to the PR that triggered the test.</p>
  1289. <h3 id="executing-managed-kubernetes-e2e-tests-locally">Executing Managed Kubernetes e2e tests locally</h3>
  1290. <p>You have to prepare your shell environment with the necessary variables so the e2e
  1291. test runner knows what credentials to use. See <code>.github/workflows/e2e-managed.yml</code>
  1292. for the variables that are passed in. If you e.g. want to test AWS integration make
  1293. sure set all variables containing <code>AWS_*</code> and <code>TF_VAR_AWS_*</code> mentioned in that file.</p>
  1294. <p>Then execute <code>tf.apply.aws</code> or <code>tf.apply.gcp</code> to create the infrastructure.</p>
  1295. <div class="highlight"><pre><span></span><code>make tf.apply.aws
  1296. </code></pre></div>
  1297. <p>Then run the <code>managed</code> testsuite. You will need push permissions to the external-secrets ghcr repository. You can set <code>IMAGE_NAME</code> to control which image registry is used to store the controller and e2e test images in.</p>
  1298. <p>You also have to setup a proper Kubeconfig so the e2e test pod gets deployed into the managed cluster.</p>
  1299. <div class="highlight"><pre><span></span><code>aws eks update-kubeconfig --name ${AWS_CLUSTER_NAME}
  1300. or
  1301. gcloud container clusters get-credentials ${GCP_GKE_CLUSTER} --region europe-west1-b
  1302. </code></pre></div>
  1303. <p>Use <a href="https://onsi.github.io/ginkgo/#spec-labels">ginkgo labels</a> to select the tests
  1304. you want to execute.</p>
  1305. <div class="highlight"><pre><span></span><code># you may have to set IMAGE_NAME=docker.io/your-user/external-secrets
  1306. make test.e2e.managed GINKGO_LABELS=&#39;gcp&#39;
  1307. </code></pre></div>
  1308. <h2 id="proposal-process">Proposal Process</h2>
  1309. <p>Before we introduce significant changes to the project we want to gather feedback
  1310. from the community to ensure that we progress in the right direction before we
  1311. develop and release big changes. Significant changes include for example:</p>
  1312. <ul>
  1313. <li>creating new custom resources</li>
  1314. <li>proposing breaking changes</li>
  1315. <li>changing the behavior of the controller significantly</li>
  1316. </ul>
  1317. <p>Please create a document in the <code>design/</code> directory based on the template <code>000-template.md</code>
  1318. and fill in your proposal. Open a pull request in draft mode and request feedback. Once the proposal is accepted and the pull request is merged we can create work packages and proceed with the implementation.</p>
  1319. <h2 id="release-planning">Release Planning</h2>
  1320. <p>We have a <a href="https://github.com/orgs/external-secrets/projects/2/views/1">GitHub Project Board</a> where we organize issues on a high level. We group issues by milestone. Once all issues of a given milestone are closed we should prepare a new feature release. Issues of the next milestone have priority over other issues - but that does not mean that no one is allowed to start working on them.</p>
  1321. <p>Issues must be <em>manually</em> added to that board (at least for now, see <a href="https://github.com/github/roadmap/issues/286">GH Roadmap</a>). Milestones must be assigned manually as well. If no milestone is assigned it is basically a backlog item. It is the responsibility of the maintainers to:</p>
  1322. <ol>
  1323. <li>assign new issues to the GH Project</li>
  1324. <li>add a milestone if needed</li>
  1325. <li>add appropriate labels</li>
  1326. </ol>
  1327. <p>If you would like to raise the priority of an issue for whatever reason feel free to comment on the issue or ping a maintainer.</p>
  1328. <h2 id="support-questions">Support &amp; Questions</h2>
  1329. <p>Providing support to end users is an important and difficult task.
  1330. We have three different channels through which support questions arise:</p>
  1331. <ol>
  1332. <li>Kubernetes Slack <a href="https://kubernetes.slack.com/archives/C017BF84G2Y">#external-secrets</a></li>
  1333. <li><a href="https://github.com/external-secrets/external-secrets/discussions">GitHub Discussions</a></li>
  1334. <li>GitHub Issues</li>
  1335. </ol>
  1336. <p>We use labels to identify GitHub Issues. Specifically for managing support cases we use the following labels to identify the state a support case is in:</p>
  1337. <ul>
  1338. <li><code>triage/needs-information</code>: Indicates an issue needs more information in order to work on it.</li>
  1339. <li><code>triage/not-reproducible</code>: Indicates an issue can not be reproduced as described.</li>
  1340. <li><code>triage/support</code>: Indicates an issue that is a support question.</li>
  1341. </ul>
  1342. <h2 id="cutting-releases">Cutting Releases</h2>
  1343. <p>The external-secrets project is released on a as-needed basis. Feel free to open a issue to request a release. Details on how to cut a release can be found in the <a href="../release/">release</a> page.</p>
  1344. </article>
  1345. </div>
  1346. <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
  1347. </div>
  1348. </main>
  1349. <footer class="md-footer">
  1350. <div class="md-footer-meta md-typeset">
  1351. <div class="md-footer-meta__inner md-grid">
  1352. <div class="md-copyright">
  1353. <div class="md-copyright__highlight">
  1354. &copy; 2024 The external-secrets Authors.<br/>
  1355. &copy; 2024 The Linux Foundation. All rights reserved.<br/><br/>
  1356. The Linux Foundation has registered trademarks and uses trademarks.<br/>
  1357. For a list of trademarks of The Linux Foundation, please see our <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage page</a>.
  1358. </div>
  1359. Made with
  1360. <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
  1361. Material for MkDocs
  1362. </a>
  1363. </div>
  1364. </div>
  1365. </div>
  1366. </footer>
  1367. </div>
  1368. <div class="md-dialog" data-md-component="dialog">
  1369. <div class="md-dialog__inner md-typeset"></div>
  1370. </div>
  1371. <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.tabs", "navigation.indexes", "navigation.expand"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "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>
  1372. <script src="../../assets/javascripts/bundle.ad660dcc.min.js"></script>
  1373. </body>
  1374. </html>