Atlas 에서 에지 서버 관리 - 미리 보기

데이터 서비스 UI 로 이동

Atlas UI 프로젝트 대시보드 에서 프로젝트 를 선택하면 기본값 Data Services 탭 이 표시됩니다.

App Services 또는 Charts에 있는 경우 Data Services 탭을 선택합니다.

'장치 및 에지 동기화' 선택

왼쪽 사이드바에서 Services 섹션으로 이동합니다. Device & Edge Sync을(를) 선택합니다.

서비스 생성

생성하려는 서비스의 유형을 선택하고, 표시되는 메시지에 따라 Edge Server 서비스 또는 Device Sync 서비스를 생성합니다.

Edge Server 서비스를 생성한 후 즉시 Edge Server 인스턴스를 추가할 수 있습니다.

Device Sync 서비스를 생성하는 경우 왼쪽 탐색에서 Edge Server 를 클릭합니다. 그러면 Edge Server 인스턴스를 추가하고 볼 수 있는 목록이 열립니다.

Add a server 버튼을 클릭하고 지시에 따라 새 Edge Server 인스턴스의 이름을 지정하고 생성합니다.

Device Sync 앱 만들기

App Services App 만들기 설명서를 참조하세요.

앱 유형을 선택할 때 Device Sync 을 선택합니다. Device Device Sync 를 구성한 후 Device Sync 앱에 에지 서버를 추가할 수 있습니다.

서비스에 Edge Server 인스턴스 추가 Device Sync

Device Sync Service를 보면서 왼쪽 탐색에서 Edge Server 을(를) 클릭합니다. 그러면 Edge Server 인스턴스를 추가하고 볼 수 있는 목록이 열립니다.

Add a server 버튼을 클릭하고 지시에 따라 새 Edge Server 인스턴스의 이름을 지정하고 생성합니다.

서버 추가

Add a server를 클릭합니다. Edge Server의 이름을 지정하라는 메시지가 표시됩니다.

UI 는 Edge Server 코드를 설치하려는 장치의 터미널에 복사하여 붙여넣을 수 있는 설치 스크립트 를 제공합니다. Edge Server 인스턴스 를 구성할 때 사용할 토큰도 받게 됩니다.

Edge Server 코드 설치 및 구성

Edge Server 코드를 설치하려는 기기의 터미널에 설치 스크립트 를 복사하여 붙여넣습니다. 자세한 내용 은 Edge Server 인스턴스 설치 및 구성을 참조하세요.

Edge Server 인스턴스 를 구성하고 시작하면 Edge Server 대시보드 의 Health 상태가 Pending 에서 Active로 변경됩니다.

MongoDB Atlas 사용자 인증하기

MongoDB Atlas API 키 쌍을 사용하여 관리자 사용자 인증 엔드포인트를 호출합니다.

curl -X POST \
  https://services.cloud.mongodb.com/api/admin/v3.0/auth/providers/mongodb-cloud/login \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "username": "<Public API Key>",
    "apiKey": "<Private API Key>"
  }'

인증 이 성공하면 응답 본문에 access_token 값을 가진 JSON 객체 가 포함됩니다.

{
  "access_token": "<access_token>",
  "refresh_token": "<refresh_token>",
  "user_id": "<user_id>",
  "device_id": "<device_id>"
}

access_token 은(는) App Services Admin API 에 대한 액세스 을 부여합니다. 모든 관리자 API 요청에 대해 Authorization 헤더에 베어러 토큰으로 포함해야 합니다.

Edge Server 인스턴스 생성 엔드포인트를 호출합니다.

Admin API Edge Server 인스턴스 생성 엔드포인트를 호출하여 서비스에 Edge Server 인스턴스 를 추가합니다.

요청 에는 다음이 포함되어야 합니다.

• Authorization 관리자 API 액세스 토큰을 베어러 토큰 으로 사용하는 헤더입니다.

• 새 Edge Server 인스턴스 에 대한 name

curl -X POST \
  https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/edge \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <AccessToken>' \
  -d '{
    "name": "YOUR-EDGE-SERVER-INSTANCE-NAME"
  }'

