-
decK
This page is an introduction to decK, a command line tool for API Lifecycle Automation.
-
Get started with decK
Learn how to install decK and use it to configure Kong Gateway
-
decK configuration
Configure decK using CLI flags, environment variables, or a configuration file
-
decK security
decK can be used to configure RBAC rules in Kong Gateway Enterprise
-
decK version support
The decK version support policy outlines the decK versioning scheme and version lifecycle.
All decK Documentation
Overview
Install & Configure
-
Install decK on Windows
Install a binary package on Windows
-
Install decK on MacOS
Use Homebrew to install decK
-
Install decK on Linux
Install a .deb or .rpm package, or install a binary
-
Run decK using Docker
Create an alias to run deck via Docker
-
Use decK with GitHub Actions
Use the kong/setup-deck action to run in CI/CD
-
Configuring on-prem authentication
Configure decK for use with an on-prem Kong Gateway
-
Configuring Konnect
Configure decK for use with Konnect.
Gateway
-
Overview
Manage Kong Gateway declaratively
-
deck gateway diff
Diff the current state of Kong Gateway against the provided configuration.
-
deck gateway sync
Update Kong Gateway to match the state defined in the provided configuration.
-
deck gateway dump
Export the current state of Kong Gateway to a file.
-
deck gateway apply
Apply configuration to Kong without deleting existing entities.
-
deck gateway validate
Validate the data in the provided state file against a live Admin API.
-
deck gateway ping
Verify that decK can talk to the configured Admin API.
-
deck gateway reset
Delete all entities in Kong Gateway.
Advanced Gateway Configuration
-
Select tags and lookup tags
Segment your configuration in to multiple files using tags.
-
Workspaces
Manage configuration in multiple Workspaces.
-
Manage RBAC roles
Configure your RBAC configuration declaratively with decK.
-
De-duplicate plugin configuration
Reference predefined Plugin configurations in your declarative configuration.
-
Object defaults
Set custom defaults for Kong Gateway entities.
-
Managing sensitive data
Keep your secrets safe using Kong Gateway Vaults with decK.
File Manipulation
-
decK file overview
Manipulate a decK configuration file programmatically. Layer in additional configuration and lint against your governance rules.
-
deck file validate
Validate your declarative configuration locally against predefined schemas
-
deck file lint
Validate your decK configuration file against predefined rules.
-
deck file openapi2kong
Convert an OpenAPI specification to Kong Services and Routes.
-
deck file kong2kic
Convert a Kong declarative configuration file to Kong Ingress Controller compatible CRDs. Supports both Gateway API and Ingress resources.
-
deck file kong2tf
Convert a Kong declarative configuration file to Terraform manifests (Konnect only).
-
deck file patch
Update values in a Kong declarative configuration file.
-
deck file add-plugins
Manage plugin configurations in a Kong declarative configuration file.
-
deck file *-tags
Manage tags in a Kong declarative configuration file.
-
deck file namespace
Apply a namespace to Routes in a decK file by path or hostname.
-
deck file render
Render the final configuration sent to the Admin API in a single file.
-
deck file merge
Merge multiple files in to a single file, leaving env variables in place.
-
deck file convert
Convert decK files from one format to another, for example Kong Gateway 2.x to 3.x
APIOps
-
APIOps
Manage Kong Gateway declaratively
-
Continuous integration with decK
Run decK in CI/CD systems
-
Federated configuration with decK
Allow independent teams to manage their own configuration in a distributed way
Reference
-
Entities managed by decK
Understand which entities decK can manage
-
Environment variables for decK
Use environment variables to provide runtime configuration
-
Upgrade to Kong Gateway 3.x with decK
Use decK to upgrade from Kong Gateway 2.x to 3.x