ServBay에서 Redis 설정 변경하기

ServBay는 강력한 로컬 웹 개발 환경으로, 고성능 키-값 저장 데이터베이스인 Redis를 포함하여 다양한 데이터베이스 서비스를 통합 제공합니다. 본 문서에서는 ServBay 내에서 Redis 설정을 안전하고 효율적으로 변경하는 방법을 안내합니다.

중요 안내: ServBay UI를 통한 설정 변경을 우선하세요

설정의 안정성과 ServBay 업데이트 또는 재시작 시 설정이 의도치 않게 덮어써지는 것을 방지하기 위해, 반드시 ServBay의 그래픽 사용자 인터페이스(UI)를 통해 Redis 설정을 변경하실 것을 강력히 권장합니다. ServBay UI는 직관적인 설정 옵션을 제공하며, 설정 파일의 생성과 적용을 자동으로 관리해줍니다.

설정 파일을 직접 수정하는 방식은 임시 테스트나 디버깅과 같은 특별한 상황에만 사용하길 바랍니다. 상시적인 설정 변경 방법으로는 추천되지 않습니다.

ServBay 그래픽 사용자 인터페이스(UI)로 설정 변경하기(추천)

ServBay는 직관적이고 사용하기 쉬운 그래픽 관리 인터페이스를 제공하여, 복잡한 설정 파일을 수동으로 편집하지 않고도 각종 서비스와 패키지를 쉽게 관리할 수 있습니다. Redis 설정을 변경하는 최적의 방법은 ServBay UI에서 진행하는 것입니다.

변경 방법

1. ServBay 앱을 실행합니다.
2. 왼쪽 네비게이션 바에서 데이터베이스 -> NoSQL -> Redis를 선택합니다.
3. Redis 설정 페이지로 이동합니다. 여기서 다음과 같은 주요 설정 항목들을 확인할 수 있습니다:
   • 리스닝 주소(bind): Redis가 네트워크 인터페이스를 리스닝할 주소를 지정합니다. 기본값은 *:6379로, 모든 사용 가능한 네트워크 인터페이스를 리스닝합니다. 특정 IP 주소(예: 127.0.0.1은 오직 로컬에서만 접근 허용)로 변경할 수 있습니다.
   • 포트(port): Redis 서비스가 리스닝할 TCP 포트를 지정합니다. 기본 포트는 6379입니다.
   • 비밀번호(requirepass): Redis 접근을 위한 패스워드를 설정함으로써 보안을 강화할 수 있습니다. 프로덕션 환경에서는 반드시 강력한 비밀번호를 설정하는 것이 중요합니다.
4. 원하는 값을 해당 입력란에 수정합니다.
5. 수정이 끝나면 화면의 저장 버튼을 클릭합니다. ServBay는 변경 내용을 Redis 설정에 실시간으로 반영하며, 별도의 Redis 서비스 재시작 없이 즉시 적용됩니다.

그림: ServBay UI 내 Redis 설정 화면

설정 파일 수동 편집을 통한 변경(비추천)

권장하지 않으나, 일부 특수한 상황(예: 임시 디버깅)에서는 Redis의 설정 파일을 직접 확인하거나 수정해야 할 수도 있습니다.

수동 편집의 위험성

ServBay는 소프트웨어 패키지의 설정 파일을 시작, 재시작 또는 업데이트 시 자동으로 생성 및 관리합니다. 만약 ServBay 설치 디렉터리 내 설정 파일을 직접 변경하면, 다음 번 ServBay에서 설정 파일이 자동 생성될 때 해당 변경 내용이 덮어써져 사라질 가능성이 있습니다. 이 점을 반드시 인지하시고 수동 편집 리스크에 유의하세요.

설정 파일 위치

ServBay에서 Redis의 주요 설정 파일 위치는 다음과 같습니다:

• redis.conf: /Applications/ServBay/etc/redis/redis.conf

대표 설정 항목 예시

아래는 redis.conf 파일 내에서 자주 사용되는 설정 항목과 파일 내 구성 예시입니다. 실제 파일에 포함된 설정 항목은 이보다 많을 수 있습니다.

1. 리스닝 주소 변경:

   bind 0.0.0.0

   설명: 0.0.0.0은 모든 네트워크 인터페이스를 리스닝합니다. 오직 로컬에서만 접근하고 싶다면 127.0.0.1로 변경하면 됩니다.

2. 포트 변경:

   port 6379

   설명: Redis가 사용하는 리스닝 포트를 변경합니다.

3. 최대 메모리 사용량 설정:

   maxmemory 256mb

   설명: Redis가 사용할 수 있는 최대 메모리 용량을 제한합니다. 과도한 메모리 사용으로 인한 시스템 불안정을 방지할 수 있습니다.

4. 클라이언트 유휴 시간 제한 설정:

   timeout 300

   설명: 클라이언트가 지정된 초만큼 유휴 상태일 경우 Redis가 연결을 종료합니다.

5. 슬로우 쿼리 로그 활성화:

   slowlog-log-slower-than 10000

   설명: 지정한 마이크로초(microseconds)를 초과한 명령 실행 시 로그를 기록합니다. 10000 마이크로초는 10밀리초에 해당합니다.

수동 변경 사항 적용

redis.conf 파일을 수동 편집한 경우, 변경 사항을 적용하려면 Redis 서비스를 반드시 재시작해야 합니다.

Redis 서비스 재시작하기

Redis 설정을 ServBay UI 또는 수동 편집 방식으로 변경한 후에는, 모든 변경 사항이 올바르게 적용되도록 Redis 서비스를 재시작해야 할 수 있습니다.

ServBay 관리 UI에서 재시작

1. ServBay 관리 UI를 엽니다.
2. 왼쪽 네비게이션 바에서 소프트웨어 패키지로 이동합니다.
3. 해당 Redis 버전 소프트웨어 패키지를 찾습니다.
4. Redis 패키지 옆의 재시작 버튼을 클릭합니다.

servbayctl 명령어로 재시작

ServBay는 터미널에서 서비스를 제어할 수 있도록 servbayctl 명령줄 도구도 제공합니다.

아래 명령어를 사용해 Redis 서비스를 재시작할 수 있습니다:

servbayctl restart redis -all

요약

ServBay에서 Redis 설정을 변경하는 가장 안전하고 권장되는 방법은 ServBay의 그래픽 사용자 인터페이스(UI)를 이용하는 것입니다. 이를 통해 설정의 안정성과 지속성을 보장할 수 있습니다. /Applications/ServBay/etc/redis/redis.conf 파일을 직접 수정하는 방식은 임시적인 상황에만 사용하며, 변경 내용이 덮어써질 위험이 있습니다. 설정 변경 후에는 보통 Redis 서비스 재시작이 필요하며, ServBay UI 또는 servbayctl을 통해 손쉽게 재시작할 수 있습니다. 이 방법들을 익혀두면 로컬 개발 환경에서 Redis 데이터베이스를 보다 효율적으로 사용 및 관리할 수 있습니다.