요청 이 201 성공적인 하면 코드와 JSON 새로 생성된 인스턴스 에 대한 정보가 포함된 객체 가 Edge Server 반환됩니다.

{
  "id": "6622b8f5118368b943d228a9",
  "user_id": "6622b8f5118368b943d2288a",
  "registration_key": "Qi4GgpvVduwwt4k1w77ZzaQ1n4SdTWC8rLBD9vyTib1w9G3CX2ta8WrJvt3giEK7"
}

• id: 유형의 인스턴스 의 고유 식별자(Edge Server ObjectId string)입니다. 이 식별자를 사용하여 Edge Server 인스턴스 를 삭제 하거나 업데이트 할 수 있습니다.

• user_id: Edge Server 자체가 사용자입니다. 유형의 사용자의 고유 Edge Server 식별자(ObjectId string)입니다. 권한을 구성할 때 이 식별자를 사용할 수 있습니다.

• registration_key: 이 정보를 저장합니다. 호스팅하다 에 Edge Server 코드를 설치할 때 이 등록 토큰을 입력합니다. 는 이를 로 Edge Server API 인증하는 데 사용하는 키와 교환합니다.Atlas 이 등록 토큰은 한 번만 사용할 수 있습니다.

Edge Server 코드 설치

Edge Server 코드를 설치하려는 기기의 터미널에 설치 스크립트 를 복사하여 붙여넣습니다. 자세한 내용 은 Edge Server 인스턴스 설치 및 구성을 참조하세요.

MongoDB Atlas 사용자 인증하기

MongoDB Atlas API 키 쌍을 사용하여 관리자 사용자 인증 엔드포인트를 호출합니다.

curl -X POST \
  https://services.cloud.mongodb.com/api/admin/v3.0/auth/providers/mongodb-cloud/login \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "username": "<Public API Key>",
    "apiKey": "<Private API Key>"
  }'

인증 이 성공하면 응답 본문에 access_token 값을 가진 JSON 객체 가 포함됩니다.

{
  "access_token": "<access_token>",
  "refresh_token": "<refresh_token>",
  "user_id": "<user_id>",
  "device_id": "<device_id>"
}

access_token 은(는) App Services Admin API 에 대한 액세스 을 부여합니다. 모든 관리자 API 요청에 대해 Authorization 헤더에 베어러 토큰으로 포함해야 합니다.

Edge Server 인스턴스 목록 가져오기

관리자 API 목록 에지 서버 엔드포인트를 호출하여 모든 에지 서버 인스턴스의 목록을 가져옵니다.

요청에는 Authorization 관리자 API 액세스 토큰이 베어러 토큰 인 헤더가 포함되어야 합니다.

curl -X GET \
  https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/edge \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <AccessToken>'

요청이 성공하면 200 코드와 appId와 연결된 각 Edge Server 인스턴스에 대한 요약 세부 정보가 포함된 객체 배열의 값을 가진 edge_servers 키가 반환됩니다.

{
  "edge_servers": [
    {
      "id": "6622b8f5118368b943d228a9",
      "created": "2024-04-19T08:51:00Z",
      "name": "Edge-Store-42",
      "user_id": "6622b8f5118368b943d2288a",
      "status": "active",
      "hostname": "ec2-13-58-70-88.us-east-2.compute.amazonaws.com",
      "last_connection": "2024-04-19T09:51:00Z"
    }
  ]
}

자세한 내용을 보려면 세부 정보를 보려는 인스턴스의 id 를 찾으세요.

Edge Server 정보 엔드포인트 호출

관리자 API Edge Server 정보 가져오기 엔드포인트를 호출하여 Edge Server 인스턴스에 대한 자세한 정보를 가져옵니다.

요청에는 Authorization 관리자 API 액세스 토큰이 베어러 토큰 인 헤더가 포함되어야 합니다.

curl -X GET \
  https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/edge/{edgeServerId} \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <AccessToken>'

요청이 성공하면 200 코드와 인스턴스에 JSON 대한 자세한 정보가 포함된 객체가 Edge Server 반환됩니다.

