The inso generate config
command generates a configuration from an API specification by using openapi-2-kong. The command works similarly to generating a declarative configuration file or Kubernetes manifest from within Insomnia.
For more in-depth information on working with other Kong products, see:
inso generate config [identifier]
identifier
is a specification name, or id, or a file path.
Option | Alias | Description |
---|---|---|
--type <type> |
-t |
type of configuration to generate, options are kubernetes and declarative (default: declarative ) |
--output <path> |
-o |
save the generated config to a file in the working directory. The default output is yaml . Change the output type to json for type declarative with the --format option. |
--format |
-f |
output format, either yaml or json . This option only applies to type declarative , and will be ignored for type kubernetes (default: yaml ) |
--tags <tags> |
comma-separated list of tags to apply to each entity |
The following commands work when running in the example git-repo directory.
When you don’t specify any arguments, you’ll be prompted with:
inso generate config
Scope configuration generation by the Document name or ID:
inso generate config spc_46c5a4
inso generate config "Sample Specification"
Scope configuration generation by a file on the filesystem:
inso generate config spec.yaml
inso generate config spec.yaml --workingDir another/dir
Save the configuration output to a file:
inso generate config spc_46c5a4 --output output.yaml
inso generate config spc_46c5a4 > output.yaml
Save the configuration output to a file with json output:
inso generate config spc_46c5a4 --output output.json --format json
Add tags to your generated configuration:
inso generate config spec.yaml --workingDir another/dir
inso generate config spec.yaml --tags first
inso generate config spec.yaml --tags "first,second"
Change the generated configuration output type to either declarative
or kubernetes
:
inso generate config spc_46c5a4 --type declarative
inso generate config "Sample Specification" --type kubernetes