kubernetes-sigs/kustomize
1
0
Fork 0
mirror of https://github.com/kubernetes-sigs/kustomize.git synced 2026-06-14 02:20:53 +00:00
Code Issues Packages Projects Releases 1 Wiki Activity

Docs: build site

Browse Source
This commit is contained in:
Phillip Wittrock
2020-07-22 09:27:32 -07:00
parent c6524f984c
commit aa991956ef
130 changed files with 1473 additions and 401 deletions
Download Patch File Download Diff File Expand all files Collapse all files

29
docs/guides/bespoke/index.html
View File

@@ -3,7 +3,7 @@
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
<meta name="generator" content="Hugo 0.68.3" />
<meta name="generator" content="Hugo 0.73.0-DEV" />
<META NAME="ROBOTS" CONTENT="NOINDEX, NOFOLLOW">
@@ -296,6 +296,29 @@
<ul class="td-sidebar-nav__section pr-md-3">
<li class="td-sidebar-nav__section-title">
<a href="/kustomize/guides/components/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">Kustomize Components</a>
</li>
<ul>
<li class="collapse " id="kustomizeguidescomponents">
</li>
</ul>
</ul>
</li>
</ul>
</ul>
@@ -431,12 +454,14 @@ kubectl apply -k ~/ldap/overlays/production
</div>
<div class="text-muted mt-5 pt-3 border-top">Last modified June 7, 2020: <a href="https://github.com/kubernetes-sigs/kustomize/commit/42497c664f619a36cc86156e366b53099bd633cb">Convert docs to docsy (42497c66)</a>
<div class="text-muted mt-5 pt-3 border-top">Last modified July 16, 2020: <a href="https://github.com/kubernetes-sigs/kustomize/commit/f9ee578aed600136133c3232fff03029cdfc526e">Docs: Auto-fix markdownlint issues (f9ee578a)</a>
</div>
</div>

835
docs/guides/components/index.html Normal file
View File

