Redis String Increment

Redis String Increment

Certified

Increment a Redis string number

Runs INCR, INCRBY, or INCRBYFLOAT on the rendered key depending on the amount type, and can apply an expiration (absolute or relative, not both).

yaml
type: io.kestra.plugin.redis.string.Increment
yaml
id: redis_increment
namespace: company.team

inputs:
    - id: key_name
      type: STRING
      displayName: Key name to increment

tasks:
  - id: increment
    type: io.kestra.plugin.redis.string.Increment
    url: redis://:redis@localhost:6379/0
    key: "{{ inputs.key_name }}"
Installation

Our standard Docker images already include this plugin. If you use a -slim image or another setup, install it with the following command:

kestractl plugins get io.kestra.plugin:plugin-redis --compatible-for $KESTRA_VERSION

For kestractl, use your Kestra version with --compatible-for, or specify an exact plugin version.

For Kestra CLI, replace LATEST with a specific version or version range to pin the plugin version.

Properties

Redis key to increment

Rendered before the increment command.

Redis connection string

Increment amount

Optional, defaults to 1. A whole number (for example 2) uses INCRBY and needs the key to hold an integer. Write a decimal (for example 2.0) to use INCRBYFLOAT.

Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

Asset failure behavior

Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150

Expiration options

Optional TTL settings; choose either duration or absolute date.

Definitions
expirationDatestring

Expiration date

Absolute timestamp; cannot be combined with expirationDuration.

expirationDurationstring

Expiration duration

Relative TTL; cannot be combined with expirationDate.

Incremented key

Incremented value

A Long when the increment used INCR/INCRBY, a Double when it used INCRBYFLOAT.