Yandex Cloud
Поиск
Связаться с намиПопробовать бесплатно
  • Истории успеха
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
  • Marketplace
    • Доступны в регионе
    • Инфраструктура и сеть
    • Платформа данных
    • Искусственный интеллект
    • Безопасность
    • Инструменты DevOps
    • Бессерверные вычисления
    • Управление ресурсами
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Партнёрская программа
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Калькулятор цен
    • Тарифы
    • Акции и free tier
  • Истории успеха
  • Документация
  • Блог
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ТОО «Облачные Сервисы Казахстан»
Yandex Managed Service for Valkey™
  • Начало работы
    • Все инструкции
      • Предварительная настройка
      • FQDN хостов
      • Подключение из приложений
        • Обзор
        • Примеры для подключения к нешардированному кластеру
        • Примеры для подключения к шардированному кластеру
  • Управление доступом
  • Правила тарификации
  • Справочник Terraform
  • Метрики Monitoring
  • Аудитные логи Audit Trails
  • Публичные материалы
  • История изменений
  • Вопросы и ответы

В этой статье:

  • C#
  • Go
  • Java
  • Node.js
  • PHP
  • Python
  • Ruby
  1. Пошаговые инструкции
  2. Подключение
  3. Примеры кода
  4. Примеры для подключения к шардированному кластеру

Примеры кода для подключения к шардированному кластеру Valkey™

Статья создана
Yandex Cloud
Обновлена 29 января 2026 г.
  • C#
  • Go
  • Java
  • Node.js
  • PHP
  • Python
  • Ruby

C#C#

Перед подключением:

  1. Установите зависимости:

    sudo apt update && sudo apt install --yes apt-transport-https dotnet-sdk-6.0
    
  2. Создайте директорию для проекта:

    cd ~/ && mkdir cs-project && cd cs-project
    
  3. Создайте конфигурационный файл:

    RedisClient.csproj
    <Project Sdk="Microsoft.NET.Sdk">
      <PropertyGroup>
        <OutputType>Exe</OutputType>
        <TargetFramework>net6.0</TargetFramework>
      </PropertyGroup>
      <ItemGroup>
        <PackageReference Include="StackExchange.Redis" Version="2.8.58" />
      </ItemGroup>
    </Project>
    
  4. Для подключения с SSL получите SSL-сертификат.

Подключение без SSL
Подключение с SSL

Program.cs

using System;
using System.Threading.Tasks;
using StackExchange.Redis;

namespace RedisClient
{
    class Program
    {
        // Configuration constants
        private const string TEST_KEY = "test-key";
        private const string TEST_VALUE = "test-value";
        private const string USERNAME = "default";
        private const string PASSWORD = "<пароль>";

        static async Task<int> Main(string[] args)
        {
            try
            {
                var masterOptions = new ConfigurationOptions
                {
                    EndPoints = {
                        "<FQDN_хоста-мастера_в_шарде_1>:6379",
                        ...
                        "<FQDN_хоста-мастера_в_шарде_N>:6379"
                    },
                    User = USERNAME,
                    Password = PASSWORD
                };

                var connection = await ConnectionMultiplexer.ConnectAsync(masterOptions);

                var db = connection.GetDatabase();

                // Send SET command
                bool setResult = await db.StringSetAsync(TEST_KEY, TEST_VALUE);
                if (!setResult)
                {
                    Console.WriteLine($"SET failed for key {TEST_KEY}");
                    return 1;
                }
                Console.WriteLine($"Successfully set {TEST_KEY} = {TEST_VALUE}");

                // Send GET command
                var getResult = await db.StringGetAsync(TEST_KEY);
                if (!getResult.HasValue)
                {
                    Console.WriteLine($"GET failed: Key {TEST_KEY} not found");
                    return 1;
                }

                string retrievedValue = getResult.ToString();
                if (retrievedValue != TEST_VALUE)
                {
                    Console.WriteLine($"GET failed. Expected: '{TEST_VALUE}', Actual: '{retrievedValue}'");
                    return 1;
                }
                Console.WriteLine($"Successfully retrieved {TEST_KEY} = {retrievedValue}");

            return 0;
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Operation failed: {ex.Message}");
            return 1;
        }
        }
    }    
}

