App Services 앱 만들기

App Services UI로 이동합니다.

Atlas UI Project 대시보드 에서 App Services 탭 을 클릭합니다.

앱 유형 선택

새로운 빈 앱을 생성하거나 일부 서비스가 사전 구성된 템플릿에서 시작할 수 있습니다. 일부 템플릿 앱은 해당 클라이언트 애플리케이션과 함께 제공되기도 합니다.

자세한 내용은 Template Apps를 참조하세요.

프로젝트에 앱이 없는 경우 템플릿에서 새 앱을 생성하거나 처음부터 시작하라는 메시지가 표시됩니다.

아니면 App Services 탭의 오른쪽 상단에 있는 생성 버튼 두 개 중 하나를 선택하세요.

• 빈 앱을 만들려면 Create a New App 버튼을 클릭합니다.

• 템플릿을 사용하려면 Create App from Template을 클릭하고 드롭다운 메뉴에서 템플릿을 선택합니다.

앱 설정 구성하기

다음 설정을 구성하라는 메시지가 UI에 표시됩니다.

• 애플리케이션 이름입니다. 사용자의 앱 이름은 공개되며 클라이언트가 사용하는 앱 ID에 포함됩니다.

  참고

  앱 이름 제한

  애플리케이션 이름은 1자에서 32자 사이여야 하며 ASCII 문자, 숫자, 밑줄 및 하이픈만 포함할 수 있습니다.

• 연결된 데이터 소스. 앱이 액세스할 수 있는 Atlas 클러스터입니다. 프로젝트에 클러스터가 없는 경우 App Services에서 클러스터를 자동으로 생성하도록 할 수 있습니다.

  참고

  MongoDB 5.0 버전 이상 필요

  Atlas Device Sync 에는 MongoDB 버전 5.0 이상을 실행 하는 Atlas cluster 가 필요합니다. 클러스터 를 설정할 때 Additional Settings 아래의 드롭다운 메뉴에서 버전을 선택합니다.

Advanced Configuration에서 다음과 같은 선택 설정을 구성할 수도 있습니다.

• 애플리케이션 리전에 따라 앱이 실행되는 위치와 메타데이터가 저장되는 위치가 결정됩니다. 자세한 내용은 배포 모델 및 리전 항목을 참조하세요.

• 사용할 환경 값을 결정하는 앱 환경입니다. 자세한 내용은 앱 환경 구성하기 항목을 참조하세요.

앱 생성하기

앱을 구성한 후 Create App Service을 클릭합니다.

앱을 생성하면 Atlas UI가 자동으로 App Services 관리 UI로 리디렉션됩니다.

MongoDB Atlas 사용자 인증하기

MongoDB Atlas Admin API 키를 사용하여 CLI에 로그인합니다.

appservices login --api-key="<my api key>" --private-api-key="<my private api key>"

앱 생성 명령 실행

CLI는 단일 명령으로 앱을 생성하고 해당 구성 파일 을 로컬 디렉토리에 복사할 수 있습니다. 이 명령은 앱 이름과 앱을 포함해야 하는 Atlas 프로젝트를 지정하라는 메시지를 표시합니다. 플래그를 사용하거나 대화형으로 명령을 구성할 수 있습니다.

appservices apps create

이 명령은 앱을 사용자 지정하기 위해 선택적으로 포함할 수 있는 추가 플래그도 지원합니다. 다음 표에는 사용할 수 있는 일반적인 플래그가 나열되어 있습니다.

관리자 API 액세스 토큰 가져오기

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 가져오기

모든 App Services App 은 MongoDB Atlas 프로젝트 에 속합니다.

앱을 만들려면 앱이 포함된 MongoDB Atlas 프로젝트의 프로젝트 ID(그룹 ID라고도 함)가 필요합니다. 이 ID를 API 요청의 URL에 포함합니다.

새 앱 만들기

앱 생성 엔드포인트를 통해 새 앱을 생성할 수 있습니다.

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

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

• 새 앱에 대한 name

curl -X POST \
  https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps \
  --header 'Authorization:  Bearer <access_token>' \
  --data '{ "name": "<App Name>" }'

템플릿 에서 앱 을 만들려면 요청 본문에 다음도 포함해야 합니다.

• 사용 가능한 템플릿 앱 중 하나가 포함된 template_id 필드 입니다. 모든 템플릿 앱 목록은 사용 가능한 템플릿 앱을 참조하세요.

• 기존 Atlas cluster 에 대한 정보가 포함된 data_source 필드 입니다.

  curl -X POST \
    https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps \
    -H 'Authorization:  Bearer <access_token>' \
    -d '{
      "name": "<App Name>",
      "template_id": "<Template App Id>",
      "data_source": {
        "name": "mongodb-atlas",
        "type": "mongodb-atlas",
        "config": {
          "clusterName": "<Atlas Cluster Name>"
        }
      }
    }'

앱이 성공적으로 생성되면 API 는 새 앱에 대한 정보가 포함된 201 응답을 반환합니다.