MongoDB 루비 드라이버

공식적으로 지원되는 MongoDB 용 Ruby 운전자 입니다.

Ruby 운전자 Ruby 2.7-3.3 및 JRuby 9.3-9.4.

설치

임시 사용의 경우 명령줄을 통해 또는 RubyGems를 통해 설치합니다.

$ gem install Mongo

또는 보다 일반적인 용도로 사용하려면 Gemfile을 통해 다음을 수행합니다.

gem ‘mongo’

릴리스 무결성

버전 2.20.0 이후의 각 MongoDB Ruby 운전자 출시하다 는 팀의 GPG 키를 사용하여 자동으로 빌드되고 서명되었습니다.

드라이버의 gem 파일 확인하려면 다음을 수행합니다.

  1. GPG 키를 다운로드합니다.

  2. gpg --import ruby-driver.asc을(를) 사용하여 키를 GPG 키링으로 가져옵니다.

  3. gem 파일 다운로드합니다(아직 없는 경우). 를 사용하여 RubyGems에서 다운로드 gem fetch mongo 하거나 Github 의 릴리스 페이지에서 다운로드 할 수 있습니다.

  4. 동일한 출시하다 에서 해당하는 분리된 서명 파일 다운로드합니다. gem 파일 에 해당하는 출시하다 하단의 'Assets' 목록 아래에서 설치하려는 gem과 동일한 버전 번호를 가진 .sig 파일 이 있는지 확인합니다.

  5. gpg --verify mongo-X.Y.Z.gem.sig mongo-X.Y.Z.gem (X.Y.Z 을 실제 버전 번호로 대체)으로 gem을 확인합니다.

출력에서 " 좋은 서명 from "MongoDB Ruby 드라이버 릴리스 서명 키 패키징@mongodb.com " 과 같은 텍스트를 찾고 있습니다. 이를 보면 서명이 지정된 gem 파일 에 해당하는 것으로 나타났습니다.