Program.cs

using System;
using System.Threading.Tasks;
using System.Net.Security;
using System.Security.Authentication;
using System.Security.Cryptography.X509Certificates;
using StackExchange.Redis;

namespace RedisClient
{
    class Program
    {
        // Configuration constants
        private const string TEST_KEY = "test-key";
        private const string TEST_VALUE = "test-value";
        private const string USERNAME = "default";
        private const string PASSWORD = "<пароль>";
        private const string CERT = "/home/<домашняя_директория>/.redis/YandexInternalRootCA.crt"            

        static async Task<int> Main(string[] args)
        {
            try
            {
                var masterOptions = new ConfigurationOptions
                {
                    EndPoints = {
                        "<FQDN_хоста-мастера_в_шарде_1>:6380",
                        ...
                        "<FQDN_хоста-мастера_в_шарде_N>:6380"
                    },
                    User = USERNAME,
                    Password = PASSWORD,
                    Ssl = true
                };
                masterOptions.CertificateValidation += (
                    object sender,
                    X509Certificate? certificate,
                    X509Chain? chain,
                    SslPolicyErrors sslPolicyErrors) =>
                {
                    if (certificate == null) {
                        return false;       
                    }
                    var ca = new X509Certificate2(CERT);
                    bool verdict = (certificate.Issuer == ca.Subject);
                    if (verdict) {
                        return true;
                    }
                    Console.WriteLine("Certificate error: {0}", sslPolicyErrors);
                    return false;
                }

                var connection = await ConnectionMultiplexer.ConnectAsync(masterOptions);

                var db = connection.GetDatabase();

                // Send SET command
                bool setResult = await db.StringSetAsync(TEST_KEY, TEST_VALUE);
                if (!setResult)
                {
                    Console.WriteLine($"SET failed for key {TEST_KEY}");
                    return 1;
                }
                Console.WriteLine($"Successfully set {TEST_KEY} = {TEST_VALUE}");

                // Send GET command
                var getResult = await db.StringGetAsync(TEST_KEY);
                if (!getResult.HasValue)
                {
                    Console.WriteLine($"GET failed: Key {TEST_KEY} not found");
                    return 1;
                }

                string retrievedValue = getResult.ToString();
                if (retrievedValue != TEST_VALUE)
                {
                    Console.WriteLine($"GET failed. Expected: '{TEST_VALUE}', Actual: '{retrievedValue}'");
                    return 1;
                }
                Console.WriteLine($"Successfully retrieved {TEST_KEY} = {retrievedValue}");

            return 0;
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Operation failed: {ex.Message}");
            return 1;
        }
        }
    }    
}

О том, как получить FQDN хоста, см. инструкцию.

Подключение:

cd ~/cs-project && \
dotnet build && dotnet run bin/Debug/net6.0/RedisClient

При успешном подключении к кластеру и выполнении тестового запроса будут выведены строки:

Successfully set test-key = test-value
Successfully retrieved test-key = test-value

GoGo

Перед подключением установите зависимости:

sudo apt update && sudo apt install --yes golang git && \
go mod init github.com/go-redis/redis && \
go get github.com/redis/go-redis/v9
Подключение без SSL
Подключение с SSL

connect.go

package main

import (
	"fmt"
	"github.com/go-redis/redis/v7"
	"time"
)

func main() {
	hostports := []string{
		"<FQDN_хоста-мастера_в_шарде_1>:6379",
		...
		"<FQDN_хоста-мастера_в_шарде_N>:6379",
	}
	options := redis.UniversalOptions{
		Addrs:       hostports,
		DB:          0,
		ReadOnly:    false,
		DialTimeout: 5 * time.Second,
		Password:    "<пароль>",
	}
	client := redis.NewUniversalClient(&options)

	err := client.Set("foo", "bar", 0).Err()
	if err != nil {
		panic(err)
	}

	result, err := client.Get("foo").Result()
	if err != nil {
		panic(err)
	}
	fmt.Println(result)

	client.Close()
}

