index.html 58 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182
  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="../getting-started/">
  7. <link rel="next" href="../stability-support/">
  8. <link rel="icon" href="../../assets/images/favicon.png">
  9. <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.9">
  10. <title>FAQ - External Secrets Operator</title>
  11. <link rel="stylesheet" href="../../assets/stylesheets/main.f2e4d321.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="#can-i-manually-trigger-a-secret-refresh" 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. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z"/></svg>
  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. FAQ
  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" 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.1 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 2023 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 md-tabs__item--active">
  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">
  136. <a href="../../contributing/devguide/" class="md-tabs__link">
  137. Community
  138. </a>
  139. </li>
  140. </ul>
  141. </div>
  142. </nav>
  143. <main class="md-main" data-md-component="main">
  144. <div class="md-main__inner md-grid">
  145. <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
  146. <div class="md-sidebar__scrollwrap">
  147. <div class="md-sidebar__inner">
  148. <nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
  149. <label class="md-nav__title" for="__drawer">
  150. <a href="../.." title="External Secrets Operator" class="md-nav__button md-logo" aria-label="External Secrets Operator" data-md-component="logo">
  151. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z"/></svg>
  152. </a>
  153. External Secrets Operator
  154. </label>
  155. <div class="md-nav__source">
  156. <a href="https://github.com/external-secrets/external-secrets" title="Go to repository" class="md-source" data-md-component="source">
  157. <div class="md-source__icon md-icon">
  158. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 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 2023 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>
  159. </div>
  160. <div class="md-source__repository">
  161. External Secrets Operator
  162. </div>
  163. </a>
  164. </div>
  165. <ul class="md-nav__list" data-md-scrollfix>
  166. <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
  167. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_1" checked>
  168. <div class="md-nav__link md-nav__container">
  169. <a href="../.." class="md-nav__link ">
  170. <span class="md-ellipsis">
  171. Introduction
  172. </span>
  173. </a>
  174. <label class="md-nav__link " for="__nav_1" id="__nav_1_label" tabindex="">
  175. <span class="md-nav__icon md-icon"></span>
  176. </label>
  177. </div>
  178. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_1_label" aria-expanded="true">
  179. <label class="md-nav__title" for="__nav_1">
  180. <span class="md-nav__icon md-icon"></span>
  181. Introduction
  182. </label>
  183. <ul class="md-nav__list" data-md-scrollfix>
  184. <li class="md-nav__item">
  185. <a href="../overview/" class="md-nav__link">
  186. <span class="md-ellipsis">
  187. Overview
  188. </span>
  189. </a>
  190. </li>
  191. <li class="md-nav__item">
  192. <a href="../getting-started/" class="md-nav__link">
  193. <span class="md-ellipsis">
  194. Getting started
  195. </span>
  196. </a>
  197. </li>
  198. <li class="md-nav__item md-nav__item--active">
  199. <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
  200. <label class="md-nav__link md-nav__link--active" for="__toc">
  201. <span class="md-ellipsis">
  202. FAQ
  203. </span>
  204. <span class="md-nav__icon md-icon"></span>
  205. </label>
  206. <a href="./" class="md-nav__link md-nav__link--active">
  207. <span class="md-ellipsis">
  208. FAQ
  209. </span>
  210. </a>
  211. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  212. <label class="md-nav__title" for="__toc">
  213. <span class="md-nav__icon md-icon"></span>
  214. Table of contents
  215. </label>
  216. <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
  217. <li class="md-nav__item">
  218. <a href="#can-i-manually-trigger-a-secret-refresh" class="md-nav__link">
  219. <span class="md-ellipsis">
  220. Can I manually trigger a secret refresh?
  221. </span>
  222. </a>
  223. </li>
  224. <li class="md-nav__item">
  225. <a href="#how-do-i-know-when-my-secret-was-last-synced" class="md-nav__link">
  226. <span class="md-ellipsis">
  227. How do I know when my secret was last synced?
  228. </span>
  229. </a>
  230. </li>
  231. <li class="md-nav__item">
  232. <a href="#how-do-i-know-when-the-status-of-my-secret-changed-the-last-time" class="md-nav__link">
  233. <span class="md-ellipsis">
  234. How do I know when the status of my secret changed the last time?
  235. </span>
  236. </a>
  237. </li>
  238. <li class="md-nav__item">
  239. <a href="#differences-to-csi-secret-store" class="md-nav__link">
  240. <span class="md-ellipsis">
  241. Differences to csi-secret-store
  242. </span>
  243. </a>
  244. </li>
  245. <li class="md-nav__item">
  246. <a href="#how-do-i-debug-an-external-secret-that-doesnt-sync" class="md-nav__link">
  247. <span class="md-ellipsis">
  248. How do I debug an external-secret that doesn't sync?
  249. </span>
  250. </a>
  251. </li>
  252. <li class="md-nav__item">
  253. <a href="#upgrading-from-kes-to-eso" class="md-nav__link">
  254. <span class="md-ellipsis">
  255. Upgrading from KES to ESO
  256. </span>
  257. </a>
  258. </li>
  259. </ul>
  260. </nav>
  261. </li>
  262. <li class="md-nav__item">
  263. <a href="../stability-support/" class="md-nav__link">
  264. <span class="md-ellipsis">
  265. Stability and Support
  266. </span>
  267. </a>
  268. </li>
  269. <li class="md-nav__item">
  270. <a href="../deprecation-policy/" class="md-nav__link">
  271. <span class="md-ellipsis">
  272. Deprecation Policy
  273. </span>
  274. </a>
  275. </li>
  276. </ul>
  277. </nav>
  278. </li>
  279. <li class="md-nav__item md-nav__item--nested">
  280. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
  281. <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
  282. <span class="md-ellipsis">
  283. API
  284. </span>
  285. <span class="md-nav__icon md-icon"></span>
  286. </label>
  287. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
  288. <label class="md-nav__title" for="__nav_2">
  289. <span class="md-nav__icon md-icon"></span>
  290. API
  291. </label>
  292. <ul class="md-nav__list" data-md-scrollfix>
  293. <li class="md-nav__item">
  294. <a href="../../api/components/" class="md-nav__link">
  295. <span class="md-ellipsis">
  296. Components
  297. </span>
  298. </a>
  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_2" >
  302. <label class="md-nav__link" for="__nav_2_2" id="__nav_2_2_label" tabindex="0">
  303. <span class="md-ellipsis">
  304. Core Resources
  305. </span>
  306. <span class="md-nav__icon md-icon"></span>
  307. </label>
  308. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_2_label" aria-expanded="false">
  309. <label class="md-nav__title" for="__nav_2_2">
  310. <span class="md-nav__icon md-icon"></span>
  311. Core Resources
  312. </label>
  313. <ul class="md-nav__list" data-md-scrollfix>
  314. <li class="md-nav__item">
  315. <a href="../../api/externalsecret/" class="md-nav__link">
  316. <span class="md-ellipsis">
  317. ExternalSecret
  318. </span>
  319. </a>
  320. </li>
  321. <li class="md-nav__item">
  322. <a href="../../api/secretstore/" class="md-nav__link">
  323. <span class="md-ellipsis">
  324. SecretStore
  325. </span>
  326. </a>
  327. </li>
  328. <li class="md-nav__item">
  329. <a href="../../api/clustersecretstore/" class="md-nav__link">
  330. <span class="md-ellipsis">
  331. ClusterSecretStore
  332. </span>
  333. </a>
  334. </li>
  335. <li class="md-nav__item">
  336. <a href="../../api/clusterexternalsecret/" class="md-nav__link">
  337. <span class="md-ellipsis">
  338. ClusterExternalSecret
  339. </span>
  340. </a>
  341. </li>
  342. <li class="md-nav__item">
  343. <a href="../../api/pushsecret/" class="md-nav__link">
  344. <span class="md-ellipsis">
  345. PushSecret
  346. </span>
  347. </a>
  348. </li>
  349. </ul>
  350. </nav>
  351. </li>
  352. <li class="md-nav__item md-nav__item--nested">
  353. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_3" >
  354. <div class="md-nav__link md-nav__container">
  355. <a href="../../api/generator/" class="md-nav__link ">
  356. <span class="md-ellipsis">
  357. Generators
  358. </span>
  359. </a>
  360. <label class="md-nav__link " for="__nav_2_3" id="__nav_2_3_label" tabindex="0">
  361. <span class="md-nav__icon md-icon"></span>
  362. </label>
  363. </div>
  364. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_3_label" aria-expanded="false">
  365. <label class="md-nav__title" for="__nav_2_3">
  366. <span class="md-nav__icon md-icon"></span>
  367. Generators
  368. </label>
  369. <ul class="md-nav__list" data-md-scrollfix>
  370. <li class="md-nav__item">
  371. <a href="../../api/generator/acr/" class="md-nav__link">
  372. <span class="md-ellipsis">
  373. Azure Container Registry
  374. </span>
  375. </a>
  376. </li>
  377. <li class="md-nav__item">
  378. <a href="../../api/generator/ecr/" class="md-nav__link">
  379. <span class="md-ellipsis">
  380. AWS Elastic Container Registry
  381. </span>
  382. </a>
  383. </li>
  384. <li class="md-nav__item">
  385. <a href="../../api/generator/gcr/" class="md-nav__link">
  386. <span class="md-ellipsis">
  387. Google Container Registry
  388. </span>
  389. </a>
  390. </li>
  391. <li class="md-nav__item">
  392. <a href="../../api/generator/vault/" class="md-nav__link">
  393. <span class="md-ellipsis">
  394. Vault Dynamic Secret
  395. </span>
  396. </a>
  397. </li>
  398. <li class="md-nav__item">
  399. <a href="../../api/generator/password/" class="md-nav__link">
  400. <span class="md-ellipsis">
  401. Password
  402. </span>
  403. </a>
  404. </li>
  405. <li class="md-nav__item">
  406. <a href="../../api/generator/fake/" class="md-nav__link">
  407. <span class="md-ellipsis">
  408. Fake
  409. </span>
  410. </a>
  411. </li>
  412. <li class="md-nav__item">
  413. <a href="../../api/generator/webhook/" class="md-nav__link">
  414. <span class="md-ellipsis">
  415. Webhook
  416. </span>
  417. </a>
  418. </li>
  419. </ul>
  420. </nav>
  421. </li>
  422. <li class="md-nav__item md-nav__item--nested">
  423. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_4" >
  424. <label class="md-nav__link" for="__nav_2_4" id="__nav_2_4_label" tabindex="0">
  425. <span class="md-ellipsis">
  426. Reference Docs
  427. </span>
  428. <span class="md-nav__icon md-icon"></span>
  429. </label>
  430. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_4_label" aria-expanded="false">
  431. <label class="md-nav__title" for="__nav_2_4">
  432. <span class="md-nav__icon md-icon"></span>
  433. Reference Docs
  434. </label>
  435. <ul class="md-nav__list" data-md-scrollfix>
  436. <li class="md-nav__item">
  437. <a href="../../api/spec/" class="md-nav__link">
  438. <span class="md-ellipsis">
  439. API specification
  440. </span>
  441. </a>
  442. </li>
  443. <li class="md-nav__item">
  444. <a href="../../api/controller-options/" class="md-nav__link">
  445. <span class="md-ellipsis">
  446. Controller Options
  447. </span>
  448. </a>
  449. </li>
  450. <li class="md-nav__item">
  451. <a href="../../api/metrics/" class="md-nav__link">
  452. <span class="md-ellipsis">
  453. Metrics
  454. </span>
  455. </a>
  456. </li>
  457. </ul>
  458. </nav>
  459. </li>
  460. </ul>
  461. </nav>
  462. </li>
  463. <li class="md-nav__item md-nav__item--nested">
  464. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
  465. <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
  466. <span class="md-ellipsis">
  467. Guides
  468. </span>
  469. <span class="md-nav__icon md-icon"></span>
  470. </label>
  471. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
  472. <label class="md-nav__title" for="__nav_3">
  473. <span class="md-nav__icon md-icon"></span>
  474. Guides
  475. </label>
  476. <ul class="md-nav__list" data-md-scrollfix>
  477. <li class="md-nav__item">
  478. <a href="../../guides/introduction/" class="md-nav__link">
  479. <span class="md-ellipsis">
  480. Introduction
  481. </span>
  482. </a>
  483. </li>
  484. <li class="md-nav__item md-nav__item--nested">
  485. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_2" >
  486. <label class="md-nav__link" for="__nav_3_2" id="__nav_3_2_label" tabindex="0">
  487. <span class="md-ellipsis">
  488. External Secrets
  489. </span>
  490. <span class="md-nav__icon md-icon"></span>
  491. </label>
  492. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_2_label" aria-expanded="false">
  493. <label class="md-nav__title" for="__nav_3_2">
  494. <span class="md-nav__icon md-icon"></span>
  495. External Secrets
  496. </label>
  497. <ul class="md-nav__list" data-md-scrollfix>
  498. <li class="md-nav__item">
  499. <a href="../../guides/all-keys-one-secret/" class="md-nav__link">
  500. <span class="md-ellipsis">
  501. Extract structured data
  502. </span>
  503. </a>
  504. </li>
  505. <li class="md-nav__item">
  506. <a href="../../guides/getallsecrets/" class="md-nav__link">
  507. <span class="md-ellipsis">
  508. Find Secrets by Name or Metadata
  509. </span>
  510. </a>
  511. </li>
  512. <li class="md-nav__item">
  513. <a href="../../guides/datafrom-rewrite/" class="md-nav__link">
  514. <span class="md-ellipsis">
  515. Rewriting Keys
  516. </span>
  517. </a>
  518. </li>
  519. <li class="md-nav__item md-nav__item--nested">
  520. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_2_4" >
  521. <label class="md-nav__link" for="__nav_3_2_4" id="__nav_3_2_4_label" tabindex="0">
  522. <span class="md-ellipsis">
  523. Advanced Templating
  524. </span>
  525. <span class="md-nav__icon md-icon"></span>
  526. </label>
  527. <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_3_2_4_label" aria-expanded="false">
  528. <label class="md-nav__title" for="__nav_3_2_4">
  529. <span class="md-nav__icon md-icon"></span>
  530. Advanced Templating
  531. </label>
  532. <ul class="md-nav__list" data-md-scrollfix>
  533. <li class="md-nav__item">
  534. <a href="../../guides/templating/" class="md-nav__link">
  535. <span class="md-ellipsis">
  536. v2
  537. </span>
  538. </a>
  539. </li>
  540. <li class="md-nav__item">
  541. <a href="../../guides/templating-v1/" class="md-nav__link">
  542. <span class="md-ellipsis">
  543. v1
  544. </span>
  545. </a>
  546. </li>
  547. </ul>
  548. </nav>
  549. </li>
  550. <li class="md-nav__item">
  551. <a href="../../guides/common-k8s-secret-types/" class="md-nav__link">
  552. <span class="md-ellipsis">
  553. Kubernetes Secret Types
  554. </span>
  555. </a>
  556. </li>
  557. <li class="md-nav__item">
  558. <a href="../../guides/ownership-deletion-policy/" class="md-nav__link">
  559. <span class="md-ellipsis">
  560. Lifecycle: ownership & deletion
  561. </span>
  562. </a>
  563. </li>
  564. <li class="md-nav__item">
  565. <a href="../../guides/decoding-strategy/" class="md-nav__link">
  566. <span class="md-ellipsis">
  567. Decoding Strategies
  568. </span>
  569. </a>
  570. </li>
  571. <li class="md-nav__item">
  572. <a href="../../guides/controller-class/" class="md-nav__link">
  573. <span class="md-ellipsis">
  574. Controller Classes
  575. </span>
  576. </a>
  577. </li>
  578. </ul>
  579. </nav>
  580. </li>
  581. <li class="md-nav__item">
  582. <a href="../../guides/generator/" class="md-nav__link">
  583. <span class="md-ellipsis">
  584. Generators
  585. </span>
  586. </a>
  587. </li>
  588. <li class="md-nav__item">
  589. <a href="../../guides/pushsecrets/" class="md-nav__link">
  590. <span class="md-ellipsis">
  591. Push Secrets
  592. </span>
  593. </a>
  594. </li>
  595. <li class="md-nav__item md-nav__item--nested">
  596. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_5" >
  597. <label class="md-nav__link" for="__nav_3_5" id="__nav_3_5_label" tabindex="0">
  598. <span class="md-ellipsis">
  599. Operations
  600. </span>
  601. <span class="md-nav__icon md-icon"></span>
  602. </label>
  603. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_5_label" aria-expanded="false">
  604. <label class="md-nav__title" for="__nav_3_5">
  605. <span class="md-nav__icon md-icon"></span>
  606. Operations
  607. </label>
  608. <ul class="md-nav__list" data-md-scrollfix>
  609. <li class="md-nav__item">
  610. <a href="../../guides/multi-tenancy/" class="md-nav__link">
  611. <span class="md-ellipsis">
  612. Multi Tenancy
  613. </span>
  614. </a>
  615. </li>
  616. <li class="md-nav__item">
  617. <a href="../../guides/security-best-practices/" class="md-nav__link">
  618. <span class="md-ellipsis">
  619. Security Best Practices
  620. </span>
  621. </a>
  622. </li>
  623. <li class="md-nav__item">
  624. <a href="../../guides/threat-model/" class="md-nav__link">
  625. <span class="md-ellipsis">
  626. Threat Model
  627. </span>
  628. </a>
  629. </li>
  630. <li class="md-nav__item">
  631. <a href="../../guides/v1beta1/" class="md-nav__link">
  632. <span class="md-ellipsis">
  633. Upgrading to v1beta1
  634. </span>
  635. </a>
  636. </li>
  637. <li class="md-nav__item">
  638. <a href="../../guides/using-latest-image/" class="md-nav__link">
  639. <span class="md-ellipsis">
  640. Using Latest Image
  641. </span>
  642. </a>
  643. </li>
  644. <li class="md-nav__item">
  645. <a href="../../guides/disable-cluster-features/" class="md-nav__link">
  646. <span class="md-ellipsis">
  647. Disable Cluster Features
  648. </span>
  649. </a>
  650. </li>
  651. </ul>
  652. </nav>
  653. </li>
  654. </ul>
  655. </nav>
  656. </li>
  657. <li class="md-nav__item md-nav__item--nested">
  658. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
  659. <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
  660. <span class="md-ellipsis">
  661. Provider
  662. </span>
  663. <span class="md-nav__icon md-icon"></span>
  664. </label>
  665. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
  666. <label class="md-nav__title" for="__nav_4">
  667. <span class="md-nav__icon md-icon"></span>
  668. Provider
  669. </label>
  670. <ul class="md-nav__list" data-md-scrollfix>
  671. <li class="md-nav__item">
  672. <a href="../../provider/aws-secrets-manager/" class="md-nav__link">
  673. <span class="md-ellipsis">
  674. AWS Secrets Manager
  675. </span>
  676. </a>
  677. </li>
  678. <li class="md-nav__item">
  679. <a href="../../provider/aws-parameter-store/" class="md-nav__link">
  680. <span class="md-ellipsis">
  681. AWS Parameter Store
  682. </span>
  683. </a>
  684. </li>
  685. <li class="md-nav__item">
  686. <a href="../../provider/azure-key-vault/" class="md-nav__link">
  687. <span class="md-ellipsis">
  688. Azure Key Vault
  689. </span>
  690. </a>
  691. </li>
  692. <li class="md-nav__item">
  693. <a href="../../provider/chef/" class="md-nav__link">
  694. <span class="md-ellipsis">
  695. Chef
  696. </span>
  697. </a>
  698. </li>
  699. <li class="md-nav__item">
  700. <a href="../../provider/conjur/" class="md-nav__link">
  701. <span class="md-ellipsis">
  702. CyberArk Conjur
  703. </span>
  704. </a>
  705. </li>
  706. <li class="md-nav__item">
  707. <a href="../../provider/google-secrets-manager/" class="md-nav__link">
  708. <span class="md-ellipsis">
  709. Google Cloud Secret Manager
  710. </span>
  711. </a>
  712. </li>
  713. <li class="md-nav__item">
  714. <a href="../../provider/hashicorp-vault/" class="md-nav__link">
  715. <span class="md-ellipsis">
  716. HashiCorp Vault
  717. </span>
  718. </a>
  719. </li>
  720. <li class="md-nav__item">
  721. <a href="../../provider/kubernetes/" class="md-nav__link">
  722. <span class="md-ellipsis">
  723. Kubernetes
  724. </span>
  725. </a>
  726. </li>
  727. <li class="md-nav__item">
  728. <a href="../../provider/ibm-secrets-manager/" class="md-nav__link">
  729. <span class="md-ellipsis">
  730. IBM Secrets Manager
  731. </span>
  732. </a>
  733. </li>
  734. <li class="md-nav__item">
  735. <a href="../../provider/akeyless/" class="md-nav__link">
  736. <span class="md-ellipsis">
  737. Akeyless
  738. </span>
  739. </a>
  740. </li>
  741. <li class="md-nav__item">
  742. <a href="../../provider/yandex-certificate-manager/" class="md-nav__link">
  743. <span class="md-ellipsis">
  744. Yandex Certificate Manager
  745. </span>
  746. </a>
  747. </li>
  748. <li class="md-nav__item">
  749. <a href="../../provider/yandex-lockbox/" class="md-nav__link">
  750. <span class="md-ellipsis">
  751. Yandex Lockbox
  752. </span>
  753. </a>
  754. </li>
  755. <li class="md-nav__item">
  756. <a href="../../provider/alibaba/" class="md-nav__link">
  757. <span class="md-ellipsis">
  758. Alibaba Cloud
  759. </span>
  760. </a>
  761. </li>
  762. <li class="md-nav__item">
  763. <a href="../../provider/gitlab-variables/" class="md-nav__link">
  764. <span class="md-ellipsis">
  765. GitLab Variables
  766. </span>
  767. </a>
  768. </li>
  769. <li class="md-nav__item">
  770. <a href="../../provider/oracle-vault/" class="md-nav__link">
  771. <span class="md-ellipsis">
  772. Oracle Vault
  773. </span>
  774. </a>
  775. </li>
  776. <li class="md-nav__item">
  777. <a href="../../provider/1password-automation/" class="md-nav__link">
  778. <span class="md-ellipsis">
  779. 1Password Secrets Automation
  780. </span>
  781. </a>
  782. </li>
  783. <li class="md-nav__item">
  784. <a href="../../provider/webhook/" class="md-nav__link">
  785. <span class="md-ellipsis">
  786. Webhook
  787. </span>
  788. </a>
  789. </li>
  790. <li class="md-nav__item">
  791. <a href="../../provider/fake/" class="md-nav__link">
  792. <span class="md-ellipsis">
  793. Fake
  794. </span>
  795. </a>
  796. </li>
  797. <li class="md-nav__item">
  798. <a href="../../provider/senhasegura-dsm/" class="md-nav__link">
  799. <span class="md-ellipsis">
  800. senhasegura DevOps Secrets Management (DSM)
  801. </span>
  802. </a>
  803. </li>
  804. <li class="md-nav__item">
  805. <a href="../../provider/doppler/" class="md-nav__link">
  806. <span class="md-ellipsis">
  807. Doppler
  808. </span>
  809. </a>
  810. </li>
  811. <li class="md-nav__item">
  812. <a href="../../provider/keeper-security/" class="md-nav__link">
  813. <span class="md-ellipsis">
  814. Keeper Security
  815. </span>
  816. </a>
  817. </li>
  818. <li class="md-nav__item">
  819. <a href="../../provider/cloak/" class="md-nav__link">
  820. <span class="md-ellipsis">
  821. Cloak End 2 End Encrypted Secrets
  822. </span>
  823. </a>
  824. </li>
  825. <li class="md-nav__item">
  826. <a href="../../provider/scaleway/" class="md-nav__link">
  827. <span class="md-ellipsis">
  828. Scaleway
  829. </span>
  830. </a>
  831. </li>
  832. <li class="md-nav__item">
  833. <a href="../../provider/delinea/" class="md-nav__link">
  834. <span class="md-ellipsis">
  835. Delinea
  836. </span>
  837. </a>
  838. </li>
  839. <li class="md-nav__item">
  840. <a href="../../provider/pulumi/" class="md-nav__link">
  841. <span class="md-ellipsis">
  842. Pulumi ESC
  843. </span>
  844. </a>
  845. </li>
  846. </ul>
  847. </nav>
  848. </li>
  849. <li class="md-nav__item md-nav__item--nested">
  850. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
  851. <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
  852. <span class="md-ellipsis">
  853. Examples
  854. </span>
  855. <span class="md-nav__icon md-icon"></span>
  856. </label>
  857. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
  858. <label class="md-nav__title" for="__nav_5">
  859. <span class="md-nav__icon md-icon"></span>
  860. Examples
  861. </label>
  862. <ul class="md-nav__list" data-md-scrollfix>
  863. <li class="md-nav__item">
  864. <a href="../../examples/gitops-using-fluxcd/" class="md-nav__link">
  865. <span class="md-ellipsis">
  866. FluxCD
  867. </span>
  868. </a>
  869. </li>
  870. <li class="md-nav__item">
  871. <a href="../../examples/anchore-engine-credentials/" class="md-nav__link">
  872. <span class="md-ellipsis">
  873. Anchore Engine
  874. </span>
  875. </a>
  876. </li>
  877. <li class="md-nav__item">
  878. <a href="../../examples/jenkins-kubernetes-credentials/" class="md-nav__link">
  879. <span class="md-ellipsis">
  880. Jenkins
  881. </span>
  882. </a>
  883. </li>
  884. <li class="md-nav__item">
  885. <a href="../../examples/bitwarden/" class="md-nav__link">
  886. <span class="md-ellipsis">
  887. BitWarden
  888. </span>
  889. </a>
  890. </li>
  891. </ul>
  892. </nav>
  893. </li>
  894. <li class="md-nav__item md-nav__item--nested">
  895. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
  896. <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
  897. <span class="md-ellipsis">
  898. Community
  899. </span>
  900. <span class="md-nav__icon md-icon"></span>
  901. </label>
  902. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
  903. <label class="md-nav__title" for="__nav_6">
  904. <span class="md-nav__icon md-icon"></span>
  905. Community
  906. </label>
  907. <ul class="md-nav__list" data-md-scrollfix>
  908. <li class="md-nav__item md-nav__item--nested">
  909. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6_1" >
  910. <label class="md-nav__link" for="__nav_6_1" id="__nav_6_1_label" tabindex="0">
  911. <span class="md-ellipsis">
  912. Contributing
  913. </span>
  914. <span class="md-nav__icon md-icon"></span>
  915. </label>
  916. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_1_label" aria-expanded="false">
  917. <label class="md-nav__title" for="__nav_6_1">
  918. <span class="md-nav__icon md-icon"></span>
  919. Contributing
  920. </label>
  921. <ul class="md-nav__list" data-md-scrollfix>
  922. <li class="md-nav__item">
  923. <a href="../../contributing/devguide/" class="md-nav__link">
  924. <span class="md-ellipsis">
  925. Developer guide
  926. </span>
  927. </a>
  928. </li>
  929. <li class="md-nav__item">
  930. <a href="../../contributing/process/" class="md-nav__link">
  931. <span class="md-ellipsis">
  932. Contributing Process
  933. </span>
  934. </a>
  935. </li>
  936. <li class="md-nav__item">
  937. <a href="../../contributing/release/" class="md-nav__link">
  938. <span class="md-ellipsis">
  939. Release Process
  940. </span>
  941. </a>
  942. </li>
  943. <li class="md-nav__item">
  944. <a href="../../contributing/coc/" class="md-nav__link">
  945. <span class="md-ellipsis">
  946. Code of Conduct
  947. </span>
  948. </a>
  949. </li>
  950. <li class="md-nav__item">
  951. <a href="../../contributing/roadmap/" class="md-nav__link">
  952. <span class="md-ellipsis">
  953. Roadmap
  954. </span>
  955. </a>
  956. </li>
  957. </ul>
  958. </nav>
  959. </li>
  960. <li class="md-nav__item md-nav__item--nested">
  961. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6_2" >
  962. <label class="md-nav__link" for="__nav_6_2" id="__nav_6_2_label" tabindex="0">
  963. <span class="md-ellipsis">
  964. External Resources
  965. </span>
  966. <span class="md-nav__icon md-icon"></span>
  967. </label>
  968. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_2_label" aria-expanded="false">
  969. <label class="md-nav__title" for="__nav_6_2">
  970. <span class="md-nav__icon md-icon"></span>
  971. External Resources
  972. </label>
  973. <ul class="md-nav__list" data-md-scrollfix>
  974. <li class="md-nav__item">
  975. <a href="../../eso-talks/" class="md-nav__link">
  976. <span class="md-ellipsis">
  977. Talks
  978. </span>
  979. </a>
  980. </li>
  981. <li class="md-nav__item">
  982. <a href="../../eso-demos/" class="md-nav__link">
  983. <span class="md-ellipsis">
  984. Demos
  985. </span>
  986. </a>
  987. </li>
  988. <li class="md-nav__item">
  989. <a href="../../eso-blogs/" class="md-nav__link">
  990. <span class="md-ellipsis">
  991. Blogs
  992. </span>
  993. </a>
  994. </li>
  995. </ul>
  996. </nav>
  997. </li>
  998. </ul>
  999. </nav>
  1000. </li>
  1001. </ul>
  1002. </nav>
  1003. </div>
  1004. </div>
  1005. </div>
  1006. <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
  1007. <div class="md-sidebar__scrollwrap">
  1008. <div class="md-sidebar__inner">
  1009. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  1010. <label class="md-nav__title" for="__toc">
  1011. <span class="md-nav__icon md-icon"></span>
  1012. Table of contents
  1013. </label>
  1014. <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
  1015. <li class="md-nav__item">
  1016. <a href="#can-i-manually-trigger-a-secret-refresh" class="md-nav__link">
  1017. <span class="md-ellipsis">
  1018. Can I manually trigger a secret refresh?
  1019. </span>
  1020. </a>
  1021. </li>
  1022. <li class="md-nav__item">
  1023. <a href="#how-do-i-know-when-my-secret-was-last-synced" class="md-nav__link">
  1024. <span class="md-ellipsis">
  1025. How do I know when my secret was last synced?
  1026. </span>
  1027. </a>
  1028. </li>
  1029. <li class="md-nav__item">
  1030. <a href="#how-do-i-know-when-the-status-of-my-secret-changed-the-last-time" class="md-nav__link">
  1031. <span class="md-ellipsis">
  1032. How do I know when the status of my secret changed the last time?
  1033. </span>
  1034. </a>
  1035. </li>
  1036. <li class="md-nav__item">
  1037. <a href="#differences-to-csi-secret-store" class="md-nav__link">
  1038. <span class="md-ellipsis">
  1039. Differences to csi-secret-store
  1040. </span>
  1041. </a>
  1042. </li>
  1043. <li class="md-nav__item">
  1044. <a href="#how-do-i-debug-an-external-secret-that-doesnt-sync" class="md-nav__link">
  1045. <span class="md-ellipsis">
  1046. How do I debug an external-secret that doesn't sync?
  1047. </span>
  1048. </a>
  1049. </li>
  1050. <li class="md-nav__item">
  1051. <a href="#upgrading-from-kes-to-eso" class="md-nav__link">
  1052. <span class="md-ellipsis">
  1053. Upgrading from KES to ESO
  1054. </span>
  1055. </a>
  1056. </li>
  1057. </ul>
  1058. </nav>
  1059. </div>
  1060. </div>
  1061. </div>
  1062. <div class="md-content" data-md-component="content">
  1063. <article class="md-content__inner md-typeset">
  1064. <h1>FAQ</h1>
  1065. <h2 id="can-i-manually-trigger-a-secret-refresh">Can I manually trigger a secret refresh?</h2>
  1066. <p>You can trigger a secret refresh by using kubectl or any other kubernetes api client.
  1067. You just need to change an annotation, label or the spec of the resource:</p>
  1068. <div class="highlight"><pre><span></span><code>kubectl annotate es my-es force-sync=$(date +%s) --overwrite
  1069. </code></pre></div>
  1070. <h2 id="how-do-i-know-when-my-secret-was-last-synced">How do I know when my secret was last synced?</h2>
  1071. <p>The last synchronization timestamp of an ExternalSecret can be retrieved from the field <code>refreshTime</code>. </p>
  1072. <div class="highlight"><pre><span></span><code>kubectl get es my-external-secret -o yaml | grep refreshTime
  1073. refreshTime: &quot;2022-05-21T23:02:47Z&quot;
  1074. </code></pre></div>
  1075. <p>The interval can be changed by the <code>spec.refreshInterval</code> in the ExternalSecret.</p>
  1076. <h2 id="how-do-i-know-when-the-status-of-my-secret-changed-the-last-time">How do I know when the status of my secret changed the last time?</h2>
  1077. <p>Every ExternalSecret resource contains a status condition that indicates whether a secret was successfully synchronized, along with the timestamp of the last status change of the ExternalSecret (e.g. from SecretSyncedError to SecretSynced). This can be obtained from the field <code>lastTransitionTime</code>:</p>
  1078. <div class="highlight"><pre><span></span><code>kubectl get es my-external-secret -o yaml | grep condition -A 5
  1079. conditions:
  1080. - lastTransitionTime: &quot;2022-05-21T21:02:47Z&quot;
  1081. message: Secret was synced
  1082. reason: SecretSynced
  1083. status: &quot;True&quot;
  1084. type: Ready
  1085. </code></pre></div>
  1086. <h2 id="differences-to-csi-secret-store">Differences to csi-secret-store</h2>
  1087. <p>Please take a look at this <a href="https://github.com/external-secrets/external-secrets/issues/478#issuecomment-964413129">issue comment here</a>.</p>
  1088. <h2 id="how-do-i-debug-an-external-secret-that-doesnt-sync">How do I debug an external-secret that doesn't sync?</h2>
  1089. <p>First, check the status of the ExternalSecret resource using <code>kubectl describe</code>. That displays the status conditions as well as recent events.
  1090. You should expect a status condition with <code>Type=Ready</code>, <code>Status=True</code>. Further you shouldn't see any events with <code>Type=Warning</code>. Read carefully if they exist.</p>
  1091. <div class="highlight"><pre><span></span><code>kubectl describe es my-external-secret
  1092. [...]
  1093. Status:
  1094. Conditions:
  1095. Last Transition Time: 2022-05-21T21:02:47Z
  1096. Message: Secret was synced
  1097. Reason: SecretSynced
  1098. Status: True
  1099. Type: Ready
  1100. Refresh Time: 2022-05-21T21:06:47Z
  1101. Synced Resource Version: 1-5c833527afd7ba3f426cb0082ee7e083
  1102. Events:
  1103. Type Reason Age From Message
  1104. ---- ------ ---- ---- -------
  1105. Warning UpdateFailed 4m12s external-secrets secrets &quot;yyyyyyy&quot; already exists
  1106. Normal Updated 12s (x4 over 3m12s) external-secrets Updated Secret
  1107. </code></pre></div>
  1108. <p>If everything looks good you should check the corresponding secret store resource that is referenced from an ExternalSecret. Again, use <code>kubectl describe</code> to show status conditions and events and look for warning signs as described above.</p>
  1109. <p>In an ideally, the store should be validated and Ready.</p>
  1110. <div class="highlight"><pre><span></span><code>kubectl describe css kubernetes
  1111. [...]
  1112. Status:
  1113. Conditions:
  1114. Last Transition Time: 2022-05-21T21:02:47Z
  1115. Message: store validated
  1116. Reason: Valid
  1117. Status: True
  1118. Type: Ready
  1119. Events:
  1120. Type Reason Age From Message
  1121. ---- ------ ---- ---- -------
  1122. Normal Valid 52s (x4 over 10m) cluster-secret-store store validated
  1123. Normal Valid 52s (x4 over 10m) cluster-secret-store store validated
  1124. </code></pre></div>
  1125. <p>If everything looks normal so far, please go ahead and ensure that the created secret has the expected value. Also, take a look at the logs of the controller.</p>
  1126. <h2 id="upgrading-from-kes-to-eso">Upgrading from KES to ESO</h2>
  1127. <p>Migrating from KES to ESO is quite tricky! There is a tool we built to help users out available <a href="https://github.com/external-secrets/kes-to-eso">here</a>, and there is a small migration procedure.</p>
  1128. <p>There are some incompatibilities between KES to ESO, and while the tool tries to cover most of them, some of them will require manual intervention. We recommend to first convert the manifest files, and actually see if the tool provides a warning about any file needed to be changed.
  1129. Beware that the tool points the SecretStores to use KES Service Account, so you'll also need to tweak that if you plan to uninstall KES after the upgrade.</p>
  1130. </article>
  1131. </div>
  1132. <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
  1133. </div>
  1134. </main>
  1135. <footer class="md-footer">
  1136. <div class="md-footer-meta md-typeset">
  1137. <div class="md-footer-meta__inner md-grid">
  1138. <div class="md-copyright">
  1139. <div class="md-copyright__highlight">
  1140. &copy; 2023 The external-secrets Authors.<br/>
  1141. &copy; 2023 The Linux Foundation. All rights reserved.<br/><br/>
  1142. The Linux Foundation has registered trademarks and uses trademarks.<br/>
  1143. For a list of trademarks of The Linux Foundation, please see our <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage page</a>.
  1144. </div>
  1145. Made with
  1146. <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
  1147. Material for MkDocs
  1148. </a>
  1149. </div>
  1150. </div>
  1151. </div>
  1152. </footer>
  1153. </div>
  1154. <div class="md-dialog" data-md-component="dialog">
  1155. <div class="md-dialog__inner md-typeset"></div>
  1156. </div>
  1157. <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>
  1158. <script src="../../assets/javascripts/bundle.8fd75fb4.min.js"></script>
  1159. </body>
  1160. </html>