GitHub를 통해 자동 배포하기

Atlas App Services GitHub 앱 설치하기

GitHub 저장소를 기반으로 자동 배포하려면 Atlas App Services에서 최소한 저장소에 대한 읽기 액세스 권한이 있는 GitHub 앱을 설치해야 합니다.

앱을 설치하려면 App Services UI의 왼쪽 탐색 메뉴에서 Deployment를 클릭합니다. Configuration 탭을 선택한 다음 Install App Services on GitHub를 클릭합니다. 새 브라우저 창이 열리고 GitHub 애플리케이션 설치 흐름이 표시됩니다.

앱을 설치하려는 GitHub 계정 또는 조직을 선택합니다.

App Services 읽기 액세스 권한을 부여하려는 저장소를 한 개 이상 지정합니다. 특정 저장소를 선택하거나 GitHub의 모든 저장소에 대한 액세스 권한을 부여할 수 있습니다. 사용하려는 저장소를 선택한 다음 Install를 클릭합니다.

애플리케이션을 설치한 후 Configuration 탭으로 돌아가서 Authorize 버튼을 클릭하여 GitHub에 대한 App Services 연결을 완료합니다. 그러면 Github 권한 화면으로 이동합니다. Authorize MongoDB Atlas App Services를 클릭합니다.

GitHub 저장소 지정

GitHub 계정을 앱에 연결한 후에는 App Services에서 자동으로 배포해야 하는 리포지토리를 지정할 수 있습니다. 앱의 구성 파일이 포함된 Repository, Branch 및 Directory를 지정한 다음 Save을 클릭합니다.

리포지토리 초기화하기

지정한 Git 리포지토리의 로컬 복사본을 복제합니다.

git clone https://github.com/<organization>/<repo>.git

구성된 브랜치 및 디렉토리에는 애플리케이션을 정의하는 구성 파일이 포함되어야 합니다. 구성을 수동으로 생성하거나 기존 앱의 애플리케이션 디렉토리를 내보낼 수 있습니다.

애플리케이션 디렉토리를 저장소에 추가한 다음 변경 사항을 커밋합니다.

git add -A
git commit -m "Adds App Services Application Directory"

최신 버전의 애플리케이션을 리포지토리에 커밋한 후 이를 GitHub 리포지토리에 푸시합니다.

git push origin <branch name>

자동 배포 허용하기

배포할 저장소를 지정하고 최신 버전의 앱으로 초기화한 후 자동 배포를 허용해야 배포를 시작할 수 있습니다. Deploy 페이지의 Configuration 탭에서 Enable Automatic Deployment를 클릭합니다. 표시되는 모달에서 Enable Automatic Deployment를 클릭하여 선택을 확인합니다.

애플리케이션 변경하기

배포에는 이전 배포 이후 애플리케이션에 적용한 하나 이상의 변경 사항이 포함됩니다. 배포에 포함할 리포지토리를 추가, 수정 또는 삭제합니다.

애플리케이션 디렉토리의 구조 및 스키마에 대한 자세한 내용은 앱 구성 참조 페이지 및 개별 구성 요소 참조 페이지를 확인해 보세요.

변경 사항 커밋 및 푸시

애플리케이션 구성을 업데이트한 후에는 지정한 GitHub 리포지토리에 업데이트를 푸시하여 업데이트를 앱의 새 버전으로 배포할 수 있습니다. 자동 GitHub 배포를 사용하도록 설정하면 App Services는 구성된 브랜치 및 디렉토리에 대한 최신 커밋을 즉시 배포합니다.

배포할 준비가 되면 포함하려는 모든 파일을 커밋한 다음 GitHub에 푸시합니다.

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

GitHub에 변경 사항을 성공적으로 푸시하면 App Services는 최신 커밋 상태와 일치하는 새 버전의 애플리케이션을 즉시 배포합니다. 클라이언트 애플리케이션은 자동으로 최신 버전을 사용하므로 필요한 경우 새 버전을 사용하도록 클라이언트 코드도 업데이트해야 합니다.

MongoDB Atlas 사용자 인증하기

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

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

배포 구성 명령 실행

App Services CLI는 자동 배포를 구성하는 프로세스를 안내할 수 있습니다. 이는 대화형 명령입니다.

appservices deploy configure

이 명령은 선택적으로 포함할 수 있는 추가 플래그도 지원합니다. 이러한 플래그에 대한 자세한 내용은 appservices 배포 구성을 참조하세요.

이 명령을 완료하면 Atlas App Services CLI가 즉시 자동 배포를 활성화합니다. enable 명령을 추가 단계로 실행할 필요가 없습니다.

구성 세부 정보 비활성화, 활성화 또는 보기(선택 사항)

자동 배포를 구성한 후 Atlas App Services CLI를 사용하여 구성 세부 정보를 볼 수 있습니다.

appservices deploy describe

Atlas App Services CLI를 사용하여 자동 배포를 비활성화 및 활성화할 수도 있습니다. 이러한 명령과 해당 옵션에 대한 자세한 내용은 appservices 배포를 참조하세요.

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 헤더에 베어러 토큰으로 포함해야 합니다.

기존 배포 구성 가져오기(선택 사항)

배포 구성 가져오기 엔드포인트에 GET 요청을 수행하여 앱 의 기존 배포 구성을 가져올 수 있습니다.

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

배포 구성 업데이트

배포 구성 엔드포인트에 PATCH 요청을 수행하여 앱의 기존 배포 구성을 업데이트할 수 있습니다.

curl -X PATCH \
   https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/deploy/config \
   -H 'Authorization: Bearer <access_token>' \
   -d '{
      "ui_drafts_disabled": true,
      "automatic_deployment": {
         "enabled": true,
         "provider": "github",
         "installation_ids": [
            "string"
         ]
      },
      "last_modified": 0
      }'