index.html 64 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059
  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="icon" href="../../assets/images/favicon.png">
  7. <meta name="generator" content="mkdocs-1.2.3, mkdocs-material-8.1.10">
  8. <title>FluxCD - External Secrets Operator</title>
  9. <link rel="stylesheet" href="../../assets/stylesheets/main.d6be258b.min.css">
  10. <link rel="stylesheet" href="../../assets/stylesheets/palette.e6a45f82.min.css">
  11. <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
  12. <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,400,400i,700%7CRoboto+Mono&display=fallback">
  13. <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
  14. <script>__md_scope=new URL("../..",location),__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>
  15. <script>function gtag(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],gtag("js",new Date),gtag("config","G-QP38TD8K7V"),document.addEventListener("DOMContentLoaded",function(){document.forms.search&&document.forms.search.query.addEventListener("blur",function(){this.value&&gtag("event","search",{search_term:this.value})}),"undefined"!=typeof location$&&location$.subscribe(function(e){gtag("config","G-QP38TD8K7V",{page_path:e.pathname})})})</script>
  16. <script async src="https://www.googletagmanager.com/gtag/js?id=G-QP38TD8K7V"></script>
  17. </head>
  18. <body dir="ltr" data-md-color-scheme="" data-md-color-primary="none" data-md-color-accent="none">
  19. <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
  20. <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
  21. <label class="md-overlay" for="__drawer"></label>
  22. <div data-md-component="skip">
  23. <a href="#gitops-using-fluxcd-v2" class="md-skip">
  24. Skip to content
  25. </a>
  26. </div>
  27. <div data-md-component="announce">
  28. </div>
  29. <div data-md-component="outdated" hidden>
  30. <aside class="md-banner md-banner--warning">
  31. <div class="md-banner__inner md-grid md-typeset">
  32. You're not viewing the latest version.
  33. <a href="../../..">
  34. <strong>Click here to go to latest.</strong>
  35. </a>
  36. </div>
  37. <script>var el=document.querySelector("[data-md-component=outdated]"),outdated=__md_get("__outdated",sessionStorage);!0===outdated&&el&&(el.hidden=!1)</script>
  38. </aside>
  39. </div>
  40. <header class="md-header" data-md-component="header">
  41. <nav class="md-header__inner md-grid" aria-label="Header">
  42. <a href="../.." title="External Secrets Operator" class="md-header__button md-logo" aria-label="External Secrets Operator" data-md-component="logo">
  43. <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>
  44. </a>
  45. <label class="md-header__button md-icon" for="__drawer">
  46. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2z"/></svg>
  47. </label>
  48. <div class="md-header__title" data-md-component="header-title">
  49. <div class="md-header__ellipsis">
  50. <div class="md-header__topic">
  51. <span class="md-ellipsis">
  52. External Secrets Operator
  53. </span>
  54. </div>
  55. <div class="md-header__topic" data-md-component="header-topic">
  56. <span class="md-ellipsis">
  57. FluxCD
  58. </span>
  59. </div>
  60. </div>
  61. </div>
  62. <label class="md-header__button md-icon" for="__search">
  63. <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>
  64. </label>
  65. <div class="md-search" data-md-component="search" role="dialog">
  66. <label class="md-search__overlay" for="__search"></label>
  67. <div class="md-search__inner" role="search">
  68. <form class="md-search__form" name="search">
  69. <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>
  70. <label class="md-search__icon md-icon" for="__search">
  71. <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>
  72. <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>
  73. </label>
  74. <nav class="md-search__options" aria-label="Search">
  75. <button type="reset" class="md-search__icon md-icon" aria-label="Clear" tabindex="-1">
  76. <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>
  77. </button>
  78. </nav>
  79. </form>
  80. <div class="md-search__output">
  81. <div class="md-search__scrollwrap" data-md-scrollfix>
  82. <div class="md-search-result" data-md-component="search-result">
  83. <div class="md-search-result__meta">
  84. Initializing search
  85. </div>
  86. <ol class="md-search-result__list"></ol>
  87. </div>
  88. </div>
  89. </div>
  90. </div>
  91. </div>
  92. <div class="md-header__source">
  93. <a href="https://github.com/external-secrets/external-secrets/" title="Go to repository" class="md-source" data-md-component="source">
  94. <div class="md-source__icon md-icon">
  95. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><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>
  96. </div>
  97. <div class="md-source__repository">
  98. External Secrets Operator
  99. </div>
  100. </a>
  101. </div>
  102. </nav>
  103. </header>
  104. <div class="md-container" data-md-component="container">
  105. <main class="md-main" data-md-component="main">
  106. <div class="md-main__inner md-grid">
  107. <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
  108. <div class="md-sidebar__scrollwrap">
  109. <div class="md-sidebar__inner">
  110. <nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
  111. <label class="md-nav__title" for="__drawer">
  112. <a href="../.." title="External Secrets Operator" class="md-nav__button md-logo" aria-label="External Secrets Operator" data-md-component="logo">
  113. <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>
  114. </a>
  115. External Secrets Operator
  116. </label>
  117. <div class="md-nav__source">
  118. <a href="https://github.com/external-secrets/external-secrets/" title="Go to repository" class="md-source" data-md-component="source">
  119. <div class="md-source__icon md-icon">
  120. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><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>
  121. </div>
  122. <div class="md-source__repository">
  123. External Secrets Operator
  124. </div>
  125. </a>
  126. </div>
  127. <ul class="md-nav__list" data-md-scrollfix>
  128. <li class="md-nav__item">
  129. <a href="../.." class="md-nav__link">
  130. Introduction
  131. </a>
  132. </li>
  133. <li class="md-nav__item">
  134. <a href="../../overview/" class="md-nav__link">
  135. Overview
  136. </a>
  137. </li>
  138. <li class="md-nav__item md-nav__item--nested">
  139. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_3" type="checkbox" id="__nav_3" >
  140. <label class="md-nav__link" for="__nav_3">
  141. API Types
  142. <span class="md-nav__icon md-icon"></span>
  143. </label>
  144. <nav class="md-nav" aria-label="API Types" data-md-level="1">
  145. <label class="md-nav__title" for="__nav_3">
  146. <span class="md-nav__icon md-icon"></span>
  147. API Types
  148. </label>
  149. <ul class="md-nav__list" data-md-scrollfix>
  150. <li class="md-nav__item">
  151. <a href="../../api/externalsecret/" class="md-nav__link">
  152. ExternalSecret
  153. </a>
  154. </li>
  155. <li class="md-nav__item">
  156. <a href="../../api/secretstore/" class="md-nav__link">
  157. SecretStore
  158. </a>
  159. </li>
  160. <li class="md-nav__item">
  161. <a href="../../api/clustersecretstore/" class="md-nav__link">
  162. ClusterSecretStore
  163. </a>
  164. </li>
  165. <li class="md-nav__item">
  166. <a href="../../api/clusterexternalsecret/" class="md-nav__link">
  167. ClusterExternalSecret
  168. </a>
  169. </li>
  170. </ul>
  171. </nav>
  172. </li>
  173. <li class="md-nav__item md-nav__item--nested">
  174. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_4" type="checkbox" id="__nav_4" >
  175. <label class="md-nav__link" for="__nav_4">
  176. Guides
  177. <span class="md-nav__icon md-icon"></span>
  178. </label>
  179. <nav class="md-nav" aria-label="Guides" data-md-level="1">
  180. <label class="md-nav__title" for="__nav_4">
  181. <span class="md-nav__icon md-icon"></span>
  182. Guides
  183. </label>
  184. <ul class="md-nav__list" data-md-scrollfix>
  185. <li class="md-nav__item">
  186. <a href="../../guides/introduction/" class="md-nav__link">
  187. Introduction
  188. </a>
  189. </li>
  190. <li class="md-nav__item">
  191. <a href="../../guides/getting-started/" class="md-nav__link">
  192. Getting started
  193. </a>
  194. </li>
  195. <li class="md-nav__item md-nav__item--nested">
  196. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_4_3" type="checkbox" id="__nav_4_3" >
  197. <label class="md-nav__link" for="__nav_4_3">
  198. Advanced Templating
  199. <span class="md-nav__icon md-icon"></span>
  200. </label>
  201. <nav class="md-nav" aria-label="Advanced Templating" data-md-level="2">
  202. <label class="md-nav__title" for="__nav_4_3">
  203. <span class="md-nav__icon md-icon"></span>
  204. Advanced Templating
  205. </label>
  206. <ul class="md-nav__list" data-md-scrollfix>
  207. <li class="md-nav__item">
  208. <a href="../../guides/templating/" class="md-nav__link">
  209. v2
  210. </a>
  211. </li>
  212. <li class="md-nav__item">
  213. <a href="../../guides/templating-v1/" class="md-nav__link">
  214. v1
  215. </a>
  216. </li>
  217. </ul>
  218. </nav>
  219. </li>
  220. <li class="md-nav__item">
  221. <a href="../../guides/all-keys-one-secret/" class="md-nav__link">
  222. All keys, One secret
  223. </a>
  224. </li>
  225. <li class="md-nav__item">
  226. <a href="../../guides/common-k8s-secret-types/" class="md-nav__link">
  227. Common K8S Secret Types
  228. </a>
  229. </li>
  230. <li class="md-nav__item">
  231. <a href="../../guides/controller-class/" class="md-nav__link">
  232. Controller Classes
  233. </a>
  234. </li>
  235. <li class="md-nav__item">
  236. <a href="../../guides/ownership-deletion-policy/" class="md-nav__link">
  237. Lifecycle: ownership & deletion
  238. </a>
  239. </li>
  240. <li class="md-nav__item">
  241. <a href="../../guides/decoding-strategy/" class="md-nav__link">
  242. Decoding Strategies
  243. </a>
  244. </li>
  245. <li class="md-nav__item">
  246. <a href="../../guides/getallsecrets/" class="md-nav__link">
  247. Getting Multiple Secrets
  248. </a>
  249. </li>
  250. <li class="md-nav__item">
  251. <a href="../../guides/multi-tenancy/" class="md-nav__link">
  252. Multi Tenancy
  253. </a>
  254. </li>
  255. <li class="md-nav__item">
  256. <a href="../../guides/metrics/" class="md-nav__link">
  257. Metrics
  258. </a>
  259. </li>
  260. <li class="md-nav__item">
  261. <a href="../../guides/datafrom-rewrite/" class="md-nav__link">
  262. Rewriting Keys
  263. </a>
  264. </li>
  265. <li class="md-nav__item">
  266. <a href="../../guides/v1beta1/" class="md-nav__link">
  267. Upgrading to v1beta1
  268. </a>
  269. </li>
  270. <li class="md-nav__item">
  271. <a href="../../guides/using-latest-image/" class="md-nav__link">
  272. Using Latest Image
  273. </a>
  274. </li>
  275. </ul>
  276. </nav>
  277. </li>
  278. <li class="md-nav__item md-nav__item--nested">
  279. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5" type="checkbox" id="__nav_5" >
  280. <label class="md-nav__link" for="__nav_5">
  281. Provider
  282. <span class="md-nav__icon md-icon"></span>
  283. </label>
  284. <nav class="md-nav" aria-label="Provider" data-md-level="1">
  285. <label class="md-nav__title" for="__nav_5">
  286. <span class="md-nav__icon md-icon"></span>
  287. Provider
  288. </label>
  289. <ul class="md-nav__list" data-md-scrollfix>
  290. <li class="md-nav__item md-nav__item--nested">
  291. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5_1" type="checkbox" id="__nav_5_1" >
  292. <label class="md-nav__link" for="__nav_5_1">
  293. AWS
  294. <span class="md-nav__icon md-icon"></span>
  295. </label>
  296. <nav class="md-nav" aria-label="AWS" data-md-level="2">
  297. <label class="md-nav__title" for="__nav_5_1">
  298. <span class="md-nav__icon md-icon"></span>
  299. AWS
  300. </label>
  301. <ul class="md-nav__list" data-md-scrollfix>
  302. <li class="md-nav__item">
  303. <a href="../../provider/aws-secrets-manager/" class="md-nav__link">
  304. Secrets Manager
  305. </a>
  306. </li>
  307. <li class="md-nav__item">
  308. <a href="../../provider/aws-parameter-store/" class="md-nav__link">
  309. Parameter Store
  310. </a>
  311. </li>
  312. </ul>
  313. </nav>
  314. </li>
  315. <li class="md-nav__item md-nav__item--nested">
  316. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5_2" type="checkbox" id="__nav_5_2" >
  317. <label class="md-nav__link" for="__nav_5_2">
  318. Azure
  319. <span class="md-nav__icon md-icon"></span>
  320. </label>
  321. <nav class="md-nav" aria-label="Azure" data-md-level="2">
  322. <label class="md-nav__title" for="__nav_5_2">
  323. <span class="md-nav__icon md-icon"></span>
  324. Azure
  325. </label>
  326. <ul class="md-nav__list" data-md-scrollfix>
  327. <li class="md-nav__item">
  328. <a href="../../provider/azure-key-vault/" class="md-nav__link">
  329. Key Vault
  330. </a>
  331. </li>
  332. </ul>
  333. </nav>
  334. </li>
  335. <li class="md-nav__item md-nav__item--nested">
  336. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5_3" type="checkbox" id="__nav_5_3" >
  337. <label class="md-nav__link" for="__nav_5_3">
  338. Google
  339. <span class="md-nav__icon md-icon"></span>
  340. </label>
  341. <nav class="md-nav" aria-label="Google" data-md-level="2">
  342. <label class="md-nav__title" for="__nav_5_3">
  343. <span class="md-nav__icon md-icon"></span>
  344. Google
  345. </label>
  346. <ul class="md-nav__list" data-md-scrollfix>
  347. <li class="md-nav__item">
  348. <a href="../../provider/google-secrets-manager/" class="md-nav__link">
  349. Secret Manager
  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" data-md-toggle="__nav_5_4" type="checkbox" id="__nav_5_4" >
  357. <label class="md-nav__link" for="__nav_5_4">
  358. IBM
  359. <span class="md-nav__icon md-icon"></span>
  360. </label>
  361. <nav class="md-nav" aria-label="IBM" data-md-level="2">
  362. <label class="md-nav__title" for="__nav_5_4">
  363. <span class="md-nav__icon md-icon"></span>
  364. IBM
  365. </label>
  366. <ul class="md-nav__list" data-md-scrollfix>
  367. <li class="md-nav__item">
  368. <a href="../../provider/ibm-secrets-manager/" class="md-nav__link">
  369. Secrets Manager
  370. </a>
  371. </li>
  372. </ul>
  373. </nav>
  374. </li>
  375. <li class="md-nav__item">
  376. <a href="../../provider/akeyless/" class="md-nav__link">
  377. Akeyless
  378. </a>
  379. </li>
  380. <li class="md-nav__item">
  381. <a href="../../provider/hashicorp-vault/" class="md-nav__link">
  382. HashiCorp Vault
  383. </a>
  384. </li>
  385. <li class="md-nav__item md-nav__item--nested">
  386. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5_7" type="checkbox" id="__nav_5_7" >
  387. <label class="md-nav__link" for="__nav_5_7">
  388. Yandex
  389. <span class="md-nav__icon md-icon"></span>
  390. </label>
  391. <nav class="md-nav" aria-label="Yandex" data-md-level="2">
  392. <label class="md-nav__title" for="__nav_5_7">
  393. <span class="md-nav__icon md-icon"></span>
  394. Yandex
  395. </label>
  396. <ul class="md-nav__list" data-md-scrollfix>
  397. <li class="md-nav__item">
  398. <a href="../../provider/yandex-certificate-manager/" class="md-nav__link">
  399. Certificate Manager
  400. </a>
  401. </li>
  402. <li class="md-nav__item">
  403. <a href="../../provider/yandex-lockbox/" class="md-nav__link">
  404. Lockbox
  405. </a>
  406. </li>
  407. </ul>
  408. </nav>
  409. </li>
  410. <li class="md-nav__item md-nav__item--nested">
  411. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5_8" type="checkbox" id="__nav_5_8" >
  412. <label class="md-nav__link" for="__nav_5_8">
  413. Gitlab
  414. <span class="md-nav__icon md-icon"></span>
  415. </label>
  416. <nav class="md-nav" aria-label="Gitlab" data-md-level="2">
  417. <label class="md-nav__title" for="__nav_5_8">
  418. <span class="md-nav__icon md-icon"></span>
  419. Gitlab
  420. </label>
  421. <ul class="md-nav__list" data-md-scrollfix>
  422. <li class="md-nav__item">
  423. <a href="../../provider/gitlab-project-variables/" class="md-nav__link">
  424. Gitlab Project Variables
  425. </a>
  426. </li>
  427. </ul>
  428. </nav>
  429. </li>
  430. <li class="md-nav__item md-nav__item--nested">
  431. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5_9" type="checkbox" id="__nav_5_9" >
  432. <label class="md-nav__link" for="__nav_5_9">
  433. Oracle
  434. <span class="md-nav__icon md-icon"></span>
  435. </label>
  436. <nav class="md-nav" aria-label="Oracle" data-md-level="2">
  437. <label class="md-nav__title" for="__nav_5_9">
  438. <span class="md-nav__icon md-icon"></span>
  439. Oracle
  440. </label>
  441. <ul class="md-nav__list" data-md-scrollfix>
  442. <li class="md-nav__item">
  443. <a href="../../provider/oracle-vault/" class="md-nav__link">
  444. Oracle Vault
  445. </a>
  446. </li>
  447. </ul>
  448. </nav>
  449. </li>
  450. <li class="md-nav__item md-nav__item--nested">
  451. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5_10" type="checkbox" id="__nav_5_10" >
  452. <label class="md-nav__link" for="__nav_5_10">
  453. 1Password
  454. <span class="md-nav__icon md-icon"></span>
  455. </label>
  456. <nav class="md-nav" aria-label="1Password" data-md-level="2">
  457. <label class="md-nav__title" for="__nav_5_10">
  458. <span class="md-nav__icon md-icon"></span>
  459. 1Password
  460. </label>
  461. <ul class="md-nav__list" data-md-scrollfix>
  462. <li class="md-nav__item">
  463. <a href="../../provider/1password-automation/" class="md-nav__link">
  464. Secrets Automation
  465. </a>
  466. </li>
  467. </ul>
  468. </nav>
  469. </li>
  470. <li class="md-nav__item">
  471. <a href="../../provider/webhook/" class="md-nav__link">
  472. Webhook
  473. </a>
  474. </li>
  475. <li class="md-nav__item">
  476. <a href="../../provider/fake/" class="md-nav__link">
  477. Fake
  478. </a>
  479. </li>
  480. <li class="md-nav__item">
  481. <a href="../../provider/kubernetes/" class="md-nav__link">
  482. Kubernetes
  483. </a>
  484. </li>
  485. <li class="md-nav__item md-nav__item--nested">
  486. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5_14" type="checkbox" id="__nav_5_14" >
  487. <label class="md-nav__link" for="__nav_5_14">
  488. senhasegura
  489. <span class="md-nav__icon md-icon"></span>
  490. </label>
  491. <nav class="md-nav" aria-label="senhasegura" data-md-level="2">
  492. <label class="md-nav__title" for="__nav_5_14">
  493. <span class="md-nav__icon md-icon"></span>
  494. senhasegura
  495. </label>
  496. <ul class="md-nav__list" data-md-scrollfix>
  497. <li class="md-nav__item">
  498. <a href="../../provider/senhasegura-dsm/" class="md-nav__link">
  499. DevOps Secrets Management (DSM)
  500. </a>
  501. </li>
  502. </ul>
  503. </nav>
  504. </li>
  505. <li class="md-nav__item">
  506. <a href="../../provider/doppler/" class="md-nav__link">
  507. Doppler
  508. </a>
  509. </li>
  510. </ul>
  511. </nav>
  512. </li>
  513. <li class="md-nav__item md-nav__item--active md-nav__item--nested">
  514. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_6" type="checkbox" id="__nav_6" checked>
  515. <label class="md-nav__link" for="__nav_6">
  516. Examples
  517. <span class="md-nav__icon md-icon"></span>
  518. </label>
  519. <nav class="md-nav" aria-label="Examples" data-md-level="1">
  520. <label class="md-nav__title" for="__nav_6">
  521. <span class="md-nav__icon md-icon"></span>
  522. Examples
  523. </label>
  524. <ul class="md-nav__list" data-md-scrollfix>
  525. <li class="md-nav__item md-nav__item--active">
  526. <input class="md-nav__toggle md-toggle" data-md-toggle="toc" type="checkbox" id="__toc">
  527. <label class="md-nav__link md-nav__link--active" for="__toc">
  528. FluxCD
  529. <span class="md-nav__icon md-icon"></span>
  530. </label>
  531. <a href="./" class="md-nav__link md-nav__link--active">
  532. FluxCD
  533. </a>
  534. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  535. <label class="md-nav__title" for="__toc">
  536. <span class="md-nav__icon md-icon"></span>
  537. Table of contents
  538. </label>
  539. <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
  540. <li class="md-nav__item">
  541. <a href="#advantages" class="md-nav__link">
  542. Advantages
  543. </a>
  544. </li>
  545. <li class="md-nav__item">
  546. <a href="#the-approach" class="md-nav__link">
  547. The approach
  548. </a>
  549. </li>
  550. <li class="md-nav__item">
  551. <a href="#the-problem" class="md-nav__link">
  552. The problem
  553. </a>
  554. </li>
  555. <li class="md-nav__item">
  556. <a href="#the-solution" class="md-nav__link">
  557. The solution
  558. </a>
  559. </li>
  560. <li class="md-nav__item">
  561. <a href="#create-the-main-kustomization" class="md-nav__link">
  562. Create the main kustomization
  563. </a>
  564. </li>
  565. <li class="md-nav__item">
  566. <a href="#create-the-secret" class="md-nav__link">
  567. Create the secret
  568. </a>
  569. </li>
  570. <li class="md-nav__item">
  571. <a href="#creating-the-references-to-repositories" class="md-nav__link">
  572. Creating the references to repositories
  573. </a>
  574. </li>
  575. <li class="md-nav__item">
  576. <a href="#deploy-the-crds" class="md-nav__link">
  577. Deploy the CRDs
  578. </a>
  579. </li>
  580. <li class="md-nav__item">
  581. <a href="#deploy-the-operator" class="md-nav__link">
  582. Deploy the operator
  583. </a>
  584. </li>
  585. <li class="md-nav__item">
  586. <a href="#deploy-the-crs" class="md-nav__link">
  587. Deploy the CRs
  588. </a>
  589. </li>
  590. <li class="md-nav__item">
  591. <a href="#results" class="md-nav__link">
  592. Results
  593. </a>
  594. </li>
  595. </ul>
  596. </nav>
  597. </li>
  598. <li class="md-nav__item">
  599. <a href="../anchore-engine-credentials/" class="md-nav__link">
  600. Anchore Engine
  601. </a>
  602. </li>
  603. <li class="md-nav__item">
  604. <a href="../jenkins-kubernetes-credentials/" class="md-nav__link">
  605. Jenkins
  606. </a>
  607. </li>
  608. </ul>
  609. </nav>
  610. </li>
  611. <li class="md-nav__item md-nav__item--nested">
  612. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_7" type="checkbox" id="__nav_7" >
  613. <label class="md-nav__link" for="__nav_7">
  614. External Resources
  615. <span class="md-nav__icon md-icon"></span>
  616. </label>
  617. <nav class="md-nav" aria-label="External Resources" data-md-level="1">
  618. <label class="md-nav__title" for="__nav_7">
  619. <span class="md-nav__icon md-icon"></span>
  620. External Resources
  621. </label>
  622. <ul class="md-nav__list" data-md-scrollfix>
  623. <li class="md-nav__item">
  624. <a href="../../eso-talks/" class="md-nav__link">
  625. Talks
  626. </a>
  627. </li>
  628. <li class="md-nav__item">
  629. <a href="../../eso-demos/" class="md-nav__link">
  630. Demos
  631. </a>
  632. </li>
  633. <li class="md-nav__item">
  634. <a href="../../eso-blogs/" class="md-nav__link">
  635. Blogs
  636. </a>
  637. </li>
  638. </ul>
  639. </nav>
  640. </li>
  641. <li class="md-nav__item md-nav__item--nested">
  642. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_8" type="checkbox" id="__nav_8" >
  643. <label class="md-nav__link" for="__nav_8">
  644. References
  645. <span class="md-nav__icon md-icon"></span>
  646. </label>
  647. <nav class="md-nav" aria-label="References" data-md-level="1">
  648. <label class="md-nav__title" for="__nav_8">
  649. <span class="md-nav__icon md-icon"></span>
  650. References
  651. </label>
  652. <ul class="md-nav__list" data-md-scrollfix>
  653. <li class="md-nav__item">
  654. <a href="../../spec/" class="md-nav__link">
  655. API specification
  656. </a>
  657. </li>
  658. </ul>
  659. </nav>
  660. </li>
  661. <li class="md-nav__item md-nav__item--nested">
  662. <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_9" type="checkbox" id="__nav_9" >
  663. <label class="md-nav__link" for="__nav_9">
  664. Contributing
  665. <span class="md-nav__icon md-icon"></span>
  666. </label>
  667. <nav class="md-nav" aria-label="Contributing" data-md-level="1">
  668. <label class="md-nav__title" for="__nav_9">
  669. <span class="md-nav__icon md-icon"></span>
  670. Contributing
  671. </label>
  672. <ul class="md-nav__list" data-md-scrollfix>
  673. <li class="md-nav__item">
  674. <a href="../../contributing/devguide/" class="md-nav__link">
  675. Developer guide
  676. </a>
  677. </li>
  678. <li class="md-nav__item">
  679. <a href="../../contributing/process/" class="md-nav__link">
  680. Contributing Process
  681. </a>
  682. </li>
  683. <li class="md-nav__item">
  684. <a href="../../contributing/release/" class="md-nav__link">
  685. Release Process
  686. </a>
  687. </li>
  688. <li class="md-nav__item">
  689. <a href="../../contributing/coc/" class="md-nav__link">
  690. Code of Conduct
  691. </a>
  692. </li>
  693. <li class="md-nav__item">
  694. <a href="../../contributing/roadmap/" class="md-nav__link">
  695. Roadmap
  696. </a>
  697. </li>
  698. </ul>
  699. </nav>
  700. </li>
  701. <li class="md-nav__item">
  702. <a href="../../faq/" class="md-nav__link">
  703. FAQ
  704. </a>
  705. </li>
  706. <li class="md-nav__item">
  707. <a href="../../stability-support/" class="md-nav__link">
  708. Stability and Support
  709. </a>
  710. </li>
  711. <li class="md-nav__item">
  712. <a href="../../deprecation-policy/" class="md-nav__link">
  713. Deprecation Policy
  714. </a>
  715. </li>
  716. </ul>
  717. </nav>
  718. </div>
  719. </div>
  720. </div>
  721. <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
  722. <div class="md-sidebar__scrollwrap">
  723. <div class="md-sidebar__inner">
  724. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  725. <label class="md-nav__title" for="__toc">
  726. <span class="md-nav__icon md-icon"></span>
  727. Table of contents
  728. </label>
  729. <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
  730. <li class="md-nav__item">
  731. <a href="#advantages" class="md-nav__link">
  732. Advantages
  733. </a>
  734. </li>
  735. <li class="md-nav__item">
  736. <a href="#the-approach" class="md-nav__link">
  737. The approach
  738. </a>
  739. </li>
  740. <li class="md-nav__item">
  741. <a href="#the-problem" class="md-nav__link">
  742. The problem
  743. </a>
  744. </li>
  745. <li class="md-nav__item">
  746. <a href="#the-solution" class="md-nav__link">
  747. The solution
  748. </a>
  749. </li>
  750. <li class="md-nav__item">
  751. <a href="#create-the-main-kustomization" class="md-nav__link">
  752. Create the main kustomization
  753. </a>
  754. </li>
  755. <li class="md-nav__item">
  756. <a href="#create-the-secret" class="md-nav__link">
  757. Create the secret
  758. </a>
  759. </li>
  760. <li class="md-nav__item">
  761. <a href="#creating-the-references-to-repositories" class="md-nav__link">
  762. Creating the references to repositories
  763. </a>
  764. </li>
  765. <li class="md-nav__item">
  766. <a href="#deploy-the-crds" class="md-nav__link">
  767. Deploy the CRDs
  768. </a>
  769. </li>
  770. <li class="md-nav__item">
  771. <a href="#deploy-the-operator" class="md-nav__link">
  772. Deploy the operator
  773. </a>
  774. </li>
  775. <li class="md-nav__item">
  776. <a href="#deploy-the-crs" class="md-nav__link">
  777. Deploy the CRs
  778. </a>
  779. </li>
  780. <li class="md-nav__item">
  781. <a href="#results" class="md-nav__link">
  782. Results
  783. </a>
  784. </li>
  785. </ul>
  786. </nav>
  787. </div>
  788. </div>
  789. </div>
  790. <div class="md-content" data-md-component="content">
  791. <article class="md-content__inner md-typeset">
  792. <a href="https://github.com/external-secrets/external-secrets/edit/main/docs/examples/gitops-using-fluxcd.md" title="Edit this page" class="md-content__button md-icon">
  793. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20.71 7.04c.39-.39.39-1.04 0-1.41l-2.34-2.34c-.37-.39-1.02-.39-1.41 0l-1.84 1.83 3.75 3.75M3 17.25V21h3.75L17.81 9.93l-3.75-3.75L3 17.25z"/></svg>
  794. </a>
  795. <h1 id="gitops-using-fluxcd-v2">GitOps using FluxCD (v2)</h1>
  796. <p>FluxCD is a GitOps operator for Kubernetes. It synchronizes the status of the cluster from manifests allocated in
  797. different repositories (Git or Helm). This approach fits perfectly with External Secrets on clusters which are dynamically
  798. created, to get credentials with no manual intervention from the beginning.</p>
  799. <h2 id="advantages">Advantages</h2>
  800. <p>This approach has several advantages as follows:</p>
  801. <ul>
  802. <li><strong>Homogenize environments</strong> allowing developers to use the same toolset in Kind in the same way they do in the cloud
  803. provider distributions such as EKS or GKE. This accelerates the development</li>
  804. <li><strong>Reduce security risks</strong>, because credentials can be easily obtained, so temptation to store them locally is reduced.</li>
  805. <li><strong>Application compatibility increase</strong>: Applications are deployed in different ways, and sometimes they need to share
  806. credentials. This can be done using External Secrets as a wire for them at real time.</li>
  807. <li><strong>Automation by default</strong> oh, come on!</li>
  808. </ul>
  809. <h2 id="the-approach">The approach</h2>
  810. <p>FluxCD is composed by several controllers dedicated to manage different custom resources. The most important
  811. ones are <strong>Kustomization</strong> (to clarify, Flux one, not Kubernetes' one) and <strong>HelmRelease</strong> to deploy using the approaches
  812. of the same names.</p>
  813. <p>External Secrets can be deployed using Helm <a href="../../guides/getting-started/">as explained here</a>. The deployment includes the
  814. CRDs if enabled on the <code>values.yaml</code>, but after this, you need to deploy some <code>SecretStore</code> to start
  815. getting credentials from your secrets manager with External Secrets.</p>
  816. <blockquote>
  817. <p>The idea of this guide is to deploy the whole stack, using flux, needed by developers not to worry about the credentials,
  818. but only about the application and its code.</p>
  819. </blockquote>
  820. <h2 id="the-problem">The problem</h2>
  821. <p>This can sound easy, but External Secrets is deployed using Helm, which is managed by the HelmController,
  822. and your custom resources, for example a <code>ClusterSecretStore</code> and the related <code>Secret</code>, are often deployed using a
  823. <code>kustomization.yaml</code>, which is deployed by the KustomizeController.</p>
  824. <p>Both controllers manage the resources independently, at different moments, with no possibility to wait each other.
  825. This means that we have a wonderful race condition where sometimes the CRs (<code>SecretStore</code>,<code>ClusterSecretStore</code>...) tries
  826. to be deployed before than the CRDs needed to recognize them.</p>
  827. <h2 id="the-solution">The solution</h2>
  828. <p>Let's see the conditions to start working on a solution:</p>
  829. <ul>
  830. <li>The External Secrets operator is deployed with Helm, and admits disabling the CRDs deployment</li>
  831. <li>The race condition only affects the deployment of <code>CustomResourceDefinition</code> and the CRs needed later</li>
  832. <li>CRDs can be deployed directly from the Git repository of the project using a Flux <code>Kustomization</code></li>
  833. <li>Required CRs can be deployed using a Flux <code>Kustomization</code> too, allowing dependency between CRDs and CRs</li>
  834. <li>All previous manifests can be applied with a Kubernetes <code>kustomization</code></li>
  835. </ul>
  836. <h2 id="create-the-main-kustomization">Create the main kustomization</h2>
  837. <p>To have a better view of things needed later, the first manifest to be created is the <code>kustomization.yaml</code></p>
  838. <div class="highlight"><pre><span></span><code><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kustomize.config.k8s.io/v1beta1</span><span class="w"></span>
  839. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Kustomization</span><span class="w"></span>
  840. <span class="nt">resources</span><span class="p">:</span><span class="w"></span>
  841. <span class="c1"># Deploy the Vault access secret</span><span class="w"></span>
  842. <span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">namespace.yaml</span><span class="w"></span>
  843. <span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">secret-token.yaml</span><span class="w"></span>
  844. <span class="c1"># Deploy the repositories</span><span class="w"></span>
  845. <span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">repositories.yaml</span><span class="w"></span>
  846. <span class="c1"># Deploy the CRDs</span><span class="w"></span>
  847. <span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">deployment-crds.yaml</span><span class="w"></span>
  848. <span class="c1"># Deploy the operator</span><span class="w"></span>
  849. <span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">deployment.yaml</span><span class="w"></span>
  850. <span class="c1"># Deploy default Custom Resources from &#39;crs&#39; directory</span><span class="w"></span>
  851. <span class="c1"># INFO: This depends on the CRDs deployment. Will happen after it</span><span class="w"></span>
  852. <span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">deployment-crs.yaml</span><span class="w"></span>
  853. </code></pre></div>
  854. <h2 id="create-the-secret">Create the secret</h2>
  855. <p>To access your secret manager, External Secrets needs some credentials. They are stored inside a Secret, which is intended
  856. to be deployed by automation as a good practise. This time, a placeholder called <code>secret-token.yaml</code> is show as an example:</p>
  857. <div class="highlight"><pre><span></span><code><span class="c1"># The namespace.yaml first</span><span class="w"></span>
  858. <span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">v1</span><span class="w"></span>
  859. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Namespace</span><span class="w"></span>
  860. <span class="nt">metadata</span><span class="p">:</span><span class="w"></span>
  861. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets</span><span class="w"></span>
  862. </code></pre></div>
  863. <div class="highlight"><pre><span></span><code><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">v1</span><span class="w"></span>
  864. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Secret</span><span class="w"></span>
  865. <span class="nt">metadata</span><span class="p">:</span><span class="w"></span>
  866. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">vault-token-global</span><span class="w"></span>
  867. <span class="w"> </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets</span><span class="w"></span>
  868. <span class="nt">stringData</span><span class="p">:</span><span class="w"></span>
  869. <span class="w"> </span><span class="c1"># This token must be patched by overlays. Not here for security reasons</span><span class="w"></span>
  870. <span class="w"> </span><span class="nt">token</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">change-me-placeholder</span><span class="w"></span>
  871. </code></pre></div>
  872. <h2 id="creating-the-references-to-repositories">Creating the references to repositories</h2>
  873. <p>Create a manifest called <code>repositories.yaml</code> to store the references to external repositories for Flux</p>
  874. <div class="highlight"><pre><span></span><code><span class="c1"># Reference to Helm repository</span><span class="w"></span>
  875. <span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">source.toolkit.fluxcd.io/v1beta1</span><span class="w"></span>
  876. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HelmRepository</span><span class="w"></span>
  877. <span class="nt">metadata</span><span class="p">:</span><span class="w"></span>
  878. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets</span><span class="w"></span>
  879. <span class="w"> </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">flux-system</span><span class="w"></span>
  880. <span class="nt">spec</span><span class="p">:</span><span class="w"></span>
  881. <span class="w"> </span><span class="nt">interval</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10m</span><span class="w"></span>
  882. <span class="w"> </span><span class="nt">url</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">https://charts.external-secrets.io</span><span class="w"></span>
  883. <span class="nn">---</span><span class="w"></span>
  884. <span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">source.toolkit.fluxcd.io/v1beta1</span><span class="w"></span>
  885. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GitRepository</span><span class="w"></span>
  886. <span class="nt">metadata</span><span class="p">:</span><span class="w"></span>
  887. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets</span><span class="w"></span>
  888. <span class="w"> </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">flux-system</span><span class="w"></span>
  889. <span class="nt">spec</span><span class="p">:</span><span class="w"></span>
  890. <span class="w"> </span><span class="nt">interval</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10m</span><span class="w"></span>
  891. <span class="w"> </span><span class="nt">ref</span><span class="p">:</span><span class="w"></span>
  892. <span class="w"> </span><span class="nt">branch</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">main</span><span class="w"></span>
  893. <span class="w"> </span><span class="nt">url</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">http://github.com/external-secrets/external-secrets</span><span class="w"></span>
  894. </code></pre></div>
  895. <h2 id="deploy-the-crds">Deploy the CRDs</h2>
  896. <p>As mentioned, CRDs can be deployed using the official Helm package, but to solve the race condition, they will be deployed
  897. from our git repository using a Kustomization manifest called <code>deployment-crds.yaml</code> as follows:</p>
  898. <div class="highlight"><pre><span></span><code><span class="nn">---</span><span class="w"></span>
  899. <span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kustomize.toolkit.fluxcd.io/v1beta2</span><span class="w"></span>
  900. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Kustomization</span><span class="w"></span>
  901. <span class="nt">metadata</span><span class="p">:</span><span class="w"></span>
  902. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets-crds</span><span class="w"></span>
  903. <span class="w"> </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">flux-system</span><span class="w"></span>
  904. <span class="nt">spec</span><span class="p">:</span><span class="w"></span>
  905. <span class="w"> </span><span class="nt">interval</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10m</span><span class="w"></span>
  906. <span class="w"> </span><span class="nt">path</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">./deploy/crds</span><span class="w"></span>
  907. <span class="w"> </span><span class="nt">prune</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span><span class="w"></span>
  908. <span class="w"> </span><span class="nt">sourceRef</span><span class="p">:</span><span class="w"></span>
  909. <span class="w"> </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GitRepository</span><span class="w"></span>
  910. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets</span><span class="w"></span>
  911. </code></pre></div>
  912. <h2 id="deploy-the-operator">Deploy the operator</h2>
  913. <p>The operator is deployed using a HelmRelease manifest to deploy the Helm package, but due to the special race condition,
  914. the deployment must be disabled in the <code>values</code> of the manifest called <code>deployment.yaml</code>, as follows:</p>
  915. <div class="highlight"><pre><span></span><code><span class="c1"># How to manage values files. Ref: https://fluxcd.io/docs/guides/helmreleases/#refer-to-values-inside-the-chart</span><span class="w"></span>
  916. <span class="c1"># How to inject values: https://fluxcd.io/docs/guides/helmreleases/#cloud-storage</span><span class="w"></span>
  917. <span class="nn">---</span><span class="w"></span>
  918. <span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">helm.toolkit.fluxcd.io/v2beta1</span><span class="w"></span>
  919. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HelmRelease</span><span class="w"></span>
  920. <span class="nt">metadata</span><span class="p">:</span><span class="w"></span>
  921. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets</span><span class="w"></span>
  922. <span class="w"> </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">flux-system</span><span class="w"></span>
  923. <span class="nt">spec</span><span class="p">:</span><span class="w"></span>
  924. <span class="w"> </span><span class="c1"># Override Release name to avoid the pattern Namespace-Release</span><span class="w"></span>
  925. <span class="w"> </span><span class="c1"># Ref: https://fluxcd.io/docs/components/helm/api/#helm.toolkit.fluxcd.io/v2beta1.HelmRelease</span><span class="w"></span>
  926. <span class="w"> </span><span class="nt">releaseName</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets</span><span class="w"></span>
  927. <span class="w"> </span><span class="nt">targetNamespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets</span><span class="w"></span>
  928. <span class="w"> </span><span class="nt">interval</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10m</span><span class="w"></span>
  929. <span class="w"> </span><span class="nt">chart</span><span class="p">:</span><span class="w"></span>
  930. <span class="w"> </span><span class="nt">spec</span><span class="p">:</span><span class="w"></span>
  931. <span class="w"> </span><span class="nt">chart</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets</span><span class="w"></span>
  932. <span class="w"> </span><span class="nt">version</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">0.3.9</span><span class="w"></span>
  933. <span class="w"> </span><span class="nt">sourceRef</span><span class="p">:</span><span class="w"></span>
  934. <span class="w"> </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">HelmRepository</span><span class="w"></span>
  935. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets</span><span class="w"></span>
  936. <span class="w"> </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">flux-system</span><span class="w"></span>
  937. <span class="w"> </span><span class="nt">values</span><span class="p">:</span><span class="w"></span>
  938. <span class="w"> </span><span class="nt">installCRDs</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">false</span><span class="w"></span>
  939. <span class="w"> </span><span class="c1"># Ref: https://fluxcd.io/docs/components/helm/api/#helm.toolkit.fluxcd.io/v2beta1.Install</span><span class="w"></span>
  940. <span class="w"> </span><span class="nt">install</span><span class="p">:</span><span class="w"></span>
  941. <span class="w"> </span><span class="nt">createNamespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span><span class="w"></span>
  942. </code></pre></div>
  943. <h2 id="deploy-the-crs">Deploy the CRs</h2>
  944. <p>Now, be ready for the arcane magic. Create a Kustomization manifest called <code>deployment-crs.yaml</code> with the following content:</p>
  945. <div class="highlight"><pre><span></span><code><span class="nn">---</span><span class="w"></span>
  946. <span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">kustomize.toolkit.fluxcd.io/v1beta2</span><span class="w"></span>
  947. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Kustomization</span><span class="w"></span>
  948. <span class="nt">metadata</span><span class="p">:</span><span class="w"></span>
  949. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets-crs</span><span class="w"></span>
  950. <span class="w"> </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">flux-system</span><span class="w"></span>
  951. <span class="nt">spec</span><span class="p">:</span><span class="w"></span>
  952. <span class="w"> </span><span class="nt">dependsOn</span><span class="p">:</span><span class="w"></span>
  953. <span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets-crds</span><span class="w"></span>
  954. <span class="w"> </span><span class="nt">interval</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">10m</span><span class="w"></span>
  955. <span class="w"> </span><span class="nt">path</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">./infrastructure/external-secrets/crs</span><span class="w"></span>
  956. <span class="w"> </span><span class="nt">prune</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span><span class="w"></span>
  957. <span class="w"> </span><span class="nt">sourceRef</span><span class="p">:</span><span class="w"></span>
  958. <span class="w"> </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GitRepository</span><span class="w"></span>
  959. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">flux-system</span><span class="w"></span>
  960. </code></pre></div>
  961. <p>There are several interesting details to see here, that finally solves the race condition:</p>
  962. <ol>
  963. <li>First one is the field <code>dependsOn</code>, which points to a previous Kustomization called <code>external-secrets-crds</code>. This
  964. dependency forces this deployment to wait for the other to be ready, before start being deployed.</li>
  965. <li>The reference to the place where to find the CRs
  966. <div class="highlight"><pre><span></span><code><span class="nt">path</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">./infrastructure/external-secrets/crs</span><span class="w"></span>
  967. <span class="nt">sourceRef</span><span class="p">:</span><span class="w"></span>
  968. <span class="w"> </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">GitRepository</span><span class="w"></span>
  969. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">flux-system</span><span class="w"></span>
  970. </code></pre></div>
  971. Custom Resources will be searched in the relative path <code>./infrastructure/external-secrets/crs</code> of the GitRepository
  972. called <code>flux-system</code>, which is a reference to the same repository that FluxCD watches to synchronize the cluster.
  973. With fewer words, a reference to itself, but going to another directory called <code>crs</code></li>
  974. </ol>
  975. <p>Of course, allocate inside the mentioned path <code>./infrastructure/external-secrets/crs</code>, all the desired CRs to be deployed,
  976. for example, a manifest <code>clusterSecretStore.yaml</code> to reach your Hashicorp Vault as follows:</p>
  977. <div class="highlight"><pre><span></span><code><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets.io/v1beta1</span><span class="w"></span>
  978. <span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ClusterSecretStore</span><span class="w"></span>
  979. <span class="nt">metadata</span><span class="p">:</span><span class="w"></span>
  980. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">vault-backend-global</span><span class="w"></span>
  981. <span class="nt">spec</span><span class="p">:</span><span class="w"></span>
  982. <span class="w"> </span><span class="nt">provider</span><span class="p">:</span><span class="w"></span>
  983. <span class="w"> </span><span class="nt">vault</span><span class="p">:</span><span class="w"></span>
  984. <span class="w"> </span><span class="nt">server</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;https://vault.your-domain.com&quot;</span><span class="w"></span>
  985. <span class="w"> </span><span class="nt">path</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">secret</span><span class="w"></span>
  986. <span class="w"> </span><span class="nt">version</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">v2</span><span class="w"></span>
  987. <span class="w"> </span><span class="nt">auth</span><span class="p">:</span><span class="w"></span>
  988. <span class="w"> </span><span class="c1"># points to a secret that contains a vault token</span><span class="w"></span>
  989. <span class="w"> </span><span class="c1"># https://www.vaultproject.io/docs/auth/token</span><span class="w"></span>
  990. <span class="w"> </span><span class="nt">tokenSecretRef</span><span class="p">:</span><span class="w"></span>
  991. <span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;vault-token-global&quot;</span><span class="w"></span>
  992. <span class="w"> </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="s">&quot;token&quot;</span><span class="w"></span>
  993. <span class="w"> </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">external-secrets</span><span class="w"></span>
  994. </code></pre></div>
  995. <h2 id="results">Results</h2>
  996. <p>At the end, the required files tree is shown in the following picture:</p>
  997. <p><img alt="FluxCD files tree" src="../../pictures/screenshot_gitops_final_directory_tree.png" /></p>
  998. </article>
  999. </div>
  1000. </div>
  1001. </main>
  1002. <footer class="md-footer">
  1003. <nav class="md-footer__inner md-grid" aria-label="Footer">
  1004. <a href="../../provider/doppler/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Doppler" rel="prev">
  1005. <div class="md-footer__button md-icon">
  1006. <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>
  1007. </div>
  1008. <div class="md-footer__title">
  1009. <div class="md-ellipsis">
  1010. <span class="md-footer__direction">
  1011. Previous
  1012. </span>
  1013. Doppler
  1014. </div>
  1015. </div>
  1016. </a>
  1017. <a href="../anchore-engine-credentials/" class="md-footer__link md-footer__link--next" aria-label="Next: Anchore Engine" rel="next">
  1018. <div class="md-footer__title">
  1019. <div class="md-ellipsis">
  1020. <span class="md-footer__direction">
  1021. Next
  1022. </span>
  1023. Anchore Engine
  1024. </div>
  1025. </div>
  1026. <div class="md-footer__button md-icon">
  1027. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4z"/></svg>
  1028. </div>
  1029. </a>
  1030. </nav>
  1031. <div class="md-footer-meta md-typeset">
  1032. <div class="md-footer-meta__inner md-grid">
  1033. <div class="md-copyright">
  1034. <div class="md-copyright__highlight">
  1035. &copy; 2022 The external-secrets Authors.<br/>
  1036. &copy; 2022 The Linux Foundation. All rights reserved.<br/><br/>
  1037. The Linux Foundation has registered trademarks and uses trademarks.<br/>
  1038. For a list of trademarks of The Linux Foundation, please see our <a href="https://www.linuxfoundation.org/trademark-usage/">Trademark Usage page</a>.
  1039. </div>
  1040. Made with
  1041. <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
  1042. Material for MkDocs
  1043. </a>
  1044. </div>
  1045. </div>
  1046. </div>
  1047. </footer>
  1048. </div>
  1049. <div class="md-dialog" data-md-component="dialog">
  1050. <div class="md-dialog__inner md-typeset"></div>
  1051. </div>
  1052. <script id="__config" type="application/json">{"base": "../..", "features": [], "translations": {"clipboard.copy": "Copy to clipboard", "clipboard.copied": "Copied to clipboard", "search.config.lang": "en", "search.config.pipeline": "trimmer, stopWordFilter", "search.config.separator": "[\\s\\-]+", "search.placeholder": "Search", "search.result.placeholder": "Type to start searching", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.term.missing": "Missing", "select.version.title": "Select version"}, "search": "../../assets/javascripts/workers/search.092fa1f6.min.js", "version": {"provider": "mike"}}</script>
  1053. <script src="../../assets/javascripts/bundle.e3b2bf44.min.js"></script>
  1054. </body>
  1055. </html>