사전 빌드된 MongoDB C 드라이버 라이브러리 설치
이 페이지의 내용
libmongoc 및 libbson 라이브러리는 일반 Linux 배포판 및 Homebrew를 통한 macOS의 패키지 관리 리포지토리에서 사용할 수 있는 경우가 많습니다.
참고
Windows 의 경우 로컬 도구 체인과의 호환성을 극대화하려면 대신 소스에서 라이브러리를 빌드 하는 것이 좋습니다. Conan 과 같은 소스 라이브러리 패키지 관리 도구를 사용하여 소스에서 빌드를 자동화할 수 있습니다. 또는 vcpkg(참조: 라이브러리 패키지 관리자를 사용한 교차 플랫폼 설치 ).
경고
타사 패키지 프로그램에서 사전 빌드된 바이너리를 설치하고 사용하는 경우 해당 문서 페이지(1.28)에 설명된 라이브러리 버전보다 뒤처질 수 있습니다. 설치 버전을 기록하고 이 페이지를 읽을 때 염두에 두세요.
C 드라이버 라이브러리의 최신 버전을 사용하려면 소스에서 빌드하는 것이 좋습니다.
라이브러리 패키지 관리자를 사용한 교차 플랫폼 설치
다양한 라이브러리 패키지 관리자는 libbson 및 libmongoc 을(를) 설치 가능한 패키지로 제공 합니다 .및 vcpkg . 이 섹션에서는 이러한 도구를 사용하여 설치하는 방법을 자세히 설명합니다.
vcpkg를 사용하여 설치
참고
이 페이지에서는 vcpkg 를 사용하여 시작하는 방법에 대해 자세히 설명하지 않습니다. . 자세한 내용 은 vcpkg 시작하기를 참조하세요.
vcpkg 매니페스트 모드 에서 프로젝트의 vcpkg.json 매니페스트 파일 에 원하는 라이브러리를 추가합니다.
{ // ... "dependencies": [ // ... "mongo-c-driver" ] }
vcpkg 통합을 사용하여 CMake 프로젝트 를 빌드 하고 vcpkg.json 매니페스트 파일 이 있는 경우 vcpkg는 구성 단계를 진행하기 전에 프로젝트의 종속성을 자동으로 설치하므로 추가 수작업이 필요하지 않습니다.
vcpkg 클래식 모드 libbson 에서 , 및 는 libmongoc libbson mongo-c-driver각각 및 이름을 통해 설치할 수 있습니다.
$ vcpkg install mongo-c-driver
( mongo-c-driver 을 설치하면 libbson 도 이행적으로 설치됩니다.)
libmongoc 및 libbson 패키지가 설치되고 vcpkg가 빌드 시스템에 제대로 통합되면 원하는 라이브러리를 가져올 수 있습니다.
CMake를 사용하면 표준 구성 파일 패키지와 생성된 IMPORTED 대상을 사용할 수 있습니다.
find_package(mongoc-1.0 CONFIG REQUIRED) target_link_libraries(my-application PRIVATE $<IF:$<TARGET_EXISTS:mongo::mongoc_shared>,mongo::mongoc_shared,mongo::mongoc_static>)
참고
큰 $<IF:$<TARGET_EXISTS...>:...> 생성기 표현식을 사용하면 find_package() 명령에서 사용 가능한 형식에 따라 libmongoc 의 링크 유형을 전환할 수 있습니다. libmongoc 는 동적 및 정적 라이브러리 유형을 모두 사용한 빌드를 지원하지만 vcpkg는 한 번에 두 가지 라이브러리 유형 중 하나만 설치합니다.
vcpkg 통합을 사용하여 CMake 프로젝트를 구성하려면 초기 구성 명령에서 CMake 도구 체인 파일을 설정하기만 하면 됩니다.
$ cmake -S . -B _build -D CMAKE_TOOLCHAIN_FILE=$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake
Linux에 설치
libbson 및 libmongoc 의 이름과 설치 프로세스는 배포판에 따라 다르지만 일반적으로 유사한 패턴을 따릅니다.
다음 Linux 배포판은 libbson 및 libmongoc 패키지를 제공합니다.
dnf를 통한 FedoraRedHat Enterprise Linux(RHEL) 7 이상 및 RHEL 7 이상을 기반으로 하는 배포판(CentOS, Rocky Linux 및 AlmaLinux 포함)은
yum/dnf및 EPEL을 통해 제공됩니다.APT를 통한 Ubuntu 및 Ubuntu 파생 상품을 포함한Debian 및 Debian 기반 배포.
RedHat 기반 시스템
RedHat 기반 Linux 배포판( Fedora, CentOS, Rocky Linux, AlmaLinux 등)에서 C 운전자 라이브러리는 Yum/DNF와 함께 설치할 수 있습니다.
참고
Fedora 및 엔터프라이즈 Linux 버전 8 이상에서는 yum 명령 대신 dnf 명령을 사용하는 것이 좋습니다.
중요
Fedora 제외:
C 드라이버 라이브러리는 각 엔터프라이즈 Linux 배포의 7 이상 버전에서만 사용할 수 있습니다. 그러나 C 드라이버 라이브러리는 기본 리포지토리에서 사용할 수 없지만 EPEL 리포지토리를 활성화하여 얻을 수 있습니다. 이 작업은 epel-release 패키지를 설치하여 수행할 수 있습니다.
# yum install epel-release
epel-release C 드라이버 라이브러리를 설치하기 전에 설치해야 합니다(즉, 단일 yum install 명령으로 두 라이브러리를 모두 설치할 수는 없습니다).
libbson 만 설치하려면 libbson-devel 패키지를 설치합니다.
# yum install libbson-devel
전체 C 데이터베이스 드라이버(libmongoc)를 설치하려면 mongo-c-driver-devel 을(를) 설치합니다.
## (This package will transitively install libbson-devel) # yum install mongo-c-driver-devel
사용 가능한 버전을 확인하려면 https://packages.fedoraproject.org/pkgs/mongo-c-driver/mongo-c-driver-devel을 참조하세요.
개발 패키지( -devel 로 끝남)에는 libbson 및 libmongoc 를 사용하여 애플리케이션을 빌드하는 데 필요한 파일이 포함되어 있습니다. 개발 파일 없이 라이브러리만 설치하려면 libbson 또는 mongo-c-driver-libs 패키지를 설치합니다.
Debian 기반 시스템
Ubuntu 및 Ubuntu 파생 상품을 포함한 Debian 기반 Linux 배포에서 libbson 및 libmongoc 은 APT를 통해 배포 리포지토리에서 사용할 수 있으며, 각각 libbson-dev 및 libmongoc-dev 로 설치할 수 있습니다.
## Update repository information, if necessary: # apt update
libbson 만 설치하려면 다음을 수행합니다.
# apt install libbson-dev
libmongoc 을(를) 설치하려면( libbson 도 설치됨):
# apt install libmongoc-dev
사용 가능한 버전을 확인하려면 apt-cache policy libmongoc-dev 를 실행합니다.
개발 패키지( -dev 로 끝남)에는 libbson 및 libmongoc 를 사용하여 애플리케이션을 빌드하는 데 필요한 파일이 포함되어 있습니다. 개발 파일 없이 라이브러리만 설치하려면 libbson-1.0-0 또는 libmongoc-1.0-0 패키지를 설치합니다.
Homebrew로 macOS에 설치하기
macOS 시스템을 사용하는 경우 libmongoc libbson Homebrew 를 사용하여 C 운전자 라이브러리( 및 모두 포함)를 설치할 수 있습니다. 다음 명령을 사용하여 패키지 관리자를 실행합니다.
$ brew install mongo-c-driver
참고
Homebrew는 libbson 및 libmongoc 에 대한 별도의 패키지를 제공하지 않습니다.
팁
홈브루 패키지 관리자는 macOS에 기본값 으로 설치되지 않습니다. Homebrew 설치에 대한 자세한 내용 은 Homebrew 설치 설명서 페이지 를 참조하세요. .