Edge Server 구성 - 미리 보기

전제 조건

각 Edge Server 인스턴스는 Atlas 프로젝트의 서비스에 연결됩니다. Edge Server 인스턴스를 사용하려면 먼저 관련 서비스를 생성하고 에지 Edge Server 인스턴스에 대한 인증 제공자 및 권한을 구성해야 합니다.

자세한 내용 은 Edge Server 서비스 생성을 참조하세요.

에지 서버 호스트 요구 사항

Edge Server 인스턴스를 실행하는 호스트는 EC2 인스턴스 또는 기타 클라우드 서버이거나 온사이트에서 프로비저닝하는 하드웨어일 수 있습니다.

Edge Server 인스턴스 설치 및 구성

Edge Server 서비스 또는 Device Sync 서비스를 생성한 후에는 Edge Server 인스턴스를 생성해야 합니다. 각 서비스에는 여러 개의 Edge Server 인스턴스가 있을 수 있습니다. 에지 서버 인스턴스를 생성하면 Edge Server Edge Server edgectl를 설치 및 관리하는 도구를 다운로드하는 데 사용할 수 있는 설치 스크립트를 받게 됩니다. Edge Server 인스턴스를 등록하는 데 사용할 수 있는 토큰도 얻을 수 있습니다. 자세한 내용 은 Edge Server 인스턴스 생성을 참조하세요.

설치 스크립트를 사용하여 호스트에서 Edge Server 인스턴스를 설정하고 실행합니다.

curl -s https://services.cloud.mongodb.com/edge/install.sh | bash

edgectl init --app-id="<INSERT-YOUR-APP-ID-HERE>" --platform=compose

edgectl config --insecure-disable-auth=true

에지 서버 시작 및 중지

edgectl 을(를) 사용하여 Edge Server 인스턴스를 시작 및 중지합니다.

모든 Edge Server 인스턴스 컨테이너를 시작하려면 start 명령을 사용합니다.

edgectl start

모든 Edge Server 인스턴스 컨테이너를 중지하려면 stop 명령을 사용합니다.

edgectl stop

에지 서버 상태 확인

Edge Server 인스턴스가 실행 중일 때 다음을 사용하여 인스턴스의 상태를 볼 수 있습니다.

edgectl status

이렇게 하면 Edge Server 컨테이너의 상태에 대한 정보와 중요한 정보가 분석된 동기화 서버의 자세한 상태가 제공됩니다. 다음과 유사할 수 있습니다.

{
   "mongoContainerStatus": {
      "message": "running"
   },
   "mongoDBStatus": {
      "message": "ready"
   },
   "syncServerContainerStatus": {
      "message": "running"
   },
   "syncServerStatus": {
      "message": "ACTIVE"
   },
   "syncServerDetailedStatus": {
      "version": "v0.22.3",
      "status": "ACTIVE",
      "cloud_connected": true,
      "num_local_clients": 0,
      "query": {
         "Item": "truepredicate"
      }
   }
}

syncServerDetailedStatus 에는 Edge Server 인스턴스의 상태에 대한 정보가 포함되어 있습니다. 여기에는 다음과 같이 Atlas와의 연결 및 연결된 클라이언트에 대한 세부 정보가 포함됩니다.

Edge Server 인스턴스 구성 업데이트

edgectl을(를) 사용하여 기존 Edge Server 인스턴스를 변경할 수 있습니다. 구성을 변경한 후 인스턴스를 다시 시작하여 업데이트를 적용합니다.

edgectl config --YOUR-FLAG-HERE

edgectl stop

edgectl start

에지 서버 버전 업그레이드

Edge Server 가 발전함에 따라 새로운 기능을 활용하려면 Edge Server 버전을 업그레이드해야 할 수 있습니다. 또한 Edge Server 인스턴스는 사용 가능한 최신 버전보다 하나 이하인 주요 버전이어야 하며, 그렇지 않으면 FAILED 상태가 되어 Atlas 에 연결할 수 없습니다.

edgectl update

edgectl config

edgectl start

edgectl clean

edgectl start

edgectl prune

Edge Server API 키 순환

Edge Server API 키를 순환하려면 다음을 수행합니다.

edgectl config --update-registration-token=true

Edge Server 의 쿼리 지정

쿼리를 지정하지 않으면 Edge Server 인스턴스는 기본적으로 글로벌 쿼리 "*"을 사용하며, 연결된 데이터 소스의 모든 컬렉션에 있는 모든 데이터를 자동으로 동기화합니다.

edgectl config 명령과 함께 몇 가지 인수를 사용하여 Edge Server 인스턴스 동기화 쿼리를 지정할 수 있습니다.

• 간단한 string 쿼리를 전달합니다.

  edgectl config --query="Store: store_id == 42"

• 여러 쿼리 플래그를 전달하여 여러 컬렉션에 대한 쿼리를 제공합니다.

  edgectl config --query="Person: age > 10" --query "Pet: type = 'cat'"