("이 키는 신뢰할 수 있는 서명으로 인증되지 않았습니다!"와 같은 기타 출력은 웹 오브 트러스트와 관련이 있으며, 당사에서 다운로드한 ruby-driver.asc 키를 개인적으로 얼마나 신뢰하는지에 따라 달라집니다. 자세한 학습 www.gnupg.org/gph/en/manual/x.html 을334 참조하세요.

RubyGems의 gem 서명 기능을 사용하는 것이 좋습니다.

RubyGems의 자체 gem 서명은 문제가 있는데, 가장 큰 이유는 gem을 서명하는 데 사용되는 키와 관련하여 설정된 신뢰 체인이 없기 때문입니다. RubyGems의 자체 문서에서는 "이 gems 서명 방법은 널리 사용되지 않음" 을 인정합니다(참조:guides.rubygems.org/security/). 이에 대한 RubyGems 커뮤니티의 논의는 10년 이상 계속해서 이루어지고 있으며, 결국 솔루션이 도착하지만 다음과 같은 이유로 GPG를 대신 사용하기로 결정했습니다.

  1. MongoDB 의 다른 많은 운전자 팀은 GPG를 사용하여 제품 릴리스에 서명하고 있습니다. 다른 팀과의 일관성은 기존 도구를 자체 제품 릴리스에 재사용할 수 있음을 의미합니다.

  2. GPG는 널리 사용할 수 있으며 신뢰의 웹을 처리하기 위한 기존 도구와 절차가 있습니다(유감스럽게도 이러한 방식이 초심자에게는 상당히 비밀스럽고 겁이 나는 것이 사실입니다).

궁극적으로 대부분의 사용자는 gem을 확인하는 데 번거롭지 않으며, RubyGems의 네이티브 방법 대신 GPG를 선택해도 영향을 받지 않습니다.

문서

높은 수준의 문서와 사용 예제는 여기 에 있습니다.

가장 최근 출시하다 에 대한 API 설명서는 여기 에서 찾을 수 있습니다. 마스터 브랜치에 대한 API 문서를 빌드 하려면 로컬에서 리포지토리 를 체크아웃하고 rake docs 를 실행 합니다.

Docs 폴더에 있던 튜토리얼 및 참고 자료를 포함한 상위 수준 운전자 문서를 이제 여기에서 문서-루비 리포지토리 에서 찾을 수있습니다.

Support

운전자 에 대한 상업적 지원 은 MongoDB 지원 포털 을 통해 제공됩니다.

질문, 토론 또는 일반적인 기술 지원 이 필요한 경우 MongoDB Community 포럼 을 방문하세요.

기타 지원 리소스는 문서의 기술 지원 페이지를 참조하세요.

버그 및 기능 요청

드라이버의 버그를 신고하거나 Ruby 드라이버 전용 기능을 요청하려면 다음을 수행하세요.

  1. 이슈 트래커 를 방문하여 로그인하세요(또는 아직 계정이 없는 경우 계정을 생성하세요).

  2. Ruby 프로젝트 로 이동합니다.

  3. 'Create Issue'를 클릭하고 해당 양식 필드를 모두 작성합니다.

이슈를 생성할 때 RUBY 프로젝트에 대한 JIRA의 모든 정보와 코어 서버 (SERVER 프로젝트)가 공개적으로 표시된다는 점을 명심하십시오.

다음을 수행하세요.

  • 해당 문제에 대해 가능한 한 많은 정보를 제공합니다.

  • 문제를 재현하기 위한 자세한 단계를 제공합니다.

  • 해당하는 코드 스니펫, 스택 추적 및 로그 데이터를 제공합니다. 민감한 데이터나 서버 로그를 포함하지 마세요.

  • 드라이버 및 MongoDB Server의 버전 번호를 지정합니다.

다음과 같은 행동을 하지 마세요.

  • 민감한 데이터 또는 서버 로그를 제공합니다.

  • 잠재적인 보안 문제를 공개적으로 보고합니다(아래 '보안 문제' 참조).

보안 문제

Ruby 운전자 (또는 기타 MongoDB 제품)에서 잠재적인 보안 관련 문제를 발견한 경우 여기의 지침에 따라 신고해 주세요.

제품 기능 요청

Ruby 운전자 에만 국한되지 않는 기능 이나 운전자 에만 영향을 미치는 것보다 더 많은 영향을 미치는 기능 ( 예시 : MongoDB 서버 지원 이 필요한 기능)을 요청 하려면 MongoDB 피드백 포럼 을 통해 아이디어를 제출 주세요.

유지 관리 및 버그 수정 정책

새로운 운전자 기능은 일반적으로 이전 버전과 호환되는 방식으로 추가되며 새로운 마이너 드라이버 릴리스 (2.x)가 됩니다. 버그 수정은 일반적으로 마스터에서 먼저 이루어지고 현재 마이너 운전자 출시하다 로 백포트됩니다. 예외는 사례별로 적용될 수 있으며, 예를 예시 보안 수정 사항이 이전의 안정적인 브랜치로 백포팅될 수 있습니다. 가장 최근의 마이너 운전자 출시하다 만 공식적으로 지원됩니다. 고객은 애플리케이션에 최신 운전자 출시하다 를 사용해야 합니다.

테스트 실행

드라이버의 테스트 제품군을 실행 하는 방법에 대한 지침은 spec/README.md 를 참조하세요.

릴리스 내역

전체 릴리스 노트와 릴리스 기록은 Github 릴리스 페이지에서 확인할 수 있습니다.

라이선스

저작권 © 2009-2020 MongoDB, Inc.

Apache 라이선스, 버전 2.0 ('라이선스')에 따라 라이선스가 부여됩니다. 라이선스를 준수하지 않는 한 이 파일을 사용할 수 없습니다. 다음에서 라이선스 사본을 얻을 수 있습니다.

www.apache.org/licenses/LICENSE-2.0

해당 법률에서 요구하거나 문서로 동의하지 않는 한, 라이선스에 따라 배포되는 소프트웨어는 명시적이든 Express 이든 어떤 종류의 보증이나 조건 없이 "있는 그대로" 배포됩니다. 라이선스에 따른 권한 및 제한 사항을 적용하는 특정 언어는 라이선스를 참조하세요.