{
  "id": "6622b8f5118368b943d228a9",
  "created": "2024-04-19T08:51:00Z",
  "name": "Edge-Store-42",
  "user_id": "6622b8f5118368b943d2288a",
  "status": "active",
  "hostname": "ec2-13-58-70-88.us-east-2.compute.amazonaws.com",
  "last_connection": "2024-04-19T09:51:00Z",
  "query": {
    "Item": "(store_id == \"641cb3d99e425c794ef69315\")"
  },
  "package_version": "v0.21.2",
  "latest_package_version": "v0.22.2",
  "metrics": [
    {
      "key": "edge_host_memory_percent",
      "name": "Memory Usage",
      "category": "host",
      "detail": "Percentage of memory used by the edge container",
      "value": 15,
      "unit": "%"
    },
    ...additional Edge Server metrics...
  ]
}

이 응답 본문에 대한 자세한 내용은 API 사양을 참조하세요.

Edge Server 대시보드 찾아보기

왼쪽 탐색 사이드바에서 Edge Server 옵션을 클릭하여 Edge Server 대시보드 를 엽니다.

Edge Server 인스턴스 세부 정보 보기

목록에서 삭제 하려는 Edge Server 인스턴스 를 찾아 View Details 버튼을 클릭합니다.

Edge Server 인스턴스 삭제

Edge Server 세부 정보 보기 하단에 있는 Delete 버튼을 클릭합니다.

삭제를 확인하라는 메시지가 표시됩니다. 표시되는 메시지에 따라 Edge Server를 삭제할 것인지 확인합니다.

MongoDB Atlas 사용자 인증하기

MongoDB Atlas API 키 쌍을 사용하여 관리자 사용자 인증 엔드포인트를 호출합니다.

curl -X POST \
  https://services.cloud.mongodb.com/api/admin/v3.0/auth/providers/mongodb-cloud/login \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "username": "<Public API Key>",
    "apiKey": "<Private API Key>"
  }'

인증 이 성공하면 응답 본문에 access_token 값을 가진 JSON 객체 가 포함됩니다.

{
  "access_token": "<access_token>",
  "refresh_token": "<refresh_token>",
  "user_id": "<user_id>",
  "device_id": "<device_id>"
}

access_token 은(는) App Services Admin API 에 대한 액세스 을 부여합니다. 모든 관리자 API 요청에 대해 Authorization 헤더에 베어러 토큰으로 포함해야 합니다.

ID Edge Server 삭제할 의 가져오기

관리자 API 목록 에지 서버 엔드포인트를 호출하여 모든 Edge Server 인스턴스의 목록을 가져옵니다.

요청에는 Authorization 관리자 API 액세스 토큰이 베어러 토큰 인 헤더가 포함되어야 합니다.

curl -X GET \
  https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/edge \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <AccessToken>'

요청이 성공하면 200 코드와 appId와 연결된 각 Edge Server 인스턴스에 대한 요약 세부 정보가 포함된 객체 배열의 값을 가진 edge_servers 키가 반환됩니다.

{
  "edge_servers": [
    {
      "id": "6622b8f5118368b943d228a9",
      "created": "2024-04-19T08:51:00Z",
      "name": "Edge-Store-42",
      "user_id": "6622b8f5118368b943d2288a",
      "status": "active",
      "hostname": "ec2-13-58-70-88.us-east-2.compute.amazonaws.com",
      "last_connection": "2024-04-19T09:51:00Z"
    }
  ]
}

배열 에서 삭제 하려는 Edge Server 인스턴스 의 id 를 찾습니다.

엔드포인트 삭제 호출

삭제하려는 에지 인스턴스 의 로 에지 서버 인스턴스 API Edge Server 삭제 삭제 포인트를 호출합니다.ID Edge Server

요청에는 Authorization 관리자 API 액세스 토큰이 베어러 토큰 인 헤더가 포함되어야 합니다.

curl -X DELETE \
  https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/edge/{edgeServerId} \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <AccessToken>'

요청 이 성공적인 하면 200 코드가 반환됩니다.