@@ -0,0 +1,835 @@
<!doctype html>
<html lang="en" class="no-js">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
<meta name="generator" content="Hugo 0.73.0-DEV" />
<META NAME="ROBOTS" CONTENT="NOINDEX, NOFOLLOW">
<link rel="alternate" type="application/rss&#43;xml" href="https://kubernetes-sigs.github.io/kustomize/guides/components/index.xml">
<link rel="shortcut icon" href="/favicons/favicon.ico" >
<link rel="apple-touch-icon" href="/kustomize/favicons/apple-touch-icon-180x180.png" sizes="180x180">
<link rel="icon" type="image/png" href="/kustomize/favicons/favicon-16x16.png" sizes="16x16">
<link rel="icon" type="image/png" href="/kustomize/favicons/favicon-32x32.png" sizes="32x32">
<link rel="icon" type="image/png" href="/kustomize/favicons/android-36x36.png" sizes="36x36">
<link rel="icon" type="image/png" href="/kustomize/favicons/android-48x48.png" sizes="48x48">
<link rel="icon" type="image/png" href="/kustomize/favicons/android-72x72.png" sizes="72x72">
<link rel="icon" type="image/png" href="/kustomize/favicons/android-96x96.png" sizes="96x96">
<link rel="icon" type="image/png" href="/kustomize/favicons/android-144x144.png" sizes="144x144">
<link rel="icon" type="image/png" href="/kustomize/favicons/android-192x192.png" sizes="192x192">
<title>Kustomize Components | Kustomize</title><meta property="og:title" content="Kustomize Components" />
<meta property="og:description" content="Kustomize components guide
" />
<meta property="og:type" content="website" />
<meta property="og:url" content="https://kubernetes-sigs.github.io/kustomize/guides/components/" />
<meta property="og:site_name" content="Kustomize" />
<meta itemprop="name" content="Kustomize Components">
<meta itemprop="description" content="Kustomize components guide
"><meta name="twitter:card" content="summary"/>
<meta name="twitter:title" content="Kustomize Components"/>
<meta name="twitter:description" content="Kustomize components guide
"/>
<link rel="preload" href="/kustomize/scss/main.min.818a933df0186c907f1faea6730835dd5fa01c3b53af36bb68396dc80a2d3c45.css" as="style">
<link href="/kustomize/scss/main.min.818a933df0186c907f1faea6730835dd5fa01c3b53af36bb68396dc80a2d3c45.css" rel="stylesheet" integrity="">
<script
src="https://code.jquery.com/jquery-3.3.1.min.js"
integrity="sha256-FgpCb/KJQlLNfOu91ta32o/NMZxltwRo8QtmkMRdAu8="
crossorigin="anonymous"></script>
<link rel="stylesheet" type="text/css" href="https://kubernetes-sigs.github.io/kustomize//css/asciinema-player.css" />
<title>Kustomize Components | Kustomize</title>
</head>
<body class="td-section">
<header>
<nav class="js-navbar-scroll navbar navbar-expand navbar-dark flex-column flex-md-row td-navbar">
<a class="navbar-brand" href="/kustomize/">
<span class="navbar-logo"></span><span class="text-uppercase font-weight-bold">Kustomize</span>
</a>
<div class="td-navbar-nav-scroll ml-md-auto" id="main_navbar">
<ul class="navbar-nav mt-2 mt-lg-0">
<li class="nav-item mr-4 mb-2 mb-lg-0">
<a class="nav-link" href="/kustomize/installation/" ><span>Installation</span></a>
</li>
<li class="nav-item mr-4 mb-2 mb-lg-0">
<a class="nav-link active" href="/kustomize/guides/" ><span class="active">Guides</span></a>
</li>
<li class="nav-item mr-4 mb-2 mb-lg-0">
<a class="nav-link" href="/kustomize/api-reference/" ><span>API Reference</span></a>
</li>
<li class="nav-item mr-4 mb-2 mb-lg-0">
<a class="nav-link" href="https://github.com/kubernetes-sigs/kustomize/tree/master/examples" target="_blank" ><span>Example</span></a>
</li>
<li class="nav-item mr-4 mb-2 mb-lg-0">
<a class="nav-link" href="/kustomize/faq/" ><span>FAQ</span></a>
</li>
<li class="nav-item mr-4 mb-2 mb-lg-0">
<a class="nav-link" href="/kustomize/blog/" ><span>Blog</span></a>
</li>
<li class="nav-item mr-4 mb-2 mb-lg-0">
<a class="nav-link" href="/kustomize/contributing/" ><span>Contributing</span></a>
</li>
<li class="nav-item dropdown d-none d-lg-block">
<a class="nav-link dropdown-toggle" href="#" id="navbarDropdown" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
English
</a>
<div class="dropdown-menu" aria-labelledby="navbarDropdownMenuLink">
<a class="dropdown-item" href="/kustomize/zh/">简体中文</a>
</div>
</li>
</ul>
</div>
<div class="navbar-nav d-none d-lg-block">
</div>
</nav>
</header>
<div class="container-fluid td-outer">
<div class="td-main">
<div class="row flex-xl-nowrap">
<div class="col-12 col-md-3 col-xl-2 td-sidebar d-print-none">
<div id="td-sidebar-menu" class="td-sidebar__inner">
<form class="td-sidebar__search d-flex align-items-center">
<button class="btn btn-link td-sidebar__toggle d-md-none p-0 ml-3 fas fa-bars" type="button" data-toggle="collapse" data-target="#td-section-nav" aria-controls="td-docs-nav" aria-expanded="false" aria-label="Toggle section navigation">
</button>
</form>
<nav class="collapse td-sidebar-nav pt-2 pl-4" id="td-section-nav">
<div class="nav-item dropdown d-block d-lg-none">
<a class="nav-link dropdown-toggle" href="#" id="navbarDropdown" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
English
</a>
<div class="dropdown-menu" aria-labelledby="navbarDropdownMenuLink">
<a class="dropdown-item" href="/kustomize/zh/">简体中文</a>
</div>
</div>
<ul class="td-sidebar-nav__section pr-md-3">
<li class="td-sidebar-nav__section-title">
<a href="/kustomize/guides/" class="align-left pl-0 pr-2 td-sidebar-link td-sidebar-link__section">Guides</a>
</li>
<ul>
<li class="collapse show" id="kustomizeguides">
<ul class="td-sidebar-nav__section pr-md-3">
<li class="td-sidebar-nav__section-title">
<a href="/kustomize/guides/bespoke/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">Bespoke Application</a>
</li>
<ul>
<li class="collapse " id="kustomizeguidesbespoke">
</li>
</ul>
</ul>
<ul class="td-sidebar-nav__section pr-md-3">
<li class="td-sidebar-nav__section-title">
<a href="/kustomize/guides/offtheshelf/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">Off The Shelf Application</a>
</li>
<ul>
<li class="collapse " id="kustomizeguidesofftheshelf">
</li>
</ul>
</ul>
<ul class="td-sidebar-nav__section pr-md-3">
<li class="td-sidebar-nav__section-title">
<a href="/kustomize/guides/plugins/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">Kustomize Plugins</a>
</li>
<ul>
<li class="collapse " id="kustomizeguidesplugins">
<a class="td-sidebar-link td-sidebar-link__page " id="m-kustomizeguidespluginsbuiltins" href="/kustomize/guides/plugins/builtins/">Builtin Plugins</a>
<a class="td-sidebar-link td-sidebar-link__page " id="m-kustomizeguidespluginsexecpluginguidedexample" href="/kustomize/guides/plugins/execpluginguidedexample/">Exec plugin on linux</a>
<a class="td-sidebar-link td-sidebar-link__page " id="m-kustomizeguidespluginsgoplugincaveats" href="/kustomize/guides/plugins/goplugincaveats/">Go plugin Caveats</a>
<a class="td-sidebar-link td-sidebar-link__page " id="m-kustomizeguidespluginsgopluginguidedexample" href="/kustomize/guides/plugins/gopluginguidedexample/">Go plugin example</a>
</li>
</ul>
</ul>
<ul class="td-sidebar-nav__section pr-md-3">
<li class="td-sidebar-nav__section-title">
<a href="/kustomize/guides/components/" class="align-left pl-0 pr-2 active td-sidebar-link td-sidebar-link__section">Kustomize Components</a>
</li>
<ul>
<li class="collapse show" id="kustomizeguidescomponents">
</li>
</ul>
</ul>
</li>
</ul>
</ul>
</nav>
</div>
</div>
<div class="d-none d-xl-block col-xl-2 td-toc d-print-none">
<div class="td-page-meta ml-2 pb-1 pt-2 mb-0">
<a href="https://github.com/kubernetes-sigs/kustomize/edit/master/site/content/en/guides/components/_index.md" target="_blank"><i class="fa fa-edit fa-fw"></i> Edit this page</a>
<a href="https://github.com/kubernetes-sigs/kustomize/issues/new?title=Kustomize%20Components" target="_blank"><i class="fab fa-github fa-fw"></i> Create documentation issue</a>
<a href="https://github.com/kubernetes-sigs/kustomize/issues/new" target="_blank"><i class="fas fa-tasks fa-fw"></i> Create project issue</a>
</div>
</div>
<main class="col-12 col-md-9 col-xl-8 pl-md-5" role="main">
<nav aria-label="breadcrumb" class="d-none d-md-block d-print-none">
<ol class="breadcrumb spb-1">
<li class="breadcrumb-item" >
<a href="https://kubernetes-sigs.github.io/kustomize/guides/">Guides</a>
</li>
<li class="breadcrumb-item active" aria-current="page">
<a href="https://kubernetes-sigs.github.io/kustomize/guides/components/">Kustomize Components</a>
</li>
</ol>
</nav >
<div class="td-content">
<h1>Kustomize Components</h1>
<div class="lead">Kustomize components guide</div>
<p>As of <code>v3.7.0</code> Kustomize supports a special type of kustomization that allows
one to define reusable pieces of configuration logic that can be included from
multiple overlays.</p>
<p>Components come in handy when dealing with applications that support multiple
optional features and you wish to enable only a subset of them in different
overlays, i.e., different features for different environments or audiences.</p>
<p>For more details regarding this feature you can read the
<a href="https://github.com/kubernetes/enhancements/blob/master/keps/sig-cli/1802-kustomize-components.md">Kustomize Components KEP</a>.</p>
<h2 id="use-case">Use case</h2>
<p>Suppose you&rsquo;ve written a very simple Web application:</p>
<div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-yaml" data-lang="yaml"><span style="color:#204a87;font-weight:bold">apiVersion</span><span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>apps/v1<span style="color:#f8f8f8;text-decoration:underline">
</span><span style="color:#f8f8f8;text-decoration:underline"></span><span style="color:#204a87;font-weight:bold">kind</span><span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>Deployment<span style="color:#f8f8f8;text-decoration:underline">
</span><span style="color:#f8f8f8;text-decoration:underline"></span><span style="color:#204a87;font-weight:bold">metadata</span><span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline">
</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#204a87;font-weight:bold">name</span><span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>example<span style="color:#f8f8f8;text-decoration:underline">
</span><span style="color:#f8f8f8;text-decoration:underline"></span><span style="color:#204a87;font-weight:bold">spec</span><span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline">
</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#204a87;font-weight:bold">template</span><span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline">
</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#204a87;font-weight:bold">spec</span><span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline">
</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#204a87;font-weight:bold">containers</span><span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline">
</span><span style="color:#f8f8f8;text-decoration:underline"> </span>- <span style="color:#204a87;font-weight:bold">name</span><span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>example<span style="color:#f8f8f8;text-decoration:underline">
</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#204a87;font-weight:bold">image</span><span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>example<span style="color:#000;font-weight:bold">:</span><span style="color:#0000cf;font-weight:bold">1.0</span><span style="color:#f8f8f8;text-decoration:underline">
</span></code></pre></div><p>You want to deploy a <strong>community</strong> edition of this application as SaaS, so you
add support for persistence (e.g. an external database), and bot detection
(e.g. Google reCAPTCHA).</p>
<p>You&rsquo;ve now attracted <strong>enterprise</strong> customers who want to deploy it
on-premises, so you add LDAP support, and disable Google reCAPTCHA. At the same
time, the <strong>devs</strong> need to be able to test parts of the application, so they
want to deploy it with some features enabled and others not.</p>
<p>Here&rsquo;s a matrix with the deployments of this application and the features
enabled for each one:</p>
<table>
<thead>
<tr>
<th></th>
<th align="center">External DB</th>
<th align="center">LDAP</th>
<th align="center">reCAPTCHA</th>
</tr>
</thead>
<tbody>
<tr>
<td>Community</td>
<td align="center">✔️</td>
<td align="center"></td>
<td align="center">✔️</td>
</tr>
<tr>
<td>Enterprise</td>
<td align="center">✔️</td>
<td align="center">✔️</td>
<td align="center"></td>
</tr>
<tr>
<td>Dev</td>
<td align="center">✅</td>
<td align="center">✅</td>
<td align="center">✅</td>
</tr>
</tbody>
</table>
<p>(✔️ enabled, ✅: optional)</p>
<p>So, you want to make it easy to deploy your application in any of the above
three environments. Here&rsquo;s how you can do this with Kustomize components: each
opt-in feature gets packaged as a component, so that it can be referred to from
multiple higher-level overlays.</p>
<p>First, define a place to work:</p>
<div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell"><span style="color:#000">DEMO_HOME</span><span style="color:#ce5c00;font-weight:bold">=</span><span style="color:#204a87;font-weight:bold">$(</span>mktemp -d<span style="color:#204a87;font-weight:bold">)</span>
</code></pre></div><p>Define a common <strong>base</strong> that has a <code>Deployment</code> and a simple <code>ConfigMap</code>, that
is mounted on the application&rsquo;s container.</p>
<div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell"><span style="color:#000">BASE</span><span style="color:#ce5c00;font-weight:bold">=</span><span style="color:#000">$DEMO_HOME</span>/base
mkdir <span style="color:#000">$BASE</span>
cat <span style="color:#4e9a06">&lt;&lt;EOF &gt;$BASE/kustomization.yaml
</span><span style="color:#4e9a06">resources:
</span><span style="color:#4e9a06">- deployment.yaml
</span><span style="color:#4e9a06">
</span><span style="color:#4e9a06">configMapGenerator:
</span><span style="color:#4e9a06">- name: conf
</span><span style="color:#4e9a06"> literals:
</span><span style="color:#4e9a06"> - main.conf=|
</span><span style="color:#4e9a06"> color=cornflower_blue
</span><span style="color:#4e9a06"> log_level=info
</span><span style="color:#4e9a06">EOF</span>
cat <span style="color:#4e9a06">&lt;&lt;EOF &gt;$BASE/deployment.yaml
</span><span style="color:#4e9a06">apiVersion: apps/v1
</span><span style="color:#4e9a06">kind: Deployment
</span><span style="color:#4e9a06">metadata:
</span><span style="color:#4e9a06"> name: example
</span><span style="color:#4e9a06">spec:
</span><span style="color:#4e9a06"> template:
</span><span style="color:#4e9a06"> spec:
</span><span style="color:#4e9a06"> containers:
</span><span style="color:#4e9a06"> - name: example
</span><span style="color:#4e9a06"> image: example:1.0
</span><span style="color:#4e9a06"> volumeMounts:
</span><span style="color:#4e9a06"> - name: conf
</span><span style="color:#4e9a06"> mountPath: /etc/config
</span><span style="color:#4e9a06"> volumes:
</span><span style="color:#4e9a06"> - name: conf
</span><span style="color:#4e9a06"> configMap:
</span><span style="color:#4e9a06"> name: conf
</span><span style="color:#4e9a06">EOF</span>
</code></pre></div><p>Define an <code>external_db</code> component, using <code>kind: Component</code>, that creates a
<code>Secret</code> for the DB password and a new entry in the <code>ConfigMap</code>:</p>
<div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell"><span style="color:#000">EXT_DB</span><span style="color:#ce5c00;font-weight:bold">=</span><span style="color:#000">$DEMO_HOME</span>/components/external_db
mkdir -p <span style="color:#000">$EXT_DB</span>
cat <span style="color:#4e9a06">&lt;&lt;EOF &gt;$EXT_DB/kustomization.yaml
</span><span style="color:#4e9a06">apiVersion: kustomize.config.k8s.io/v1alpha1 # &lt;-- Component notation
</span><span style="color:#4e9a06">kind: Component
</span><span style="color:#4e9a06">
</span><span style="color:#4e9a06">secretGenerator:
</span><span style="color:#4e9a06">- name: dbpass
</span><span style="color:#4e9a06"> files:
</span><span style="color:#4e9a06"> - dbpass.txt
</span><span style="color:#4e9a06">
</span><span style="color:#4e9a06">patchesStrategicMerge:
</span><span style="color:#4e9a06"> - configmap.yaml
</span><span style="color:#4e9a06">
</span><span style="color:#4e9a06">patchesJson6902:
</span><span style="color:#4e9a06">- target:
</span><span style="color:#4e9a06"> group: apps
</span><span style="color:#4e9a06"> version: v1
</span><span style="color:#4e9a06"> kind: Deployment
</span><span style="color:#4e9a06"> name: example
</span><span style="color:#4e9a06"> path: deployment.yaml
</span><span style="color:#4e9a06">EOF</span>
cat <span style="color:#4e9a06">&lt;&lt;EOF &gt;$EXT_DB/deployment.yaml
</span><span style="color:#4e9a06">- op: add
</span><span style="color:#4e9a06"> path: /spec/template/spec/volumes/0
</span><span style="color:#4e9a06"> value:
</span><span style="color:#4e9a06"> name: dbpass
</span><span style="color:#4e9a06"> secret:
</span><span style="color:#4e9a06"> secretName: dbpass
</span><span style="color:#4e9a06">- op: add
</span><span style="color:#4e9a06"> path: /spec/template/spec/containers/0/volumeMounts/0
</span><span style="color:#4e9a06"> value:
</span><span style="color:#4e9a06"> mountPath: /var/run/secrets/db/
</span><span style="color:#4e9a06"> name: dbpass
</span><span style="color:#4e9a06">EOF</span>
cat <span style="color:#4e9a06">&lt;&lt;EOF &gt;$EXT_DB/configmap.yaml
</span><span style="color:#4e9a06">apiVersion: v1
</span><span style="color:#4e9a06">kind: ConfigMap
</span><span style="color:#4e9a06">metadata:
</span><span style="color:#4e9a06"> name: conf
</span><span style="color:#4e9a06">data:
</span><span style="color:#4e9a06"> db.conf: |
</span><span style="color:#4e9a06"> endpoint=127.0.0.1:1234
</span><span style="color:#4e9a06"> name=app
</span><span style="color:#4e9a06"> user=admin
</span><span style="color:#4e9a06"> pass=/var/run/secrets/db/dbpass.txt
</span><span style="color:#4e9a06">EOF</span>
</code></pre></div><p>Define an <code>ldap</code> component, that creates a <code>Secret</code> for the LDAP password
and a new entry in the <code>ConfigMap</code>:</p>
<div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell"><span style="color:#000">LDAP</span><span style="color:#ce5c00;font-weight:bold">=</span><span style="color:#000">$DEMO_HOME</span>/components/ldap
mkdir -p <span style="color:#000">$LDAP</span>
cat <span style="color:#4e9a06">&lt;&lt;EOF &gt;$LDAP/kustomization.yaml
</span><span style="color:#4e9a06">apiVersion: kustomize.config.k8s.io/v1alpha1
</span><span style="color:#4e9a06">kind: Component
</span><span style="color:#4e9a06">
</span><span style="color:#4e9a06">secretGenerator:
</span><span style="color:#4e9a06">- name: ldappass
</span><span style="color:#4e9a06"> files:
</span><span style="color:#4e9a06"> - ldappass.txt
</span><span style="color:#4e9a06">
</span><span style="color:#4e9a06">patchesStrategicMerge:
</span><span style="color:#4e9a06"> - configmap.yaml
</span><span style="color:#4e9a06">
</span><span style="color:#4e9a06">patchesJson6902:
</span><span style="color:#4e9a06">- target:
</span><span style="color:#4e9a06"> group: apps
</span><span style="color:#4e9a06"> version: v1
</span><span style="color:#4e9a06"> kind: Deployment
</span><span style="color:#4e9a06"> name: example
</span><span style="color:#4e9a06"> path: deployment.yaml
</span><span style="color:#4e9a06">EOF</span>
cat <span style="color:#4e9a06">&lt;&lt;EOF &gt;$LDAP/deployment.yaml
</span><span style="color:#4e9a06">- op: add
</span><span style="color:#4e9a06"> path: /spec/template/spec/volumes/0
</span><span style="color:#4e9a06"> value:
</span><span style="color:#4e9a06"> name: ldappass
</span><span style="color:#4e9a06"> secret:
</span><span style="color:#4e9a06"> secretName: ldappass
</span><span style="color:#4e9a06">- op: add
</span><span style="color:#4e9a06"> path: /spec/template/spec/containers/0/volumeMounts/0
</span><span style="color:#4e9a06"> value:
</span><span style="color:#4e9a06"> mountPath: /var/run/secrets/ldap/
</span><span style="color:#4e9a06"> name: ldappass
</span><span style="color:#4e9a06">EOF</span>
cat <span style="color:#4e9a06">&lt;&lt;EOF &gt;$LDAP/configmap.yaml
</span><span style="color:#4e9a06">apiVersion: v1
</span><span style="color:#4e9a06">kind: ConfigMap
</span><span style="color:#4e9a06">metadata:
</span><span style="color:#4e9a06"> name: conf
</span><span style="color:#4e9a06">data:
</span><span style="color:#4e9a06"> ldap.conf: |
</span><span style="color:#4e9a06"> endpoint=ldap://ldap.example.com
</span><span style="color:#4e9a06"> bindDN=cn=admin,dc=example,dc=com
</span><span style="color:#4e9a06"> pass=/var/run/secrets/ldap/ldappass.txt
</span><span style="color:#4e9a06">EOF</span>
</code></pre></div><p>Define a <code>recaptcha</code> component, that creates a <code>Secret</code> for the reCAPTCHA
site/secret keys and a new entry in the <code>ConfigMap</code>:</p>
<div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell"><span style="color:#000">RECAPTCHA</span><span style="color:#ce5c00;font-weight:bold">=</span><span style="color:#000">$DEMO_HOME</span>/components/recaptcha
mkdir -p <span style="color:#000">$RECAPTCHA</span>
cat <span style="color:#4e9a06">&lt;&lt;EOF &gt;$RECAPTCHA/kustomization.yaml
</span><span style="color:#4e9a06">apiVersion: kustomize.config.k8s.io/v1alpha1
</span><span style="color:#4e9a06">kind: Component
</span><span style="color:#4e9a06">
</span><span style="color:#4e9a06">secretGenerator:
</span><span style="color:#4e9a06">- name: recaptcha
</span><span style="color:#4e9a06"> files:
</span><span style="color:#4e9a06"> - site_key.txt
</span><span style="color:#4e9a06"> - secret_key.txt
</span><span style="color:#4e9a06">
</span><span style="color:#4e9a06"># Updating the ConfigMap works with generators as well.
</span><span style="color:#4e9a06">configMapGenerator:
</span><span style="color:#4e9a06">- name: conf
</span><span style="color:#4e9a06"> behavior: merge
</span><span style="color:#4e9a06"> literals:
</span><span style="color:#4e9a06"> - recaptcha.conf=|
</span><span style="color:#4e9a06"> enabled=true
</span><span style="color:#4e9a06"> site_key=/var/run/secrets/recaptcha/site_key.txt
</span><span style="color:#4e9a06"> secret_key=/var/run/secrets/recaptcha/secret_key.txt
</span><span style="color:#4e9a06">
</span><span style="color:#4e9a06">patchesJson6902:
</span><span style="color:#4e9a06">- target:
</span><span style="color:#4e9a06"> group: apps
</span><span style="color:#4e9a06"> version: v1
</span><span style="color:#4e9a06"> kind: Deployment
</span><span style="color:#4e9a06"> name: example
</span><span style="color:#4e9a06"> path: deployment.yaml
</span><span style="color:#4e9a06">EOF</span>
cat <span style="color:#4e9a06">&lt;&lt;EOF &gt;$RECAPTCHA/deployment.yaml
</span><span style="color:#4e9a06">- op: add
</span><span style="color:#4e9a06"> path: /spec/template/spec/volumes/0
</span><span style="color:#4e9a06"> value:
</span><span style="color:#4e9a06"> name: recaptcha
</span><span style="color:#4e9a06"> secret:
</span><span style="color:#4e9a06"> secretName: recaptcha
</span><span style="color:#4e9a06">- op: add
</span><span style="color:#4e9a06"> path: /spec/template/spec/containers/0/volumeMounts/0
</span><span style="color:#4e9a06"> value:
</span><span style="color:#4e9a06"> mountPath: /var/run/secrets/recaptcha/
</span><span style="color:#4e9a06"> name: recaptcha
</span><span style="color:#4e9a06">EOF</span>
</code></pre></div><p>Define a <code>community</code> variant, that bundles the external DB and reCAPTCHA
components:</p>
<div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell"><span style="color:#000">COMMUNITY</span><span style="color:#ce5c00;font-weight:bold">=</span><span style="color:#000">$DEMO_HOME</span>/overlays/community
mkdir -p <span style="color:#000">$COMMUNITY</span>
cat <span style="color:#4e9a06">&lt;&lt;EOF &gt;$COMMUNITY/kustomization.yaml
</span><span style="color:#4e9a06">apiVersion: kustomize.config.k8s.io/v1beta1
</span><span style="color:#4e9a06">kind: Kustomization
</span><span style="color:#4e9a06">
</span><span style="color:#4e9a06">resources:
</span><span style="color:#4e9a06"> - ../../base
</span><span style="color:#4e9a06">
</span><span style="color:#4e9a06">components:
</span><span style="color:#4e9a06"> - ../../components/external_db
</span><span style="color:#4e9a06"> - ../../components/recaptcha
</span><span style="color:#4e9a06">EOF</span>
</code></pre></div><p>Define an <code>enterprise</code> overlay, that bundles the external DB and LDAP
components:</p>
<div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell"><span style="color:#000">ENTERPRISE</span><span style="color:#ce5c00;font-weight:bold">=</span><span style="color:#000">$DEMO_HOME</span>/overlays/enterprise
mkdir -p <span style="color:#000">$ENTERPRISE</span>
cat <span style="color:#4e9a06">&lt;&lt;EOF &gt;$ENTERPRISE/kustomization.yaml
</span><span style="color:#4e9a06">apiVersion: kustomize.config.k8s.io/v1beta1
</span><span style="color:#4e9a06">kind: Kustomization
</span><span style="color:#4e9a06">
</span><span style="color:#4e9a06">resources:
</span><span style="color:#4e9a06"> - ../../base
</span><span style="color:#4e9a06">
</span><span style="color:#4e9a06">components:
</span><span style="color:#4e9a06"> - ../../components/external_db
</span><span style="color:#4e9a06"> - ../../components/ldap
</span><span style="color:#4e9a06">EOF</span>
</code></pre></div><p>Define a <code>dev</code> overlay, that points to all the components and has LDAP
disabled:</p>
<div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell"><span style="color:#000">DEV</span><span style="color:#ce5c00;font-weight:bold">=</span><span style="color:#000">$DEMO_HOME</span>/overlays/dev
mkdir -p <span style="color:#000">$DEV</span>
cat <span style="color:#4e9a06">&lt;&lt;EOF &gt;$DEV/kustomization.yaml
</span><span style="color:#4e9a06">apiVersion: kustomize.config.k8s.io/v1beta1
</span><span style="color:#4e9a06">kind: Kustomization
</span><span style="color:#4e9a06">
</span><span style="color:#4e9a06">resources:
</span><span style="color:#4e9a06"> - ../../base
</span><span style="color:#4e9a06">
</span><span style="color:#4e9a06">components:
</span><span style="color:#4e9a06"> - ../../components/external_db
</span><span style="color:#4e9a06"> #- ../../components/ldap
</span><span style="color:#4e9a06"> - ../../components/recaptcha
</span><span style="color:#4e9a06">EOF</span>
</code></pre></div><p>Now, the workspace has the following directories:</p>
<div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell">├── base
│ ├── deployment.yaml
│ └── kustomization.yaml
├── components
│ ├── external_db
│ │ ├── configmap.yaml
│ │ ├── dbpass.txt
│ │ ├── deployment.yaml
│ │ └── kustomization.yaml
│ ├── ldap
│ │ ├── configmap.yaml
│ │ ├── deployment.yaml
│ │ ├── kustomization.yaml
│ │ └── ldappass.txt
│ └── recaptcha
│ ├── deployment.yaml
│ ├── kustomization.yaml
│ ├── secret_key.txt
│ └── site_key.txt
└── overlays
├── community
│ └── kustomization.yaml
├── dev
│ └── kustomization.yaml
└── enterprise
└── kustomization.yaml
</code></pre></div><p>With this structure, you can generate the YAML manifests for each deployment
using <code>kustomize build</code>:</p>
<div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell">kustomize build overlays/community
kustomize build overlays/enterprise
kustomize build overlays/dev
</code></pre></div>
<div class="section-index">
<hr class="panel-line">
</div>
<div class="text-muted mt-5 pt-3 border-top">Last modified July 6, 2020: <a href="https://github.com/kubernetes-sigs/kustomize/commit/1b531c6ac737065d574a9c9f2cdf98cf2873c79e">docs: Add guide for components (1b531c6a)</a>
</div>
</div>
</main>
</div>
</div>
<footer class="bg-dark py-5 row d-print-none">
<div class="container-fluid mx-sm-5">
<div class="row">
<div class="col-6 col-sm-4 text-xs-center order-sm-2">
<ul class="list-inline mb-0">
<li class="list-inline-item mx-2 h3" data-toggle="tooltip" data-placement="top" title="User mailing list" aria-label="User mailing list">
<a class="text-white" target="_blank" href="https://groups.google.com/forum/#!forum/kubernetes-sig-cli">
<i class="fa fa-envelope"></i>
</a>
</li>
</ul>
</div>
<div class="col-6 col-sm-4 text-right text-xs-center order-sm-3">
<ul class="list-inline mb-0">
<li class="list-inline-item mx-2 h3" data-toggle="tooltip" data-placement="top" title="GitHub" aria-label="GitHub">
<a class="text-white" target="_blank" href="https://github.com/kubernetes-sigs/kustomize">
<i class="fab fa-github"></i>
</a>
</li>
</ul>
</div>
<div class="col-12 col-sm-4 text-center py-2 order-sm-2">
<small class="text-white">&copy; 2020 Kubernetes Authors All Rights Reserved</small>
</div>
</div>
</div>
</footer>
</div>
<script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.3/umd/popper.min.js" integrity="sha384-ZMP7rVo3mIykV+2+9J3UJ46jBk0WLaUAdn689aCwoqbBJiSnjAK/l8WvCWPIPm49" crossorigin="anonymous"></script>
<script src="https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/js/bootstrap.min.js" integrity="sha384-ChfqqxuZUCnJSK3+MXmPNIyE6ZbWh2IMqE241rYiqJxyMiZ6OW/JmZQ5stwEULTy" crossorigin="anonymous"></script>
<script src="/kustomize/js/main.min.35b203b3c2114e187f6e4bbf0903c511aaaac5535186321e3b5e364656b6de0c.js" integrity="sha256-NbIDs8IRThh/bku/CQPFEaqqxVNRhjIeO142Rla23gw=" crossorigin="anonymous"></script>
<script src="https://kubernetes-sigs.github.io/kustomize//js/asciinema-player.js"></script>
</body>
</html>

