앱 업데이트

이 페이지의 내용

개요

기존 앱 업데이트
배포 초안

Atlas Device Sync, Atlas Edge Server, Data API 및 HTTPS endpoints 는 더 이상 사용되지 않습니다. 자세한 내용은 지원 중단 페이지를 참조하세요.

개요

기본 구성을 변경한 다음 변경 사항을 배포하여 기존 앱을 업데이트할 수 있습니다. 여러 가지 방법으로 이 작업을 수행할 수 있습니다.

App Services 관리자 UI: MongoDB Atlas에 내장된 웹 애플리케이션입니다. 여기에는 앱에서 구성하려는 모든 것에 대한 그래픽 인터페이스가 포함되어 있습니다.
App Services CLI: 앱을 로컬에서 구성하고 배포하는 데 사용할 수 있는 명령줄 도구입니다. 앱의 기본 구성 파일로 직접 작업할 수 있습니다.
관리자 API: 프로그래밍 방식으로 앱을 구성하고 배포하는 데 사용할 수 있는 REST API입니다. 관리자 API 요청은 앱의 기본 구성 파일을 읽고 씁니다.
자동 GitHub 배포: 앱 구성을 GitHub 리포지토리와 동기화하는 GitHub 통합입니다. Github를 사용하여 앱의 구성 파일을 managed하고 변경 사항을 리포지토리에 푸시하여 앱을 배포할 수 있습니다.

기존 앱 업데이트

시작하기 전에

Atlas UI에서 앱을 업데이트하려면 다음이 필요합니다.

프로젝트 소유자 권한이 있는 MongoDB Atlas 계정. 무료 계정을 등록하는 방법을 학습 보려면 Atlas 시작하기를 참조하세요.

CLI 에서 앱을 업데이트 하려면 다음이 필요합니다.

프로젝트 소유자 권한이 있는 MongoDB Atlas 계정입니다. 무료 계정을 등록하는 방법은 Atlas 시작하기를 참조하세요.
MongoDB Atlas Admin API 공용/개인 키 쌍. API 키에는 App Services Admin API를 사용하려면 프로젝트 소유자 권한이 있어야 합니다.
로컬 시스템 PATH에 설치 및 추가된 App Services CLI의 사본입니다. 방법을 알아보려면 App Services CLI 설치를 참조하세요.

관리자 API 로 앱을 업데이트 하려면 다음이 필요합니다.

프로젝트 소유자 권한이 있는 MongoDB Atlas 계정입니다. 무료 계정을 등록하는 방법은 Atlas 시작하기를 참조하세요.
MongoDB Atlas Admin API 공용/개인 키 쌍. API 키에는 App Services Admin API를 사용하려면 프로젝트 소유자 권한이 있어야 합니다.

Github 리포지토리 의 구성 파일을 기반으로 앱을 업데이트 하려면 앱에 대해 자동 Github 배포 를 활성화 해야 합니다.

절차

애플리케이션 변경하기

App Services UI를 통해 배포에 포함할 추가, 수정 또는 삭제를 먼저 수행합니다. 초안을 활성화한 경우 변경 사항은 자동으로 초안으로 저장됩니다.

팁

다음도 참조하세요.

배포 초안 비활성화 가이드.

참고

App Services UI 또는 Admin API를 통해서만 초안 변경 사항을 만들 수 있습니다. Github 또는 App Services CLI를 사용하여 변경한 모든 내용은 초안 변경 사항과 독립적으로 배포됩니다. 충돌이나 불일치를 방지하려면 한 번에 한 곳에서 변경하는 것이 가장 좋습니다.

초안 변경 검토

배포하기 전에 애플리케이션에 대한 모든 변경 초안을 검토할 수 있습니다.

왼쪽 탐색 메뉴에서 Deployment 을 클릭하여 앱의 배포서버 기록 테이블로 이동합니다. 표의 맨 위 행은 이전 배포서버 이후 변경된 모든 초안을 나타냅니다.

맨 위 행의 Review Draft and Deploy 버튼을 클릭하면 초안 변경 사항을 나타내는 기본 앱 구성 파일 의 차이점을 볼 수 있습니다.

참고

병합 충돌로 인해 변경 사항의 초안을 다운로드하거나 UI 외부에 초안을 저장할 수 있습니다. Review Draft and Deploy 모달에서 오른쪽 상단에 있는 Export State 을 클릭하여 이를 수행할 수 있습니다. 다운로드를 사용하여 App Services에 변경 사항을 배포하거나 UI에서 변경 사항을 다시 적용할 때 참고로 사용할 수 있습니다.

새 앱 버전 배포

초안 변경 사항을 검토하고 배포할 것을 확인한 후 Deploy 을(를) 클릭합니다. App Services는 초안 변경 사항이 포함된 애플리케이션의 새 버전을 배포합니다. 클라이언트 애플리케이션은 자동으로 최신 버전을 사용하므로 필요한 경우 새 버전을 사용하도록 클라이언트 코드도 업데이트해야 합니다.

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를 사용하여 애플리케이션 구성 파일의 사본을 내보낼 수도 있습니다. 방법을 알아보려면 앱 내보내기를 참조하세요.

애플리케이션 업데이트

애플리케이션의 다양한 구성 요소에 대한 구성 파일 을 추가, 삭제 및 수정합니다.

업데이트된 앱 배포

업데이트된 구성 파일을 원격 앱 에 푸시하여 변경 사항을 배포합니다.

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

새 초안 만들기(선택 사항)