connect.go

package main

import (
    "context"
    "crypto/tls"
    "crypto/x509"
    "fmt"
    "net"
    "os"
    "strings"
    "time"

    "github.com/redis/go-redis/v9"
)

func main() {
    caCert, err := os.ReadFile("/home/<домашняя_директория>/.redis/YandexInternalRootCA.crt")
    if err != nil {
        panic(err)
    }
    caCertPool := x509.NewCertPool()
    caCertPool.AppendCertsFromPEM(caCert)

    hostports := []string{
        "<FQDN_хоста-мастера_в_шарде_1>:6380",
        ...
        "<FQDN_хоста-мастера_в_шарде_N>:6380",
    }
    options := redis.UniversalOptions{
        Addrs:        hostports,
        MaxRedirects: 1,
        Password:     "password",
        DB:           0,
        ReadOnly:     false,
        DialTimeout:  5 * time.Second,
        TLSConfig: &tls.Config{
            RootCAs:            caCertPool,
            ServerName: "c-<идентификатор_кластера>.rw.mdb.yandexcloud.kz",
            VerifyPeerCertificate: func(rawCerts [][]byte, verifiedChains [][]*x509.Certificate) error {
                certs := make([]*x509.Certificate, len(rawCerts))
                for i := 0; i < len(rawCerts); i++ {
                    cert, err := x509.ParseCertificate(rawCerts[i])
                    if err != nil {
                        return fmt.Errorf("error parsing certificate: %+v", err)
                    }
                    certs[i] = cert
                }

                opts := x509.VerifyOptions{
                    Roots:         caCertPool,
                    CurrentTime:   time.Now(),
                    DNSName:       "",
                    Intermediates: x509.NewCertPool(),
                }

                for i := range certs {
                    if i == 0 {
                        continue
                    }
                    opts.Intermediates.AddCert(certs[i])
                }
                _, err := certs[0].Verify(opts)
                return err
            },
        },
    }
    options.Dialer = func(ctx context.Context, network, addr string) (net.Conn, error) {
        parts := strings.Split(addr, ":")
        newAddr := addr
        if len(parts) > 1 && !strings.HasPrefix(parts[0], "[") {
            newAddr = "[" + strings.Join(parts[:len(parts)-1], ":") + "]:" + parts[len(parts)-1]
        }

        netDialer := &net.Dialer{
            Timeout:   options.DialTimeout,
            KeepAlive: 5 * time.Minute,
        }
        return tls.DialWithDialer(netDialer, network, newAddr, options.TLSConfig)
    }

    ctx := context.Background()

    client := redis.NewUniversalClient(&options)
    err = client.Set(ctx, "foo", "bar", 0).Err()
    if err != nil {
        panic(err)
    }

    get := client.Get(ctx, "foo")
    err = get.Err()
    if err != nil {
        panic(err)
    }
    fmt.Println(get.String())
}

О том, как получить FQDN хоста, см. инструкцию.

Подключение:

go run connect.go

При успешном подключении к кластеру и выполнении тестового запроса будет выведена строка bar.

JavaJava