17
docs/guides/components/index.xml Normal file
View File

@@ -0,0 +1,17 @@
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
<channel>
<title>Kustomize – Kustomize Components</title>
<link>https://kubernetes-sigs.github.io/kustomize/guides/components/</link>
<description>Recent content in Kustomize Components on Kustomize</description>
<generator>Hugo -- gohugo.io</generator>
<atom:link href="https://kubernetes-sigs.github.io/kustomize/guides/components/index.xml" rel="self" type="application/rss+xml" />
</channel>
</rss>

34
docs/guides/index.html
View File

@@ -3,7 +3,7 @@
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
<meta name="generator" content="Hugo 0.68.3" />
<meta name="generator" content="Hugo 0.73.0-DEV" />
<META NAME="ROBOTS" CONTENT="NOINDEX, NOFOLLOW">
@@ -296,6 +296,29 @@
<ul class="td-sidebar-nav__section pr-md-3">
<li class="td-sidebar-nav__section-title">
<a href="/kustomize/guides/components/" class="align-left pl-0 pr-2 td-sidebar-link td-sidebar-link__section">Kustomize Components</a>
</li>
<ul>
<li class="collapse show" id="kustomizeguidescomponents">
</li>
</ul>
</ul>
</li>
</ul>
</ul>
@@ -404,6 +427,15 @@
<div class="entry">
<h5>
<a href="/kustomize/guides/components/">Kustomize Components</a>
</h5>
<p>Kustomize components guide</p>
</div>
</div>

