메인 콘텐츠로 건너뛰기
이 안내는 새 대시보드(v2) 화면 기준입니다. 새 화면에서는 왼쪽 메뉴 내 서버 묶음의 서버 상태와 설치에서 설치를 시작하고, 설치 마법사는 make.magicmealkits.com/v2/deploy에서 열립니다. 이전 화면 make.magicmealkits.com/deploy를 쓰고 계신다면 버튼 위치만 조금 다를 뿐 순서는 같습니다.
매직밀키트는 웹 앱 make.magicmealkits.com에서 설치합니다. 설치 마법사가 매직밀키트 서버를 고객님의 구글 클라우드 프로젝트에 배포합니다. 서버, 데이터, URL 모두 고객님 소유입니다.

사전 준비

매직밀키트 요금제

Basic 또는 Pro 요금제를 구매한 상태여야 합니다.

Gmail 계정

구매할 때와 구글 클라우드에 로그인할 때 같은 Gmail 계정을 써야 합니다.

결제가 켜진 GCP 프로젝트

구글 워크스페이스 계정이 아닌 일반 Gmail 계정으로 설치하세요. 설치 마법사는 일반 Gmail 계정의 구글 클라우드 환경만 지원합니다. Make 계정과 Make에서 연결하는 다른 계정은 워크스페이스 계정이어도 됩니다.

서버 배포

설치 마법사는 화면 위 진행 막대의 계정, 프로젝트와 서버 사양, 배포, 완료 4단계로 나뉩니다. 예전 설치 화면은 5단계였는데, 서버 사양 선택이 프로젝트 단계로 옮겨 갔고 배포 확인 창이 새로 생겼습니다. 대시보드 첫 화면 시작하기의 체크리스트로 보면 2단계 Google Cloud 연결과 3단계 내 서버 설치에 해당합니다.
1

로그인

make.magicmealkits.com에서 Sign in with Google을 누르고 구매할 때 쓴 Gmail 계정을 고릅니다. 로그인 화면은 아직 영어로 나옵니다.
매직밀키트 로그인 화면의 Sign in with Google 버튼
매직밀키트 로그인 화면의 Sign in with Google 버튼 (확대)

확대

구글 계정 선택 화면

예시 화면입니다. 실제로는 이 자리에 Magic Meal Kits 가 보입니다.

구글 계정 선택 화면 (확대)

확대

구매하지 않은 계정으로 들어오면 요금제가 보이지 않아 설치 버튼 대신 요금제 업그레이드가 나옵니다. 이때는 로그아웃하고 구매한 계정으로 다시 로그인하세요.
2

계정: 구글 클라우드 연결

왼쪽 메뉴 내 서버 묶음의 서버 상태와 설치를 엽니다. 아직 서버가 없으면 서버 설치 시작을 눌러 서버 설치 화면(설치 마법사)을 엽니다. 시작하기 체크리스트 3단계의 설치 시작을 눌러도 같은 화면이 열립니다. 처음 들어오면 안내 영상이 뜹니다. 닫아도 됩니다. 다시 보려면 오른쪽 위 가이드 보기를 누르세요. Google로 연결을 누릅니다.
1단계 계정 화면의 Google로 연결 버튼
1단계 계정 화면의 Google로 연결 버튼 (확대)

확대

구글 권한 동의 화면에서 로그인한 계정과 같은 계정을 고르고 허용을 누릅니다. 권한을 일부만 허용하면 프로젝트 목록을 불러오지 못하거나 배포가 실패합니다.
구글 클라우드 권한 동의 화면의 체크 칸

예시 화면입니다. 실제로는 이 자리에 Magic Meal Kits 가 보입니다.

구글 클라우드 권한 동의 화면의 체크 칸 (확대)

확대

권한 항목 옆 체크 칸을 꼭 체크한 뒤 계속을 누르세요.
3

계정: 연결 확인

연결된 이메일과 앱(Basic 또는 Pro)을 확인하고 계속을 누릅니다.
연결된 계정을 확인한 뒤 누르는 계속 버튼
연결된 계정을 확인한 뒤 누르는 계속 버튼 (확대)

확대

4

프로젝트와 서버 사양: 프로젝트 고르기

GCP 프로젝트에서 설치할 프로젝트를 고릅니다. 프로젝트가 없으면 새 프로젝트 만들기를 누릅니다(소문자, 숫자, 하이픈으로 6~30자). 새로 만든 프로젝트는 목록에 나타나기까지 몇 분 걸립니다. 목록에 없으면 잠시 뒤 오른쪽 위 새로고침 버튼을 누르세요.
2단계 화면의 GCP 프로젝트 선택 칸
2단계 화면의 GCP 프로젝트 선택 칸 (확대)

확대

5