Перед подключением:

  1. Установите зависимости:

    sudo apt update && sudo apt install --yes default-jdk maven
    
  2. Создайте директорию для проекта Maven:

    cd ~/ && mkdir --parents project/src/java/com/example && cd project/
    
  3. Создайте конфигурационный файл для Maven:

    pom.xml
    <?xml version="1.0" encoding="utf-8"?>
    <project xmlns="http://maven.apache.org/POM/4.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    
      <modelVersion>4.0.0</modelVersion>
      <groupId>com.example</groupId>
      <artifactId>app</artifactId>
      <packaging>jar</packaging>
      <version>0.1.0</version>
      <properties>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
      </properties>
      <dependencies>
        <dependency>
          <groupId>redis.clients</groupId>
          <artifactId>jedis</artifactId>
          <version>3.7.0</version>
        </dependency>
        <dependency>
          <groupId>org.slf4j</groupId>
          <artifactId>slf4j-simple</artifactId>
          <version>1.7.30</version>
        </dependency>
      </dependencies>
      <build>
        <finalName>${project.artifactId}-${project.version}</finalName>
        <sourceDirectory>src</sourceDirectory>
        <resources>
          <resource>
            <directory>src</directory>
          </resource>
        </resources>
        <plugins>
          <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-assembly-plugin</artifactId>
            <executions>
              <execution>
                <goals>
                  <goal>attached</goal>
                </goals>
                <phase>package</phase>
                <configuration>
                  <descriptorRefs>
                    <descriptorRef>
                    jar-with-dependencies</descriptorRef>
                  </descriptorRefs>
                  <archive>
                    <manifest>
                      <mainClass>com.example.App</mainClass>
                    </manifest>
                  </archive>
                </configuration>
              </execution>
            </executions>
          </plugin>
          <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <version>3.1.0</version>
            <configuration>
              <archive>
                <manifest>
                  <mainClass>com.example.App</mainClass>
                </manifest>
              </archive>
            </configuration>
          </plugin>
        </plugins>
      </build>
    </project>
    

    Актуальные версии зависимостей для Maven:

    • jedis
    • slf4j-simple
  4. Для подключения с SSL:

    1. Получите SSL-сертификат.

    2. Создайте защищенное хранилище сертификатов:

      keytool -importcert \
              -alias YARootCrt \
              -file ~/.redis/YandexInternalRootCA.crt \
              -keystore ~/.redis/YATrustStore \
              -storepass <пароль_защищенного_хранилища> \
              --noprompt && chmod 0655 ~/.redis/YATrustStore
      
Подключение без SSL
Подключение с SSL

src/java/com/example/App.java

package com.example;

import java.util.HashSet;
import redis.clients.jedis.HostAndPort;
import redis.clients.jedis.JedisCluster;
import redis.clients.jedis.JedisPoolConfig;

public class App {
  public static void main(String[] args) {
    JedisPoolConfig jedisPoolConfig = new JedisPoolConfig();

    HashSet<HostAndPort> jedisClusterNodes = new HashSet<HostAndPort>();
    jedisClusterNodes.add(new HostAndPort("<FQDN_хоста-мастера_в_шарде_1>", 6379));
    ...
    jedisClusterNodes.add(new HostAndPort("<FQDN_хоста-мастера_в_шарде_N>", 6379));

    DefaultJedisClientConfig jedisClientConfig = DefaultJedisClientConfig.builder().
            password("<пароль>").
            build();

    try {
      JedisCluster jc = new JedisCluster(jedisClusterNodes, jedisClientConfig, 5, jedisPoolConfig);

      jc.set("foo", "bar");
      System.out.println(jc.get("foo"));
      jc.close();
    } catch (Exception ex) {
      ex.printStackTrace();
    }
  }
}

src/java/com/example/App.java

package com.example;

import redis.clients.jedis.DefaultJedisClientConfig;
import redis.clients.jedis.HostAndPort;
import redis.clients.jedis.JedisCluster;
import redis.clients.jedis.JedisPoolConfig;

import javax.net.ssl.SSLParameters;
import java.util.HashSet;
import java.util.Set;

