mirror of
https://github.com/kubernetes-sigs/kustomize.git
synced 2026-06-11 09:02:53 +00:00
Remove site folder
This commit is contained in:
rob8714
@@ -1,28 +0,0 @@
|
|||||||
# How to Contribute
|
|
||||||
|
|
||||||
We'd love to accept your patches and contributions to this project. There are
|
|
||||||
just a few small guidelines you need to follow.
|
|
||||||
|
|
||||||
## Contributor License Agreement
|
|
||||||
|
|
||||||
Contributions to this project must be accompanied by a Contributor License
|
|
||||||
Agreement. You (or your employer) retain the copyright to your contribution;
|
|
||||||
this simply gives us permission to use and redistribute your contributions as
|
|
||||||
part of the project. Head over to <https://cla.developers.google.com/> to see
|
|
||||||
your current agreements on file or to sign a new one.
|
|
||||||
|
|
||||||
You generally only need to submit a CLA once, so if you've already submitted one
|
|
||||||
(even if it was for a different project), you probably don't need to do it
|
|
||||||
again.
|
|
||||||
|
|
||||||
## Code reviews
|
|
||||||
|
|
||||||
All submissions, including submissions by project members, require review. We
|
|
||||||
use GitHub pull requests for this purpose. Consult
|
|
||||||
[GitHub Help](https://help.github.com/articles/about-pull-requests/) for more
|
|
||||||
information on using pull requests.
|
|
||||||
|
|
||||||
## Community Guidelines
|
|
||||||
|
|
||||||
This project follows
|
|
||||||
[Google's Open Source Community Guidelines](https://opensource.google.com/conduct/).
|
|
||||||
201
site/LICENSE
201
site/LICENSE
@@ -1,201 +0,0 @@
|
|||||||
Apache License
|
|
||||||
Version 2.0, January 2004
|
|
||||||
http://www.apache.org/licenses/
|
|
||||||
|
|
||||||
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
|
||||||
|
|
||||||
1. Definitions.
|
|
||||||
|
|
||||||
"License" shall mean the terms and conditions for use, reproduction,
|
|
||||||
and distribution as defined by Sections 1 through 9 of this document.
|
|
||||||
|
|
||||||
"Licensor" shall mean the copyright owner or entity authorized by
|
|
||||||
the copyright owner that is granting the License.
|
|
||||||
|
|
||||||
"Legal Entity" shall mean the union of the acting entity and all
|
|
||||||
other entities that control, are controlled by, or are under common
|
|
||||||
control with that entity. For the purposes of this definition,
|
|
||||||
"control" means (i) the power, direct or indirect, to cause the
|
|
||||||
direction or management of such entity, whether by contract or
|
|
||||||
otherwise, or (ii) ownership of fifty percent (50%) or more of the
|
|
||||||
outstanding shares, or (iii) beneficial ownership of such entity.
|
|
||||||
|
|
||||||
"You" (or "Your") shall mean an individual or Legal Entity
|
|
||||||
exercising permissions granted by this License.
|
|
||||||
|
|
||||||
"Source" form shall mean the preferred form for making modifications,
|
|
||||||
including but not limited to software source code, documentation
|
|
||||||
source, and configuration files.
|
|
||||||
|
|
||||||
"Object" form shall mean any form resulting from mechanical
|
|
||||||
transformation or translation of a Source form, including but
|
|
||||||
not limited to compiled object code, generated documentation,
|
|
||||||
and conversions to other media types.
|
|
||||||
|
|
||||||
"Work" shall mean the work of authorship, whether in Source or
|
|
||||||
Object form, made available under the License, as indicated by a
|
|
||||||
copyright notice that is included in or attached to the work
|
|
||||||
(an example is provided in the Appendix below).
|
|
||||||
|
|
||||||
"Derivative Works" shall mean any work, whether in Source or Object
|
|
||||||
form, that is based on (or derived from) the Work and for which the
|
|
||||||
editorial revisions, annotations, elaborations, or other modifications
|
|
||||||
represent, as a whole, an original work of authorship. For the purposes
|
|
||||||
of this License, Derivative Works shall not include works that remain
|
|
||||||
separable from, or merely link (or bind by name) to the interfaces of,
|
|
||||||
the Work and Derivative Works thereof.
|
|
||||||
|
|
||||||
"Contribution" shall mean any work of authorship, including
|
|
||||||
the original version of the Work and any modifications or additions
|
|
||||||
to that Work or Derivative Works thereof, that is intentionally
|
|
||||||
submitted to Licensor for inclusion in the Work by the copyright owner
|
|
||||||
or by an individual or Legal Entity authorized to submit on behalf of
|
|
||||||
the copyright owner. For the purposes of this definition, "submitted"
|
|
||||||
means any form of electronic, verbal, or written communication sent
|
|
||||||
to the Licensor or its representatives, including but not limited to
|
|
||||||
communication on electronic mailing lists, source code control systems,
|
|
||||||
and issue tracking systems that are managed by, or on behalf of, the
|
|
||||||
Licensor for the purpose of discussing and improving the Work, but
|
|
||||||
excluding communication that is conspicuously marked or otherwise
|
|
||||||
designated in writing by the copyright owner as "Not a Contribution."
|
|
||||||
|
|
||||||
"Contributor" shall mean Licensor and any individual or Legal Entity
|
|
||||||
on behalf of whom a Contribution has been received by Licensor and
|
|
||||||
subsequently incorporated within the Work.
|
|
||||||
|
|
||||||
2. Grant of Copyright License. Subject to the terms and conditions of
|
|
||||||
this License, each Contributor hereby grants to You a perpetual,
|
|
||||||
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
||||||
copyright license to reproduce, prepare Derivative Works of,
|
|
||||||
publicly display, publicly perform, sublicense, and distribute the
|
|
||||||
Work and such Derivative Works in Source or Object form.
|
|
||||||
|
|
||||||
3. Grant of Patent License. Subject to the terms and conditions of
|
|
||||||
this License, each Contributor hereby grants to You a perpetual,
|
|
||||||
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
||||||
(except as stated in this section) patent license to make, have made,
|
|
||||||
use, offer to sell, sell, import, and otherwise transfer the Work,
|
|
||||||
where such license applies only to those patent claims licensable
|
|
||||||
by such Contributor that are necessarily infringed by their
|
|
||||||
Contribution(s) alone or by combination of their Contribution(s)
|
|
||||||
with the Work to which such Contribution(s) was submitted. If You
|
|
||||||
institute patent litigation against any entity (including a
|
|
||||||
cross-claim or counterclaim in a lawsuit) alleging that the Work
|
|
||||||
or a Contribution incorporated within the Work constitutes direct
|
|
||||||
or contributory patent infringement, then any patent licenses
|
|
||||||
granted to You under this License for that Work shall terminate
|
|
||||||
as of the date such litigation is filed.
|
|
||||||
|
|
||||||
4. Redistribution. You may reproduce and distribute copies of the
|
|
||||||
Work or Derivative Works thereof in any medium, with or without
|
|
||||||
modifications, and in Source or Object form, provided that You
|
|
||||||
meet the following conditions:
|
|
||||||
|
|
||||||
(a) You must give any other recipients of the Work or
|
|
||||||
Derivative Works a copy of this License; and
|
|
||||||
|
|
||||||
(b) You must cause any modified files to carry prominent notices
|
|
||||||
stating that You changed the files; and
|
|
||||||
|
|
||||||
(c) You must retain, in the Source form of any Derivative Works
|
|
||||||
that You distribute, all copyright, patent, trademark, and
|
|
||||||
attribution notices from the Source form of the Work,
|
|
||||||
excluding those notices that do not pertain to any part of
|
|
||||||
the Derivative Works; and
|
|
||||||
|
|
||||||
(d) If the Work includes a "NOTICE" text file as part of its
|
|
||||||
distribution, then any Derivative Works that You distribute must
|
|
||||||
include a readable copy of the attribution notices contained
|
|
||||||
within such NOTICE file, excluding those notices that do not
|
|
||||||
pertain to any part of the Derivative Works, in at least one
|
|
||||||
of the following places: within a NOTICE text file distributed
|
|
||||||
as part of the Derivative Works; within the Source form or
|
|
||||||
documentation, if provided along with the Derivative Works; or,
|
|
||||||
within a display generated by the Derivative Works, if and
|
|
||||||
wherever such third-party notices normally appear. The contents
|
|
||||||
of the NOTICE file are for informational purposes only and
|
|
||||||
do not modify the License. You may add Your own attribution
|
|
||||||
notices within Derivative Works that You distribute, alongside
|
|
||||||
or as an addendum to the NOTICE text from the Work, provided
|
|
||||||
that such additional attribution notices cannot be construed
|
|
||||||
as modifying the License.
|
|
||||||
|
|
||||||
You may add Your own copyright statement to Your modifications and
|
|
||||||
may provide additional or different license terms and conditions
|
|
||||||
for use, reproduction, or distribution of Your modifications, or
|
|
||||||
for any such Derivative Works as a whole, provided Your use,
|
|
||||||
reproduction, and distribution of the Work otherwise complies with
|
|
||||||
the conditions stated in this License.
|
|
||||||
|
|
||||||
5. Submission of Contributions. Unless You explicitly state otherwise,
|
|
||||||
any Contribution intentionally submitted for inclusion in the Work
|
|
||||||
by You to the Licensor shall be under the terms and conditions of
|
|
||||||
this License, without any additional terms or conditions.
|
|
||||||
Notwithstanding the above, nothing herein shall supersede or modify
|
|
||||||
the terms of any separate license agreement you may have executed
|
|
||||||
with Licensor regarding such Contributions.
|
|
||||||
|
|
||||||
6. Trademarks. This License does not grant permission to use the trade
|
|
||||||
names, trademarks, service marks, or product names of the Licensor,
|
|
||||||
except as required for reasonable and customary use in describing the
|
|
||||||
origin of the Work and reproducing the content of the NOTICE file.
|
|
||||||
|
|
||||||
7. Disclaimer of Warranty. Unless required by applicable law or
|
|
||||||
agreed to in writing, Licensor provides the Work (and each
|
|
||||||
Contributor provides its Contributions) on an "AS IS" BASIS,
|
|
||||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
|
||||||
implied, including, without limitation, any warranties or conditions
|
|
||||||
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
|
|
||||||
PARTICULAR PURPOSE. You are solely responsible for determining the
|
|
||||||
appropriateness of using or redistributing the Work and assume any
|
|
||||||
risks associated with Your exercise of permissions under this License.
|
|
||||||
|
|
||||||
8. Limitation of Liability. In no event and under no legal theory,
|
|
||||||
whether in tort (including negligence), contract, or otherwise,
|
|
||||||
unless required by applicable law (such as deliberate and grossly
|
|
||||||
negligent acts) or agreed to in writing, shall any Contributor be
|
|
||||||
liable to You for damages, including any direct, indirect, special,
|
|
||||||
incidental, or consequential damages of any character arising as a
|
|
||||||
result of this License or out of the use or inability to use the
|
|
||||||
Work (including but not limited to damages for loss of goodwill,
|
|
||||||
work stoppage, computer failure or malfunction, or any and all
|
|
||||||
other commercial damages or losses), even if such Contributor
|
|
||||||
has been advised of the possibility of such damages.
|
|
||||||
|
|
||||||
9. Accepting Warranty or Additional Liability. While redistributing
|
|
||||||
the Work or Derivative Works thereof, You may choose to offer,
|
|
||||||
and charge a fee for, acceptance of support, warranty, indemnity,
|
|
||||||
or other liability obligations and/or rights consistent with this
|
|
||||||
License. However, in accepting such obligations, You may act only
|
|
||||||
on Your own behalf and on Your sole responsibility, not on behalf
|
|
||||||
of any other Contributor, and only if You agree to indemnify,
|
|
||||||
defend, and hold each Contributor harmless for any liability
|
|
||||||
incurred by, or claims asserted against, such Contributor by reason
|
|
||||||
of your accepting any such warranty or additional liability.
|
|
||||||
|
|
||||||
END OF TERMS AND CONDITIONS
|
|
||||||
|
|
||||||
APPENDIX: How to apply the Apache License to your work.
|
|
||||||
|
|
||||||
To apply the Apache License to your work, attach the following
|
|
||||||
boilerplate notice, with the fields enclosed by brackets "[]"
|
|
||||||
replaced with your own identifying information. (Don't include
|
|
||||||
the brackets!) The text should be enclosed in the appropriate
|
|
||||||
comment syntax for the file format. We also recommend that a
|
|
||||||
file or class name and description of purpose be included on the
|
|
||||||
same "printed page" as the copyright notice for easier
|
|
||||||
identification within third-party archives.
|
|
||||||
|
|
||||||
Copyright [yyyy] [name of copyright owner]
|
|
||||||
|
|
||||||
Licensed under the Apache License, Version 2.0 (the "License");
|
|
||||||
you may not use this file except in compliance with the License.
|
|
||||||
You may obtain a copy of the License at
|
|
||||||
|
|
||||||
http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
|
|
||||||
Unless required by applicable law or agreed to in writing, software
|
|
||||||
distributed under the License is distributed on an "AS IS" BASIS,
|
|
||||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
||||||
See the License for the specific language governing permissions and
|
|
||||||
limitations under the License.
|
|
||||||
@@ -1,58 +0,0 @@
|
|||||||
# Docsy Example
|
|
||||||
|
|
||||||
[Docsy](https://github.com/google/docsy) is a Hugo theme for technical documentation sites, providing easy site navigation, structure, and more. This **Docsy Example Project** uses the Docsy theme, as well as providing a skeleton documentation structure for you to use. You can either copy this project and edit it with your own content, or use the theme in your projects like any other [Hugo theme](https://gohugo.io/themes/installing-and-using-themes/).
|
|
||||||
|
|
||||||
This Docsy Example Project is hosted at [https://example.docsy.dev/](https://example.docsy.dev/).
|
|
||||||
|
|
||||||
You can find detailed theme instructions in the Docsy user guide: https://docsy.dev/docs/
|
|
||||||
|
|
||||||
This is not an officially supported Google product. This project is currently maintained.
|
|
||||||
|
|
||||||
## Cloning the Docsy Example Project
|
|
||||||
|
|
||||||
The following will give you a project that is set up and ready to use (don't forget to use `--recurse-submodules` or you won't pull down some of the code you need to generate a working site). The `hugo server` command builds and serves the site. If you just want to build the site, run `hugo` instead.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git clone --recurse-submodules --depth 1 https://github.com/google/docsy-example.git
|
|
||||||
cd docsy-example
|
|
||||||
hugo server
|
|
||||||
```
|
|
||||||
|
|
||||||
The theme is included as a Git submodule:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
▶ git submodule
|
|
||||||
a053131a4ebf6a59e4e8834a42368e248d98c01d themes/docsy (heads/master)
|
|
||||||
```
|
|
||||||
|
|
||||||
If you want to do SCSS edits and want to publish these, you need to install `PostCSS` (not needed for `hugo server`):
|
|
||||||
|
|
||||||
```bash
|
|
||||||
npm install
|
|
||||||
```
|
|
||||||
|
|
||||||
<!--### Cloning the Example from the Theme Project
|
|
||||||
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git clone --recurse-submodules --depth 1 https://github.com/docsy.git
|
|
||||||
cd tech-doc-hugo-theme/exampleSite
|
|
||||||
HUGO_THEMESDIR="../.." hugo server
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
Note that the Hugo Theme Site requires the `exampleSite` to live in a subfolder of the theme itself. To avoid recursive duplication, the example site is added as a Git subtree:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git subtree add --prefix exampleSite https://github.com/google/docsy.git master --squash
|
|
||||||
```
|
|
||||||
|
|
||||||
To pull in changes, see `pull-deps.sh` script in the theme.-->
|
|
||||||
|
|
||||||
## Running the website locally
|
|
||||||
|
|
||||||
Once you've cloned the site repo, from the repo root folder, run:
|
|
||||||
|
|
||||||
```
|
|
||||||
hugo server
|
|
||||||
```
|
|
||||||
@@ -1,6 +0,0 @@
|
|||||||
/*
|
|
||||||
|
|
||||||
Add styles or override variables from the theme here.
|
|
||||||
|
|
||||||
*/
|
|
||||||
|
|
||||||
165
site/config.toml
165
site/config.toml
@@ -1,165 +0,0 @@
|
|||||||
baseURL = "https://kubernetes-sigs.github.io/kustomize/"
|
|
||||||
title = "Kustomize"
|
|
||||||
|
|
||||||
publishDir = "../docs"
|
|
||||||
|
|
||||||
enableRobotsTXT = true
|
|
||||||
|
|
||||||
# Hugo allows theme composition (and inheritance). The precedence is from left to right.
|
|
||||||
theme = ["docsy"]
|
|
||||||
|
|
||||||
# Will give values to .Lastmod etc.
|
|
||||||
enableGitInfo = true
|
|
||||||
|
|
||||||
# Language settings
|
|
||||||
contentDir = "content/en"
|
|
||||||
defaultContentLanguage = "en"
|
|
||||||
defaultContentLanguageInSubdir = false
|
|
||||||
# Useful when translating.
|
|
||||||
enableMissingTranslationPlaceholders = true
|
|
||||||
|
|
||||||
disableKinds = ["taxonomy", "taxonomyTerm"]
|
|
||||||
|
|
||||||
# Highlighting config
|
|
||||||
pygmentsCodeFences = true
|
|
||||||
pygmentsUseClasses = false
|
|
||||||
# Use the new Chroma Go highlighter in Hugo.
|
|
||||||
pygmentsUseClassic = false
|
|
||||||
#pygmentsOptions = "linenos=table"
|
|
||||||
# See https://help.farbox.com/pygments.html
|
|
||||||
pygmentsStyle = "tango"
|
|
||||||
|
|
||||||
# Configure how URLs look like per section.
|
|
||||||
[permalinks]
|
|
||||||
blog = "/:section/:year/:month/:day/:slug/"
|
|
||||||
|
|
||||||
## Configuration for BlackFriday markdown parser: https://github.com/russross/blackfriday
|
|
||||||
[blackfriday]
|
|
||||||
plainIDAnchors = true
|
|
||||||
hrefTargetBlank = true
|
|
||||||
angledQuotes = false
|
|
||||||
latexDashes = true
|
|
||||||
|
|
||||||
# Image processing configuration.
|
|
||||||
[imaging]
|
|
||||||
resampleFilter = "CatmullRom"
|
|
||||||
quality = 75
|
|
||||||
anchor = "smart"
|
|
||||||
|
|
||||||
[services]
|
|
||||||
[services.googleAnalytics]
|
|
||||||
# Comment out the next line to disable GA tracking. Also disables the feature described in [params.ui.feedback].
|
|
||||||
#id = "UA-00000000-0"
|
|
||||||
|
|
||||||
# Language configuration
|
|
||||||
|
|
||||||
[languages]
|
|
||||||
[languages.en]
|
|
||||||
title = "Kustomize"
|
|
||||||
description = "Kubernetes Configuration Customization"
|
|
||||||
languageName ="English"
|
|
||||||
# Weight used for sorting.
|
|
||||||
weight = 1
|
|
||||||
|
|
||||||
[[menu.main]]
|
|
||||||
name = "Example"
|
|
||||||
weight = 50
|
|
||||||
url = "https://github.com/kubernetes-sigs/kustomize/tree/master/examples"
|
|
||||||
|
|
||||||
[languages.zh]
|
|
||||||
title = "Kustomize"
|
|
||||||
description = "自定义 Kubernetes 配置"
|
|
||||||
languageName ="简体中文"
|
|
||||||
contentDir = "content/zh"
|
|
||||||
time_format_default = "2006年01月02日"
|
|
||||||
time_format_blog = "2006年01月02日"
|
|
||||||
# Weight used for sorting.
|
|
||||||
weight = 2
|
|
||||||
|
|
||||||
[markup]
|
|
||||||
[markup.goldmark]
|
|
||||||
[markup.goldmark.renderer]
|
|
||||||
unsafe = true
|
|
||||||
|
|
||||||
# Everything below this are Site Params
|
|
||||||
|
|
||||||
[params]
|
|
||||||
copyright = "Kubernetes Authors"
|
|
||||||
|
|
||||||
# First one is picked as the Twitter card image if not set on page.
|
|
||||||
# images = ["images/project-illustration.png"]
|
|
||||||
|
|
||||||
# Menu title if your navbar has a versions selector to access old versions of your site.
|
|
||||||
# This menu appears only if you have at least one [params.versions] set.
|
|
||||||
version_menu = "Releases"
|
|
||||||
|
|
||||||
# Flag used in the "version-banner" partial to decide whether to display a
|
|
||||||
# banner on every page indicating that this is an archived version of the docs.
|
|
||||||
# Set this flag to "true" if you want to display the banner.
|
|
||||||
archived_version = false
|
|
||||||
|
|
||||||
# The version number for the version of the docs represented in this doc set.
|
|
||||||
# Used in the "version-banner" partial to display a version number for the
|
|
||||||
# current doc set.
|
|
||||||
version = "0.0"
|
|
||||||
|
|
||||||
# A link to latest version of the docs. Used in the "version-banner" partial to
|
|
||||||
# point people to the main doc site.
|
|
||||||
url_latest_version = "https://kubernetes-sigs.github.io/kustomize"
|
|
||||||
|
|
||||||
# Repository configuration (URLs for in-page links to opening issues and suggesting changes)
|
|
||||||
github_repo = "https://github.com/kubernetes-sigs/kustomize"
|
|
||||||
|
|
||||||
# An optional link to a related project repo. For example, the sibling repository where your product code lives.
|
|
||||||
github_project_repo = "https://github.com/kubernetes-sigs/kustomize"
|
|
||||||
|
|
||||||
# Specify a value here if your content directory is not in your repo's root directory
|
|
||||||
github_subdir = "site"
|
|
||||||
|
|
||||||
# Google Custom Search Engine ID. Remove or comment out to disable search.
|
|
||||||
# gcs_engine_id = "011737558837375720776:fsdu1nryfng"
|
|
||||||
|
|
||||||
# Enable Algolia DocSearch
|
|
||||||
algolia_docsearch = false
|
|
||||||
|
|
||||||
# Enable Lunr.js offline search
|
|
||||||
offlineSearch = false
|
|
||||||
|
|
||||||
# User interface configuration
|
|
||||||
[params.ui]
|
|
||||||
# Enable to show the side bar menu in its compact state.
|
|
||||||
sidebar_menu_compact = false
|
|
||||||
# Set to true to disable breadcrumb navigation.
|
|
||||||
breadcrumb_disable = false
|
|
||||||
# Set to true to hide the sidebar search box (the top nav search box will still be displayed if search is enabled)
|
|
||||||
sidebar_search_disable = false
|
|
||||||
# Set to false if you don't want to display a logo (/assets/icons/logo.svg) in the top nav bar
|
|
||||||
navbar_logo = false
|
|
||||||
# Set to true to disable the About link in the site footer
|
|
||||||
footer_about_disable = false
|
|
||||||
|
|
||||||
# Adds a H2 section titled "Feedback" to the bottom of each doc. The responses are sent to Google Analytics as events.
|
|
||||||
# This feature depends on [services.googleAnalytics] and will be disabled if "services.googleAnalytics.id" is not set.
|
|
||||||
# If you want this feature, but occasionally need to remove the "Feedback" section from a single page,
|
|
||||||
# add "hide_feedback: true" to the page's front matter.
|
|
||||||
[params.ui.feedback]
|
|
||||||
enable = false
|
|
||||||
# The responses that the user sees after clicking "yes" (the page was helpful) or "no" (the page was not helpful).
|
|
||||||
yes = 'Glad to hear it! Please <a href="https://github.com/kubernetes-sigs/kustomize/issues/new">tell us how we can improve</a>.'
|
|
||||||
no = 'Sorry to hear that. Please <a href="https://github.com/kubernetes-sigs/kustomize/issues/new">tell us how we can improve</a>.'
|
|
||||||
|
|
||||||
[params.links]
|
|
||||||
# End user relevant links. These will show up on left side of footer and in the community page if you have one.
|
|
||||||
[[params.links.user]]
|
|
||||||
name = "User mailing list"
|
|
||||||
url = "https://groups.google.com/forum/#!forum/kubernetes-sig-cli"
|
|
||||||
icon = "fa fa-envelope"
|
|
||||||
desc = "Discussion and help from your fellow users"
|
|
||||||
# Developer relevant links. These will show up on right side of footer and in the community page if you have one.
|
|
||||||
[[params.links.developer]]
|
|
||||||
name = "GitHub"
|
|
||||||
url = "https://github.com/kubernetes-sigs/kustomize"
|
|
||||||
icon = "fab fa-github"
|
|
||||||
desc = "Development takes place here!"
|
|
||||||
|
|
||||||
|
|
||||||
@@ -1,36 +0,0 @@
|
|||||||
+++
|
|
||||||
title = "Kustomize"
|
|
||||||
linkTitle = "Kustomize"
|
|
||||||
|
|
||||||
+++
|
|
||||||
|
|
||||||
{{<blocks/cover title="Kustomize" image_anchor="center" height="full" color="primary">}}
|
|
||||||
<div class="mx-auto">
|
|
||||||
<p class="lead mt-5">Kustomize provides a solution for customizing Kubernetes resource configuration free from templates
|
|
||||||
and DSLs.</p>
|
|
||||||
<a
|
|
||||||
class="btn btn-lg btn-primary mr-3 mb-4"
|
|
||||||
href="/kustomize/installation/"
|
|
||||||
>
|
|
||||||
Get Started <i class="fas fa-arrow-alt-circle-right ml-2"></i>
|
|
||||||
</a>
|
|
||||||
<a
|
|
||||||
class="btn btn-lg btn-secondary mr-3 mb-4"
|
|
||||||
href="/kustomize/contributing/"
|
|
||||||
>
|
|
||||||
Contribute <i class="fas fa-pencil-alt ml-2"></i>
|
|
||||||
</a>
|
|
||||||
<div class="mx-auto mt-5">
|
|
||||||
{{<blocks/link-down color="light">}}
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
{{</blocks/cover>}}
|
|
||||||
|
|
||||||
{{< blocks/section >}}
|
|
||||||
|
|
||||||
{{% blocks/feature icon="fab fa-github" title="Contribute" %}}
|
|
||||||
We do a [Pull Request](https://github.com/kubernetes-sigs/kustomize/pulls) contributions workflow on **GitHub**.
|
|
||||||
New users are always welcome!
|
|
||||||
{{% /blocks/feature %}}
|
|
||||||
|
|
||||||
{{< /blocks/section >}}
|
|
||||||
@@ -1,15 +0,0 @@
|
|||||||
---
|
|
||||||
title: "API Reference"
|
|
||||||
linkTitle: "API Reference"
|
|
||||||
type: docs
|
|
||||||
weight: 4
|
|
||||||
menu:
|
|
||||||
main:
|
|
||||||
weight: 40
|
|
||||||
description: >
|
|
||||||
Reference for Kustomize client-side APIs
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/references/kustomize/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,10 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Glossary"
|
|
||||||
linkTitle: "Glossary"
|
|
||||||
type: docs
|
|
||||||
weight: 99
|
|
||||||
description: >
|
|
||||||
Glossary of terms
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/references/kustomize/glossary/" />
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
---
|
|
||||||
title: "kustomization.yaml"
|
|
||||||
linkTitle: "kustomization.yaml"
|
|
||||||
type: docs
|
|
||||||
weight: 10
|
|
||||||
description: >
|
|
||||||
kustomization.yaml fields and API
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/references/kustomize/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "bases"
|
|
||||||
linkTitle: "bases"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Add resources from a kustomization dir.
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/references/kustomize/bases/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "commonAnnotations"
|
|
||||||
linkTitle: "commonAnnotations"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Add annotations to all resources.
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/references/kustomize/commonannotations/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "commonLabels"
|
|
||||||
linkTitle: "commonLabels"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Add labels and selectors to add all resources.
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/references/kustomize/commonlabels/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "components"
|
|
||||||
linkTitle: "components"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Compose kustomizations.
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/references/kustomize/components/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "configMapGenerator"
|
|
||||||
linkTitle: "configMapGenerator"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Generate ConfigMap resources.
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/references/kustomize/configmapgenerator/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "crds"
|
|
||||||
linkTitle: "crds"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Adding CRD support
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/references/kustomize/crds/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
---
|
|
||||||
title: "generatorOptions"
|
|
||||||
linkTitle: "generatorOptions"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Control behavior of [ConfigMap](/kustomize/api-reference/kustomization/configmapgenerator) and
|
|
||||||
[Secret](/kustomize/api-reference/kustomization/secretgenerator) generators.
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/references/kustomize/generatoroptions/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "images"
|
|
||||||
linkTitle: "images"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Modify the name, tags and/or digest for images.
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/references/kustomize/images/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "namePrefix"
|
|
||||||
linkTitle: "namePrefix"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Prepends the value to the names of all resources and references.
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/references/kustomize/nameprefix/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
---
|
|
||||||
title: "namespace"
|
|
||||||
linkTitle: "namespace"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Adds namespace to all resources.
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/references/kustomize/namespace/" />
|
|
||||||
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
---
|
|
||||||
title: "nameSuffix"
|
|
||||||
linkTitle: "nameSuffix"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Appends the value to the names of all resources and references.
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/references/kustomize/namesuffix/" />
|
|
||||||
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "patches"
|
|
||||||
linkTitle: "patches"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Patch resources
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/references/kustomize/patches/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "patchesStrategicMerge"
|
|
||||||
linkTitle: "patchesStrategicMerge"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Patch resources using the strategic merge patch standard.
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/references/kustomize/patchesstrategicmerge/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "patchesJson6902"
|
|
||||||
linkTitle: "patchesJson6902"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Patch resources using the [json 6902 standard](https://tools.ietf.org/html/rfc6902)
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/references/kustomize/patchesjson6902/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "replicas"
|
|
||||||
linkTitle: "replicas"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Change the number of replicas for a resource.
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/references/kustomize/replicas/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "resources"
|
|
||||||
linkTitle: "resources"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Resources to include.
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/references/kustomize/resources/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "secretGenerator"
|
|
||||||
linkTitle: "secretGenerator"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Generate Secret resources.
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/references/kustomize/secretegenerator/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "vars"
|
|
||||||
linkTitle: "vars"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Substitute name references.
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/references/kustomize/vars/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Kustomize Blog"
|
|
||||||
linkTitle: "Blog"
|
|
||||||
menu:
|
|
||||||
main:
|
|
||||||
weight: 80
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/blog/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,9 +0,0 @@
|
|||||||
---
|
|
||||||
title: "New Releases"
|
|
||||||
linkTitle: "Releases"
|
|
||||||
weight: 20
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/blog/releases" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,22 +0,0 @@
|
|||||||
---
|
|
||||||
title: "v1.0.1"
|
|
||||||
linkTitle: "v1.0.1"
|
|
||||||
date: 2018-05-21
|
|
||||||
description: >
|
|
||||||
Kustomize v1.0.1
|
|
||||||
---
|
|
||||||
|
|
||||||
Initial release after move from github.com/kubernetes/kubectl to github.com/kubernetes-sigs/kustomize.
|
|
||||||
|
|
||||||
History
|
|
||||||
|
|
||||||
* May 2018: v1.0 after move to github.com/kubernetes-sigs/kubectl
|
|
||||||
from github.com/kubernetes/kubectl.
|
|
||||||
Has kustomization file, bases, overlays, basic transforms.
|
|
||||||
* Apr 2018: s/kinflate/kustomize/, s/manifest/kustomization/
|
|
||||||
* Oct 2017: s/kexpand/kinflate/
|
|
||||||
* Sep 2017: kexpand [starts](https://github.com/kubernetes/kubectl/pull/65)
|
|
||||||
in github.com/kubernetes/kubectl
|
|
||||||
* Aug 2017: [DAM] authored by Brian Grant
|
|
||||||
|
|
||||||
[DAM]: https://docs.google.com/document/d/1cLPGweVEYrVqQvBLJg6sxV-TrE5Rm2MNOBA_cxZP2WU
|
|
||||||
@@ -1,137 +0,0 @@
|
|||||||
---
|
|
||||||
title: "v2.0.0"
|
|
||||||
linkTitle: "v2.0.0"
|
|
||||||
date: 2019-02-05
|
|
||||||
description: >
|
|
||||||
Kustomize v2.0.0
|
|
||||||
---
|
|
||||||
|
|
||||||
[security concern]: https://docs.google.com/document/d/1FYgLVdq-siB_Cef9yuQBmit0PbrE8lsyTBdGI2eA2y8/edit
|
|
||||||
|
|
||||||
After security review, a field used in secret
|
|
||||||
generation (see below) was removed from the
|
|
||||||
definition of a kustomization file with no
|
|
||||||
mechanism to convert it to a new form. Also, the
|
|
||||||
set of files accessible from a kustomization file
|
|
||||||
has been further constrained.
|
|
||||||
|
|
||||||
Per the [versioning policy](/kustomize/faq/versioningpolicy),
|
|
||||||
backward incompatible changes trigger an increment
|
|
||||||
of the major version number, hence we go
|
|
||||||
from 1.0.11 to 2.0.0. We're taking this major
|
|
||||||
version increment opportunity to remove some
|
|
||||||
already deprecated fields, and the code paths
|
|
||||||
associated with them.
|
|
||||||
|
|
||||||
## Backward Incompatible Changes
|
|
||||||
|
|
||||||
### Kustomization Path Constraints
|
|
||||||
|
|
||||||
A kustomization file can specify paths to other
|
|
||||||
files, including resources, patches, configmap
|
|
||||||
generation data, secret generation data and
|
|
||||||
bases. In the case of a base, the path can be a
|
|
||||||
git URL instead.
|
|
||||||
|
|
||||||
In 1.x, these paths had to be relative to the
|
|
||||||
current kustomization directory (the location of
|
|
||||||
the kustomization file used in the `build`
|
|
||||||
command).
|
|
||||||
|
|
||||||
In 2.0, bases can continue to specify, via
|
|
||||||
relative paths, kustomizations outside the current
|
|
||||||
kustomization directory. But non-base paths are
|
|
||||||
constrained to terminate in or below the current
|
|
||||||
kustomization directory. Further, bases specified
|
|
||||||
via a git URL may not reference files outside of
|
|
||||||
the directory used to clone the repository.
|
|
||||||
|
|
||||||
### Kustomization Field Removals
|
|
||||||
|
|
||||||
#### patches
|
|
||||||
|
|
||||||
`patches` was deprecated and replaced by
|
|
||||||
`patchesStrategicMerge` when `patchesJson6902` was
|
|
||||||
introduced. In Kustomize 2.0.0, `patches` is
|
|
||||||
removed. Please use `patchesStrategicMerge`
|
|
||||||
instead.
|
|
||||||
|
|
||||||
#### imageTags
|
|
||||||
|
|
||||||
`imageTags` is replaced by `images` since `images`
|
|
||||||
can provide more features to change image names,
|
|
||||||
registries, tags and digests.
|
|
||||||
|
|
||||||
#### secretGenerator/commands
|
|
||||||
|
|
||||||
`commands` is removed from SecretGenerator due to
|
|
||||||
a [security concern]. One can use `files` or
|
|
||||||
`literals`, similar to ConfigMapGenerator, to
|
|
||||||
generate a secret.
|
|
||||||
|
|
||||||
```
|
|
||||||
secretGenerator:
|
|
||||||
- name: app-tls
|
|
||||||
files:
|
|
||||||
- secret/tls.cert
|
|
||||||
- secret/tls.key
|
|
||||||
type: "kubernetes.io/tls"
|
|
||||||
```
|
|
||||||
|
|
||||||
## Compatible Changes (New Features)
|
|
||||||
|
|
||||||
As this release is triggered by a security change,
|
|
||||||
there are no major new features to announce. A few
|
|
||||||
things that are worth mentioning in this release
|
|
||||||
are:
|
|
||||||
|
|
||||||
* More than _40_ issues closed since 1.0.11
|
|
||||||
release (including many extensions to
|
|
||||||
transformation rules).
|
|
||||||
|
|
||||||
* Users can run `kustomize edit fix` to migrate a
|
|
||||||
kustomization file working with previous
|
|
||||||
versions to one working with 2.0.0. For example,
|
|
||||||
a kustomization.yaml with following content
|
|
||||||
|
|
||||||
```
|
|
||||||
patches:
|
|
||||||
- deployment-patch.yaml
|
|
||||||
imageTags:
|
|
||||||
- name: postgres
|
|
||||||
newTag: v1
|
|
||||||
```
|
|
||||||
|
|
||||||
will be converted to
|
|
||||||
|
|
||||||
```
|
|
||||||
apiVersion: kustomize.config.k8s.io/v1beta1
|
|
||||||
kind: Kustomization
|
|
||||||
patchesStrategicMerge:
|
|
||||||
- deployment-patch.yaml
|
|
||||||
images:
|
|
||||||
- name: postgres
|
|
||||||
newTag: v1
|
|
||||||
```
|
|
||||||
|
|
||||||
* Kustomization filename
|
|
||||||
|
|
||||||
In previous versions, the name of a
|
|
||||||
kustomization file had to be
|
|
||||||
`kustomization.yaml`.
|
|
||||||
Kustomize allows `kustomization.yaml`,
|
|
||||||
`kustomization.yml` and
|
|
||||||
`Kustomization`. In a directory, only one of
|
|
||||||
those filenames is allowed. If there are more
|
|
||||||
than one found, Kustomize will exit with an
|
|
||||||
error. Please select the best filename for your
|
|
||||||
use cases.
|
|
||||||
|
|
||||||
* Cancelled plans to deprecate applying prefix/suffix to namespace.
|
|
||||||
The deprecation warning
|
|
||||||
|
|
||||||
```
|
|
||||||
Adding nameprefix and namesuffix to Namespace resource will be deprecated in next release.
|
|
||||||
```
|
|
||||||
|
|
||||||
was removed.
|
|
||||||
@@ -1,248 +0,0 @@
|
|||||||
---
|
|
||||||
title: "v2.1.0"
|
|
||||||
linkTitle: "v2.1.0"
|
|
||||||
date: 2019-06-18
|
|
||||||
description: >
|
|
||||||
Kustomize v2.1.0
|
|
||||||
---
|
|
||||||
|
|
||||||
[Go modules]: https://github.com/golang/go/wiki/Modules
|
|
||||||
[generator options]: https://github.com/kubernetes-sigs/kustomize/tree/master/examples/generatorOptions.md
|
|
||||||
[imgModules]: /kustomize/images/goModules.png
|
|
||||||
[imgPlugins]: /kustomize/images/plugins.png
|
|
||||||
[imgPruning]: /kustomize/images/pruning.png
|
|
||||||
[imgSorted]: /kustomize/images/sorted.png
|
|
||||||
[imgWheels]: /kustomize/images/abandonedTrainingWheels.png
|
|
||||||
[kustomization]: glossary#kustomization
|
|
||||||
[_kustomization_]: /kustomize/api-reference/glossary#kustomization
|
|
||||||
[base]: /kustomize/api-reference/glossary#base
|
|
||||||
[bases]: /kustomize/api-reference/glossary#base
|
|
||||||
[_base_]: /kustomize/api-reference/glossary#base
|
|
||||||
[kustomize inventory object documentation]: https://github.com/kubernetes-sigs/kustomize/tree/master/docs/inventory_object.md
|
|
||||||
[kustomize plugin documentation]: plugins
|
|
||||||
[root]: /kustomize/api-reference/glossary#kustomization-root
|
|
||||||
[transformer configs]: https://github.com/kubernetes-sigs/kustomize/tree/master/examples/transformerconfigs
|
|
||||||
[v1.0.9]: https://github.com/kubernetes-sigs/kustomize/releases/tag/v1.0.9
|
|
||||||
[v2.0.3]: https://github.com/kubernetes-sigs/kustomize/releases/tag/v1.0.9releases/tag/v2.0.3
|
|
||||||
[v2.1.0]: https://github.com/kubernetes-sigs/kustomize/releases/tag/v1.0.9releases/tag/v2.1.0
|
|
||||||
[versioning policy]: /kustomize/faq/versioningpolicy
|
|
||||||
|
|
||||||
Go modules, resource ordering respected, generator and transformer plugins, eased
|
|
||||||
loading restrictions, the notion of inventory, eased replica count modification.
|
|
||||||
About ~90 issues closed since [v2.0.3] in ~400 commits.
|
|
||||||
|
|
||||||
Download [here][v2.1.0].
|
|
||||||
|
|
||||||
## Go modules
|
|
||||||
|
|
||||||
![gopher with boxes][imgModules]
|
|
||||||
|
|
||||||
Kustomize now defines its dependencies in a top
|
|
||||||
level `go.mod` file. This is the first step
|
|
||||||
towards a package structure intentially exported
|
|
||||||
as one or more [Go modules] for use in other
|
|
||||||
programs (kubectl, kubebuilder, etc.) and in
|
|
||||||
kustomize plugins (see below).
|
|
||||||
|
|
||||||
## Resource ordering
|
|
||||||
|
|
||||||
![sort order retained][imgSorted]
|
|
||||||
|
|
||||||
Kustomize now retains the depth-first order of
|
|
||||||
resources as read, a frequently requested
|
|
||||||
feature.
|
|
||||||
|
|
||||||
This means resource order can be controlled
|
|
||||||
by editting kustomization files. This is
|
|
||||||
also vital to applying user-defined
|
|
||||||
transformations (plugins) in a particular
|
|
||||||
order.
|
|
||||||
|
|
||||||
Nothing needs to be done to activate this;
|
|
||||||
it happens automatically.
|
|
||||||
|
|
||||||
The `build` command now accepts a `--reorder`
|
|
||||||
flag with values `legacy` and `none`,
|
|
||||||
with a default value of `legacy`.
|
|
||||||
|
|
||||||
`legacy` means apply an ordering based on
|
|
||||||
GVK, that currently emits `Namespace` objects
|
|
||||||
first, and `ValidatingWebhookConfiguration`
|
|
||||||
objects last. This means that despite
|
|
||||||
automatic retention of load order, your
|
|
||||||
`build` output won't change by default.
|
|
||||||
|
|
||||||
`none` means _don't_ reorder the resources before
|
|
||||||
output. Specify this to see output order
|
|
||||||
respect input order.
|
|
||||||
|
|
||||||
## Generator and transformer plugins
|
|
||||||
|
|
||||||
![kid putting knife in electrical outlet][imgPlugins]
|
|
||||||
|
|
||||||
Since the beginning (as `kinflate` back in Sep
|
|
||||||
2017), kustomize has read or generated resources,
|
|
||||||
applied a series of pipelined transformation to
|
|
||||||
them, and emitted the result to `stdout`.
|
|
||||||
|
|
||||||
At that time, the only way to change the behavior
|
|
||||||
of a generator (e.g. a secret generator), or
|
|
||||||
change the behavior of a transformer (e.g. a name
|
|
||||||
changer, or json patcher), was to modify source
|
|
||||||
code and put out a release.
|
|
||||||
|
|
||||||
[v1.0.9] introduced [generator options] as a means
|
|
||||||
to change the behavior of the only two generators
|
|
||||||
available at the time - Secret and ConfigMap
|
|
||||||
generators. It also introduced
|
|
||||||
[transformer configs] as a way to fine tune the
|
|
||||||
targets of transformations (e.g. to which fields
|
|
||||||
_selectors_ should be added). Most of the feature
|
|
||||||
requests for kustomize revolve around changing the
|
|
||||||
behavior of the builtin generators and
|
|
||||||
transformers.
|
|
||||||
|
|
||||||
[v2.1.0] adds an _alpha_ plugin framework, that
|
|
||||||
encourages users to write their own generators or
|
|
||||||
transformers, _declaring them as kubernetes
|
|
||||||
objects just like everything else_, and apply them
|
|
||||||
as part of the `kustomize build` process.
|
|
||||||
|
|
||||||
To inform the API exposed to plugins, and to
|
|
||||||
confirm that the plugin framework can offer plugin
|
|
||||||
authors the same capabilities as builtin
|
|
||||||
operations, all the builtin generators and
|
|
||||||
tranformers have been converted to plugin form
|
|
||||||
(with one exceptions awaiting Go module
|
|
||||||
refinements). This means that adding, say, a
|
|
||||||
`secretGenerator` or `commonAnnotations` directive
|
|
||||||
to your kustomization will (in [v2.1.0]) trigger
|
|
||||||
execution of
|
|
||||||
[code committed as a plugin](https://github.com/kubernetes-sigs/kustomize/tree/master/plugin/builtin).
|
|
||||||
|
|
||||||
For more information, see the
|
|
||||||
[kustomize plugin documentation].
|
|
||||||
|
|
||||||
## Remove load restrictions
|
|
||||||
|
|
||||||
![removed training wheels][imgWheels]
|
|
||||||
|
|
||||||
The following usage:
|
|
||||||
|
|
||||||
```
|
|
||||||
kustomize build --load_restrictor none $target
|
|
||||||
```
|
|
||||||
|
|
||||||
allows a `kustomization.yaml` file used in this
|
|
||||||
build to refer to files outside its own directory
|
|
||||||
(i.e. outside its [root]).
|
|
||||||
|
|
||||||
This is an opt-in to suppress a security feature
|
|
||||||
that denies this precise behavior.
|
|
||||||
|
|
||||||
This feature should only be used to allow multiple
|
|
||||||
overlays (e.g. prod, staging and dev) to share a
|
|
||||||
patch file. To share _resources_, use a relative
|
|
||||||
path or URL to a kustomization directory in the
|
|
||||||
`resources` directive.
|
|
||||||
|
|
||||||
## Inventory generation for pruning
|
|
||||||
|
|
||||||
![pruning dead branches][imgPruning]
|
|
||||||
|
|
||||||
_Alpha_
|
|
||||||
|
|
||||||
Users can add an `inventory` stanza to their
|
|
||||||
kustomization file, to add a special _inventory
|
|
||||||
object_ to the `build` result.
|
|
||||||
|
|
||||||
This object applies to the cluster along with
|
|
||||||
everything else in the build result and can be
|
|
||||||
used by other clients to intelligently _prune_
|
|
||||||
orphaned cluster resources.
|
|
||||||
|
|
||||||
For more information see the
|
|
||||||
[kustomize inventory object documentation].
|
|
||||||
|
|
||||||
## Field changes / deprecations
|
|
||||||
|
|
||||||
### `resources` expanded, `bases` deprecated
|
|
||||||
|
|
||||||
The `resources` field has been generalized; it now
|
|
||||||
accepts what formerly could only be specified in
|
|
||||||
the `bases` field.
|
|
||||||
|
|
||||||
This change was made to allow users fine control
|
|
||||||
over resource processing order. With a distinct
|
|
||||||
`bases` field, bases had to be loaded separately
|
|
||||||
from resources as a group. Now, base loading may
|
|
||||||
be interleaved as desired with the loading of
|
|
||||||
resource files from the current
|
|
||||||
directory. [Resource ordering](#resource-ordering)
|
|
||||||
had to be respected before this feature could be
|
|
||||||
introduced.
|
|
||||||
|
|
||||||
The `bases` field is now deprecated, and will be
|
|
||||||
deleted in some future major release. Manage the
|
|
||||||
deprecation simply moving the arguments of the
|
|
||||||
`bases` field to the `resources` field in the
|
|
||||||
desired order, e.g.
|
|
||||||
|
|
||||||
> ```
|
|
||||||
> resources:
|
|
||||||
> - someResouceFile.yaml
|
|
||||||
> - someOtherResourceFile.yaml
|
|
||||||
> bases:
|
|
||||||
> - ../../someBaseDir
|
|
||||||
> ```
|
|
||||||
|
|
||||||
could become
|
|
||||||
|
|
||||||
> ```
|
|
||||||
> resources:
|
|
||||||
> - someResouceFile.yaml
|
|
||||||
> - ../../someBaseDir
|
|
||||||
> - someOtherResourceFile.yaml
|
|
||||||
> ```
|
|
||||||
|
|
||||||
The `kustomized edit fix` command will do this for
|
|
||||||
you, though it will always put the bases at the
|
|
||||||
end.
|
|
||||||
|
|
||||||
As an aside, the `resources`, `generators` and
|
|
||||||
`transformers` fields now all accept the same
|
|
||||||
argument format.
|
|
||||||
|
|
||||||
> Each field's argument is a _string list_,
|
|
||||||
> where each entry is either a _resource_ (a
|
|
||||||
> relative path to a YAML file) or a
|
|
||||||
> [_kustomization_] (a path or URL
|
|
||||||
> pointing to a directory with a kustomization
|
|
||||||
> file). A kustomization directory used in this
|
|
||||||
> context is called a [_base_].
|
|
||||||
|
|
||||||
The fact that the `generators` and `transformers`
|
|
||||||
field accept [bases] and the fact that generator
|
|
||||||
and transformer configuration objects are just
|
|
||||||
normal k8s resources means that one can generate
|
|
||||||
or transform a generator or a transformer (see
|
|
||||||
[TestTransformerTransformers]).
|
|
||||||
|
|
||||||
[TestTransformerTransformers]: https://github.com/kubernetes-sigs/kustomize/tree/master/api/internal/target/transformerplugin_test.go
|
|
||||||
|
|
||||||
### `replicas` field
|
|
||||||
|
|
||||||
The common task of patching a deployment to edit
|
|
||||||
the number of replicas is now made easier
|
|
||||||
with the new [replicas](/kustomize/api-reference/kustomization/replicas) field.
|
|
||||||
|
|
||||||
### `envs` field
|
|
||||||
|
|
||||||
An `envs` sub-field has been added to both
|
|
||||||
`configMapGenerator` and `secretGenerator`,
|
|
||||||
replacing the now deprecated (and singular)
|
|
||||||
`env` field. The new field accepts lists, just
|
|
||||||
like its sibling fields `files` and `literals`.
|
|
||||||
|
|
||||||
Optionally use `kustomize edit fix` to merge
|
|
||||||
singular `env` field into a plural field.
|
|
||||||
@@ -1,72 +0,0 @@
|
|||||||
---
|
|
||||||
title: "v3.0.0"
|
|
||||||
linkTitle: "v3.0.0"
|
|
||||||
date: 2019-07-03
|
|
||||||
description: >
|
|
||||||
Kustomize v3.0.0
|
|
||||||
---
|
|
||||||
|
|
||||||
This release is basically [v2.1.0](v2.1.0.md),
|
|
||||||
with many post-v2.1.0 bugs fixed (in about 150
|
|
||||||
commits) and a `v3` in Go package paths.
|
|
||||||
|
|
||||||
[plugin]: /docs/plugins
|
|
||||||
|
|
||||||
The major version increment to `v3` puts a new
|
|
||||||
floor on a stable API for [plugin] developers
|
|
||||||
(both _Go_ plugin developers and _exec_ plugin
|
|
||||||
developers who happen to use Go).
|
|
||||||
|
|
||||||
### Why so soon after v2.1.0
|
|
||||||
|
|
||||||
[semantic versioning]: https://semver.org
|
|
||||||
[Go modules doc]: https://github.com/golang/go/wiki/Modules#releasing-modules-v2-or-higher
|
|
||||||
[versioning policy]: /kustomize/faq/versioningpolicy
|
|
||||||
|
|
||||||
We made a mistake - v2.1.0 should have been
|
|
||||||
v3.0.0. Per the [Go modules doc] (which have
|
|
||||||
improved a great deal recently), a release that's
|
|
||||||
already tagged v2 or higher should increment the
|
|
||||||
major version when performing their first Go
|
|
||||||
module-based release.
|
|
||||||
|
|
||||||
This advice applies to kustomize, since it was
|
|
||||||
already at major version 2 when it began using Go
|
|
||||||
modules to state _its own_ dependencies in v2.1.0.
|
|
||||||
|
|
||||||
But the more important reason for `v3` is a change
|
|
||||||
to the kustomize [versioning policy], forced by
|
|
||||||
the introduction of plugins.
|
|
||||||
|
|
||||||
Historically, kustomize's [versioning policy]
|
|
||||||
didn't involve Go modules and addressed _only_ the
|
|
||||||
command line tool's behavior and the fields in a
|
|
||||||
kustomization file. The underlying packages were
|
|
||||||
an implementation detail, not under semantic
|
|
||||||
versioning, because they weren't intended for
|
|
||||||
export (and should have all been under
|
|
||||||
`internal`). Thus although the v2.1.0 CLI is
|
|
||||||
backward compatible with v2.0.3, the underlying
|
|
||||||
package APIs are not.
|
|
||||||
|
|
||||||
[minimal version selection]: https://research.swtch.com/vgo-mvs
|
|
||||||
|
|
||||||
With Go modules, the `go` tool must assume that Go
|
|
||||||
packages respect [semantic versioning], so it can
|
|
||||||
perform [minimal version selection].
|
|
||||||
|
|
||||||
With the introduction of alpha plugins, kustomize
|
|
||||||
sub-packages - in particular `loader` and
|
|
||||||
`resmap` - become part of an API formally exposed
|
|
||||||
to plugin authors, and so must be semantically
|
|
||||||
versioned. This allows plugins defined in other
|
|
||||||
repositories to clarify that they depend on
|
|
||||||
kustomize v3.0.0, and not see confusing errors
|
|
||||||
arising from incompatibilities between v2.1.0 and
|
|
||||||
v2.0.3. Hence, the jump to v3.
|
|
||||||
|
|
||||||
Aside - the set of kustomize packages outside
|
|
||||||
`internal` is too large, and over time, informed
|
|
||||||
by package use, this API surface must shrink.
|
|
||||||
Such shrinkage will trigger a major version
|
|
||||||
increment.
|
|
||||||
@@ -1,133 +0,0 @@
|
|||||||
---
|
|
||||||
title: "v3.1.0"
|
|
||||||
linkTitle: "v3.1.0"
|
|
||||||
date: 2019-07-26
|
|
||||||
description: >
|
|
||||||
Kustomize v3.1.0
|
|
||||||
---
|
|
||||||
|
|
||||||
## Extended patches
|
|
||||||
|
|
||||||
Since this version, Kustomize allows applying one patch to multiple resources. This works for both Strategic Merge Patch and JSON Patch. Take a look at [patch multiple objects](https://github.com/kubernetes-sigs/kustomize/tree/master/examples/patchMultipleObjects.md).
|
|
||||||
|
|
||||||
## Improved Resource Matching
|
|
||||||
|
|
||||||
Multiple improvements have been made to allow the user to leverage "namespace"
|
|
||||||
instead/or with "name suffix/prefix" to segregate resources.
|
|
||||||
|
|
||||||
### Patch resolution improvement
|
|
||||||
|
|
||||||
The following example demonstrates how using the namespace field in the patch definition,
|
|
||||||
will let the user define two different patches against two different Deployment having the
|
|
||||||
same "deploy1" name but in different namespaces in the same Kustomize context/folder.
|
|
||||||
Unless the `namespace:` field has been specified in the kustomization.yaml, no namespace
|
|
||||||
value will be handled as Kubernetes `default` namespace.
|
|
||||||
|
|
||||||
```yaml
|
|
||||||
apiVersion: apps/v1
|
|
||||||
kind: Deployment
|
|
||||||
metadata:
|
|
||||||
name: deploy1
|
|
||||||
namespace: main
|
|
||||||
spec:
|
|
||||||
template:
|
|
||||||
spec:
|
|
||||||
containers:
|
|
||||||
- name: nginx
|
|
||||||
env:
|
|
||||||
- name: ANOTHERENV
|
|
||||||
value: TESTVALUE
|
|
||||||
---
|
|
||||||
apiVersion: apps/v1
|
|
||||||
kind: Deployment
|
|
||||||
metadata:
|
|
||||||
name: deploy1
|
|
||||||
namespace: production
|
|
||||||
spec:
|
|
||||||
template:
|
|
||||||
spec:
|
|
||||||
containers:
|
|
||||||
- name: main
|
|
||||||
env:
|
|
||||||
- name: ANOTHERENV
|
|
||||||
value: PRODVALUE
|
|
||||||
```
|
|
||||||
|
|
||||||
### Variable resolution improvement
|
|
||||||
|
|
||||||
It is possible to add namespace field to the variable declaration. In the following example,
|
|
||||||
two `Service` objects with the same `elasticsearch` name have been declared.
|
|
||||||
Specifying the namespace in the objRef of the corresponding varriables, allows Kustomize to
|
|
||||||
resovlve thoses variables.
|
|
||||||
If the namespace is not specified, Kustomize will handle it has a "wildcard" value.
|
|
||||||
|
|
||||||
Extract of kustomization.yaml:
|
|
||||||
|
|
||||||
```yaml
|
|
||||||
vars:
|
|
||||||
- name: elasticsearch-test-protocol
|
|
||||||
objref:
|
|
||||||
kind: Service
|
|
||||||
name: elasticsearch
|
|
||||||
namespace: test
|
|
||||||
apiVersion: v1
|
|
||||||
fieldref:
|
|
||||||
fieldpath: spec.ports[0].protocol
|
|
||||||
- name: elasticsearch-dev-protocol
|
|
||||||
objref:
|
|
||||||
kind: Service
|
|
||||||
name: elasticsearch
|
|
||||||
namespace: dev
|
|
||||||
apiVersion: v1
|
|
||||||
fieldref:
|
|
||||||
fieldpath: spec.ports[0].protocol
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
### Simultaneous change of names and namespaces
|
|
||||||
|
|
||||||
Kustomize is now able to deal with simultaneous changes of name and namespace.
|
|
||||||
Special attention has been paid the handling of:
|
|
||||||
|
|
||||||
- ClusterRoleBinding/RoleBinding "subjects" field,
|
|
||||||
- ValidatingWebhookConfiguration "webhooks" field.
|
|
||||||
|
|
||||||
The user should be able to use a kustomization.yaml as shown in the example bellow
|
|
||||||
even if ClusterRoleBind,RoleBinding and ValidatingWebookConfiguration are part of the
|
|
||||||
resources he needs to declare.
|
|
||||||
|
|
||||||
Extract of kustomization.yaml:
|
|
||||||
|
|
||||||
```yaml
|
|
||||||
namePrefix: pfx-
|
|
||||||
nameSuffix: -sfx
|
|
||||||
namespace: testnamespace
|
|
||||||
|
|
||||||
resources:
|
|
||||||
...
|
|
||||||
```
|
|
||||||
|
|
||||||
### Resource and Kustomize Context matching
|
|
||||||
|
|
||||||
Kustomize is now able to support more aggregation patterns.
|
|
||||||
|
|
||||||
If for instance, the top level of kustomization.yaml, is simply
|
|
||||||
combining sub-components, (as in the following example), Kustomize has improved
|
|
||||||
resource matching capabilities. This removes some of the constraints which were
|
|
||||||
present on the utilization of prefix/suffix and namespace transformers in the
|
|
||||||
individual components.
|
|
||||||
|
|
||||||
```yaml
|
|
||||||
resources:
|
|
||||||
- ../component1
|
|
||||||
- ../component2
|
|
||||||
- ../component3
|
|
||||||
```
|
|
||||||
|
|
||||||
## Other improvements
|
|
||||||
|
|
||||||
- Image transformation has been improved. This allows the user to update the sha256 of
|
|
||||||
an image with another sha256.
|
|
||||||
- Multiple default transformer configuration entries have been added, removing the need for the
|
|
||||||
user to add them as part of the `configurations:` section of the kustomization.yaml.
|
|
||||||
- `kustomize` help command has been tidied up.
|
|
||||||
@@ -1,37 +0,0 @@
|
|||||||
---
|
|
||||||
title: "v3.2.0"
|
|
||||||
linkTitle: "v3.2.0"
|
|
||||||
date: 2019-09-17
|
|
||||||
description: >
|
|
||||||
Kustomize v3.2.0
|
|
||||||
---
|
|
||||||
|
|
||||||
## Inline Patch
|
|
||||||
|
|
||||||
Since this version, Kustomize allows inline patches in all three of `patchesStrategicMerge`, `patchesJson6902` and `patches`. Take a look at [inline patch](https://github.com/kubernetes-sigs/kustomize/tree/master/examples/examples/inlinePatch.md).
|
|
||||||
|
|
||||||
## New Subcommand
|
|
||||||
|
|
||||||
Since this version, one can create a kustomization.yaml file in a directory through a `create` subcommand.
|
|
||||||
|
|
||||||
Create a new overlay from the base ../base
|
|
||||||
|
|
||||||
```
|
|
||||||
kustomize create --resources ../base
|
|
||||||
```
|
|
||||||
|
|
||||||
Create a new kustomization detecing resources in the current directory
|
|
||||||
|
|
||||||
```
|
|
||||||
kustomize create --autodetect
|
|
||||||
```
|
|
||||||
|
|
||||||
Once can also add all resources in the current directory recursively by
|
|
||||||
|
|
||||||
```
|
|
||||||
kustomize create --autodetect --recursive
|
|
||||||
```
|
|
||||||
|
|
||||||
### New Example Generator
|
|
||||||
|
|
||||||
A new example generator of using go-getter to download resources is added. Take a look at [go-getter generator](https://github.com/kubernetes-sigs/kustomize/tree/master/examples/goGetterGeneratorPlugin.md).
|
|
||||||
@@ -1,19 +0,0 @@
|
|||||||
---
|
|
||||||
title: "v3.2.1"
|
|
||||||
linkTitle: "v3.2.1"
|
|
||||||
date: 2019-09-26
|
|
||||||
description: >
|
|
||||||
Kustomize v3.2.1
|
|
||||||
---
|
|
||||||
|
|
||||||
This is a patch release, with no new features from 3.2.0.
|
|
||||||
|
|
||||||
It reflects a change in dependence.
|
|
||||||
|
|
||||||
The kustomize binary is now built as a client, with no special
|
|
||||||
consideration, of the set of public packages represented by the Go
|
|
||||||
module at [https://github.com/kubernetes-sigs/kustomize].
|
|
||||||
|
|
||||||
kustomize the binary is now a client of the kustomize API
|
|
||||||
represented by the public package surface presented by
|
|
||||||
`https://github.com/kubernetes-sigs/kustomize/v{whatever}`
|
|
||||||
@@ -1,120 +0,0 @@
|
|||||||
---
|
|
||||||
title: "v3.3.0"
|
|
||||||
linkTitle: "v3.3.0"
|
|
||||||
date: 2019-10-24
|
|
||||||
description: >
|
|
||||||
Kustomize v3.3.0
|
|
||||||
---
|
|
||||||
|
|
||||||
|
|
||||||
[versioning policy documentation]: /site/content/en/faq/versioningPolicy.md
|
|
||||||
[release process documentation]: /releasing
|
|
||||||
|
|
||||||
## Summary of changes
|
|
||||||
|
|
||||||
### First release of the Go API-only module
|
|
||||||
|
|
||||||
Many of the PRs since the last vrelease were
|
|
||||||
around restructuring the _sigs.k8s.io/kustomize_
|
|
||||||
repository into three Go modules instead of just one.
|
|
||||||
|
|
||||||
The reasons for this are detailed in the [versioning
|
|
||||||
policy documentation], and what it means for releasing
|
|
||||||
is explained in the [release process documentation].
|
|
||||||
|
|
||||||
The tl;dr is that the top level module
|
|
||||||
`sigs.k8s.io/kustomize` now defines the kustomize Go
|
|
||||||
API, and the _kustomize_ CLI sits below it in an
|
|
||||||
independent module `sigs.k8s.io/kustomize/kustomize`.
|
|
||||||
|
|
||||||
The modules release independently, though in practice a
|
|
||||||
new release of the kustomize Go API will likely be
|
|
||||||
followed quickly by a new release of the `kustomize`
|
|
||||||
executable.
|
|
||||||
|
|
||||||
This is a necessary step to creating a much smaller
|
|
||||||
kustomize Go API surface that has some hope of
|
|
||||||
conforming to semantic versioning and being of some use
|
|
||||||
to clients.
|
|
||||||
|
|
||||||
The kustomize CLI will see the same kustomize Go API as
|
|
||||||
any other client.
|
|
||||||
|
|
||||||
The new semver-able API will begin with `v4.0.0` (not
|
|
||||||
yet released) and be a clean break with `v3` etc.
|
|
||||||
|
|
||||||
### Change log since v3.2.0
|
|
||||||
|
|
||||||
```
|
|
||||||
3c9d828f - Have kustomize CLI depend on kustomize Go API v3.3.0 (Jeffrey Regan)
|
|
||||||
5d800f0b - Merge pull request #1595 from monopole/threeReleases (Jeff Regan)
|
|
||||||
4eb2d5bc - Three builders. (Jeffrey Regan)
|
|
||||||
988af1ff - Update README.md (Jeff Regan)
|
|
||||||
1617183e - Merge pull request #1590 from monopole/releaseProcessUpdate (Kubernetes Prow Robot)
|
|
||||||
ee727464 - update release process doc (jregan)
|
|
||||||
c9e7dc3b - Merge pull request #1589 from monopole/moreTestsAroundKustFileName (Jeff Regan)
|
|
||||||
07e0e46a - improve tests for alternative kustomization file names (Jeffrey Regan)
|
|
||||||
404d2d63 - Merge pull request #1587 from monopole/reducePgmconfig (Jeff Regan)
|
|
||||||
baa0296a - Reduce size of pgmconfig package (Jeffrey Regan)
|
|
||||||
0f665ac1 - Merge pull request #1544 from ptux/add-transformer-href (Jeff Regan)
|
|
||||||
14b0a650 - Merge pull request #1581 from monopole/refactorFs (Jeff Regan)
|
|
||||||
2d58f8b8 - Break the dep between fs and pgmconfig. (Jeffrey Regan)
|
|
||||||
9a43ca53 - Merge pull request #1578 from nlamirault/fix/build-plugins-doc (Jeff Regan)
|
|
||||||
5372fc6f - Merge pull request #1579 from monopole/fsPackageCleanup (Jeff Regan)
|
|
||||||
86bc3440 - Merge pull request #1513 from nimohunter/fix_empty_list_item (Kubernetes Prow Robot)
|
|
||||||
a014f7d4 - Merge pull request #1561 from beautytiger/dev-190925 (Jeff Regan)
|
|
||||||
9a94bcb8 - Improve fs package and doc in prep to officially go public (Jeffrey Regan)
|
|
||||||
07634ef0 - Merge pull request #1575 from monopole/versioning (Jeff Regan)
|
|
||||||
995f88d6 - Update versioning notes. (jregan)
|
|
||||||
334a6467 - Fix: documentation link for plugins (Nicolas Lamirault)
|
|
||||||
08963ba5 - improve test code coverage in transformers (Guangming Wang)
|
|
||||||
326fb689 - Merge pull request #1570 from bzub/1234-go_plugin_doc (Jeff Regan)
|
|
||||||
970ce67c - Update goPluginCaveats.md (Jeff Regan)
|
|
||||||
98d18930 - Update INSTALL.md (Jeff Regan)
|
|
||||||
d89b448c - Fix git tag recovery in cloud build. (Jeff Regan)
|
|
||||||
17bf9d32 - Update releasing README. (Jeff Regan)
|
|
||||||
a99aff1d - Merge pull request #1571 from monopole/updateCloudBuildProcess (Kubernetes Prow Robot)
|
|
||||||
a694ac7b - Update cloud build process for kustomize. (Jeffrey Regan)
|
|
||||||
b5b11ef6 - Fix compile kustomize example. (bzub)
|
|
||||||
fa1af6f5 - Merge pull request #1473 from richardmarshall/execpluginhash (Jeff Regan)
|
|
||||||
9288dec0 - Fix failing BashedConfigMapTest (Jeff Regan)
|
|
||||||
1a45dd0b - Merge pull request #1566 from monopole/releaseNotes3.2.1 (Kubernetes Prow Robot)
|
|
||||||
592c5acf - docs: Exec plugin generator options (Richard Marshall)
|
|
||||||
ac9424fa - tests: Add unit tests for update resource options (Richard Marshall)
|
|
||||||
79fbe7c4 - Support resource generator options in exec plugins (Richard Marshall)
|
|
||||||
f69d526f - v3.2.1 release notes (Jeff Regan)
|
|
||||||
07a95a60 - Merge pull request #1565 from monopole/tweakBinaryDepsBeforeTagging (Jeff Regan)
|
|
||||||
032b3857 - Pin the kustomize binary's dependence on kustomize libs. (jregan)
|
|
||||||
81062959 - Merge pull request #1564 from monopole/moveKustomizeBinaryToOwnModule (Kubernetes Prow Robot)
|
|
||||||
b82a8fd3 - Move the kustomize binary to its own module. (Jeffrey Regan)
|
|
||||||
2d0c22d6 - Merge pull request #1562 from keleustes/tools (Kubernetes Prow Robot)
|
|
||||||
aa342def - Pin tool versions using go modules (Ian Howell)
|
|
||||||
10786ec0 - Merge pull request #1554 from keleustes/readme (Kubernetes Prow Robot)
|
|
||||||
7c705687 - Update README.md to include Kubernetes 1.16 (Jerome Brette)
|
|
||||||
e8933d97 - Merge pull request #1560 from monopole/precommitTuneup (Jeff Regan)
|
|
||||||
9d7b6544 - Make pre-commit more portable and less tricky. (jregan)
|
|
||||||
7a0946a9 - Merge pull request #1558 from monopole/dependOnNewPluginatorModule (Jeff Regan)
|
|
||||||
def4f045 - Depend on new pluginator location. (Jeffrey Regan)
|
|
||||||
2f2408f1 - Merge pull request #1559 from monopole/compressCopyright (Jeff Regan)
|
|
||||||
3b9bcc48 - Compress copyright in the commands package. (Jeffrey Regan)
|
|
||||||
d0429ff4 - Merge pull request #1557 from monopole/pluginatorModule (Jeff Regan)
|
|
||||||
33deefc3 - Copy pluginator to its own module. (Jeffrey Regan)
|
|
||||||
9b3de82b - Merge pull request #1506 from Liujingfang1/release (Jeff Regan)
|
|
||||||
d217074f - Merge pull request #1550 from keleustes/apiversion (Kubernetes Prow Robot)
|
|
||||||
1d90ba7c - Fix typo in apiVersion yaml declaration (Jerome Brette)
|
|
||||||
eeeb4c36 - Merge pull request #1547 from keleustes/extensions (Kubernetes Prow Robot)
|
|
||||||
b1faa989 - Update Ingress apiVersion to networking.k8s.io/v1beta1 (Jerome Brette)
|
|
||||||
d8250c9e - move test case (nimohunter)
|
|
||||||
c9500466 - add transformer href (Wang(わん))
|
|
||||||
0c32691e - Merge pull request #1537 from jaypipes/gomod-install-note (Kubernetes Prow Robot)
|
|
||||||
88b1d627 - Merge pull request #1541 from rtnpro/patch-1 (Jeff Regan)
|
|
||||||
aec82066 - Update INSTALL.md (Jeff Regan)
|
|
||||||
20c2b53a - Merge pull request #1542 from monopole/tweakFilePathsInTest (Jeff Regan)
|
|
||||||
274b5c3b - Tweak file path handling and logging in test. (Jeffrey Regan)
|
|
||||||
b1fdaa23 - Fix typo in transformerconfigs README (Ratnadeep Debnath)
|
|
||||||
b5d5e70b - empty list or map item return error (nimohunter)
|
|
||||||
2e829853 - empty list or map item return error (nimohunter)
|
|
||||||
55941f57 - add note about GO111MODULE for source install (Jay Pipes)
|
|
||||||
9e226001 - empty list or map item return error (nimohunter)
|
|
||||||
77b63f96 - add release note for v3.2.0 (jingfangliu)
|
|
||||||
```
|
|
||||||
@@ -1,13 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Contributing"
|
|
||||||
linkTitle: "Contributing"
|
|
||||||
type: docs
|
|
||||||
menu:
|
|
||||||
main:
|
|
||||||
weight: 99
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/contributing/kustomize/" />
|
|
||||||
|
|
||||||
|
|
||||||
Follow are resources for Kustomize contributors.
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Filing Bugs"
|
|
||||||
linkTitle: "Filing Bugs"
|
|
||||||
type: docs
|
|
||||||
weight: 10
|
|
||||||
description: >
|
|
||||||
How to file bugs and fix Kustomize bugs
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/contributing/kustomize/bugs" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Community Engagment"
|
|
||||||
linkTitle: "Community"
|
|
||||||
type: docs
|
|
||||||
weight: 20
|
|
||||||
description: >
|
|
||||||
Joining SIG-CLI and the Kubernetes community
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/contributing/kustomize/community" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Writing Docs"
|
|
||||||
linkTitle: "Writing Docs"
|
|
||||||
type: docs
|
|
||||||
weight: 30
|
|
||||||
description: >
|
|
||||||
How to make Kustomize docs contributions
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/contributing/kustomize/docs" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Contributing Features"
|
|
||||||
linkTitle: "Contributing Features"
|
|
||||||
type: docs
|
|
||||||
weight: 21
|
|
||||||
description: >
|
|
||||||
How to contribute features
|
|
||||||
---
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/contributing/kustomize/features" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Writing Code"
|
|
||||||
linkTitle: "Writing Code"
|
|
||||||
type: docs
|
|
||||||
weight: 40
|
|
||||||
description: >
|
|
||||||
How to modify Kustomize
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/contributing/kustomize/howitworks" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "MacOS Dev Guide"
|
|
||||||
linkTitle: "MacOS Dev Guide"
|
|
||||||
type: docs
|
|
||||||
weight: 50
|
|
||||||
description: >
|
|
||||||
How to develop on MacOS
|
|
||||||
---
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/contributing/kustomize/mac" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Windows Dev Guide"
|
|
||||||
linkTitle: "Windows Dev Guide"
|
|
||||||
type: docs
|
|
||||||
weight: 60
|
|
||||||
description: >
|
|
||||||
How to develop on Windows
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/contributing/kustomize/windows" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
---
|
|
||||||
title: "FAQ"
|
|
||||||
linkTitle: "FAQ"
|
|
||||||
type: docs
|
|
||||||
menu:
|
|
||||||
main:
|
|
||||||
weight: 70
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/faq/kustomize/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Eschewed Features"
|
|
||||||
linkTitle: "Eschewed Features"
|
|
||||||
type: docs
|
|
||||||
weight: 99
|
|
||||||
description: >
|
|
||||||
Eschewed Features
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/faq/kustomize/eschewedfeatures/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,10 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Versioning Policy"
|
|
||||||
linkTitle: "Versioning Policy"
|
|
||||||
weight: 99
|
|
||||||
type: docs
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/faq/kustomize/versioningpolicy/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,14 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Guides"
|
|
||||||
linkTitle: "Guides"
|
|
||||||
type: docs
|
|
||||||
weight: 2
|
|
||||||
menu:
|
|
||||||
main:
|
|
||||||
weight: 20
|
|
||||||
description: >
|
|
||||||
Reference for Kustomize usage and best practices
|
|
||||||
---
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/guides/config_management" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Bespoke Application"
|
|
||||||
linkTitle: "Bespoke Application"
|
|
||||||
type: docs
|
|
||||||
weight: 1
|
|
||||||
description: >
|
|
||||||
Workflow for bespoke applications
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/guides/config_management/bespoke/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Kustomize Components"
|
|
||||||
linkTitle: "Kustomize Components"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Kustomize components guide
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/guides/config_management/components/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Off The Shelf Application"
|
|
||||||
linkTitle: "Off The Shelf Application"
|
|
||||||
type: docs
|
|
||||||
weight: 2
|
|
||||||
description: >
|
|
||||||
Workflow for off the shelf applications
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/guides/config_management/offtheshelf/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Kustomize Plugins"
|
|
||||||
linkTitle: "Kustomize Plugins"
|
|
||||||
type: docs
|
|
||||||
weight: 98
|
|
||||||
description: >
|
|
||||||
Kustomize plugins guide
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/guides/extending_kustomize/plugins" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Builtin Plugins"
|
|
||||||
linkTitle: "Builtin Plugins"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Builtin Plugins
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/guides/extending_kustomize/builtins" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Exec plugin on linux"
|
|
||||||
linkTitle: "Exec plugin on linux"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Exec plugin on linux in 60 seconds
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/guides/extending_kustomize/execpluginguidedexample" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Go plugin Caveats"
|
|
||||||
linkTitle: "Go plugin Caveats"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Go plugin Caveats
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/guides/extending_kustomize/goplugincaveats" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Go plugin example"
|
|
||||||
linkTitle: "Go plugin example"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Go plugin example
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/guides/extending_kustomize/gopluginguidedexample" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,13 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Installation"
|
|
||||||
linkTitle: "Installation"
|
|
||||||
weight: 20
|
|
||||||
type: docs
|
|
||||||
menu:
|
|
||||||
main:
|
|
||||||
weight: 10
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/installation/kustomize/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Binaries"
|
|
||||||
linkTitle: "Binaries"
|
|
||||||
weight: 3
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Install Kustomize by downloading precompiled binaries.
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/installation/kustomize/binaries/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,13 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Chocolatey"
|
|
||||||
linkTitle: "Chocolatey"
|
|
||||||
weight: 4
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Install Kustomize for Windows using Chocolatey
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/installation/kustomize/chocolatey/" />
|
|
||||||
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Homebrew / MacPorts"
|
|
||||||
linkTitle: "Homebrew / MacPorts"
|
|
||||||
weight: 3
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Install Kustomize for MacOS using Homebrew or MacPorts
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/installation/kustomize/homebrew/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Go Source"
|
|
||||||
linkTitle: "Go Source"
|
|
||||||
weight: 2
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Install Kustomize from the Go source code
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/installation/kustomize/source/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,4 +0,0 @@
|
|||||||
---
|
|
||||||
type: "search-index"
|
|
||||||
url: "index.json"
|
|
||||||
---
|
|
||||||
@@ -1,6 +0,0 @@
|
|||||||
---
|
|
||||||
title: Search Results
|
|
||||||
layout: search
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
@@ -1,35 +0,0 @@
|
|||||||
+++
|
|
||||||
title = "Kustomize"
|
|
||||||
linkTitle = "Kustomize"
|
|
||||||
|
|
||||||
+++
|
|
||||||
|
|
||||||
|
|
||||||
{{<blocks/cover title="Kustomize" image_anchor="center" height="full" color="primary">}}
|
|
||||||
<div class="mx-auto">
|
|
||||||
<p class="lead mt-5">Kustomize 提供了一种自定义 Kubernetes 资源配置的解决方案，该方案摆脱了模板和 DSL。</p>
|
|
||||||
<a
|
|
||||||
class="btn btn-lg btn-primary mr-3 mb-4"
|
|
||||||
href="/kustomize/zh/installation/"
|
|
||||||
>
|
|
||||||
Get Started <i class="fas fa-arrow-alt-circle-right ml-2"></i>
|
|
||||||
</a>
|
|
||||||
<a
|
|
||||||
class="btn btn-lg btn-secondary mr-3 mb-4"
|
|
||||||
href="/kustomize/zh/contributing/"
|
|
||||||
>
|
|
||||||
Contribute <i class="fas fa-pencil-alt ml-2"></i>
|
|
||||||
</a>
|
|
||||||
<div class="mx-auto mt-5">
|
|
||||||
{{<blocks/link-down color="light">}}
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
{{</blocks/cover>}}
|
|
||||||
|
|
||||||
{{< blocks/section >}}
|
|
||||||
|
|
||||||
{{% blocks/feature icon="fab fa-github" title="参与贡献" %}}
|
|
||||||
欢迎在 **Github** 提交 [RP](https://github.com/kubernetes-sigs/kustomize/pulls)，贡献你的力量。
|
|
||||||
{{% /blocks/feature %}}
|
|
||||||
|
|
||||||
{{< /blocks/section >}}
|
|
||||||
@@ -1,15 +0,0 @@
|
|||||||
---
|
|
||||||
title: "API 参考"
|
|
||||||
linkTitle: "API 参考"
|
|
||||||
type: docs
|
|
||||||
weight: 4
|
|
||||||
menu:
|
|
||||||
main:
|
|
||||||
weight: 40
|
|
||||||
description: >
|
|
||||||
Kustomize 客户端 API 参考。
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/api-reference/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
---
|
|
||||||
title: "术语表"
|
|
||||||
linkTitle: "术语表"
|
|
||||||
type: docs
|
|
||||||
weight: 99
|
|
||||||
description: >
|
|
||||||
术语表
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/api-reference/glossary/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,13 +0,0 @@
|
|||||||
---
|
|
||||||
title: "kustomization.yaml"
|
|
||||||
linkTitle: "kustomization.yaml"
|
|
||||||
type: docs
|
|
||||||
weight: 10
|
|
||||||
description: >
|
|
||||||
kustomization.yaml fields and API
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/api-reference/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "bases"
|
|
||||||
linkTitle: "bases"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
在 Kustomization 目录中添加资源。
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/api-reference/kustomization/bases/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "commonAnnotations"
|
|
||||||
linkTitle: "commonAnnotations"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
为所有字段添加注释。
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/api-reference/kustomization/commonannotations/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "commonLabels"
|
|
||||||
linkTitle: "commonLabels"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
为所有资源和 selectors 增加标签。
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/api-reference/kustomization/commonlabels/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "components"
|
|
||||||
linkTitle: "components"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Compose kustomizations.
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/api-reference/kustomization/components/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "configMapGenerator"
|
|
||||||
linkTitle: "configMapGenerator"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
生成 ConfigMap 资源.
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/api-reference/kustomization/configmapgenerator/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "crds"
|
|
||||||
linkTitle: "crds"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
增加对 CRD 的支持。
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/api-reference/kustomization/crds/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "generatorOptions"
|
|
||||||
linkTitle: "generatorOptions"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
控制生成 [ConfigMap](/kustomize/zh/api-reference/kustomization/configmapgenerator) 和 [Secret](/kustomize/zh/api-reference/kustomization/secretgenerator) 的行为。
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/api-reference/kustomization/generatoroptions/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "images"
|
|
||||||
linkTitle: "images"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
修改镜像的名称、tag 或 image digest。
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/api-reference/kustomization/images/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "namePrefix"
|
|
||||||
linkTitle: "namePrefix"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
为所有资源和引用的名称添加前缀。
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/api-reference/kustomization/nameprefix/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "namespace"
|
|
||||||
linkTitle: "namespace"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
为所有资源添加 namespace。
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/api-reference/kustomization/namespace/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "nameSuffix"
|
|
||||||
linkTitle: "nameSuffix"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
为所有资源和引用的名称添加后缀。
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/api-reference/kustomization/namesuffix/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "patches"
|
|
||||||
linkTitle: "patches"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Patch resources
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/api-reference/kustomization/patches/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "patchesStrategicMerge"
|
|
||||||
linkTitle: "patchesStrategicMerge"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
使用 strategic merge patch 标准 Patch resources.
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/api-reference/kustomization/patchesStrategicMerge/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "patchesJson6902"
|
|
||||||
linkTitle: "patchesJson6902"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
使用 [json 6902 标准](https://tools.ietf.org/html/rfc6902) Patch resources
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/api-reference/kustomization/patchesjson6902/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "replicas"
|
|
||||||
linkTitle: "replicas"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
修改资源的副本数。
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/api-reference/kustomization/replicas/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "resources"
|
|
||||||
linkTitle: "resources"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
包含的资源。
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/api-reference/kustomization/resources/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "secretGenerator"
|
|
||||||
linkTitle: "secretGenerator"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
生成 Secret 资源。
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/api-reference/kustomization/secretegenerator/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "vars"
|
|
||||||
linkTitle: "vars"
|
|
||||||
type: docs
|
|
||||||
description: >
|
|
||||||
Substitute name references.
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/api-reference/kustomization/var/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Kustomize 博客"
|
|
||||||
linkTitle: "博客"
|
|
||||||
menu:
|
|
||||||
main:
|
|
||||||
weight: 80
|
|
||||||
---
|
|
||||||
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/blog/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,9 +0,0 @@
|
|||||||
---
|
|
||||||
title: "New Releases"
|
|
||||||
linkTitle: "Releases"
|
|
||||||
weight: 20
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/blog/releases/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "v1.0.1"
|
|
||||||
linkTitle: "v1.0.1"
|
|
||||||
date: 2018-05-21
|
|
||||||
description: >
|
|
||||||
Kustomize v1.0.1
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/blog/2018/05/21/v1.0.1/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "v2.0.0"
|
|
||||||
linkTitle: "v2.0.0"
|
|
||||||
date: 2019-02-05
|
|
||||||
description: >
|
|
||||||
Kustomize v2.0.0
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/blog/2019/02/05/v2.0.0/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "v2.1.0"
|
|
||||||
linkTitle: "v2.1.0"
|
|
||||||
date: 2019-06-18
|
|
||||||
description: >
|
|
||||||
Kustomize v2.1.0
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/blog/2019/06/18/v2.1.0/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "v3.0.0"
|
|
||||||
linkTitle: "v3.0.0"
|
|
||||||
date: 2019-07-03
|
|
||||||
description: >
|
|
||||||
Kustomize v3.0.0
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/blog/2019/07/03/v3.0.0/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "v3.1.0"
|
|
||||||
linkTitle: "v3.1.0"
|
|
||||||
date: 2019-07-26
|
|
||||||
description: >
|
|
||||||
Kustomize v3.1.0
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/blog/2019/07/26/v3.1.0/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "v3.2.0"
|
|
||||||
linkTitle: "v3.2.0"
|
|
||||||
date: 2019-09-17
|
|
||||||
description: >
|
|
||||||
Kustomize v3.2.0
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/blog/2019/09/17/v3.2.0/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
---
|
|
||||||
title: "v3.2.1"
|
|
||||||
linkTitle: "v3.2.1"
|
|
||||||
date: 2019-09-26
|
|
||||||
description: >
|
|
||||||
Kustomize v3.2.1
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/blog/2019/09/26/v3.2.1/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
---
|
|
||||||
title: "v3.3.0"
|
|
||||||
linkTitle: "v3.3.0"
|
|
||||||
date: 2019-10-24
|
|
||||||
description: >
|
|
||||||
Kustomize v3.3.0
|
|
||||||
---
|
|
||||||
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/blog/2019/10/24/v3.3.0/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,14 +0,0 @@
|
|||||||
---
|
|
||||||
title: "贡献指南"
|
|
||||||
linkTitle: "贡献指南"
|
|
||||||
type: docs
|
|
||||||
menu:
|
|
||||||
main:
|
|
||||||
weight: 99
|
|
||||||
---
|
|
||||||
|
|
||||||
以下是 Kustomize 贡献指南。
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/contributing/kustomize/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,13 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Filing Bugs"
|
|
||||||
linkTitle: "Filing Bugs"
|
|
||||||
type: docs
|
|
||||||
weight: 10
|
|
||||||
description: >
|
|
||||||
How to file bugs and fix Kustomize bugs
|
|
||||||
---
|
|
||||||
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/contributing/bugs/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Community Engagment"
|
|
||||||
linkTitle: "Community"
|
|
||||||
type: docs
|
|
||||||
weight: 20
|
|
||||||
description: >
|
|
||||||
Joining SIG-CLI and the Kubernetes community
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/contributing/community/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
---
|
|
||||||
title: "Writing Docs"
|
|
||||||
linkTitle: "Writing Docs"
|
|
||||||
type: docs
|
|
||||||
weight: 30
|
|
||||||
description: >
|
|
||||||
How to make Kustomize docs contributions
|
|
||||||
---
|
|
||||||
|
|
||||||
<meta http-equiv="refresh" content="0; url=https://kubectl.docs.kubernetes.io/zh/contributing/docs/" />
|
|
||||||
|
|
||||||
Moved to https://github.com/kubernetes-sigs/cli-experimental
|
|
||||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user