GitHub 저장소 호스팅
GitHub에서 앱 배포
호스팅 서버를 직접 유지 관리하지 않고 코드 저장소를 실행 중인 앱으로 만드세요. GitHub를 연결하고 빌드할 코드를 선택하고 Polyer 프로젝트에서 앱 설정을 관리하세요.
설정 확인 목록
- 저장소 접근과 브랜치: 대상 저장소를 승인하고 배포할 버전이 있는 브랜치를 선택하세요.
- 빌드 경로와 명령: 앱 디렉터리, 빌드 설정, 실행 시작 명령이 프로젝트에 맞는지 확인하세요.
- 실행 변수: 필요한 인증 정보와 환경별 값을 설정하고 비밀 정보를 브라우저 코드에 넣지 마세요.
- 네트워크와 데이터: 수신 포트, 도메인 설정, 데이터베이스 참조, 영속 볼륨 경로를 확인하세요.
설정에서 배포까지
저장소 연결
Polyer에 로그인하고 프로젝트를 연 다음 배포 권한이 있는 GitHub 저장소를 연결하세요.
빌드와 환경 선택
저장소 브랜치와 대상 환경을 선택하세요. 앱 디렉터리, 빌드 설정, 시작 명령을 검토하세요.
서비스 설정 검토
필요한 변수, 리소스 설정, 다른 서비스와의 연결을 설정하세요. 준비된 변경 사항을 검토한 후 배포를 제출하세요.
배포 결과 확인
배포 로그와 실행 출력을 확인하세요. 앱 엔드포인트와 데이터베이스 연결을 테스트한 뒤 필요한 초기 설정을 완료하세요.
서비스 운영과 유지 관리
- 배포할 때마다 선택한 브랜치와 대상 환경을 확인하세요. 배포 기록을 검토하고 새 배포가 필요하면 서비스의 재배포 기능을 사용하세요.
- 앱 마이그레이션과 외부 인증 정보 확인을 배포 준비에 포함하세요. 컨테이너가 시작되었다고 앱 흐름이 올바른 것은 아닙니다.
- 운영과 개발 설정을 분리하세요. 환경과 서비스 로그로 빌드 실패, 시작 오류, 연결 문제를 진단하세요.
배포 전 자주 묻는 질문
모노레포에서 앱 하나만 배포하려면 어떻게 하나요?
서비스의 루트 디렉터리를 선택하고 빌드에서 필요한 의존성 정의, 잠금 파일, 공유 패키지에 접근할 수 있는지 확인하세요. Dockerfile 경로는 사용할 파일을 지정하며 빌드 컨텍스트 밖의 파일을 추가하지 않습니다. 예를 들어 apps/web이 packages/shared에 의존하면 둘 다 포함하는 컨텍스트를 선택하고 Dockerfile도 맞게 수정하세요.
빌드 명령을 바꿔도 Dockerfile 빌드가 바뀌지 않는 이유는 무엇인가요?
빌드 명령 설정은 Railpack 빌드에 적용됩니다. Dockerfile로 빌드하는 서비스는 Dockerfile 안의 빌드 단계를 수정해야 합니다. 배포 로그에서 실제 사용된 빌더를 확인하세요. CI에서 이미 릴리스 이미지를 만들었다면 Docker 이미지 호스팅으로 저장소를 다시 빌드하지 않고 배포할 수 있습니다.
비공개 GitHub 저장소를 배포할 수 있나요?
GitHub 연동을 통해 저장소 접근 권한을 부여해야 합니다. 서비스 설정 전에 조직과 저장소에 대한 연동 접근 범위를 확인하세요.
브랜치를 바꾸면 운영 환경도 바뀌나요?
브랜치는 앱 코드 소스를 정하고 이름별 환경은 서비스 실행 위치를 정합니다. 배포 전에 두 설정과 준비된 변경 사항을 모두 검토하세요.
GitHub 배포가 실패하면 무엇을 확인해야 하나요?
배포 로그, 저장소 접근, 빌드 경로와 명령부터 확인하세요. 실행 실패는 시작 명령, 변수, 수신 포트, 의존 서비스 연결을 확인하세요.
워크스페이스에서 설정
로그인하면 워크스페이스가 열립니다. 배포 설정을 제출한 후에만 리소스가 생성됩니다.