Docker 이미지 배포
Docker 컨테이너 호스팅
이미 빌드하고 배포하는 컨테이너 이미지를 실행하세요. Polyer가 서비스 배포를 관리하고 사용자는 이미지 버전, 실행 설정, 데이터 요구 사항을 정합니다.
설정 확인 목록
- 이미지와 버전: 실행할 레지스트리 경로, 태그 또는 다이제스트를 확인하세요. 버전을 바꾸기 전에 원본 프로젝트의 업그레이드 안내를 읽으세요.
- 레지스트리 인증 정보: 비공개 이미지의 인증 정보를 설정하고 대상 레지스트리에 접근할 수 있는지 확인하세요.
- 컨테이너 네트워크: 수신 포트를 설정하고 외부 트래픽이 필요한 서비스에만 공개 엔드포인트를 설정하세요.
- 상태 검사와 시작: 검사 경로, 제한 시간, 트래픽 수신 전에 끝나야 하는 앱 초기 설정을 확인하세요.
- 영속 데이터: 필요한 데이터 디렉터리를 볼륨에 연결하고 독립 백업이 필요한 데이터를 확인하세요.
설정에서 배포까지
이미지 선택
워크스페이스를 열고 프로젝트와 환경을 선택한 다음 대상 Docker 이미지 주소를 입력하세요.
이미지 접근 설정
비공개 이미지라면 레지스트리 인증 정보를 선택하거나 설정하세요. 이미지 버전과 앱 실행 요구 사항을 확인하세요.
실행 설정 검토
변수, 포트, 리소스, 상태 검사, 볼륨을 설정하세요. 외부 접근이 필요 없는 데이터베이스는 비공개 연결로 유지하세요.
배포 및 검증
설정을 제출하고 배포 및 실행 로그를 확인한 뒤 엔드포인트를 테스트하세요. 서비스 재시작 후에도 데이터를 사용할 수 있는지 확인하세요.
서비스 운영과 유지 관리
- 이미지 업데이트를 계획적으로 검토하세요. 다른 버전을 배포하기 전에 릴리스 안내, 마이그레이션, 영속 저장 동작을 확인하세요.
- 상태 검사는 설정된 엔드포인트를 확인합니다. 앱의 중요한 흐름과 의존 서비스 연결은 별도로 테스트하세요.
- 레지스트리 인증 정보를 유효하게 유지하고 영속 데이터 복구 계획을 마련하세요. 마운트한 볼륨은 검증된 백업을 대신하지 않습니다.
배포 전 자주 묻는 질문
특권 컨테이너나 호스트 파일 마운트를 사용할 수 있나요?
서비스에는 호스트 접근 권한이 없습니다. 앱에 특권 모드, 호스트 장치 또는 Docker 소켓이 필요하다면 이 배포 방식을 선택하기 전에 해당 요구 사항을 해결하세요. 정적 파일은 이미지에 포함하고 저장할 앱 데이터에는 영구 볼륨을 사용하세요. Compose의 로컬 바인드 마운트가 기존 파일을 Polyer로 전송하지는 않습니다.
이미지를 가져올 수 없으면 무엇을 확인해야 하나요?
앱 설정을 바꾸기 전에 배포 오류를 읽으세요. 레지스트리 호스트명, 저장소 이름, 태그 또는 다이제스트가 존재하는지 확인한 뒤 선택한 자격 증명에 가져오기 권한이 있는지 확인하세요. 이미지 접근 오류는 앱 시작 전에 발생하므로 HTTP 포트나 상태 확인 경로를 바꿔도 인증 오류나 이미지 없음 오류는 해결되지 않습니다.
Docker 이미지와 GitHub 코드 배포 중 무엇을 사용해야 하나요?
빌드가 다른 곳에서 실행되거나 앱이 컨테이너로 배포된다면 이미지를 사용하세요. Polyer가 저장소 설정에 따라 빌드하도록 하려면 GitHub 배포를 선택하세요.
컨테이너 파일은 재배포 후에도 유지되나요?
장기 앱 데이터를 컨테이너의 쓰기 가능한 파일 시스템에 의존하지 마세요. 필요한 데이터 경로에 영속 볼륨을 설정하고 앱 저장 동작을 검증하세요.
실행 중인 컨테이너에 접속할 수 없는 이유는 무엇인가요?
앱 바인드 주소, 수신 포트, 엔드포인트 설정, 상태 검사 로그를 확인하세요. 필수 변수와 의존 서비스 연결도 검토하세요.
워크스페이스에서 설정
로그인하면 워크스페이스가 열립니다. 배포 설정을 제출한 후에만 리소스가 생성됩니다.