mirror of
https://github.com/kubernetes-sigs/kustomize.git
synced 2026-05-22 06:47:00 +00:00
a7df00c07a
[doc]: https://github.com/golang/go/wiki/Modules#releasing-modules-v2-or-higher Per this Go modules [doc] a repo or branch that's already tagged v2 or higher should increment the major version (e.g. go to v3) when releasing their first Go module-based packages. At the moment, the kustomize repo has these top level packages in the sigs.k8s.io/kustomize module: - `cmd` - holds main program for kustomize Conceivably someone can depend on this package for integration tests. - `internal` - intentionally unreleased subpackages - `k8sdeps` - an adapter wrapping k8s dependencies This exists only for use in pre-Go-modules kustomize-into-kubectl integration and won't live much longer (as everything involved is switching to Go modules). - `pkg` - kustomize packages for export This should shrink in later versions, since the surface area is too large, containing sub-packages that should be in 'internal'. - `plugin` - holds main programs for plugins This PR changes the top level go.mod file from ``` module sigs.k8s.io/kustomize ``` to ``` module sigs.k8s.io/kustomize/v3 ``` and adjusts all import statements to reflect the change.
72 lines
2.2 KiB
Markdown
72 lines
2.2 KiB
Markdown
English | [简体中文](zh/README.md)
|
|
|
|
# Examples
|
|
|
|
These examples assume that `kustomize` is on your `$PATH`.
|
|
|
|
They are covered by [pre-commit](../travis/pre-commit.sh)
|
|
tests, and should work with HEAD
|
|
|
|
<!-- @installkustomize @test -->
|
|
```
|
|
go get sigs.k8s.io/kustomize/v3/cmd/kustomize
|
|
```
|
|
|
|
Basic Usage
|
|
|
|
* [configGenerations](configGeneration.md) -
|
|
Rolling update when ConfigMapGenerator changes.
|
|
|
|
* [combineConfigs](combineConfigs.md) -
|
|
Mixing configuration data from different owners
|
|
(e.g. devops/SRE and developers).
|
|
|
|
* [generatorOptions](generatorOptions.md) -
|
|
Modifying behavior of all ConfigMap and Secret generators.
|
|
|
|
* [vars](wordpress/README.md) - Injecting k8s runtime data into
|
|
container arguments (e.g. to point wordpress to a SQL service) by vars.
|
|
|
|
* [image names and tags](image.md) - Updating image names and tags without applying a patch.
|
|
|
|
* [remote target](remoteBuild.md) - Building a kustomization from a github URL
|
|
|
|
* [json patch](jsonpatch.md) - Apply a json patch in a kustomization
|
|
|
|
Advanced Usage
|
|
|
|
- generator plugins:
|
|
|
|
* [last mile helm](chart.md) - Make last mile modifications to
|
|
a helm chart.
|
|
|
|
* [secret generation](secretGeneratorPlugin.md) - Generating secrets from a plugin.
|
|
|
|
- transformer plugins:
|
|
* [validation transformer](validationTransformer/README.md) -
|
|
validate resources through a transformer
|
|
|
|
- customize builtin transformer configurations
|
|
|
|
* [transformer configs](transformerconfigs/README.md) - Customize transformer configurations
|
|
|
|
|
|
Multi Variant Examples
|
|
|
|
* [hello world](helloWorld/README.md) - Deploy multiple
|
|
(differently configured) variants of a simple Hello
|
|
World server.
|
|
|
|
* [LDAP](ldap/README.md) - Deploy multiple
|
|
(differently configured) variants of a LDAP server.
|
|
|
|
* [springboot](springboot/README.md) - Create a Spring Boot
|
|
application production configuration from scratch.
|
|
|
|
* [mySql](mySql/README.md) - Create a MySQL production
|
|
configuration from scratch.
|
|
|
|
* [breakfast](breakfast.md) - Customize breakfast for
|
|
Alice and Bob.
|
|
|
|
* [multibases](multibases/README.md) - Composing three variants (dev, staging, production) with a common base. |