29
docs/guides/offtheshelf/index.html
View File

@@ -3,7 +3,7 @@
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
<meta name="generator" content="Hugo 0.68.3" />
<meta name="generator" content="Hugo 0.73.0-DEV" />
<META NAME="ROBOTS" CONTENT="NOINDEX, NOFOLLOW">
@@ -296,6 +296,29 @@
<ul class="td-sidebar-nav__section pr-md-3">
<li class="td-sidebar-nav__section-title">
<a href="/kustomize/guides/components/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">Kustomize Components</a>
</li>
<ul>
<li class="collapse " id="kustomizeguidescomponents">
</li>
</ul>
</ul>
</li>
</ul>
</ul>
@@ -433,12 +456,14 @@ git rebase upstream/master
</div>
<div class="text-muted mt-5 pt-3 border-top">Last modified June 7, 2020: <a href="https://github.com/kubernetes-sigs/kustomize/commit/42497c664f619a36cc86156e366b53099bd633cb">Convert docs to docsy (42497c66)</a>
<div class="text-muted mt-5 pt-3 border-top">Last modified July 16, 2020: <a href="https://github.com/kubernetes-sigs/kustomize/commit/f9ee578aed600136133c3232fff03029cdfc526e">Docs: Auto-fix markdownlint issues (f9ee578a)</a>
</div>
</div>

