You are browsing unreleased documentation. See the latest documentation here.

deck file add-tags

Add tags to objects in a decK file.

The tags are added to all objects that match the selector expressions. If no selectors are given, all Kong entities are tagged.

Syntax

deck file add-tags [command-specific flags] [global flags] tag [...tag]

Examples

# adds tags 'tag1' and 'tag2' to all services in file 'kong.yml'
cat kong.yml | deck file add-tags --selector='services[*]' tag1 tag2

Flags

--format

Output format: JSON or YAML. (Default: "YAML")

-h, --help

Help for add-tags.

-o, --output-file

Output file to write. Use - to write to stdout. (Default: "-")

--selector

JSON path expression to select objects to add tags to. Defaults to all Kong entities. Repeat for multiple selectors.

Warning: The JSONPath implementation has a known issue related to recursive descent with expressions. Expressions following a recursive descent do not work as expected, however, a workaround is available by preceding the expression with a wildcard selection. For example, $..plugins[?(@.regex_priority>100)] must be expressed as $..plugins[*][?(@.regex_priority>100)]. See the go-apiops library documentation for details on this issue.

-s, --state

decK file to process. Use - to read from stdin. (Default: "-")

Global flags

--analytics

Share anonymized data to help improve decK. Use --analytics=false to disable this. (Default: true)

--ca-cert

Custom CA certificate (raw contents) to use to verify Kong’s Admin TLS certificate. This value can also be set using DECK_CA_CERT environment variable. This takes precedence over --ca-cert-file flag.

--ca-cert-file

Path to a custom CA certificate to use to verify Kong’s Admin TLS certificate. This value can also be set using DECK_CA_CERT_FILE environment variable.

--config

Config file (default is $HOME/.deck.yaml).

--headers

HTTP headers (key:value) to inject in all requests to Kong’s Admin API. This flag can be specified multiple times to inject multiple headers.

--kong-addr

HTTP address of Kong’s Admin API. This value can also be set using the environment variable DECK_KONG_ADDR environment variable. (Default: "http://localhost:8001")

--kong-cookie-jar-path

Absolute path to a cookie-jar file in the Netscape cookie format for auth with Admin Server. You may also need to pass in as header the User-Agent that was used to create the cookie-jar.

--konnect-addr

Address of the Konnect endpoint. (Default: "https://us.api.konghq.com")

--konnect-token

Token associated with your Konnect account. This takes precedence over the --konnect-token-file flag.

--konnect-token-file

File containing the token associated with your Konnect account.

--konnect-control-plane-name

Konnect control plane name.

--no-color

Disable colorized output (Default: false)

--skip-workspace-crud

Skip API calls related to Workspaces (Kong Gateway Enterprise only). (Default: false)

--timeout

Set a request timeout for the client to connect with Kong (in seconds). (Default: 10)

--tls-client-cert

PEM-encoded TLS client certificate to use for authentication with Kong’s Admin API. This value can also be set using DECK_TLS_CLIENT_CERT environment variable. Must be used in conjunction with tls-client-key

--tls-client-cert-file

Path to the file containing TLS client certificate to use for authentication with Kong’s Admin API. This value can also be set using DECK_TLS_CLIENT_CERT_FILE environment variable. Must be used in conjunction with tls-client-key-file

--tls-client-key

PEM-encoded private key for the corresponding client certificate . This value can also be set using DECK_TLS_CLIENT_KEY environment variable. Must be used in conjunction with tls-client-cert

--tls-client-key-file

Path to file containing the private key for the corresponding client certificate. This value can also be set using DECK_TLS_CLIENT_KEY_FILE environment variable. Must be used in conjunction with tls-client-cert-file

--tls-server-name

Name to use to verify the hostname in Kong’s Admin TLS certificate. This value can also be set using DECK_TLS_SERVER_NAME environment variable.

--tls-skip-verify

Disable verification of Kong’s Admin TLS certificate. This value can also be set using DECK_TLS_SKIP_VERIFY environment variable. (Default: false)

--verbose

Enable verbose logging levels Setting this value to 2 outputs all HTTP requests/responses between decK and Kong. (Default: 0)

See also

File subcommands:

• deck file add-plugins - Add plugins to objects in a decK file
• deck file add-tags - Add tags to objects in a decK file
• deck file convert - Convert files from one format into another format
• deck file kong2kic - Convert decK state files to Kong Ingress Controller kubernetes manifests.
• deck file kong2tf - Convert decK state files to Terraform resources.
• deck file lint - Validate a file against a ruleset
• deck file list-tags - List current tags from objects in a decK file
• deck file merge - Merge multiple decK files into one
• deck file namespace - Apply a namespace to routes in a decK file by prefixing the path.
• deck file openapi2kong - Convert OpenAPI specifications to Kong’s decK format
• deck file patch - Apply patches on top of a decK file
• deck file remove-tags - Remove tags from objects in a decK file
• deck file render - Combines multiple complete configuration files and renders them as one Kong declarative config file.
• deck file validate - Locally validates the state file for basic structure or relationship errors.