Parallax Cloud 시작하기

Parallax Cloud 는 GitHub 저장소를 연결해 두면 푸시할 때마다 자동으로 빌드하고 배포해 주는 서비스입니다. cloud.parallax.kr 에서 이용하실 수 있습니다.

어떤 계정으로 로그인하나요

Parallax 계정으로 로그인합니다. 이메일, Google, Apple 로그인을 쓸 수 있고, parallax.kr 에서 쓰시던 계정을 그대로 쓰시면 됩니다. 계정이 없다면 cloud.parallax.kr 에서 바로 가입하실 수 있습니다.

첫 배포는 어떻게 하나요

1. 로그인한 뒤 새 프로젝트 화면에서 GitHub 계정 연결을 누릅니다.
2. GitHub 에서 Parallax Cloud GitHub App 을 설치하고, 배포할 저장소에 접근을 허용합니다.
3. 저장소 목록에서 배포할 저장소 옆의 가져오기를 누릅니다.
4. 프로젝트 설정 화면에서 프로젝트 이름, 프로덕션 브랜치, 프레임워크와 빌드 설정을 확인합니다. 필요한 환경 변수가 있으면 이때 함께 넣습니다.
5. 배포를 누르면 첫 배포가 바로 시작됩니다.

그다음부터는 프로덕션 브랜치에 푸시할 때마다 자동으로 프로덕션에 배포되고, 다른 브랜치에 푸시하거나 풀 리퀘스트를 열면 프리뷰 배포가 만들어집니다.

비공개 저장소나 조직 저장소도 되나요

네. GitHub App 에 접근을 허용한 저장소라면 비공개 저장소도 가져오실 수 있습니다. 조직 저장소는 조직 관리자가 앱 설치를 승인해야 합니다. 설치 승인을 요청한 상태라면 승인된 뒤 다시 연결해 주세요.

저장소 목록에 원하는 저장소가 보이지 않으면 GitHub 에서 저장소 권한 설정을 눌러 그 저장소에 대한 접근을 허용해 주세요. 다른 GitHub 계정이나 조직을 더 연결하려면 GitHub 계정 추가를 누르시면 됩니다.

어떤 프레임워크를 지원하나요

저장소의 package.json 을 보고 프레임워크를 자동으로 감지해 빌드 명령과 출력 폴더를 채워 둡니다. 다음 프리셋을 제공합니다.

• Next.js (Static Export), Vite, Create React App, Astro, SvelteKit (adapter-static), Nuxt (generate), Gatsby, Vue CLI, Angular, Docusaurus
• 기타 (package.json 의 build 스크립트 실행)
• 정적 파일 (빌드 없이 저장소 파일을 그대로 올림)

Parallax Cloud 는 정적 산출물(SSG, SPA)만 서빙합니다. 서버리스 함수, 서버 사이드 렌더링(SSR), API 라우트, 미들웨어는 지원하지 않습니다. Next.js 는 next.config 에 output: 'export' 가 있어야 배포할 수 있습니다.

배포하면 어떤 주소가 생기나요

프로젝트마다 무료 기본 주소가 하나 생깁니다.

• 프로덕션: 프로젝트ID.parallax.kr
• 브랜치 프리뷰: 프로젝트ID--브랜치이름.parallax.kr (그 브랜치의 최신 배포)
• 배포별 고정 주소: 배포 하나하나에도 따로 주소가 붙습니다. 배포 상세 화면에서 확인하실 수 있습니다.

프로젝트 ID 는 처음 정한 프로젝트 이름으로 만들어집니다. 영문 소문자, 숫자, 하이픈으로 바뀌고, 이미 쓰이는 이름이면 뒤에 임의의 문자가 붙습니다. 프로젝트 ID 는 주소에 쓰이기 때문에 나중에 바꿀 수 없습니다. 브랜치 이름의 / 나 대문자 같은 문자는 주소에 맞게 하이픈과 소문자로 바뀝니다.

프리뷰 주소는 검색 엔진에 노출되지 않도록 처리됩니다.

요금이 드나요

무료 플랜으로도 프로젝트 3개까지 배포하실 수 있습니다. 플랜에 따라 프로젝트 수, 하루 배포 수, 동시 빌드 수, 빌드 제한 시간, 커스텀 도메인 수가 달라집니다. 자세한 한도는 플랜별 한도, 액세스 토큰, 프로젝트 관리 문서를 참고해 주세요.

도움이 필요하면

1:1 문의에서 서비스를 Parallax Cloud 로 골라 주시고, 프로젝트 이름(또는 프로젝트 ID)과 문제가 생긴 배포의 주소나 ID, 화면에 나온 오류 문구를 함께 적어 주세요. 액세스 토큰이나 환경 변수의 비밀 값은 문의 내용에 절대 적지 마세요.