Redis*

In this tutorial, you’ll install Redis and launch a Redis-server on Clear Linux* OS. We invite you to pull our Clear Linux Redis instance on dockerhub* for application or infrastructure development.

Description

Redis is an in-memory key:value store designed for quick lookups, accessible over a network. While the redis data structure store can serve as a NoSQL database for a web application, it’s also easy to integrate into an existing stack. For example, you could use the Redis caching layer for real-time responses on a leaderboard in a gaming app. Redis offers many client libraries with language-specific bindings for Python*, Perl*, Ruby, and more.

Prerequisites

  • Install the redis-native bundle in Clear Linux OS

  • Install the containers-basic bundle in Clear Linux OS (only required in Example 2)

Install the Redis bundle

In Clear Linux OS, find Redis in the redis-native bundle.

  1. Open a terminal and login as an administrative user.

  2. Add redis-native.

    sudo swupd bundle-add redis-native

    Note

    If the bundle already exists, no action is required.

Start the Redis-server

A systemd service unit is available to control the Redis-server. By default, Redis runs on port 6379.

  1. Start the service.

    systemctl start redis

    Note

    To stop Redis, run systemctl stop redis.

  2. Confirm the service is running.

    systemctl status redis

  3. Verify that the Redis-server sends a reply.

    redis-cli ping

    Note

    Expected output: PONG.

  4. Optional: If you wish to apply the advanced configuration, copy the redis.conf into /etc/ directory.

    sudo cp /usr/share/defaults/etc/redis.conf /etc/

The Redis-server is now ready to use on Clear Linux OS. Try some of the examples shown below.

Example 1: Use the redis-cli and commands

One advantage of Redis over other NoSQL databases is that developers can easily access data structures like lists, sets, sorted sets, strings, and hashes using collection operations commands similar to those found in many programming languages. These exercises are inspired by try redis io.

After your Redis-server is running, try some basic commands.

  1. Enter the redis-cli. It provides syntax suggestions as you type.

    redis-cli

  2. SET a key to hold a string value. In the set, create connections and increment.

    SET server:name "clearlinux"

    MGET server:name

    Note

    If the key does not exist or hold a key value, nil is returned.

    SET connections 100

    INCR connections

    INCR connections

    DEL connections

  3. Create a friends list and insert new values at the end of the list.

    RPUSH friends "Deb"

    RPUSH friends "David"

    RPUSH friends "Mary"

  4. Modify the friends list, using a common slice method with a 0-index.

    LRANGE friends 0 1

    LLEN friends

    LPOP friends

    RPOP friends

    LLEN friends

  5. Consider using a hash, which maps string fields and string values, and offers multiple lookup methods.

    Enter many user key:values with HMSET. Then try HGET and HGETALL.

    HMSET user:1000 name "Robert Noyce" password "SuperEngi9eer" email "robert.noyce@intel.com"

    HGET user:1000 name

    HGET user:1000 email

    HGETALL user:1000

Example 2: Run the Clear Linux OS Redis Docker* image

We also provide a Clear Linux Redis instance, which is updated continuously and maintained by Clear Linux OS development.

sudo swupd bundle-add containers-basic

sudo systemctl start docker

sudo -E docker pull clearlinux/redis

Next Steps