35
docs/guides/plugins/builtins/index.html
View File

@@ -3,7 +3,7 @@
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
<meta name="generator" content="Hugo 0.68.3" />
<meta name="generator" content="Hugo 0.73.0-DEV" />
<META NAME="ROBOTS" CONTENT="NOINDEX, NOFOLLOW">
@@ -25,11 +25,11 @@
" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://kubernetes-sigs.github.io/kustomize/guides/plugins/builtins/" />
<meta property="article:modified_time" content="2020-06-15T13:39:13+08:00" /><meta property="og:site_name" content="Kustomize" />
<meta property="article:modified_time" content="2020-07-16T12:57:18-07:00" /><meta property="og:site_name" content="Kustomize" />
<meta itemprop="name" content="Builtin Plugins">
<meta itemprop="description" content="Builtin Plugins
">
<meta itemprop="dateModified" content="2020-06-15T13:39:13&#43;08:00" />
<meta itemprop="dateModified" content="2020-07-16T12:57:18-07:00" />
<meta itemprop="wordCount" content="1560">
@@ -301,6 +301,29 @@
<ul class="td-sidebar-nav__section pr-md-3">
<li class="td-sidebar-nav__section-title">
<a href="/kustomize/guides/components/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">Kustomize Components</a>
</li>
<ul>
<li class="collapse " id="kustomizeguidescomponents">
</li>
</ul>
</ul>
</li>
</ul>
</ul>
@@ -539,7 +562,7 @@ configMapGenerator:
- application.properties
- more.properties
- name: my-java-server-env-vars
literals:
literals:
- JAVA_HOME=/opt/java/jdk
- JAVA_TOOL_OPTIONS=-agentlib:hprof
options:
@@ -831,7 +854,7 @@ to apply the patch.</p>
value: new value
target:
kind: MyKind
labelSelector: &quot;env=dev&quot;
labelSelector: &quot;env=dev&quot;
</code></pre><p>The <code>name</code> and <code>namespace</code> fields of the patch target selector are
automatically anchored regular expressions. This means that the value <code>myapp</code>
is equivalent to <code>^myapp$</code>.</p>
@@ -995,7 +1018,7 @@ literals:
<div class="text-muted mt-5 pt-3 border-top">Last modified June 15, 2020: <a href="https://github.com/kubernetes-sigs/kustomize/commit/518147c129f831913d33226cf17068d0d4270f41">add zh docsy (518147c1)</a>
<div class="text-muted mt-5 pt-3 border-top">Last modified July 16, 2020: <a href="https://github.com/kubernetes-sigs/kustomize/commit/f9ee578aed600136133c3232fff03029cdfc526e">Docs: Auto-fix markdownlint issues (f9ee578a)</a>
</div>
</div>