프로젝트와 서버 사양: 결제 확인

프로젝트를 고르면 마법사가 결제 상태를 바로 확인합니다. 이 프로젝트에서 결제가 활성화되어 있습니다가 보이면 다음으로 넘어갑니다.결제가 활성화되지 않음이 보이면 배포가 막힙니다. 안내 문구의 이 프로젝트의 결제 페이지를 눌러 결제 계정을 연결한 뒤 돌아와 결제 상태 다시 확인을 누르세요.
결제가 꺼진 프로젝트에서 누르는 이 프로젝트의 결제 페이지 링크
결제가 꺼진 프로젝트에서 누르는 이 프로젝트의 결제 페이지 링크 (확대)

확대

6

프로젝트와 서버 사양: 서버 사양 고르고 배포

서버 사양을 고르고 배포를 누릅니다. 처음에는 무료로 시작해도 되고, 나중에 내 서버 화면에서 바꾸면 됩니다. 서버 사양은 서버의 크기이고, 매직밀키트 요금제(Basic, Pro)와는 다릅니다.
서버 사양을 고른 뒤 누르는 배포 버튼
서버 사양을 고른 뒤 누르는 배포 버튼 (확대)

확대

매직밀키트 실행 자체는 무료입니다. 인프라 비용은 구글 클라우드가 직접 청구하며 무료 제공량이 넉넉합니다. 실제 비용은 사용량과 리전에 따라 달라집니다.
7

배포 확인

Cloud Run에 배포할까요? 창에서 배포를 누릅니다.
배포 확인 창의 배포 버튼
배포 확인 창의 배포 버튼 (확대)

확대

8

배포: 기다리기

서버를 만드는 데 몇 분 걸립니다. 탭을 닫지 말고 기다리세요. 이때 결제 문제가 드러나면 결제 필요 알림과 함께 2단계로 돌아갑니다.
배포 진행 화면의 탭을 열어 두라는 안내
배포 진행 화면의 탭을 열어 두라는 안내 (확대)

확대

9

완료

배포 완료 화면에 서비스 URL이 표시됩니다. 앱 상태 보기를 누르면 내 서버 화면으로 이동합니다.
배포 완료 화면의 앱 상태 보기 버튼
배포 완료 화면의 앱 상태 보기 버튼 (확대)

확대

10

내 서버에서 API 키 확인

내 서버 화면의 접속 정보 칸에서 API 키 옆 복사 버튼으로 키를 복사합니다. 서버 주소(서비스 URL)도 같은 칸에 있습니다. 두 값은 첫 모듈 테스트에서 씁니다. 시작하기 체크리스트 4단계에도 같은 두 값과 서버 응답 확인 버튼이 나옵니다.
앱 상태 화면의 API 키 복사 버튼
앱 상태 화면의 API 키 복사 버튼 (확대)

확대

설치되는 것

설치 프로그램이 서버에 필요한 모든 것을 여러분의 프로젝트에 프로비저닝합니다.
  • Cloud Run 서비스 magic-meal-kits (리전 us-west1)
  • Firestore (default) 데이터베이스: 작업과 동기화 상태
  • BigQuery 데이터셋 threads_data: 검색용 게시물과 답글 저장소
  • Secret Manager, Cloud Tasks
  • 필요한 Google API 및 IAM 역할, 그리고 공개(호출 가능) URL
서비스에 다음 환경 변수도 설정됩니다.

배포 후

서버 URL과 API 키는 내 서버 화면의 접속 정보 칸에 표시됩니다(이전 화면에서는 앱 상태). 직접 만드는 값이 아니니 그 화면에서 복사하세요.

인증

X-API-KEY 헤더와 라이선스 등급 동작.

빠른 시작

배포에 첫 요청을 보내 보세요.

업그레이드(재배포)

서버를 최신 버전으로 올리려면 내 서버 화면 오른쪽 위의 업데이트를 누릅니다(이전 화면에서는 재배포). 확인 창에서 재배포를 한 번 더 누르면 시작됩니다. 같은 화면 위쪽 버전 칸에서 현재 버전을, 마지막 설치 시각은 화면 제목 아래에서 확인합니다. 재배포는 지금 쓰는 서버를 그대로 두고 업그레이드합니다. 실행 중인 컨테이너를 최신 버전으로 바꾸고 새 Cloud Run 리비전을 만듭니다.
앱 상태 화면 오른쪽 위의 재배포 버튼
앱 상태 화면 오른쪽 위의 재배포 버튼 (확대)

확대

재배포해도 데이터는 사라지지 않고, URL과 API 키도 바뀌지 않습니다. 서버 버전만 올라갑니다. 자동 업데이트 알림은 없으니 원하실 때 내 서버 화면에서 직접 업데이트하세요.