프리뷰, 롤백, 커스텀 도메인

프로덕션 배포와 프리뷰 배포는 무엇이 다른가요

• 프로덕션: 프로덕션 브랜치(기본은 저장소의 기본 브랜치)에 푸시하면 만들어집니다. 빌드가 끝나면 기본 주소 프로젝트ID.parallax.kr 과 연결한 커스텀 도메인이 이 배포를 보여 줍니다.
• 프리뷰: 그 밖의 브랜치에 푸시하면 만들어집니다. 프로젝트ID--브랜치이름.parallax.kr 주소가 그 브랜치의 최신 배포를 보여 줍니다.

풀 리퀘스트를 열면 커밋에 Parallax Cloud 상태 체크가 붙고, 풀 리퀘스트에 프리뷰 주소가 코멘트로 남습니다. 프리뷰 배포가 필요 없다면 설정의 프리뷰 배포를 끄세요. 프로덕션 브랜치는 설정의 Git 항목에서 바꾸실 수 있습니다.

직접 배포할 수도 있나요

네. 프로젝트의 배포 탭에서 배포하기를 누르고 브랜치를 고르면 그 브랜치의 최신 커밋을 빌드합니다. 설정에서 자동 배포를 끈 경우에는 이 방법으로만 배포됩니다.

이전 배포로 되돌리려면 어떻게 하나요

배포 목록에서 되돌아갈 배포의 메뉴를 열고 이 배포로 롤백을 누르세요. 롤백은 즉시 적용됩니다. 배포마다 빌드 결과가 그대로 보관되어 있어서 다시 빌드하지 않고, 프로덕션 주소와 커스텀 도메인이 가리키는 배포만 바꿉니다.

롤백한 뒤에도 프로덕션 브랜치에 새로 푸시하면 그 새 배포가 빌드를 마치는 대로 프로덕션이 됩니다. 문제가 있는 커밋은 되돌린 뒤 푸시해 주세요.

프리뷰 배포를 그대로 프로덕션으로 올릴 수 있나요

네. 빌드가 끝난(준비됨) 배포라면 메뉴의 프로덕션으로 승격으로 바로 프로덕션에 올릴 수 있습니다. 승격도 다시 빌드하지 않습니다.

다만 프리뷰 배포는 프리뷰용 환경 변수로 빌드된 결과물이 그대로 올라갑니다. 프로덕션과 프리뷰의 환경 변수 값이 다르다면, 승격 대신 프로덕션 브랜치에 병합해 새로 배포해 주세요.

재배포와 롤백은 어떻게 다른가요

재배포는 그 배포와 같은 커밋을 지금의 설정과 환경 변수로 다시 빌드해 새 배포를 만듭니다. 환경 변수를 바꾼 뒤 반영할 때 유용합니다. 프로덕션 배포를 재배포하면 빌드가 끝난 뒤 그 새 배포가 프로덕션이 됩니다. 롤백은 다시 빌드하지 않고 이미 있는 배포로 바로 전환합니다.

진행 중인 배포를 멈추려면

대기 중이거나 빌드 중인 배포는 메뉴의 배포 취소로 멈추실 수 있습니다. 현재 프로덕션에는 영향이 없습니다. 이미 끝난 배포는 취소할 수 없습니다.

내 도메인을 연결할 수 있나요

네. 프로젝트의 도메인 화면에서 도메인 추가를 누르고 도메인(예: www.example.com)을 입력합니다. 그러면 추가할 DNS 레코드가 화면에 나옵니다.

1. 도메인을 산 업체(DNS 관리 화면)에 화면에 나온 레코드를 그대로 추가합니다. 보통 소유권 확인용 TXT 레코드와 트래픽 연결용 CNAME 레코드 두 개입니다.
2. 도메인 화면에서 확인을 누릅니다.
3. 상태가 활성이 되면 연결이 끝난 것입니다. SSL 인증서는 자동으로 발급되고 갱신됩니다.

DNS 변경이 퍼지는 데는 몇 분에서 길게는 몇 시간이 걸릴 수 있습니다. 상태가 DNS 설정 대기나 확인 중이면 잠시 뒤 다시 확인을 눌러 주세요.

example.com 같은 루트 도메인은 CNAME 을 허용하지 않는 업체가 많습니다. 업체가 CNAME 평탄화(ALIAS, ANAME)를 지원하면 그 방식으로 추가해 주세요.

연결할 수 없는 도메인이 있나요

• parallax.kr 아래 주소처럼 Parallax 가 쓰는 도메인은 커스텀 도메인으로 쓸 수 없습니다.
• 이미 다른 프로젝트나 Parallax 사이트에 연결된 도메인은 추가할 수 없습니다. 먼저 그쪽에서 연결을 해제해 주세요.
• 프로젝트당 연결할 수 있는 도메인 수는 플랜에 따라 다릅니다(Free 1개, Pro 10개, Ultra 이상 50개).

도메인마다 다른 브랜치를 보여 주거나 리다이렉트할 수 있나요

네. 도메인 설정에서 다음 중 하나를 고르실 수 있습니다.

• 배포 연결: 기본은 현재 프로덕션 배포를 보여 줍니다. Git 브랜치를 고르면 그 브랜치의 최신 준비된 배포를 보여 줍니다(예: staging.example.com 에 staging 브랜치 연결).
• 리다이렉트: 이 도메인으로 오는 요청을 다른 호스트로 308 리다이렉트합니다. 경로는 그대로 유지됩니다. 대상은 같은 프로젝트에 연결된 다른 도메인이나 프로젝트 기본 주소만 고를 수 있습니다. 예를 들어 example.com 과 www.example.com 을 둘 다 추가한 뒤, example.com 을 www.example.com 으로 리다이렉트하시면 됩니다. 이 경우 두 도메인 모두 도메인 수 한도에 포함됩니다.

도메인을 삭제하면 어떻게 되나요

Parallax Cloud 와의 연결만 끊깁니다. 도메인 업체에 추가한 DNS 레코드는 직접 지워 주세요.

도움이 필요하면

1:1 문의에서 서비스를 Parallax Cloud 로 골라 주시고, 프로젝트 이름, 문제가 된 배포의 ID 나 주소, 도메인 문제라면 도메인 이름과 화면에 보이는 도메인 상태를 적어 주세요. 도메인 업체 계정의 비밀번호나 액세스 토큰은 절대 보내지 마세요.