35
docs/guides/plugins/execpluginguidedexample/index.html
View File

@@ -3,7 +3,7 @@
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
<meta name="generator" content="Hugo 0.68.3" />
<meta name="generator" content="Hugo 0.73.0-DEV" />
<META NAME="ROBOTS" CONTENT="NOINDEX, NOFOLLOW">
@@ -25,11 +25,11 @@
" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://kubernetes-sigs.github.io/kustomize/guides/plugins/execpluginguidedexample/" />
<meta property="article:modified_time" content="2020-06-15T13:39:13+08:00" /><meta property="og:site_name" content="Kustomize" />
<meta property="article:modified_time" content="2020-07-16T12:57:18-07:00" /><meta property="og:site_name" content="Kustomize" />
<meta itemprop="name" content="Exec plugin on linux">
<meta itemprop="description" content="Exec plugin on linux in 60 seconds
">
<meta itemprop="dateModified" content="2020-06-15T13:39:13&#43;08:00" />
<meta itemprop="dateModified" content="2020-07-16T12:57:18-07:00" />
<meta itemprop="wordCount" content="465">
@@ -301,6 +301,29 @@
<ul class="td-sidebar-nav__section pr-md-3">
<li class="td-sidebar-nav__section-title">
<a href="/kustomize/guides/components/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">Kustomize Components</a>
</li>
<ul>
<li class="collapse " id="kustomizeguidescomponents">
</li>
</ul>
</ul>
</li>
</ul>
</ul>
@@ -352,7 +375,7 @@
<li><a href="#create-the-plugin">Create the plugin</a></li>
<li><a href="#install-kustomize">Install kustomize</a></li>
<li><a href="#review-the-layout">Review the layout</a></li>
<li><a href="#build-your-app-using-the-plugin">Build your app, using the plugin:</a></li>
<li><a href="#build-your-app-using-the-plugin">Build your app, using the plugin</a></li>
</ul>
</nav>
@@ -547,7 +570,7 @@ mkdir -p $DEMO/bin
mv kustomize $DEMO/bin
</code></pre><h2 id="review-the-layout">Review the layout</h2>
<pre><code>tree $DEMO
</code></pre><h2 id="build-your-app-using-the-plugin">Build your app, using the plugin:</h2>
</code></pre><h2 id="build-your-app-using-the-plugin">Build your app, using the plugin</h2>
<pre><code>XDG_CONFIG_HOME=$DEMO $DEMO/bin/kustomize build --enable_alpha_plugins $MYAPP
</code></pre><p>Above, if you had set</p>
<blockquote>
@@ -558,7 +581,7 @@ mv kustomize $DEMO/bin
<div class="text-muted mt-5 pt-3 border-top">Last modified June 15, 2020: <a href="https://github.com/kubernetes-sigs/kustomize/commit/518147c129f831913d33226cf17068d0d4270f41">add zh docsy (518147c1)</a>
<div class="text-muted mt-5 pt-3 border-top">Last modified July 16, 2020: <a href="https://github.com/kubernetes-sigs/kustomize/commit/f9ee578aed600136133c3232fff03029cdfc526e">Docs: Auto-fix markdownlint issues (f9ee578a)</a>
</div>
</div>

35
docs/guides/plugins/goplugincaveats/index.html
View File

@@ -3,7 +3,7 @@
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
<meta name="generator" content="Hugo 0.68.3" />
<meta name="generator" content="Hugo 0.73.0-DEV" />
<META NAME="ROBOTS" CONTENT="NOINDEX, NOFOLLOW">
@@ -25,11 +25,11 @@
" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://kubernetes-sigs.github.io/kustomize/guides/plugins/goplugincaveats/" />
<meta property="article:modified_time" content="2020-06-07T21:07:46-07:00" /><meta property="og:site_name" content="Kustomize" />
<meta property="article:modified_time" content="2020-07-16T12:57:18-07:00" /><meta property="og:site_name" content="Kustomize" />
<meta itemprop="name" content="Go plugin Caveats">
<meta itemprop="description" content="Go plugin Caveats
">
<meta itemprop="dateModified" content="2020-06-07T21:07:46-07:00" />
<meta itemprop="dateModified" content="2020-07-16T12:57:18-07:00" />
<meta itemprop="wordCount" content="532">
@@ -301,6 +301,29 @@
<ul class="td-sidebar-nav__section pr-md-3">
<li class="td-sidebar-nav__section-title">
<a href="/kustomize/guides/components/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">Kustomize Components</a>
</li>
<ul>
<li class="collapse " id="kustomizeguidescomponents">
</li>
</ul>
</ul>
</li>
</ul>
</ul>
@@ -342,7 +365,7 @@
<nav id="TableOfContents">
<ul>
<li><a href="#the-skew-problem">The skew problem</a></li>
<li><a href="#why-support-go-plugins">Why support Go plugins?</a>
<li><a href="#why-support-go-plugins">Why support Go plugins</a>
<ul>
<li><a href="#safety">Safety</a></li>
<li><a href="#debugging">Debugging</a></li>
@@ -445,7 +468,7 @@ GOPATH=${whatever} GO111MODULE=on go get sigs.k8s.io/kustomize/api
adjusted as needed.</p>
<p>For comparison, consider what one
must do to write a <a href="https://www.tensorflow.org/guide/extend/op">tensorflow plugin</a>.</p>
<h2 id="why-support-go-plugins">Why support Go plugins?</h2>
<h2 id="why-support-go-plugins">Why support Go plugins</h2>
<h3 id="safety">Safety</h3>
<p>The Go plugin developer sees the same API offered
to native kustomize operations, assuring certain
@@ -485,7 +508,7 @@ plugin vs host dependencies.</p>
<div class="text-muted mt-5 pt-3 border-top">Last modified June 7, 2020: <a href="https://github.com/kubernetes-sigs/kustomize/commit/42497c664f619a36cc86156e366b53099bd633cb">Convert docs to docsy (42497c66)</a>
<div class="text-muted mt-5 pt-3 border-top">Last modified July 16, 2020: <a href="https://github.com/kubernetes-sigs/kustomize/commit/f9ee578aed600136133c3232fff03029cdfc526e">Docs: Auto-fix markdownlint issues (f9ee578a)</a>
</div>
</div>

