Overview
StackExchange.Redis is a high performance general purpose redis client for .NET languages (C#, etc.), and is designed for Windows / .NET SDK environments.
On other hand, it is possible now install .NET SDK and run PowerShell commands on Linux environments.
This article describes how to install and link all together to have a Linux environment to run some commands and connect to any Redis service using StackExchange.Redis client library.
This can be used for test proposes, and there are no support to run this on production.
Try and test this at your own risk and responsibility.
This was tested on Linux Ubuntu v20.04.02 LTS, .NET SDK v7.0.403, Stackexchange.Redis v2.7.4, and PowerShell v7.3.9.0.
There are no guarantees this will work with all scenarios and versions.
StackExchange.Redis features
StackExchange.Redis implementation on Linux Ubuntu
To have a working scenario on a Linux VM , be able to connect to some Redis server using StackExchange.Redis client library, follow these steps:
wget -q https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
Open a terminal and run the following commands to install the .NET Core SDK on your Ubuntu 20.04 system.
You can also choose a different version of the .NET SDK, but version 3.1, is compatible with StackExchange.Redis.
sudo apt update
sudo apt install -y dotnet-sdk-3.1
Create a directory for your project, navigate to it, and create a PowerShell script file with a .ps1 extension.
mkdir my-redis-project
cd my-redis-project
touch connect-redis.ps1
This will create a basic .NET Core console application and add the StackExchange.Redis package to your project.
sudo dotnet new console
sudo dotnet add package StackExchange.Redis
Open the connect-redis.ps1 script in a text editor (ex: vi) and add your PowerShell code to connect to the Redis server, using the StackExchange.Redis library.
# Load the StackExchange.Redis library
Add-Type -Path "/home/<user>/my-redis-project/bin/Debug/net7.0/StackExchange.Redis.dll"
# see note (**) below to find StackExchange.Redis.dll location
# Define the Redis server endpoint and SSL port used (example for Azure Cahe for Redis service)
$redisServerEndpoint = "<redisName>.redis.cache.windows.net:6380"
# Create a ConfigurationOptions instance to configure the connection
# https://stackexchange.github.io/StackExchange.Redis/Configuration.html#configuration-options
$redisConfig = New-Object StackExchange.Redis.ConfigurationOptions
$redisConfig.EndPoints.Add($redisServerEndpoint)
$redisConfig.Password = "<redisAccessKey>" # Replace with your actual Redis password
# Create a connection to the Redis server
$redisConnection = [StackExchange.Redis.ConnectionMultiplexer]::Connect($redisConfig)
# Get a reference to the Redis database (by default, database 0)
$redisDatabase = $redisConnection.GetDatabase()
# Perform Redis operations
$redisDatabase.StringSet("mykey", "Hello, Redis from Linux PowerShell!")
$value = $redisDatabase.StringGet("mykey")
Write-Host "Redis Value: $value"
# Close the connection
$redisConnection.Close()
pwsh connect-redis.ps1
Useful commands:
To check Linux distribution and version:
lsb_release -a
To check PowerShell installed version:
pwsh -version
To check installed .NET SDKs on your system:
dotnet --list-sdks
To check Stackexchange.Redis installed version:
sudo dotnet new console
sudo dotnet list package
To check default .NET SDK version
sudo dotnet --version
To rebuild your project, if needed, and to check the path for StackExchange.Redis.dll provided in the PS script (**)
sudo dotnet build
(**) You should obtain something like this:
my-redis-project -> /home/<user>/my-redis-project/bin/Debug/net7.0/my-redis-project.dll
StackExchange.Redis.dll should be in the same path
Install the required .NET dependencies, if needed:
sudo dotnet restore
Check the .ps1 file content for any typo:
cat ./connect-redis.ps1
Update StackExchange.Redis, if needed:
sudo dotnet add package StackExchange.Redis --version <new_version>
Conclusion:
Despite the target of this article describes not being to deploy solutions for production environments, this is a good way to test connectivity and run some Redis commands on a Redis service, from Linux environments, using Stackexchange.Redis client library.
I hope this can be useful!!!
Related documentation:
StackExchange.Redis versions
StackExchange.Redis release notes
Installing PowerShell on Ubuntu - PowerShell | Microsoft Learn
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.