Documentation and landing page for the KEDA project at https://keda.sh.

Are you using KEDA in production? Do you want to become a listed user? Say no more!

You can easily get listed by following these steps:

1. Upload your logo to static/img/logos/ (350x180)
2. Configure your company as a new user in config.toml (sorted alphabetically)

[[params.users]]
url = "https://coralogix.com/"
logo = "coralogix.gif"

Here's a good example of Coralogix becoming a listed user!

To run local site previews, you must install Hugo (the "extended" version with Hugo Pipes support) and Yarn.

1. Install Go, node and npm

2. Install Yarn:

   npm install --global yarn

3. Install Hugo:

   cd %HOME/src
   git clone https://github.com/gohugoio/hugo.git
   cd hugo
   go install --tags extended

1. Install Hugo:

   choco install hugo-extended

2. Install Yarn:

   choco install yarn

1. Install Hugo:

   brew install hugo

2. Install Yarn:

   brew install yarn

1. Fork the keda-docs repository.

2. Clone the fork.

3. Navigate to your cloned repository and run the commands:

   yarn

   hugo server -D -F

   The Web Server is available at http://localhost:1313/.

The KEDA website is published automatically by Netlify. Any time changes to this repo are pushed to master, the site is re-built and re-published in roughly two minutes.

To add a new post to the KEDA blog:

hugo new blog/my-new-post.md

This creates a boilerplate Markdown file in content/blog/my-new-post.md whose contents you can modify. The following fields are required:

• title
• date (in YYYY-MM-DD format)
• author

To add documentation for a new KEDA scaler:

hugo new --kind scaler docs/<VERSION>/scalers/my-new-scaler.md

This creates a boilerplate Markdown file in content/docs/<VERSION>/scalers/my-new-scaler.md whose contents you can modify. Make sure to update the following metadata fields:

• title
• availability
• maintainer
• description

In order to maintain the style consistency across different scalers, all the parameters which are listed have to be written using this convention:

• name - Description. (Values: x, y, z, Default: y, Optional, Extra Info)

If a parameter is required or doesn't have defined/default values, the missing info should be removed from the pattern.

Here are a few examples:

• targetMetricValue - Target value for your metric.
• metricFilter - Aggregation method of the metric. (Values: max, min, average, sum, variance, Default: average, Optional)
• metricPeriod - Granularity of the metric. (Default: 300, Optional)
• subscriptionName - Name of the Azure Service Bus queue to scale on. (Optional, Required when topicName is specified)

To update the KEDA FAQ page, update the TOML file at [data/faq20.toml]. Here's an example question/answer pair:

[[qna]]
q = "How can I add a new question/answer pair?"
a = "You're looking at it! 😀"

To add a new section to the troubleshooting page:

hugo new troubleshooting/<VERSION>/my-new-issue.md

To adjust the order in which the troubleshooting tiles appear, use the weight parameter in each page's metadata.

The KEDA documentation is versioned. Each version has its own subdirectory under content/docs. To add a new version, copy the directory for the most recent version. Here's an example:

cp -rf content/docs/<CurrentVersion> content/docs/<NewVersion>

By default, new documentation versions are not listed as available version so it's safe to make changes to them. After every release, the version will be published as new version.

Once a version is ready to be published, we must add the version to the params.versions.docs list in config.toml.

More recent versions should be placed first in the list (ordering does matter because the first element in that list is considered the latest version).