public class App {
  public static void main(String[] args) {
    System.setProperty("javax.net.ssl.trustStore", "/home/<домашняя_директория>/.redis/YATrustStore");
    System.setProperty("javax.net.ssl.trustStorePassword", "<пароль_защищенного_хранилища_сертификатов>");

    JedisPoolConfig jedisPoolConfig = new JedisPoolConfig();
    Set<HostAndPort> jedisClusterNodes = new HashSet<HostAndPort>();
    SSLParameters sslParameters = new SSLParameters();
    jedisClusterNodes.add(new HostAndPort("<FQDN_хоста-мастера_в_шарде_1>", 6380));
    ...
    jedisClusterNodes.add(new HostAndPort("<FQDN_хоста-мастера_в_шарде_N>", 6380));

    DefaultJedisClientConfig jedisClientConfig = DefaultJedisClientConfig.builder().
            password("<пароль_кластера>").
            ssl(true).
            sslParameters(sslParameters).
            build();

    try {
      JedisCluster jc = new JedisCluster(jedisClusterNodes, jedisClientConfig, 5, jedisPoolConfig);

      jc.set("foo", "bar");
      System.out.println(jc.get("foo"));
      jc.close();
    } catch (Exception ex) {
      ex.printStackTrace();
    }
  }
}

О том, как получить FQDN хоста, см. инструкцию.

Подключение:

mvn clean package && \
java -jar target/app-0.1.0-jar-with-dependencies.jar

При успешном подключении к кластеру и выполнении тестового запроса будет выведена строка bar.

Node.jsNode.js

Перед подключением установите зависимости:

sudo apt update && sudo apt install --yes nodejs npm && \
npm install ioredis
Подключение без SSL
Подключение с SSL

app.js

"use strict";

const Redis = require("ioredis");

const cluster = new Redis.Cluster(
    [
        {
            host: "<FQDN_хоста-мастера_в_шарде_1>",
            port: 6379
        },
        ...
        {
            host: "<FQDN_хоста-мастера_в_шарде_N>",
            port: 6379
        }
    ],
    {
        redisOptions: {
            password: "<пароль>"
        }
    }
);

cluster.on("ready", () => {
    Promise.all([
        cluster.set("foo", "bar"),
        cluster.get("foo")
    ]).then(
        (result) => {
            console.log(result[1]); // result == ["OK", "bar"]
            cluster.disconnect();
        },
        (reject) => {
            console.log(reject);
            cluster.disconnect();
        }
    );
});

app.js

"use strict";

const Redis = require("ioredis");
const fs = require("fs");

const cluster = new Redis.Cluster(
    [
        {
            host: "<FQDN_хоста-мастера_в_шарде_1>",
            port: 6380
        },
        ...
        {
            host: "<FQDN_хоста-мастера_в_шарде_N>",
            port: 6380
        },
    ],
    {
        redisOptions: {
            password: "<пароль>",
            tls: {
                ca: [fs.readFileSync("/home/<домашняя_директория>/.redis/YandexInternalRootCA.crt")],
                checkServerIdentity: () => {
                    return null;
                }
            }
        }
    }
);

cluster.on("ready", () => {
    Promise.all([
        cluster.set("foo", "bar"),
        cluster.get("foo")
    ]).then(
        (result) => {
            console.log(result[1]); // result == [ "OK", "bar"]
            cluster.disconnect();
        },
        (reject) => {
             console.log(reject);
             cluster.disconnect();
        }
    );
});

О том, как получить FQDN хоста, см. инструкцию.

Подключение:

node app.js

При успешном подключении к кластеру и выполнении тестового запроса будет выведена строка bar.

PHPPHP

Перед подключением установите зависимости:

sudo apt update && sudo apt install --yes php php-dev php-pear && \
sudo pear channel-discover pear.nrk.io && \
sudo pear install nrk/Predis
Подключение без SSL
Подключение с SSL

connect.php

<?php

require "Predis/Autoloader.php";
Predis\Autoloader::register();

$hosts = [
    "tcp://<FQDN_хоста-мастера_в_шарде_1>:6379",
    ...
    "tcp://<FQDN_хоста-мастера_в_шарде_N>:6379",
];

$options = [
    "cluster" => "redis",
    "parameters" => [
        "password" => "<пароль>",
    ],
];

$conn = new Predis\Client($hosts, $options);
$conn->set("foo", "bar");

var_dump($conn->get("foo"));

$conn->disconnect();
?>

connect.php

<?php

require "Predis/Autoloader.php";
Predis\Autoloader::register();