39
docs/guides/plugins/gopluginguidedexample/index.html
View File

@@ -3,7 +3,7 @@
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
<meta name="generator" content="Hugo 0.68.3" />
<meta name="generator" content="Hugo 0.73.0-DEV" />
<META NAME="ROBOTS" CONTENT="NOINDEX, NOFOLLOW">
@@ -25,11 +25,11 @@
" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://kubernetes-sigs.github.io/kustomize/guides/plugins/gopluginguidedexample/" />
<meta property="article:modified_time" content="2020-06-07T21:07:46-07:00" /><meta property="og:site_name" content="Kustomize" />
<meta property="article:modified_time" content="2020-07-16T12:57:18-07:00" /><meta property="og:site_name" content="Kustomize" />
<meta itemprop="name" content="Go plugin example">
<meta itemprop="description" content="Go plugin example
">
<meta itemprop="dateModified" content="2020-06-07T21:07:46-07:00" />
<meta itemprop="dateModified" content="2020-07-16T12:57:18-07:00" />
<meta itemprop="wordCount" content="1057">
@@ -301,6 +301,29 @@
<ul class="td-sidebar-nav__section pr-md-3">
<li class="td-sidebar-nav__section-title">
<a href="/kustomize/guides/components/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">Kustomize Components</a>
</li>
<ul>
<li class="collapse " id="kustomizeguidescomponents">
</li>
</ul>
</ul>
</li>
</ul>
</ul>
@@ -350,7 +373,7 @@
<li><a href="#install-kustomize">Install kustomize</a></li>
<li><a href="#make-a-home-for-plugins">Make a home for plugins</a>
<ul>
<li><a href="#what-apiversion-and-kind">What apiVersion and kind?</a></li>
<li><a href="#what-apiversion-and-kind">What apiVersion and kind</a></li>
<li><a href="#define-the-plugins-home-dir">Define the plugin&rsquo;s home dir</a></li>
<li><a href="#download-the-sopsencodedsecrets-plugin">Download the SopsEncodedSecrets plugin</a></li>
<li><a href="#try-the-plugins-own-test">Try the plugin&rsquo;s own test</a></li>
@@ -363,7 +386,7 @@
<li><a href="#create-data-encrypted-with-your-private-key">Create data encrypted with your private key</a></li>
</ul>
</li>
<li><a href="#build-your-app-using-the-plugin">Build your app, using the plugin:</a></li>
<li><a href="#build-your-app-using-the-plugin">Build your app, using the plugin</a></li>
</ul>
</nav>
@@ -476,7 +499,7 @@ ephemeral directory</p>
<div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell"><span style="color:#000">PLUGIN_ROOT</span><span style="color:#ce5c00;font-weight:bold">=</span><span style="color:#000">$DEMO</span>/kustomize/plugin
</code></pre></div><p>and ephemerally set <code>XDG_CONFIG_HOME</code> on a command
line below.</p>
<h3 id="what-apiversion-and-kind">What apiVersion and kind?</h3>
<h3 id="what-apiversion-and-kind">What apiVersion and kind</h3>
<p>At this stage in the development of kustomize
plugins, plugin code doesn&rsquo;t know or care what
<code>apiVersion</code> or <code>kind</code> appears in the config file
@@ -632,7 +655,7 @@ gcloud kms keys create sops-key --location global <span style="color:#4e9a06">\
├── myEncryptedData.yaml
└── secGenerator.yaml
</code></pre></div></blockquote>
<h2 id="build-your-app-using-the-plugin">Build your app, using the plugin:</h2>
<h2 id="build-your-app-using-the-plugin">Build your app, using the plugin</h2>
<div class="highlight"><pre style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-shell" data-lang="shell"><span style="color:#000">XDG_CONFIG_HOME</span><span style="color:#ce5c00;font-weight:bold">=</span><span style="color:#000">$DEMO</span> <span style="color:#000">$tmpGoPath</span>/bin/kustomize build --enable_alpha_plugins <span style="color:#000">$MYAPP</span>
</code></pre></div><p>This should emit a kubernetes secret, with
encrypted data for the names <code>ROCKET</code> and <code>CAR</code>.</p>
@@ -645,7 +668,7 @@ encrypted data for the names <code>ROCKET</code> and <code>CAR</code>.</p>
<div class="text-muted mt-5 pt-3 border-top">Last modified June 7, 2020: <a href="https://github.com/kubernetes-sigs/kustomize/commit/42497c664f619a36cc86156e366b53099bd633cb">Convert docs to docsy (42497c66)</a>
<div class="text-muted mt-5 pt-3 border-top">Last modified July 16, 2020: <a href="https://github.com/kubernetes-sigs/kustomize/commit/f9ee578aed600136133c3232fff03029cdfc526e">Docs: Auto-fix markdownlint issues (f9ee578a)</a>
</div>
</div>

37
docs/guides/plugins/index.html
View File