• 더 복잡한 쿼리를 매핑하는 JSON 객체가 포함된 파일의 경로를 전달합니다.

  edgectl config --query-file="/Users/my.user/edge-server/query.json"

• 모든 컬렉션에 대해 동일한 쿼리를 사용하려면 글로벌 쿼리를 전달합니다.

  edgectl config --global-query="shouldSync == true"

글로벌 쿼리를 사용하지 않는 한 Edge Server 쿼리는 YOUR-SCHEMA-TITLE: YOUR-QUERY 형식을 취합니다.

• YOUR-SCHEMA-TITLE: 스키마 의 title 필드로, 일반적으로 데이터베이스의 컬렉션 이름과 일치합니다. 서로 다른 데이터베이스에 동일한 이름을 가진 두 개의 컬렉션이 있는 경우 데이터베이스 이름 앞에 컬렉션 이름을 붙입니다. 예: databaseName_collectionName.

  연결된 Atlas 데이터 소스에는 각각 일치하는 스키마를 가진 여러 컬렉션이 포함될 수 있습니다. 기본 Edge Server 쿼리 "*" 또는 모든 항목을 동기화하는 글로벌 쿼리를 사용하지 않는 경우 동기화하려는 각 스키마에 고유한 쿼리가 있어야 합니다.

  템플릿 앱을 사용하는 경우 이는 Item 컬렉션입니다.

• YOUR-QUERY: Edge Server 가 컬렉션과 동기화할 수 있는 문서를 결정하는 쿼리입니다. RQL 을 사용하여 이 쿼리를 정의할 수 있으며, Flexible Sync RQL 제한과 동일한 주의 사항이 적용됩니다.

edgectl config --global-query="truepredicate"

edgectl config --global-query="store_id == 42"

edgectl config --query="Inventory: store_id == 42"

edgectl config --query="Project: facility_id == 42" --query "Item: priority >= 3"

edgectl config --query-file="/Users/my.user/edge-server/query.json"

{
  "Project": "facility_id == 42",
  "Item": "priority >= 3"
}

오프라인 연결 시뮬레이션

Edge Server 는 Edge Server 인스턴스가 Atlas 와의 연결이 끊어지는 것을 시뮬레이션하는 데 사용할 수 있는 데모 모드를 제공합니다. Edge Server 인스턴스가 오프라인 데모 모드에 있는 CRUD 동안,MongoDB 드라이버나 도구 또는 애플리케이션을 사용하여 인스턴스로 작업을 계속 수행할 수 Atlas Device SDK 있습니다.

Edge Server 인스턴스에 연결된 클라이언트를 통해 로컬로 데이터 변경 사항을 볼 수 있지만 Atlas 에는 반영된 변경 사항이 표시되지 않습니다. Atlas 마찬가지로 Edge Server 인스턴스가 오프라인 상태일 때 에서 변경한 Edge Server 내용도 에지 에 동기화되지 않고 로컬 클라이언트에 반영됩니다.

Edge Server 인스턴스를 오프라인 데모 모드에서 해제하면 자동으로 Atlas 와의 동기화가 다시 시작됩니다. 에 반영된 인스턴스의 데이터를 볼 Edge Server 수 Atlas 있으며, 에서 변경된 데이터는 Atlas 인스턴스와 연결된 클라이언트에 표시됩니다.

edgectl config --insecure-enable-offline-demo

edgectl offline-demo disable-connection

edgectl offline-demo enable-connection

호스트에서 여러 Edge Server 인스턴스 실행

Edge Server 아키텍처를 개발하는 동안 단일 호스트(예: 로컬 시스템)에서 여러 Edge Server 인스턴스를 실행할 수 있습니다. edgectl 프로필 기능을 사용하여 이 작업을 수행할 수 있습니다.

Edge Server 인스턴스를 만들면 edgectl 가 자동으로 기본 프로필을 만듭니다. 프로필은 명령을 특정 Edge Server 인스턴스에 매핑합니다.

동일한 머신에서 새 Edge Server 인스턴스를 만들면 edgectl 이(가) 새 프로필을 기본 프로필로 설정합니다. 기본값 이외의 프로필을 사용하는 명령을 실행하려면 각 명령에 --profile 플래그를 추가합니다.

edgectl start --profile=YOUR-PROFILE-NAME

다음에서 프로필 및 관련 구성 파일을 볼 수 있습니다.

~/.mongodb-edge/profiles/

edgectl init --app-id="YOUR-APP-ID" --platform=compose --profile=YOUR-PROFILE-NAME

edgectl profile list

edgectl profile inspect YOUR-PROFILE-NAME

{
  "appId" : "YOUR-APP-ID",
  "platform" : "compose"
}

edgectl profile set-default YOUR-PROFILE-NAME

edgectl profile delete YOUR-PROFILE-NAME