Upstash 는 완전 관리형 Redis 데이터베이스 서비스입니다. Upstash 는 Redis® API 와 함께 작동하므로 Bun 의 네이티브 Redis 클라이언트를 사용하여 Upstash 데이터베이스에 연결할 수 있습니다.

NOTE

모든 Upstash Redis 데이터베이스는 기본적으로 TLS 가 활성화되어 있습니다.

---

새 프로젝트 만들기

bun init 을 실행하여 새 프로젝트를 만듭니다.

bun init bun-upstash-redis
cd bun-upstash-redis

Upstash Redis 데이터베이스 만들기

Upstash 대시보드 로 이동하여 새 Redis 데이터베이스를 만듭니다. 시작 가이드 를 완료한 후 연결 정보가 있는 데이터베이스 페이지가 표시됩니다.

데이터베이스 페이지에는 HTTP 와 TLS 의 두 가지 연결 방법이 표시됩니다. Bun 의 Redis 클라이언트에는 TLS 연결 정보가 필요합니다. 이 URL 은 rediss:// 로 시작합니다.

Bun 의 Redis 클라이언트로 연결하기

Bun 의 기본 redis 클라이언트로 환경 변수를 설정하여 Upstash 에 연결할 수 있습니다.

.env 파일에 REDIS_URL 환경 변수를 Redis 엔드포인트 (REST URL 아님) 로 설정하세요.

REDIS_URL=rediss://********@********.upstash.io:6379

Bun 의 Redis 클라이언트는 기본적으로 REDIS_URL 에서 연결 정보를 읽습니다.

import { redis } from "bun";

// process.env.REDIS_URL 에서 자동으로 읽기
await redis.set("counter", "0"); 

또는 RedisClient 를 사용하여 사용자 지정 클라이언트를 생성할 수 있습니다.

import { RedisClient } from "bun";

const redis = new RedisClient(process.env.REDIS_URL); 

Redis 클라이언트 사용하기

이제 Redis 클라이언트를 사용하여 Upstash Redis 데이터베이스와 상호 작용할 수 있습니다.

import { redis } from "bun";

// 값 가져오기
let counter = await redis.get("counter");

// 값이 없으면 설정
if (!counter) {
  await redis.set("counter", "0");
}

// 카운터 증가
await redis.incr("counter");

// 업데이트된 값 가져오기
counter = await redis.get("counter");
console.log(counter);

1

Redis 클라이언트는 백그라운드에서 연결을 자동으로 처리합니다. 기본 작업의 경우 수동으로 연결하거나 연결을 끊을 필요가 없습니다.