앱 환경 구성

새 값 만들기

App Services UI의 왼쪽 탐색 메뉴에서 Values 을 클릭한 다음 Create New Value 를 클릭합니다.

값의 이름을 입력하고 값 유형으로 Environment 을 선택합니다.

각 환경에 대한 값 정의

값에 액세스하려는 각 환경 태그의 값을 정의합니다. 각 환경에 대해 서로 다른 값을 정의할 수 있으며 모든 환경에서는 정의되지 않은 값을 남겨 둘 수 있습니다.

앱 환경 지정

앱은 항상 모든 환경 값의 값에 영향을 미치는 특정 환경에서 실행됩니다. Deploy > Environment 화면에서 앱의 현재 환경을 지정할 수 있습니다.

저장 및 배포

환경 값을 정의한 후 Save 를 클릭하여 구성을 업데이트합니다. 애플리케이션에 배포 초안이 활성화되어 있는 경우 Review & Deploy 를 클릭하여 변경 사항을 배포합니다.

MongoDB Atlas 사용자 인증하기

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

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

앱의 최신 버전 가져오기

앱 구성 파일의 로컬 복사본을 가져옵니다. 최신 버전의 앱을 받으려면 다음 명령을 실행합니다.

appservices pull --remote="<Your App ID>"

UI에서 또는 Admin API를 사용하여 애플리케이션 구성 파일의 사본을 내보낼 수도 있습니다. 방법을 알아보려면 앱 내보내기를 참조하세요.

하나 이상의 환경 정의

/environments 디렉토리에는 지원되는 각 환경 태그에 대한 .json 파일이 포함되어 있습니다. 각 파일은 해당 환경에 대한 모든 환경 값을 정의합니다.

Atlas App Services는 다음 환경 태그를 지원합니다.

• ""

• "development"

• "testing"

• "qa"

• "production"

사용하려는 각 환경에 대한 파일을 엽니다. 각 파일에서 값의 이름을 해당 환경의 값에 매핑하는 항목을 values 하위 문서에 추가합니다.

{
  "values": {
    "baseUrl": "https://example.com"
  }
}

{
  "values": {
    "baseUrl": "https://dev.example.com"
  }
}

앱 환경 설정

앱은 항상 모든 환경 값의 값에 영향을 미치는 특정 환경에서 실행됩니다. root_config.json 에서 앱의 현재 환경을 지정할 수 있습니다.

{
  ...,
  "environment": "development"
}

앱 배포

각 환경에 대한 값을 정의한 후에는 업데이트된 구성을 원격 앱에 Atlas App Services CLI로 푸시할 수 있습니다. App Services CLI는 푸시 시 업데이트된 환경 값을 즉시 배포합니다.

appservices push --remote="<Your App ID>"

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 은(는) Atlas App Services Admin API에 대한 액세스 권한을 부여합니다. 모든 관리자 API 요청에 대해 이를 Authorization 헤더에 베어러 토큰으로 포함해야 합니다.

환경 값 정의

환경 값 생성 엔드포인트를 호출하여 앱의 환경 값을 정의할 수 있습니다. 각 환경 값에는 이름과 환경 태그를 환경의 값에 매핑하는 values 객체가 있습니다.

curl -X GET \
  https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/environment_values/{environmentValueId} \
  -H 'Authorization: Bearer <access_token>' \
  -d '{
    "name": "myEnvironmentValue",
    "values": {
      "none": "alpha",
      "development": "beta",
      "testing": "gamma",
      "qa": "delta",
      "production": "epsilon"
    }
  }'

앱 환경 설정

앱 환경 설정 엔드포인트를 호출하여 앱의 환경 태그를 설정할 수 있습니다.

curl -X PUT \
  https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/environment \
  -H 'Authorization: Bearer <access_token>' \
  -d '{ "environment": "production" }'