
Change-Id: I5ab8722dd151d9e652e0b20e1d82988cd98505af Signed-off-by: Ruslan Aliev <raliev@mirantis.com>
64 lines
1.5 KiB
Markdown
64 lines
1.5 KiB
Markdown
## airshipctl document plugin
|
|
|
|
Run as a kustomize exec plugin
|
|
|
|
### Synopsis
|
|
|
|
This command is meant to be used as a kustomize exec plugin.
|
|
|
|
The command reads the configuration file CONFIG passed as a first argument and
|
|
determines a particular plugin to execute. Additional arguments may be passed
|
|
to this command and can be used by the particular plugin.
|
|
|
|
CONFIG must be a structured kubernetes manifest (i.e. resource) and must have
|
|
'apiVersion' and 'kind' keys. If the appropriate plugin was not found, the
|
|
command returns an error.
|
|
|
|
|
|
```
|
|
airshipctl document plugin CONFIG [ARGS] [flags]
|
|
```
|
|
|
|
### Examples
|
|
|
|
```
|
|
|
|
# Perform a replacement on a deployment. Prior to running this command,
|
|
# the file '/tmp/replacement.yaml' should be created as follows:
|
|
---
|
|
apiVersion: airshipit.org/v1alpha1
|
|
kind: ReplacementTransformer
|
|
metadata:
|
|
name: notImportantHere
|
|
replacements:
|
|
- source:
|
|
value: nginx:newtag
|
|
target:
|
|
objref:
|
|
kind: Deployment
|
|
fieldrefs:
|
|
- spec.template.spec.containers[name=nginx-latest].image
|
|
|
|
# The replacement can then be performed. Output defaults to stdout.
|
|
airshipctl document plugin /tmp/replacement.yaml
|
|
|
|
```
|
|
|
|
### Options
|
|
|
|
```
|
|
-h, --help help for plugin
|
|
```
|
|
|
|
### Options inherited from parent commands
|
|
|
|
```
|
|
--airshipconf string Path to file for airshipctl configuration. (default "$HOME/.airship/config")
|
|
--debug enable verbose output
|
|
```
|
|
|
|
### SEE ALSO
|
|
|
|
* [airshipctl document](airshipctl_document.md) - Manage deployment documents
|
|
|