index.html 50 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350
  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.4.3, mkdocs-material-9.1.9">
  10. <title>FAQ - External Secrets Operator</title>
  11. <link rel="stylesheet" href="../../assets/stylesheets/main.85bb2934.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. <script>var palette=__md_get("__palette");if(palette&&"object"==typeof palette.color)for(var key of Object.keys(palette.color))document.body.setAttribute("data-md-color-"+key,palette.color[key])</script>
  21. <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
  22. <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
  23. <label class="md-overlay" for="__drawer"></label>
  24. <div data-md-component="skip">
  25. <a href="#can-i-manually-trigger-a-secret-refresh" class="md-skip">
  26. Skip to content
  27. </a>
  28. </div>
  29. <div data-md-component="announce">
  30. </div>
  31. <div data-md-color-scheme="default" data-md-component="outdated" hidden>
  32. <aside class="md-banner md-banner--warning">
  33. <div class="md-banner__inner md-grid md-typeset">
  34. You're not viewing the latest version.
  35. <a href="../../..">
  36. <strong>Click here to go to latest.</strong>
  37. </a>
  38. </div>
  39. <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
  40. </aside>
  41. </div>
  42. <header class="md-header" data-md-component="header">
  43. <nav class="md-header__inner md-grid" aria-label="Header">
  44. <a href="../.." title="External Secrets Operator" class="md-header__button md-logo" aria-label="External Secrets Operator" data-md-component="logo">
  45. <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>
  46. </a>
  47. <label class="md-header__button md-icon" for="__drawer">
  48. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
  49. </label>
  50. <div class="md-header__title" data-md-component="header-title">
  51. <div class="md-header__ellipsis">
  52. <div class="md-header__topic">
  53. <span class="md-ellipsis">
  54. External Secrets Operator
  55. </span>
  56. </div>
  57. <div class="md-header__topic" data-md-component="header-topic">
  58. <span class="md-ellipsis">
  59. FAQ
  60. </span>
  61. </div>
  62. </div>
  63. </div>
  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.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 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">
  111. <a href="../.." class="md-tabs__link md-tabs__link--active">
  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.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 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--nested">
  167. <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_1" checked>
  168. <div class="md-nav__link md-nav__link--index ">
  169. <a href="../..">Introduction</a>
  170. <label for="__nav_1">
  171. <span class="md-nav__icon md-icon"></span>
  172. </label>
  173. </div>
  174. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_1_label" aria-expanded="true">
  175. <label class="md-nav__title" for="__nav_1">
  176. <span class="md-nav__icon md-icon"></span>
  177. Introduction
  178. </label>
  179. <ul class="md-nav__list" data-md-scrollfix>
  180. <li class="md-nav__item">
  181. <a href="../overview/" class="md-nav__link">
  182. Overview
  183. </a>
  184. </li>
  185. <li class="md-nav__item">
  186. <a href="../getting-started/" class="md-nav__link">
  187. Getting started
  188. </a>
  189. </li>
  190. <li class="md-nav__item md-nav__item--active">
  191. <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
  192. <label class="md-nav__link md-nav__link--active" for="__toc">
  193. FAQ
  194. <span class="md-nav__icon md-icon"></span>
  195. </label>
  196. <a href="./" class="md-nav__link md-nav__link--active">
  197. FAQ
  198. </a>
  199. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  200. <label class="md-nav__title" for="__toc">
  201. <span class="md-nav__icon md-icon"></span>
  202. Table of contents
  203. </label>
  204. <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
  205. <li class="md-nav__item">
  206. <a href="#can-i-manually-trigger-a-secret-refresh" class="md-nav__link">
  207. Can I manually trigger a secret refresh?
  208. </a>
  209. </li>
  210. <li class="md-nav__item">
  211. <a href="#how-do-i-know-when-my-secret-was-last-synced" class="md-nav__link">
  212. How do I know when my secret was last synced?
  213. </a>
  214. </li>
  215. <li class="md-nav__item">
  216. <a href="#how-do-i-know-when-the-status-of-my-secret-changed-the-last-time" class="md-nav__link">
  217. How do I know when the status of my secret changed the last time?
  218. </a>
  219. </li>
  220. <li class="md-nav__item">
  221. <a href="#differences-to-csi-secret-store" class="md-nav__link">
  222. Differences to csi-secret-store
  223. </a>
  224. </li>
  225. <li class="md-nav__item">
  226. <a href="#how-do-i-debug-an-external-secret-that-doesnt-sync" class="md-nav__link">
  227. How do I debug an external-secret that doesn't sync?
  228. </a>
  229. </li>
  230. <li class="md-nav__item">
  231. <a href="#upgrading-from-kes-to-eso" class="md-nav__link">
  232. Upgrading from KES to ESO
  233. </a>
  234. </li>
  235. </ul>
  236. </nav>
  237. </li>
  238. <li class="md-nav__item">
  239. <a href="../stability-support/" class="md-nav__link">
  240. Stability and Support
  241. </a>
  242. </li>
  243. <li class="md-nav__item">
  244. <a href="../deprecation-policy/" class="md-nav__link">
  245. Deprecation Policy
  246. </a>
  247. </li>
  248. </ul>
  249. </nav>
  250. </li>
  251. <li class="md-nav__item md-nav__item--nested">
  252. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
  253. <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
  254. API
  255. <span class="md-nav__icon md-icon"></span>
  256. </label>
  257. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
  258. <label class="md-nav__title" for="__nav_2">
  259. <span class="md-nav__icon md-icon"></span>
  260. API
  261. </label>
  262. <ul class="md-nav__list" data-md-scrollfix>
  263. <li class="md-nav__item">
  264. <a href="../../api/components/" class="md-nav__link">
  265. Components
  266. </a>
  267. </li>
  268. <li class="md-nav__item md-nav__item--nested">
  269. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_2" >
  270. <label class="md-nav__link" for="__nav_2_2" id="__nav_2_2_label" tabindex="0">
  271. Core Resources
  272. <span class="md-nav__icon md-icon"></span>
  273. </label>
  274. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_2_label" aria-expanded="false">
  275. <label class="md-nav__title" for="__nav_2_2">
  276. <span class="md-nav__icon md-icon"></span>
  277. Core Resources
  278. </label>
  279. <ul class="md-nav__list" data-md-scrollfix>
  280. <li class="md-nav__item">
  281. <a href="../../api/externalsecret/" class="md-nav__link">
  282. ExternalSecret
  283. </a>
  284. </li>
  285. <li class="md-nav__item">
  286. <a href="../../api/secretstore/" class="md-nav__link">
  287. SecretStore
  288. </a>
  289. </li>
  290. <li class="md-nav__item">
  291. <a href="../../api/clustersecretstore/" class="md-nav__link">
  292. ClusterSecretStore
  293. </a>
  294. </li>
  295. <li class="md-nav__item">
  296. <a href="../../api/clusterexternalsecret/" class="md-nav__link">
  297. ClusterExternalSecret
  298. </a>
  299. </li>
  300. <li class="md-nav__item">
  301. <a href="../../api/pushsecret/" class="md-nav__link">
  302. PushSecret
  303. </a>
  304. </li>
  305. </ul>
  306. </nav>
  307. </li>
  308. <li class="md-nav__item md-nav__item--nested">
  309. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_3" >
  310. <div class="md-nav__link md-nav__link--index ">
  311. <a href="../../api/generator/">Generators</a>
  312. <label for="__nav_2_3">
  313. <span class="md-nav__icon md-icon"></span>
  314. </label>
  315. </div>
  316. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_3_label" aria-expanded="false">
  317. <label class="md-nav__title" for="__nav_2_3">
  318. <span class="md-nav__icon md-icon"></span>
  319. Generators
  320. </label>
  321. <ul class="md-nav__list" data-md-scrollfix>
  322. <li class="md-nav__item">
  323. <a href="../../api/generator/acr/" class="md-nav__link">
  324. Azure Container Registry
  325. </a>
  326. </li>
  327. <li class="md-nav__item">
  328. <a href="../../api/generator/ecr/" class="md-nav__link">
  329. AWS Elastic Container Registry
  330. </a>
  331. </li>
  332. <li class="md-nav__item">
  333. <a href="../../api/generator/gcr/" class="md-nav__link">
  334. Google Container Registry
  335. </a>
  336. </li>
  337. <li class="md-nav__item">
  338. <a href="../../api/generator/vault/" class="md-nav__link">
  339. Vault Dynamic Secret
  340. </a>
  341. </li>
  342. <li class="md-nav__item">
  343. <a href="../../api/generator/password/" class="md-nav__link">
  344. Password
  345. </a>
  346. </li>
  347. <li class="md-nav__item">
  348. <a href="../../api/generator/fake/" class="md-nav__link">
  349. Fake
  350. </a>
  351. </li>
  352. </ul>
  353. </nav>
  354. </li>
  355. <li class="md-nav__item md-nav__item--nested">
  356. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2_4" >
  357. <label class="md-nav__link" for="__nav_2_4" id="__nav_2_4_label" tabindex="0">
  358. Reference Docs
  359. <span class="md-nav__icon md-icon"></span>
  360. </label>
  361. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_4_label" aria-expanded="false">
  362. <label class="md-nav__title" for="__nav_2_4">
  363. <span class="md-nav__icon md-icon"></span>
  364. Reference Docs
  365. </label>
  366. <ul class="md-nav__list" data-md-scrollfix>
  367. <li class="md-nav__item">
  368. <a href="../../api/spec/" class="md-nav__link">
  369. API specification
  370. </a>
  371. </li>
  372. <li class="md-nav__item">
  373. <a href="../../api/controller-options/" class="md-nav__link">
  374. Controller Options
  375. </a>
  376. </li>
  377. <li class="md-nav__item">
  378. <a href="../../api/metrics/" class="md-nav__link">
  379. Metrics
  380. </a>
  381. </li>
  382. </ul>
  383. </nav>
  384. </li>
  385. </ul>
  386. </nav>
  387. </li>
  388. <li class="md-nav__item md-nav__item--nested">
  389. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
  390. <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
  391. Guides
  392. <span class="md-nav__icon md-icon"></span>
  393. </label>
  394. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
  395. <label class="md-nav__title" for="__nav_3">
  396. <span class="md-nav__icon md-icon"></span>
  397. Guides
  398. </label>
  399. <ul class="md-nav__list" data-md-scrollfix>
  400. <li class="md-nav__item">
  401. <a href="../../guides/introduction/" class="md-nav__link">
  402. Introduction
  403. </a>
  404. </li>
  405. <li class="md-nav__item md-nav__item--nested">
  406. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_2" >
  407. <label class="md-nav__link" for="__nav_3_2" id="__nav_3_2_label" tabindex="0">
  408. External Secrets
  409. <span class="md-nav__icon md-icon"></span>
  410. </label>
  411. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_2_label" aria-expanded="false">
  412. <label class="md-nav__title" for="__nav_3_2">
  413. <span class="md-nav__icon md-icon"></span>
  414. External Secrets
  415. </label>
  416. <ul class="md-nav__list" data-md-scrollfix>
  417. <li class="md-nav__item">
  418. <a href="../../guides/all-keys-one-secret/" class="md-nav__link">
  419. Extract structured data
  420. </a>
  421. </li>
  422. <li class="md-nav__item">
  423. <a href="../../guides/getallsecrets/" class="md-nav__link">
  424. Find Secrets by Name or Metadata
  425. </a>
  426. </li>
  427. <li class="md-nav__item">
  428. <a href="../../guides/datafrom-rewrite/" class="md-nav__link">
  429. Rewriting Keys
  430. </a>
  431. </li>
  432. <li class="md-nav__item md-nav__item--nested">
  433. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_2_4" >
  434. <label class="md-nav__link" for="__nav_3_2_4" id="__nav_3_2_4_label" tabindex="0">
  435. Advanced Templating
  436. <span class="md-nav__icon md-icon"></span>
  437. </label>
  438. <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_3_2_4_label" aria-expanded="false">
  439. <label class="md-nav__title" for="__nav_3_2_4">
  440. <span class="md-nav__icon md-icon"></span>
  441. Advanced Templating
  442. </label>
  443. <ul class="md-nav__list" data-md-scrollfix>
  444. <li class="md-nav__item">
  445. <a href="../../guides/templating/" class="md-nav__link">
  446. v2
  447. </a>
  448. </li>
  449. <li class="md-nav__item">
  450. <a href="../../guides/templating-v1/" class="md-nav__link">
  451. v1
  452. </a>
  453. </li>
  454. </ul>
  455. </nav>
  456. </li>
  457. <li class="md-nav__item">
  458. <a href="../../guides/common-k8s-secret-types/" class="md-nav__link">
  459. Kubernetes Secret Types
  460. </a>
  461. </li>
  462. <li class="md-nav__item">
  463. <a href="../../guides/ownership-deletion-policy/" class="md-nav__link">
  464. Lifecycle: ownership & deletion
  465. </a>
  466. </li>
  467. <li class="md-nav__item">
  468. <a href="../../guides/decoding-strategy/" class="md-nav__link">
  469. Decoding Strategies
  470. </a>
  471. </li>
  472. <li class="md-nav__item">
  473. <a href="../../guides/controller-class/" class="md-nav__link">
  474. Controller Classes
  475. </a>
  476. </li>
  477. </ul>
  478. </nav>
  479. </li>
  480. <li class="md-nav__item">
  481. <a href="../../guides/generator/" class="md-nav__link">
  482. Generators
  483. </a>
  484. </li>
  485. <li class="md-nav__item md-nav__item--nested">
  486. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3_4" >
  487. <label class="md-nav__link" for="__nav_3_4" id="__nav_3_4_label" tabindex="0">
  488. Operations
  489. <span class="md-nav__icon md-icon"></span>
  490. </label>
  491. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_4_label" aria-expanded="false">
  492. <label class="md-nav__title" for="__nav_3_4">
  493. <span class="md-nav__icon md-icon"></span>
  494. Operations
  495. </label>
  496. <ul class="md-nav__list" data-md-scrollfix>
  497. <li class="md-nav__item">
  498. <a href="../../guides/multi-tenancy/" class="md-nav__link">
  499. Multi Tenancy
  500. </a>
  501. </li>
  502. <li class="md-nav__item">
  503. <a href="../../guides/security-best-practices/" class="md-nav__link">
  504. Security Best Practices
  505. </a>
  506. </li>
  507. <li class="md-nav__item">
  508. <a href="../../guides/threat-model/" class="md-nav__link">
  509. Threat Model
  510. </a>
  511. </li>
  512. <li class="md-nav__item">
  513. <a href="../../guides/v1beta1/" class="md-nav__link">
  514. Upgrading to v1beta1
  515. </a>
  516. </li>
  517. <li class="md-nav__item">
  518. <a href="../../guides/using-latest-image/" class="md-nav__link">
  519. Using Latest Image
  520. </a>
  521. </li>
  522. <li class="md-nav__item">
  523. <a href="../../guides/disable-cluster-features/" class="md-nav__link">
  524. Disable Cluster Features
  525. </a>
  526. </li>
  527. </ul>
  528. </nav>
  529. </li>
  530. </ul>
  531. </nav>
  532. </li>
  533. <li class="md-nav__item md-nav__item--nested">
  534. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
  535. <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
  536. Provider
  537. <span class="md-nav__icon md-icon"></span>
  538. </label>
  539. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
  540. <label class="md-nav__title" for="__nav_4">
  541. <span class="md-nav__icon md-icon"></span>
  542. Provider
  543. </label>
  544. <ul class="md-nav__list" data-md-scrollfix>
  545. <li class="md-nav__item">
  546. <a href="../../provider/aws-secrets-manager/" class="md-nav__link">
  547. AWS Secrets Manager
  548. </a>
  549. </li>
  550. <li class="md-nav__item">
  551. <a href="../../provider/aws-parameter-store/" class="md-nav__link">
  552. AWS Parameter Store
  553. </a>
  554. </li>
  555. <li class="md-nav__item">
  556. <a href="../../provider/azure-key-vault/" class="md-nav__link">
  557. Azure Key Vault
  558. </a>
  559. </li>
  560. <li class="md-nav__item">
  561. <a href="../../provider/conjur/" class="md-nav__link">
  562. CyberArk Conjur
  563. </a>
  564. </li>
  565. <li class="md-nav__item">
  566. <a href="../../provider/google-secrets-manager/" class="md-nav__link">
  567. Google Cloud Secret Manager
  568. </a>
  569. </li>
  570. <li class="md-nav__item">
  571. <a href="../../provider/hashicorp-vault/" class="md-nav__link">
  572. HashiCorp Vault
  573. </a>
  574. </li>
  575. <li class="md-nav__item">
  576. <a href="../../provider/kubernetes/" class="md-nav__link">
  577. Kubernetes
  578. </a>
  579. </li>
  580. <li class="md-nav__item">
  581. <a href="../../provider/ibm-secrets-manager/" class="md-nav__link">
  582. IBM Secrets Manager
  583. </a>
  584. </li>
  585. <li class="md-nav__item">
  586. <a href="../../provider/akeyless/" class="md-nav__link">
  587. Akeyless
  588. </a>
  589. </li>
  590. <li class="md-nav__item">
  591. <a href="../../provider/yandex-certificate-manager/" class="md-nav__link">
  592. Yandex Certificate Manager
  593. </a>
  594. </li>
  595. <li class="md-nav__item">
  596. <a href="../../provider/yandex-lockbox/" class="md-nav__link">
  597. Yandex Lockbox
  598. </a>
  599. </li>
  600. <li class="md-nav__item">
  601. <a href="../../provider/alibaba/" class="md-nav__link">
  602. Alibaba Cloud
  603. </a>
  604. </li>
  605. <li class="md-nav__item">
  606. <a href="../../provider/gitlab-variables/" class="md-nav__link">
  607. GitLab Variables
  608. </a>
  609. </li>
  610. <li class="md-nav__item">
  611. <a href="../../provider/oracle-vault/" class="md-nav__link">
  612. Oracle Vault
  613. </a>
  614. </li>
  615. <li class="md-nav__item">
  616. <a href="../../provider/1password-automation/" class="md-nav__link">
  617. 1Password Secrets Automation
  618. </a>
  619. </li>
  620. <li class="md-nav__item">
  621. <a href="../../provider/webhook/" class="md-nav__link">
  622. Webhook
  623. </a>
  624. </li>
  625. <li class="md-nav__item">
  626. <a href="../../provider/fake/" class="md-nav__link">
  627. Fake
  628. </a>
  629. </li>
  630. <li class="md-nav__item">
  631. <a href="../../provider/senhasegura-dsm/" class="md-nav__link">
  632. senhasegura DevOps Secrets Management (DSM)
  633. </a>
  634. </li>
  635. <li class="md-nav__item">
  636. <a href="../../provider/doppler/" class="md-nav__link">
  637. Doppler
  638. </a>
  639. </li>
  640. <li class="md-nav__item">
  641. <a href="../../provider/keeper-security/" class="md-nav__link">
  642. Keeper Security
  643. </a>
  644. </li>
  645. <li class="md-nav__item">
  646. <a href="../../provider/cloak/" class="md-nav__link">
  647. Cloak End 2 End Encrypted Secrets
  648. </a>
  649. </li>
  650. <li class="md-nav__item">
  651. <a href="../../provider/scaleway/" class="md-nav__link">
  652. Scaleway
  653. </a>
  654. </li>
  655. <li class="md-nav__item">
  656. <a href="../../provider/delinea/" class="md-nav__link">
  657. Delinea
  658. </a>
  659. </li>
  660. </ul>
  661. </nav>
  662. </li>
  663. <li class="md-nav__item md-nav__item--nested">
  664. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
  665. <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
  666. Examples
  667. <span class="md-nav__icon md-icon"></span>
  668. </label>
  669. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
  670. <label class="md-nav__title" for="__nav_5">
  671. <span class="md-nav__icon md-icon"></span>
  672. Examples
  673. </label>
  674. <ul class="md-nav__list" data-md-scrollfix>
  675. <li class="md-nav__item">
  676. <a href="../../examples/gitops-using-fluxcd/" class="md-nav__link">
  677. FluxCD
  678. </a>
  679. </li>
  680. <li class="md-nav__item">
  681. <a href="../../examples/anchore-engine-credentials/" class="md-nav__link">
  682. Anchore Engine
  683. </a>
  684. </li>
  685. <li class="md-nav__item">
  686. <a href="../../examples/jenkins-kubernetes-credentials/" class="md-nav__link">
  687. Jenkins
  688. </a>
  689. </li>
  690. <li class="md-nav__item">
  691. <a href="../../examples/bitwarden/" class="md-nav__link">
  692. BitWarden
  693. </a>
  694. </li>
  695. </ul>
  696. </nav>
  697. </li>
  698. <li class="md-nav__item md-nav__item--nested">
  699. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
  700. <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
  701. Community
  702. <span class="md-nav__icon md-icon"></span>
  703. </label>
  704. <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
  705. <label class="md-nav__title" for="__nav_6">
  706. <span class="md-nav__icon md-icon"></span>
  707. Community
  708. </label>
  709. <ul class="md-nav__list" data-md-scrollfix>
  710. <li class="md-nav__item md-nav__item--nested">
  711. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6_1" >
  712. <label class="md-nav__link" for="__nav_6_1" id="__nav_6_1_label" tabindex="0">
  713. Contributing
  714. <span class="md-nav__icon md-icon"></span>
  715. </label>
  716. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_1_label" aria-expanded="false">
  717. <label class="md-nav__title" for="__nav_6_1">
  718. <span class="md-nav__icon md-icon"></span>
  719. Contributing
  720. </label>
  721. <ul class="md-nav__list" data-md-scrollfix>
  722. <li class="md-nav__item">
  723. <a href="../../contributing/devguide/" class="md-nav__link">
  724. Developer guide
  725. </a>
  726. </li>
  727. <li class="md-nav__item">
  728. <a href="../../contributing/process/" class="md-nav__link">
  729. Contributing Process
  730. </a>
  731. </li>
  732. <li class="md-nav__item">
  733. <a href="../../contributing/release/" class="md-nav__link">
  734. Release Process
  735. </a>
  736. </li>
  737. <li class="md-nav__item">
  738. <a href="../../contributing/coc/" class="md-nav__link">
  739. Code of Conduct
  740. </a>
  741. </li>
  742. <li class="md-nav__item">
  743. <a href="../../contributing/roadmap/" class="md-nav__link">
  744. Roadmap
  745. </a>
  746. </li>
  747. </ul>
  748. </nav>
  749. </li>
  750. <li class="md-nav__item md-nav__item--nested">
  751. <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6_2" >
  752. <label class="md-nav__link" for="__nav_6_2" id="__nav_6_2_label" tabindex="0">
  753. External Resources
  754. <span class="md-nav__icon md-icon"></span>
  755. </label>
  756. <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_2_label" aria-expanded="false">
  757. <label class="md-nav__title" for="__nav_6_2">
  758. <span class="md-nav__icon md-icon"></span>
  759. External Resources
  760. </label>
  761. <ul class="md-nav__list" data-md-scrollfix>
  762. <li class="md-nav__item">
  763. <a href="../../eso-talks/" class="md-nav__link">
  764. Talks
  765. </a>
  766. </li>
  767. <li class="md-nav__item">
  768. <a href="../../eso-demos/" class="md-nav__link">
  769. Demos
  770. </a>
  771. </li>
  772. <li class="md-nav__item">
  773. <a href="../../eso-blogs/" class="md-nav__link">
  774. Blogs
  775. </a>
  776. </li>
  777. </ul>
  778. </nav>
  779. </li>
  780. </ul>
  781. </nav>
  782. </li>
  783. </ul>
  784. </nav>
  785. </div>
  786. </div>
  787. </div>
  788. <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
  789. <div class="md-sidebar__scrollwrap">
  790. <div class="md-sidebar__inner">
  791. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  792. <label class="md-nav__title" for="__toc">
  793. <span class="md-nav__icon md-icon"></span>
  794. Table of contents
  795. </label>
  796. <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
  797. <li class="md-nav__item">
  798. <a href="#can-i-manually-trigger-a-secret-refresh" class="md-nav__link">
  799. Can I manually trigger a secret refresh?
  800. </a>
  801. </li>
  802. <li class="md-nav__item">
  803. <a href="#how-do-i-know-when-my-secret-was-last-synced" class="md-nav__link">
  804. How do I know when my secret was last synced?
  805. </a>
  806. </li>
  807. <li class="md-nav__item">
  808. <a href="#how-do-i-know-when-the-status-of-my-secret-changed-the-last-time" class="md-nav__link">
  809. How do I know when the status of my secret changed the last time?
  810. </a>
  811. </li>
  812. <li class="md-nav__item">
  813. <a href="#differences-to-csi-secret-store" class="md-nav__link">
  814. Differences to csi-secret-store
  815. </a>
  816. </li>
  817. <li class="md-nav__item">
  818. <a href="#how-do-i-debug-an-external-secret-that-doesnt-sync" class="md-nav__link">
  819. How do I debug an external-secret that doesn't sync?
  820. </a>
  821. </li>
  822. <li class="md-nav__item">
  823. <a href="#upgrading-from-kes-to-eso" class="md-nav__link">
  824. Upgrading from KES to ESO
  825. </a>
  826. </li>
  827. </ul>
  828. </nav>
  829. </div>
  830. </div>
  831. </div>
  832. <div class="md-content" data-md-component="content">
  833. <article class="md-content__inner md-typeset">
  834. <h1>FAQ</h1>
  835. <h2 id="can-i-manually-trigger-a-secret-refresh">Can I manually trigger a secret refresh?</h2>
  836. <p>You can trigger a secret refresh by using kubectl or any other kubernetes api client.
  837. You just need to change an annotation, label or the spec of the resource:</p>
  838. <div class="highlight"><pre><span></span><code>kubectl annotate es my-es force-sync=$(date +%s) --overwrite
  839. </code></pre></div>
  840. <h2 id="how-do-i-know-when-my-secret-was-last-synced">How do I know when my secret was last synced?</h2>
  841. <p>The last synchronization timestamp of an ExternalSecret can be retrieved from the field <code>refreshTime</code>. </p>
  842. <div class="highlight"><pre><span></span><code>kubectl get es my-external-secret -o yaml | grep refreshTime
  843. refreshTime: &quot;2022-05-21T23:02:47Z&quot;
  844. </code></pre></div>
  845. <p>The interval can be changed by the <code>spec.refreshInterval</code> in the ExternalSecret.</p>
  846. <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>
  847. <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>
  848. <div class="highlight"><pre><span></span><code>kubectl get es my-external-secret -o yaml | grep condition -A 5
  849. conditions:
  850. - lastTransitionTime: &quot;2022-05-21T21:02:47Z&quot;
  851. message: Secret was synced
  852. reason: SecretSynced
  853. status: &quot;True&quot;
  854. type: Ready
  855. </code></pre></div>
  856. <h2 id="differences-to-csi-secret-store">Differences to csi-secret-store</h2>
  857. <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>
  858. <h2 id="how-do-i-debug-an-external-secret-that-doesnt-sync">How do I debug an external-secret that doesn't sync?</h2>
  859. <p>First, check the status of the ExternalSecret resource using <code>kubectl describe</code>. That displays the status conditions as well as recent events.
  860. 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>
  861. <div class="highlight"><pre><span></span><code>kubectl describe es my-external-secret
  862. [...]
  863. Status:
  864. Conditions:
  865. Last Transition Time: 2022-05-21T21:02:47Z
  866. Message: Secret was synced
  867. Reason: SecretSynced
  868. Status: True
  869. Type: Ready
  870. Refresh Time: 2022-05-21T21:06:47Z
  871. Synced Resource Version: 1-5c833527afd7ba3f426cb0082ee7e083
  872. Events:
  873. Type Reason Age From Message
  874. ---- ------ ---- ---- -------
  875. Warning UpdateFailed 4m12s external-secrets secrets &quot;yyyyyyy&quot; already exists
  876. Normal Updated 12s (x4 over 3m12s) external-secrets Updated Secret
  877. </code></pre></div>
  878. <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>
  879. <p>In an ideally, the store should be validated and Ready.</p>
  880. <div class="highlight"><pre><span></span><code>kubectl describe css kubernetes
  881. [...]
  882. Status:
  883. Conditions:
  884. Last Transition Time: 2022-05-21T21:02:47Z
  885. Message: store validated
  886. Reason: Valid
  887. Status: True
  888. Type: Ready
  889. Events:
  890. Type Reason Age From Message
  891. ---- ------ ---- ---- -------
  892. Normal Valid 52s (x4 over 10m) cluster-secret-store store validated
  893. Normal Valid 52s (x4 over 10m) cluster-secret-store store validated
  894. </code></pre></div>
  895. <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>
  896. <h2 id="upgrading-from-kes-to-eso">Upgrading from KES to ESO</h2>
  897. <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>
  898. <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.
  899. 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>
  900. </article>
  901. </div>
  902. </div>
  903. </main>
  904. <footer class="md-footer">
  905. <div class="md-footer-meta md-typeset">
  906. <div class="md-footer-meta__inner md-grid">
  907. <div class="md-copyright">
  908. <div class="md-copyright__highlight">
  909. &copy; 2023 The external-secrets Authors.<br/>
  910. &copy; 2023 The Linux Foundation. All rights reserved.<br/><br/>
  911. The Linux Foundation has registered trademarks and uses trademarks.<br/>
  912. For a list of trademarks of The Linux Foundation, please see our <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage page</a>.
  913. </div>
  914. Made with
  915. <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
  916. Material for MkDocs
  917. </a>
  918. </div>
  919. </div>
  920. </div>
  921. </footer>
  922. </div>
  923. <div class="md-dialog" data-md-component="dialog">
  924. <div class="md-dialog__inner md-typeset"></div>
  925. </div>
  926. <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.tabs", "navigation.indexes", "navigation.expand"], "search": "../../assets/javascripts/workers/search.208ed371.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>
  927. <script src="../../assets/javascripts/bundle.fac441b0.min.js"></script>
  928. </body>
  929. </html>