@@ -3,7 +3,7 @@
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
<meta name="generator" content="Hugo 0.68.3" />
<meta name="generator" content="Hugo 0.73.0-DEV" />
<META NAME="ROBOTS" CONTENT="NOINDEX, NOFOLLOW">
@@ -296,6 +296,29 @@
<ul class="td-sidebar-nav__section pr-md-3">
<li class="td-sidebar-nav__section-title">
<a href="/kustomize/guides/components/" class="align-left pl-0 pr-2 collapsed td-sidebar-link td-sidebar-link__section">Kustomize Components</a>
</li>
<ul>
<li class="collapse " id="kustomizeguidescomponents">
</li>
</ul>
</ul>
</li>
</ul>
</ul>
@@ -572,7 +595,7 @@ marshalled resources on <code>stdin</code> and capture
</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#204a87;font-weight:bold">annotations</span><span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline">
</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#204a87;font-weight:bold">kustomize.config.k8s.io/needs-hash</span><span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#34;true&#34;</span><span style="color:#f8f8f8;text-decoration:underline">
</span><span style="color:#f8f8f8;text-decoration:underline"></span><span style="color:#204a87;font-weight:bold">data</span><span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline">
</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#204a87;font-weight:bold">foo</span><span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>bar<span style="color:#f8f8f8;text-decoration:underline">
</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#204a87;font-weight:bold">foo</span><span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>bar<span style="color:#f8f8f8;text-decoration:underline">
</span></code></pre></div><p><strong><code>kustomize.config.k8s.io/behavior</code></strong></p>
<p>The <code>behavior</code> annotation will influence how conflicts are handled for resources emitted by the plugin. Valid values include &ldquo;create&rdquo;, &ldquo;merge&rdquo;, and &ldquo;replace&rdquo; with &ldquo;create&rdquo; being the default.</p>
<p>Example:</p>
@@ -583,9 +606,9 @@ marshalled resources on <code>stdin</code> and capture
</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#204a87;font-weight:bold">annotations</span><span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline">
</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#204a87;font-weight:bold">kustomize.config.k8s.io/behavior</span><span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#4e9a06">&#34;merge&#34;</span><span style="color:#f8f8f8;text-decoration:underline">
</span><span style="color:#f8f8f8;text-decoration:underline"></span><span style="color:#204a87;font-weight:bold">data</span><span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline">
</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#204a87;font-weight:bold">foo</span><span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>bar<span style="color:#f8f8f8;text-decoration:underline">
</span><span style="color:#f8f8f8;text-decoration:underline"> </span><span style="color:#204a87;font-weight:bold">foo</span><span style="color:#000;font-weight:bold">:</span><span style="color:#f8f8f8;text-decoration:underline"> </span>bar<span style="color:#f8f8f8;text-decoration:underline">
</span></code></pre></div><h3 id="go-plugins">Go plugins</h3>
<p>Be sure to read <a href="goPluginCaveats.md">Go plugin caveats</a>.</p>
<p>Be sure to read <a href="goplugincaveats/">Go plugin caveats</a>.</p>
<p>A <code>.go</code> file can be a <a href="https://golang.org/pkg/plugin/">Go plugin</a> if it declares
&lsquo;main&rsquo; as it&rsquo;s package, and exports a symbol to
which useful functions are attached.</p>
@@ -598,7 +621,7 @@ attached functions implement the <code>Configurable</code>,
<pre><code>package main
import (
&quot;sigs.k8s.io/kustomize/api/resmap&quot;
&quot;sigs.k8s.io/kustomize/api/resmap&quot;
...
)
@@ -702,12 +725,14 @@ go build -buildmode plugin \
</div>
</div>
<div class="text-muted mt-5 pt-3 border-top">Last modified June 26, 2020: <a href="https://github.com/kubernetes-sigs/kustomize/commit/69dc34500ad151a7ee04d3434c4cc17ff8827950">docs: add link to another Go plugin (69dc3450)</a>
<div class="text-muted mt-5 pt-3 border-top">Last modified July 17, 2020: <a href="https://github.com/kubernetes-sigs/kustomize/commit/bc581b70bf74e42fc2845c1cfc18e8fc6fbd8956">Fix go plugins caveats link (bc581b70)</a>
</div>
</div>

12
docs/guides/plugins/index.xml
View File

@@ -106,7 +106,7 @@ configMapGenerator:
- application.properties
- more.properties
- name: my-java-server-env-vars
literals:
literals:
- JAVA_HOME=/opt/java/jdk
- JAVA_TOOL_OPTIONS=-agentlib:hprof
options:
@@ -398,7 +398,7 @@ to apply the patch.&lt;/p&gt;
value: new value
target:
kind: MyKind
labelSelector: &amp;quot;env=dev&amp;quot;
labelSelector: &amp;quot;env=dev&amp;quot;
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;The &lt;code&gt;name&lt;/code&gt; and &lt;code&gt;namespace&lt;/code&gt; fields of the patch target selector are
automatically anchored regular expressions. This means that the value &lt;code&gt;myapp&lt;/code&gt;
is equivalent to &lt;code&gt;^myapp$&lt;/code&gt;.&lt;/p&gt;
@@ -718,7 +718,7 @@ mkdir -p $DEMO/bin
mv kustomize $DEMO/bin
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;review-the-layout&#34;&gt;Review the layout&lt;/h2&gt;
&lt;pre&gt;&lt;code&gt;tree $DEMO
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;build-your-app-using-the-plugin&#34;&gt;Build your app, using the plugin:&lt;/h2&gt;
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;build-your-app-using-the-plugin&#34;&gt;Build your app, using the plugin&lt;/h2&gt;
&lt;pre&gt;&lt;code&gt;XDG_CONFIG_HOME=$DEMO $DEMO/bin/kustomize build --enable_alpha_plugins $MYAPP
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;Above, if you had set&lt;/p&gt;
&lt;blockquote&gt;
@@ -786,7 +786,7 @@ GOPATH=${whatever} GO111MODULE=on go get sigs.k8s.io/kustomize/api
adjusted as needed.&lt;/p&gt;
&lt;p&gt;For comparison, consider what one
must do to write a &lt;a href=&#34;https://www.tensorflow.org/guide/extend/op&#34;&gt;tensorflow plugin&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&#34;why-support-go-plugins&#34;&gt;Why support Go plugins?&lt;/h2&gt;
&lt;h2 id=&#34;why-support-go-plugins&#34;&gt;Why support Go plugins&lt;/h2&gt;
&lt;h3 id=&#34;safety&#34;&gt;Safety&lt;/h3&gt;
&lt;p&gt;The Go plugin developer sees the same API offered
to native kustomize operations, assuring certain
@@ -900,7 +900,7 @@ ephemeral directory&lt;/p&gt;
&lt;div class=&#34;highlight&#34;&gt;&lt;pre style=&#34;background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;&lt;span style=&#34;color:#000&#34;&gt;PLUGIN_ROOT&lt;/span&gt;&lt;span style=&#34;color:#ce5c00;font-weight:bold&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color:#000&#34;&gt;$DEMO&lt;/span&gt;/kustomize/plugin
&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;and ephemerally set &lt;code&gt;XDG_CONFIG_HOME&lt;/code&gt; on a command
line below.&lt;/p&gt;
&lt;h3 id=&#34;what-apiversion-and-kind&#34;&gt;What apiVersion and kind?&lt;/h3&gt;
&lt;h3 id=&#34;what-apiversion-and-kind&#34;&gt;What apiVersion and kind&lt;/h3&gt;
&lt;p&gt;At this stage in the development of kustomize
plugins, plugin code doesn&amp;rsquo;t know or care what
&lt;code&gt;apiVersion&lt;/code&gt; or &lt;code&gt;kind&lt;/code&gt; appears in the config file
@@ -1056,7 +1056,7 @@ gcloud kms keys create sops-key --location global &lt;span style=&#34;color:#4e9
├── myEncryptedData.yaml
└── secGenerator.yaml
&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/blockquote&gt;
&lt;h2 id=&#34;build-your-app-using-the-plugin&#34;&gt;Build your app, using the plugin:&lt;/h2&gt;
&lt;h2 id=&#34;build-your-app-using-the-plugin&#34;&gt;Build your app, using the plugin&lt;/h2&gt;
&lt;div class=&#34;highlight&#34;&gt;&lt;pre style=&#34;background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;&lt;span style=&#34;color:#000&#34;&gt;XDG_CONFIG_HOME&lt;/span&gt;&lt;span style=&#34;color:#ce5c00;font-weight:bold&#34;&gt;=&lt;/span&gt;&lt;span style=&#34;color:#000&#34;&gt;$DEMO&lt;/span&gt; &lt;span style=&#34;color:#000&#34;&gt;$tmpGoPath&lt;/span&gt;/bin/kustomize build --enable_alpha_plugins &lt;span style=&#34;color:#000&#34;&gt;$MYAPP&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;This should emit a kubernetes secret, with
encrypted data for the names &lt;code&gt;ROCKET&lt;/code&gt; and &lt;code&gt;CAR&lt;/code&gt;.&lt;/p&gt;