Windows 11 Docker Redis 최신 버전 실행 방법 (Spring Boot 연동)

Windows 11 Docker Redis 환경에서 Redis를 사용하는 가장 깔끔한 방법은, Windows에 직접 설치하지 않고 Docker로 Redis를 실행하는 것입니다.

특히 Windows 11 Docker Redis 조합은 로컬 개발 환경에서 많이 사용되며, Redis 버전 업데이트가 잦기 때문에 설치 방식과 버전 관리 전략이 매우 중요합니다.

이번 글에서는 Redis를 처음 사용하는 백엔드 개발자를 기준으로 다음 내용을 최소 설정 + 실습 중심으로 정리합니다.

• Windows 11 + Docker Desktop 환경
• Redis 최신 버전 확인 방법
• Redis 특정 버전으로 고정 실행하는 방법
• Windows 부팅 시 Redis 자동 실행
• Spring Boot에서 Redis 연동
• IntelliJ HTTP Request로 테스트

1. Windows 11 Docker 환경에서 Redis 최신 버전 확인 방법

Redis는 계속 업데이트되므로 글에 특정 “최신 버전 번호”를 단정적으로 적는 것은 위험합니다.

Redis Docker 공식 이미지는 Docker Hub에서 관리되며, 최신 버전과 태그 정보는 공식 페이지에서 확인할 수 있습니다. https://hub.docker.com/_/redis

Redis 공식 문서에서는 Docker 환경에서 Redis를 실행하는 방법과 설정 예제를 자세히 설명하고 있습니다.
https://redis.io/docs/latest/

가장 정확한 최신 버전 확인 방법

docker search redis

또는 Docker Hub 공식 Redis 이미지 페이지에서 확인합니다.

• Docker Hub → redis (Official Image)
• Tags 탭에서 latest, 8.x, 7.x 확인

2. Redis 최신 버전으로 실행하기 (주의 포함)

최신 버전(latest) 실행 예시

docker run -d ^
  --name redis ^
  -p 6379:6379 ^
  redis:latest

⚠️ 주의사항

• latest는 자동으로 버전이 변경됨
• 설정이나 내부 동작이 바뀔 수 있음
• 팀 개발에서는 재현성 문제 발생

👉 학습용 / 개인 테스트용으로만 권장

---

3. Docker 기반 Redis 특정 버전 고정 실행하기 (Windows 11)

예: Redis 8.x 고정 실행

docker run -d ^
  --name redis ^
  -p 6379:6379 ^
  redis:8.4

또는 이전 버전:

docker run -d ^
  --name redis ^
  -p 6379:6379 ^
  redis:6.2.2

---

4. Windows 부팅 시 Redis 자동 실행 설정

docker update --restart unless-stopped redis

docker inspect redis --format='{{.HostConfig.RestartPolicy.Name}}'

출력:

unless-stopped

• Docker 재시작 시 자동 실행
• 개발 환경에서 가장 안전한 옵션

---

5. Spring Boot + Redis 최소 연동 구성

build.gradle

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    implementation 'org.springframework.boot:spring-boot-starter-data-redis'
}

---

application.yml

spring:
  redis:
    host: localhost
    port: 6379

---

6. Redis 설정 클래스

@Configuration
public class RedisConfig {

    @Bean
    public RedisTemplate<String, String> redisTemplate(
            RedisConnectionFactory connectionFactory) {

        RedisTemplate<String, String> template = new RedisTemplate<>();
        template.setConnectionFactory(connectionFactory);
        template.setKeySerializer(new StringRedisSerializer());
        template.setValueSerializer(new StringRedisSerializer());
        return template;
    }
}

---

7. Redis 서비스

@Service
public class RedisService {

    private final RedisTemplate<String, String> redisTemplate;

    public RedisService(RedisTemplate<String, String> redisTemplate) {
        this.redisTemplate = redisTemplate;
    }

    public void setValue(String key, String value) {
        redisTemplate.opsForValue().set(key, value);
    }

    public String getValue(String key) {
        return redisTemplate.opsForValue().get(key);
    }
}

---

8. 테스트용 컨트롤러

@RestController
@RequestMapping("/redis")
public class RedisController {

    private final RedisService redisService;

    public RedisController(RedisService redisService) {
        this.redisService = redisService;
    }

    @GetMapping("/set")
    public String set(@RequestParam String key,
                      @RequestParam String value) {
        redisService.setValue(key, value);
        return "OK";
    }

    @GetMapping("/get")
    public String get(@RequestParam String key) {
        return redisService.getValue(key);
    }
}

---

9. IntelliJ HTTP Request로 테스트하기

### Redis 값 저장
GET http://localhost:8080/redis/set?key=hello&value=world

### Redis 값 조회
GET http://localhost:8080/redis/get?key=hello

10. Redis CLI로 직접 버전 확인 (중요)

docker exec -it redis redis-cli

info server

출력:

redis_version:8.x.x

이 가이드는 Windows 11에서 Docker로 Redis를 사용하는 로컬 개발 환경을 기준으로 작성되었습니다.
Windows 환경에서 Docker 기반 Redis를 사용하면 운영체제에 직접 설치하는 방식보다 훨씬 안정적이며,
Spring Boot와 함께 사용할 때도 로컬 환경을 빠르게 구성할 수 있습니다.

마무리 정리

• Redis 최신 버전은 Docker Hub 기준으로 확인
• latest는 테스트용, 실무는 버전 고정
• Docker restart policy로 Windows 부팅 시 자동 실행
• Spring Boot 연동은 최소 설정으로 충분

이 글은 Redis Docker 공식 이미지를 기준으로 작성되었으며,
실제 최신 버전은 Docker Hub redis 공식 페이지에서 반드시 확인하시기 바랍니다.