패키지 및 서비스 관리

ServBay는 개발자를 위해 쉽고 강력한 로컬 웹 개발 환경 관리 툴을 제공합니다. 본 문서에서는 ServBay에서 웹 서버(Nginx, Caddy, Apache), 데이터베이스(MySQL, PostgreSQL, MongoDB), 캐시 서비스(Redis, Memcached), 개발 언어 런타임(PHP, Node.js, Python, Go, Java, Ruby, Rust) 등 다양한 소프트웨어 패키지와 서비스를 효과적으로 설치, 제어, 업데이트, 유지보수하는 방법을 안내합니다. ServBay가 제공하는 다양한 인터페이스를 통해 개발 환경 구성 요소를 빠르고 세밀하게 제어하세요.

빠른 서비스 관리

ServBay는 핵심 서비스의 실행 상태를 신속하게 제어할 수 있는 다양한 방법을 제공합니다.

1. macOS 메뉴바

macOS 우측 상단 메뉴바의 ServBay 아이콘을 클릭하면 빠른 서비스 관리를 위한 패널을 즉시 열 수 있습니다. 사용자는 다음과 같은 기능을 이용할 수 있습니다:

• 서비스 상태 확인: 웹 서버, 데이터베이스 등 모든 핵심 서비스의 현재 상태를 한눈에 파악할 수 있습니다.
• 서비스 시작: 시작 버튼으로 활성화된 모든 핵심 서비스를 빠르게 시작할 수 있습니다.
• 서비스 중지: 중지 버튼으로 실행 중인 모든 핵심 서비스를 신속하게 중지할 수 있습니다.
• 서비스 재시작: 재시작 버튼으로 실행 중인 모든 핵심 서비스를 빠르게 재시작할 수 있습니다.
• 캐시 비우기: Redis의 캐시 데이터를 즉시 비울 수 있습니다.
• 즐겨찾는 사이트: 자주 방문하는 웹사이트를 별표로 표시해 한 번의 클릭으로 빠르게 접근할 수 있습니다.
• 데이터베이스 관리 도구: 다양한 데이터베이스 관리 툴을 신속하게 오픈할 수 있습니다.
• 모든 서비스 중지 및 종료: 실행 중인 모든 ServBay 서비스를 중지하고 ServBay를 완전히 종료합니다.

2. ServBay 대시보드 메인 화면

ServBay 앱의 대시보드 메인 화면에는 활성화된 핵심 서비스를 빠르게 관리할 수 있는 버튼 그룹이 배치되어 있습니다. 주요 기능은 다음과 같습니다:

• 서비스 상태 확인: 현재 모든 핵심 서비스의 상태를 한눈에 확인합니다.
• 서비스 시작: 시작 버튼을 눌러 활성화된 모든 핵심 서비스를 빠르게 시작합니다.
• 서비스 중지: 중지 버튼으로 실행 중인 모든 핵심 서비스를 손쉽게 중지합니다.
• 서비스 재시작: 재시작 버튼으로 실행 중인 서비스들을 빠르게 재시작합니다.
• 로그 확인: 로그 버튼을 눌러 각 서비스의 실행 로그를 신속하게 확인, 장애 원인을 점검할 수 있습니다.

3. ServBay 앱 우측 상단의 글로벌 컨트롤

ServBay 프로그램 창의 우측 상단에는 전역 서비스 제어 버튼이 항상 표시되어, 앱 내 어느 페이지에서든 빠르게 제어할 수 있습니다. 주요 기능은 다음과 같습니다:

• 빠른 실행 옵션: 모든 핵심 서비스의 일괄 시작, 중지, 재시작을 간편하게 실행할 수 있는 옵션을 제공합니다.

패키지 및 상세 서비스 관리

ServBay의 패키지 페이지에서는 소프트웨어 패키지의 설치, 업데이트, 삭제, 상세 서비스 상태 확인 및 컨트롤이 가능합니다.

패키지 목록 보기

패키지 페이지에서는 웹 서버, 데이터베이스, 캐시, 언어 런타임 등 ServBay에서 제공하는 모든 소프트웨어 패키지가 나열됩니다. 각 패키지별 주요 정보는 다음과 같습니다:

• 현재 버전: 로컬 ServBay 환경에 설치된 해당 패키지의 버전입니다. 미설치 시 -로 표시됩니다.
• 최신 버전: 온라인 공식 저장소에 등록된 해당 소프트웨어의 최신 버전입니다. 현재 버전과 다를 경우, 업데이트 가능함을 의미합니다.
• 현재 상태: 패키지와 연동된 핵심 서비스의 현재 실행 상태(Running 실행 중, Stopped 중지됨, Error 오류 등)입니다.
• PID: 서비스가 실행 중일 경우 주 프로세스 ID(Process ID)가 표시됩니다.
• 자동 실행 상태: 해당 서비스가 ServBay 시작 시 자동 실행되도록 설정되어 있는지 표시합니다. 스위치 버튼으로 자동 시작을 켜거나 끌 수 있습니다.

패키지 컨트롤 버튼

설치된 각 패키지의 오른쪽에는 독립적인 서비스 제어 버튼이 있습니다. 이를 통해 다양한 상세 제어가 가능합니다:

