App Services 앱 만들기

App Services UI로 이동합니다.

Atlas UI 프로젝트 대시보드에서 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 를 실행하는 Atlas cluster가 필요합니다.0 이상. 클러스터를 설정할 때 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 은(는) Atlas App Services Admin API에 대한 액세스 권한을 부여합니다. 모든 관리자 API 요청에 대해 이를 Authorization 헤더에 베어러 토큰으로 포함해야 합니다.

프로젝트 ID 가져오기

모든 Atlas App Services 앱은 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 클러스터에 대한 정보가 포함된 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 응답을 반환합니다.