초안은 단일 단위로 배포 하거나 삭제할 수 있는 애플리케이션 변경 사항 그룹 을 나타냅니다. 초안을 생성하지 않으면 업데이트가 자동으로 개별적으로 배포 됩니다.

초안을 생성하려면 새 배포 초안 생성 엔드포인트에 본문 없이 POST 요청 을 보냅니다.

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

중요

사용자당 1개 초안

각 사용자는 UI 또는 관리자 API 를 통해 한 번에 하나의 초안만 만들 수 있습니다. 기존 초안이 이미 있는 경우 배포 초안 삭제 엔드포인트에 DELETE 요청 을 전송하여 기존 초안과 관련된 변경 사항을 삭제할 수 있습니다.

curl -X DELETE 'https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/drafts/{draftId}' \
  -H 'Authorization: Bearer <access_token>'

애플리케이션 변경하기

각 작업에 대해 관리자 API 엔드포인트를 호출하여 앱 을 구성하고 구성 요소를 추가, 수정 또는 삭제 수 있습니다. 예시와 자세한 참고 정보는 Atlas App Services Admin API 를 참조하세요.

초안을 생성하지 않은 경우, Admin API 요청 이 성공적인 때마다 관련 업데이트가 앱에 즉시 배포됩니다.

초안을 만든 경우 Admin API 요청 이 성공적인 때마다 관련 업데이트가 초안에 추가됩니다. 초안에 포함하려는 모든 변경 사항에 대한 요청을 보냅니다.

초안 배포

초안을 만든 경우 배포 초안 엔드포인트에 본문 없이 POST 요청 을 보내 초안의 모든 변경 사항을 배포 할 수 있습니다.

curl -X POST \
  'https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/drafts/{draftId}/deployment' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <access_token>' \

자동 Github 배포를 활성화하면 앱은 항상 연결된 리포지토리 에 있는 가장 최근 커밋 의 구성 파일을 사용합니다. 구성 파일을 구성하고 정의하는 방법에 대한 자세한 내용은 앱 구성을 참조하세요.

로컬에서 구성 파일을 추가, 수정 및 삭제하여 애플리케이션 을 업데이트합니다.

변경 사항을 배포 준비가 되면 구성 파일을 커밋 한 다음 Github 에 푸시합니다.

git add -A
git commit -m "<commit message>"
git push origin <branch name>

푸시하면 Github 통합이 최신 커밋 의 구성 파일을 기반으로 업데이트된 버전의 앱을 자동으로 배포합니다.

배포 초안

배포 초안은 단일 그룹으로 적용하거나 삭제할 수 있는 하나 이상의 앱 업데이트 집합입니다. 초안 배포는 변경 사항에 서로 상호 작용하는 서비스 또는 기능이 포함된 경우 유용합니다.

App Services UI는 기본적으로 배포 초안을 사용합니다. 활성화된 동안 App Services UI에서 앱 구성에 대한 모든 변경 사항은 수동으로 배포하는 초안에 추가됩니다. UI에 저장할 때 즉시 배포하려는 경우 UI 초안을 비활성화 할 수 있습니다.

App Services CLI 및 Github 배포 는 모두 초안을 자동으로 생성하고 배포합니다. 배포 브랜치에 대해 Atlas CLI 푸시 명령 또는 git push 를 실행하면 Atlas CLI 또는 Github 앱은 현재 배포된 구성과 비교하여 로컬 구성 파일의 차이점을 생성합니다. 그런 다음 차이점을 기반으로 초안을 만들고 배포합니다.

App Services Admin API 사용하면 초안을 수동으로 만들고 배포할 수 있습니다. 방법을 알아보려면 변경 사항 그룹 배포를 참조하세요.

초안 충돌

여러 사용자가 UI 또는 API 초안에서 동시에 충돌하는 변경을 수행하지 않도록 합니다. 변경 사항이 충돌하는 동시에 여러 개의 초안이 있는 경우 하나 이상의 초안을 배포할 수 없습니다.

예를 들어 API를 통해 변경 사항을 배포하지만 변경 사항이 충돌하는 기존 UI 초안이 있는 경우 UI 초안이 유효하지 않게 되어 배포할 수 없게 됩니다.

충돌을 복구하려면 Deployment 페이지에서 UI 초안에 대한 구성 파일을 다운로드할 수 있습니다. 이를 참고로 사용하여 UI에서 변경 사항을 다시 적용하거나 Atlas CLI 또는 관리자 API로 변경 사항을 직접 배포할 수 있습니다.

UI 배포 초안 비활성화

UI에 저장할 때 즉시 배포하려는 경우 UI 초안을 비활성화할 수 있습니다. 이 설정은 관리자 API를 사용하여 수동으로 초안을 생성하는 것을 방지하지 않습니다.

UI에서 직접 UI 초안을 비활성화하려면 다음을 수행합니다.

왼쪽 탐색에서 Deployment 을 클릭합니다.
Configuration 탭을 클릭합니다.
Disable Drafts in Atlas App Services 제목 아래에서 Disable Drafts 을 클릭한 다음 모달 창에서 결정을 확인합니다.

관리자 API 를 사용하여 UI 초안을 비활성화하려면 ui_drafts_disabled 을 true 로 설정하다 하여 배포 구성 엔드포인트에 요청 을 보냅니다.

curl -X PATCH https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/deploy/config \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "ui_drafts_disabled": true,
    "automatic_deployment": { "enabled": false, "installationIds": [], "lastModified": 0 }
  }'

돌아가기

앱 메타데이터 가져오기

앱 복사