• 시작: 패키지와 연결된 서비스를 시작합니다.
• 중지: 연동된 서비스를 중지합니다.
• 재시작: 연동된 서비스를 다시 시작합니다.
• 더보기: 이 버튼을 통해 로그 확인, 설정 파일 편집 등 추가 관리 옵션을 사용할 수 있습니다.

패키지 업그레이드

새 버전이 있을 경우, 해당 패키지의 '최신 버전' 옆에 업그레이드 알림과 버튼이 표시됩니다. 버튼을 클릭하면 최신 버전으로 자동 다운로드 및 설치가 진행됩니다. 업그레이드 완료 후에는 관련 서비스 재시작 또는 알림을 통해 최신 버전 적용을 확인할 수 있습니다.

패키지 설치

아직 설치되지 않은 소프트웨어 패키지(‘현재 버전’이 -로 표시됨)의 경우, 온라인에 최신 버전이 있을 때 우측의 설치 버튼을 클릭하면 오피셜 저장소에서 패키지를 다운로드 및 설치할 수 있습니다.

패키지 삭제

설치된 소프트웨어 패키지는 우측의 삭제 버튼을 눌러 로컬 ServBay 환경에서 해당 패키지와 관련 파일을 제거할 수 있습니다. 단, 대부분의 경우 패키지를 삭제해도 연동된 데이터 파일(예: 데이터베이스 데이터)은 삭제되지 않지만, 세부 패키지마다 다를 수 있으므로 삭제 전 필요 여부를 꼭 확인하세요.

패키지 활성화/비활성화

활성화 열에서 토글 스위치로 연동 서비스의 자동 실행을 켜거나 끌 수 있습니다. 활성화 시 ServBay 실행 시 해당 서비스가 자동 시작되며, 비활성화 시 수동으로 시작해야 합니다. 미설치된 패키지는 활성화 버튼이 비활성화되어 표시됩니다.

서비스 로그 보기

실행 중인 각 서비스의 우측에는 로그 아이콘이 표시됩니다. 이 아이콘을 클릭하면 해당 서비스의 실시간 또는 과거 실행 로그를 확인할 수 있어, 문제 진단 및 서비스 상태 파악에 유용합니다. 자세한 내용은 로그 파일 확인 문서를 참고하세요.

여러 PHP 버전 동시 실행

TIP

PHP의 설치·설정·사용 방법 등 자세한 내용은 PHP 사용하기 문서를 참고하세요.

ServBay는 여러 버전의 PHP를 동시에 설치·실행하는 강력한 기능을 지원합니다. 프로젝트마다 서로 다른 PHP 버전을 사용할 수 있으며, 별도의 복잡한 버전 스위치 도구를 쓸 필요가 없습니다. 기본 PHP 버전은 ServBay 설정 페이지에서 지정할 수 있으며, 이 설정은 커맨드라인(CLI)에서 php 명령 실행 시 사용할 PHP 기본 버전으로 적용됩니다. 자세한 설정 방법은 기본 CLI 버전 설정 문서를 참고하세요.

또한 PHP 버전 및 모듈 페이지에서 ServBay가 제공하는 각 PHP 버전에 사전 컴파일되어 포함된 주요 확장 모듈을 확인할 수 있습니다.

MySQL, MariaDB, PostgreSQL 관련 주의사항

ServBay는 데이터베이스 관리, 특히 다중 버전 관리에 특화된 기능을 제공합니다:

• 동일 포트(예: 3306)로는 한 번에 하나의 MySQL, MariaDB, PostgreSQL 인스턴트만 실행할 수 있습니다. 여러 버전을 설치한 경우, 각 인스턴스별로 서로 다른 포트를 지정하거나, Skip Networking 옵션을 이용해 서비스의 포트 리스닝을 비활성화하고 소켓 파일을 통해서만 연결할 수도 있습니다.
• ServBay는 주 버전 번호가 동일한 MySQL, MariaDB, PostgreSQL 인스턴스 간에 데이터베이스 파일을 공유하도록 설계되어 있습니다. 예를 들어, MariaDB 11.0.1과 11.0.2는 주 버전이 11.0으로 같으므로 같은 데이터베이스 디렉토리를 공유합니다. 하지만 MariaDB 10.5.22와 MariaDB 11.1.2는 주 버전(10.5, 11.1)이 다르기 때문에 데이터베이스 폴더를 공유하지 않습니다. 즉, 같은 주 버전 내에서 부 버전 업그레이드·스위칭은 데이터가 공유되지만, 다른 주 버전 간에는 데이터 이전(Migration)이 필요할 수 있습니다.

TIP

데이터베이스 파일의 저장 위치, 데이터 마이그레이션 및 백업 방법 등 자세한 정보는 데이터베이스 파일 관리 및 이전 문서를 참고하세요.

이러한 다양한 기능을 통해 ServBay는 사용자가 개발에 필요한 다양한 구성 요소를 쉽고 효율적으로 관리·업데이트 할 수 있는 종합 패키지 & 서비스 관리 툴을 제공합니다. 로컬 개발 효율성과 유연성 모두를 한층 높여보세요.