redis-enterprise 0.10.0

Redis Enterprise REST API client library
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90

# Docker Compose for local Redis Enterprise testing
#
# Usage:
#   docker compose up -d              # Start Redis Enterprise
#   docker compose --profile init up init  # Initialize cluster (run once after first start)
#   docker compose down -v            # Stop and remove
#
# Environment variables (optional):
#   REDIS_ENTERPRISE_IMAGE - Docker image (default: redislabs/redis:8.2.0-25.12)
#   REDIS_ENTERPRISE_DB_PORT - Host port mapped to the default database port (default: 12000)
#   REDIS_ENTERPRISE_API_PORT - Host port mapped to the REST API (default: 9443)
#   REDIS_ENTERPRISE_UI_PORT - Host port mapped to the admin UI (default: 8443)
#   REDISCTL_IMAGE - Cluster initializer image (defaults to the reviewed digest below)
#
# After initialization:
#   API:      https://localhost:9443 (admin@redis.local / Redis123!)
#   Web UI:   https://localhost:8443
#   Database: localhost:12000

services:
  redis-enterprise:
    image: ${REDIS_ENTERPRISE_IMAGE:-redislabs/redis:8.2.0-25.12}
    tty: true
    cap_add:
      - ALL
    ports:
      - "${REDIS_ENTERPRISE_DB_PORT:-12000}:12000"    # Default database port
      - "${REDIS_ENTERPRISE_API_PORT:-9443}:9443"     # REST API
      - "${REDIS_ENTERPRISE_UI_PORT:-8443}:8443"      # Admin UI
    healthcheck:
      test: ["CMD", "curl", "-f", "-k", "https://localhost:9443/v1/bootstrap"]
      interval: 5s
      timeout: 3s
      retries: 5
      start_period: 10s

  init:
    image: ${REDISCTL_IMAGE:-ghcr.io/redis-developer/redisctl@sha256:2d8b5148226705ae4c057611c4adcd2c9ba08cac0c02cec1c449fc31b92a2026}
    depends_on:
      redis-enterprise:
        condition: service_healthy
    environment:
      REDIS_ENTERPRISE_URL: "https://redis-enterprise:9443"
      REDIS_ENTERPRISE_USER: "admin@redis.local"
      REDIS_ENTERPRISE_PASSWORD: "Redis123!"
      REDIS_ENTERPRISE_INSECURE: "true"
      REDIS_ENTERPRISE_DATABASE_VERSION: "${REDIS_ENTERPRISE_DATABASE_VERSION:-}"
    entrypoint: ["/bin/sh", "-ec"]
    command:
      - |
        redisctl enterprise workflow init-cluster \
          --name test-cluster \
          --username admin@redis.local \
          --password 'Redis123!' \
          --skip-database

        database_data='{"name":"default-db","memory_size":1073741824,"type":"redis","replication":false}'
        if [ -n "$$REDIS_ENTERPRISE_DATABASE_VERSION" ]; then
          database_data=$$(printf \
            '{"name":"default-db","memory_size":1073741824,"type":"redis","replication":false,"redis_version":"%s"}' \
            "$$REDIS_ENTERPRISE_DATABASE_VERSION")
        fi
        create_attempt=0
        until redisctl enterprise database create --data "$$database_data" --output json > /dev/null; do
          create_attempt=$$((create_attempt + 1))
          if [ "$$create_attempt" -ge 60 ]; then
            echo "Required disposable database could not be created" >&2
            exit 1
          fi
          echo "Database create is not ready; retrying in 5 seconds"
          sleep 5
        done

        attempt=0
        while [ "$$attempt" -lt 120 ]; do
          databases=$$(redisctl enterprise database list --output json)
          shards=$$(redisctl enterprise shard list --output json)
          if echo "$$databases" | grep -Eq '"status"[[:space:]]*:[[:space:]]*"active"' \
            && echo "$$shards" | grep -Eq '"uid"[[:space:]]*:'; then
            echo "Disposable database and shard are ready"
            exit 0
          fi
          attempt=$$((attempt + 1))
          sleep 5
        done

        echo "Required disposable database and shard did not become ready" >&2
        exit 1
    profiles:
      - init