다운로드 및 설치
C 운전자 다운로드
C 운전자 는 두 개의 라이브러리 libbson
및 libmongoc
로 구성됩니다. 이 가이드 에서는 libbson
와 함께 번들로 제공되는 libmongoc
설치 방법을 학습 봅니다.
패키지 관리자를 사용하거나 소스에서 라이브러리를 설치하여 C 운전자 를 설치할 수 있습니다. 패키지 관리자를 사용하여 설치할 때 Linux 배포판은 서로 다른 버전의 운전자 를 설치합니다. 따라서 운전자 를 설치하기 전에 배포에 포함된 버전을 확인해야 합니다.
RHEL( RedHat Enterprise Linux ) 배포판의 경우 셸 에서 다음 명령을 실행 하여 버전을 확인할 수 있습니다.
sudo dnf info mongo-c-driver-devel
Debian 기반 배포에서는 셸 에서 다음 명령을 실행 하여 버전을 확인할 수 있습니다.
apt-cache policy libmongoc-dev
사용 가능한 운전자 버전이 원하는 버전이 아닌 경우 소스에서 운전자 를 설치할 수 있습니다. 소스에서 운전자 를 설치하는 방법을 학습 보려면 소스에서 C 드라이버 라이브러리 빌드하기 가이드 를 참조하세요.
패키지 관리자를 사용하여 운전자 를 설치하는 방법을 학습 보려면 운영 체제에 해당하는 탭 을 선택합니다.
RedHat Enterprise Linux 배포판
RHEL( RedHat Enterprise Linux ) 배포판, 버전 7 이상 또는 다음과 같은 RHEL 기반 배포판에 운전자 를 설치할 수 있습니다.
Fedora를 제외한 RHEL 배포에 운전자 를 설치하기 전에 먼저 EPEL(Enterprise Linux 추가 패키지) 리포지토리 를 활성화 해야 합니다. 다음 예시 와 같이 epel-release
패키지 를 설치하여 EPEL 리포지토리 를 활성화 할 수 있습니다.
yum install epel-release
그런 다음 yum
을(를) 사용하여 C 운전자 를 설치할 수 있습니다. 이렇게 하려면 셸 에서 다음 명령을 실행 합니다.
yum install mongo-c-driver-devel
참고
개발자 패키지
앞의 코드 예시 에서는 C 운전자 를 사용하는 애플리케이션을 빌드 하는 데 필요한 개발자 패키지를 설치합니다. 개발 파일 없이 라이브러리만 설치하려면 다음 명령을 실행 합니다.
yum install mongo-c-driver
버전 8 이상인 RHEL 배포에 설치하는 경우 yum
대신 dnf
를 사용하여 앞의 코드 예제를 실행 하는 것이 좋습니다.
Fedora
Fedora 또는 버전 이상의 엔터프라이즈 Linux 배포를 사용하는 경우 앞의 8 예시 에 표시된 것과 동일한 명령을 사용하고 yum
을 로 바꿔서 운전자 를 설치할 수 dnf
있습니다.
다음 예시 는 Fedora 배포에 C 운전자 를 설치하는 방법을 보여줍니다.
dnf install mongo-c-driver-devel
Debian 기반 배포판
Ubuntu 및 Ubuntu 파생 제품을 포함한 Debian 기반 Linux 배포에서 운전자 라이브러리는 고급 패키징 도구(APT)를 통해 사용할 수 있습니다. 셸 에서 다음 명령을 실행 하여 APT로 운전자 를 설치할 수 있습니다.
apt install libmongoc-dev
앞의 코드 예시 에서는 C 운전자 를 사용하는 애플리케이션을 빌드 하는 데 필요한 개발자 패키지를 설치합니다. 개발 파일 없이 라이브러리만 설치하려면 다음 명령을 실행 합니다.
apt install libmongoc-1.0-0
Windows 환경의 경우 로컬 도구 체인과의 최대 호환성을 보장하기 위해 소스에서 C 운전자 라이브러리를 빌드하는 것이 좋습니다.vcpkg와 같은 소스 라이브러리 패키지 관리 도구를 사용하여 소스에서 빌드를 자동화할 수 있습니다.
팁
vcpkg를 시작하는 방법을 학습 보려면 Microsoft 가이드 에서 vcpkg 시작하기 가이드를 참조하세요.
vcpkg 매니페스트 모드 에서 다음 예시 와 같이 운전자 라이브러리를 프로젝트의 vcpkg.json
매니페스트 파일 에 추가합니다.
{ // ... "dependencies": [ // ... "mongo-c-driver" ] }
vcpkg 통합을 사용하여 CMake 프로젝트 를 빌드 하고 vcpkg.json
매니페스트 파일 이 있는 경우 vcpkg는 구성을 진행하기 전에 프로젝트의 종속성을 자동으로 설치합니다.
vcpkg 클래식 모드 를 사용하는 경우 셸 에서 다음 명령을 실행 하여 운전자 를 설치할 수 있습니다.
vcpkg install mongo-c-driver
운전자 를 설치하면 표준 CMake 구성 파일 과 생성된 IMPORTED
대상을 사용할 수 있습니다. 다음 예시 와 같이 CMakeLists.txt
파일 을 만들 수 있습니다.
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...>:...>
앞의 예시 에서 생성기 표현식 을 libmongoc
사용하여 find_package()
명령에서 사용할 수 있는 형식에 따라 의 링크 유형을 전환할 수 있습니다. libmongoc
는 동적 및 정적 라이브러리 유형을 모두 사용하여 빌드를 지원하지만 vcpkg는 한 번에 하나의 유형만 설치합니다.
vcpkg 통합을 사용하여 CMake 프로젝트 를 구성하려면 셸 에서 다음 명령을 실행 하여 구성 명령에서 CMake 도구 체인 파일 을 설정하다 합니다.
cmake -S . -B _build -D CMAKE_TOOLCHAIN_FILE=$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake
MacOS에서 Homebrew 패키지 관리자를 사용하여 C 운전자 를 다운로드 할 수 있습니다. 이렇게 하려면 셸 에서 다음 명령을 실행 합니다.
brew install mongo-c-driver
이 단계를 완료하면 컴퓨터에 C 운전자 가 설치됩니다.
참고
이 단계에서 문제가 발생하면 MongoDB Community 포럼에서 도움을 요청하거나 이 페이지 오른쪽 또는 하단의 Rate this page 탭을 사용하여 피드백을 제출하세요.