$hosts = [
    'tls://<FQDN_хоста-мастера_в_шарде_1>:6380?ssl[cafile]=/home/<домашняя_директория>/.redis/YandexInternalRootCA.crt',
    ...
    'tls://<FQDN_хоста-мастера_в_шарде_N>:6380?ssl[cafile]=/home/<домашняя_директория>/.redis/YandexInternalRootCA.crt',
];

$options = [
    'cluster' => 'predis',
    'parameters' => [
        'password' => '<пароль>',
    ],
];

$conn = new Predis\Client($hosts, $options);
$conn->set('foo', 'bar');

var_dump($conn->get("foo"));

$conn->disconnect();
?>

О том, как получить FQDN хоста, см. инструкцию.

Подключение:

php connect.php

При успешном подключении к кластеру и выполнении тестового запроса будет выведена строка bar.

PythonPython

Перед подключением установите зависимости:

sudo apt update && sudo apt install -y python3 python3-pip python3-venv && \
python3 -m venv env && \
source env/bin/activate && \
pip install pip -U && \
pip install pyopenssl redis-py-cluster setuptools_rust
Подключение без SSL
Подключение с SSL

connect.py

from rediscluster import RedisCluster

startup_nodes = [
    {"host": "<FQDN_хоста-мастера_в_шарде_1>", "port": 6379},
    ...
    {"host": "<FQDN_хоста-мастера_в_шарде_N>", "port": 6379},
]

rc = RedisCluster(
    startup_nodes=startup_nodes,
    decode_responses=True,
    skip_full_coverage_check=True,
    password="<пароль>",
)

rc.set("foo", "bar")

print(rc.get("foo"))

connect.py

import OpenSSL
from rediscluster import RedisCluster

startup_nodes = [
    {"host": "<FQDN_хоста-мастера_в_шарде_1>", "port": 6380},
    ...
    {"host": "<FQDN_хоста-мастера_в_шарде_N>", "port": 6380},
]

rc = RedisCluster(
    startup_nodes=startup_nodes,
    decode_responses=True,
    skip_full_coverage_check=True,
    password="<пароль>",
    ssl=True,
    ssl_ca_certs="/home/<домашняя_директория>/.redis/YandexInternalRootCA.crt",
)

rc.set("foo", "bar")

print(rc.get("foo"))

О том, как получить FQDN хоста, см. инструкцию.

Подключение:

python3 connect.py

При успешном подключении к кластеру и выполнении тестового запроса будет выведена строка bar.

RubyRuby

Перед подключением установите зависимости:

sudo apt update && sudo apt install --yes ruby && \
sudo gem install redis
Подключение без SSL
Подключение с SSL

connect.rb

# coding: utf-8

require 'redis'

nodes = [
  { host: '<FQDN_хоста-мастера_в_шарде_1>', port: 6379 },
  ...
  { host: '<FQDN_хоста-мастера_в_шарде_N>', port: 6379 }
]

conn = Redis.new(
   cluster: nodes,
   password: '<пароль>'
)

conn.set('foo', 'bar')
puts conn.get('foo')

conn.close

connect.rb

# coding: utf-8

require 'redis'

nodes = [
  { host: '<FQDN_хоста-мастера_в_шарде_1>', port: 6380 },
  ...
  { host: '<FQDN_хоста-мастера_в_шарде_N>', port: 6380 }
]

conn = Redis.new(
  cluster: nodes,
  password: '<пароль>',
  ssl: true,
  ssl_params: {
    ca_file: '/home/<домашняя_директория>/.redis/YandexInternalRootCA.crt',
    verify_hostname: false
  }
)

conn.set('foo', 'bar')
puts conn.get('foo')

conn.close

О том, как получить FQDN хоста, см. инструкцию.

Подключение:

ruby connect.rb

При успешном подключении к кластеру и выполнении тестового запроса будет выведена строка bar.

Была ли статья полезна?

Предыдущая
Примеры для подключения к нешардированному кластеру
Следующая
Получение информации о пользователях
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ТОО «Облачные Сервисы Казахстан»