앱 배포 가이드
코드를 올리면 Pier가 빌드해서 사내에서 바로 열리는 HTTPS 주소를 만들어 줍니다. 서버·인증서·도메인은 신경 쓸 필요 없습니다.
어떻게 배포하나
앱 준비
코드가 Git 저장소(사내 GitLab 등)에 있거나 zip으로 압축돼 있으면 됩니다. 표준 프로젝트 구조면 Pier가 언어·프레임워크(Node·Python·Go·정적 등)를 자동 감지해 빌드합니다.
$PORT에서 리슨
웹앱·API·정적 사이트는 환경변수 PORT에서 리슨해야 합니다. Pier가 PORT=3000을 주입하니 코드에서 process.env.PORT(또는 언어별 동등물)를 읽어 바인딩하세요. 하드코딩한 포트는 URL과 어긋납니다.
“+ 새 앱”에서 등록
상단 + 새 앱 → 이름(소문자·숫자·하이픈) 입력 → 유형 선택 → 소스로 Git URL+브랜치 또는 zip 선택 → 배포. 배치 잡이면 cron 스케줄을 함께 넣습니다.
빌드 대기 & URL 확인
빌드는 보통 수십 초, 최대 10분까지 걸립니다. 끝나면 앱 상세에서 상태가 실행 중으로 바뀌고 이름.도메인 형태의 HTTPS URL이 발급됩니다. 배포 이력에서 성공/실패를 볼 수 있습니다.
환경변수·접근 설정
앱 상세에서 환경변수(KEY=value)를 추가하고, 접근을 “초대한 멤버만” 또는 “사내 로그인 전체”로 정합니다. (PORT는 Pier 예약 키라 덮어쓸 수 없습니다.)
어떻게 배포되나
Pier는 이 과정을 Dokploy 위에서 자동 실행합니다. 빌드가 끝나면 리버스 프록시(Traefik)가이름.도메인을 컨테이너로 연결하고 Let's Encrypt 인증서를 자동 발급합니다.
유형별 참고
$PORT에서 HTTP 요청을 받도록 서버를 띄우면 됩니다.
빌드 산출물을 서빙합니다. 정적 서버도 $PORT를 따릅니다.
cron 스케줄로 주기 실행. 앱 상세의 지금 실행으로 수동 실행도 가능합니다.