함께 만들기 옵션

조립 계획 카드 아래쪽의 「데모 데이터」 · 「소개 페이지 (Pages)」 · 「운영 콘솔」이 무엇을 바꾸는지, Pages 저장소 이름을 정하는 법과 게시가 하는 일을 설명합니다.

제공 중 마지막 확인: 2026-10-09

「조립 계획」 카드 아래쪽의 「함께 만들기」에서 기본 조립에 곁들일 것을 고릅니다. 요구마다 달라지는 값이라, 계획을 보고 정하도록 카드에 있습니다. 체크는 「확인하고 실행」을 누를 때 한꺼번에 쓰이고, 그 전에는 마음대로 바꿔도 아무것도 만들어지지 않습니다.

세 가지 체크

옵션	처음 상태	켜면
데모 데이터	켬	cob 에 `--demo` 를 넘겨 서버 없이 도는 데모 모드로 조립하라고 알립니다. cob 는 이 선택을 만든 프로젝트의 `project.yaml` 에 `demo: true` 로 남깁니다
소개 페이지 (Pages)	켬	실행 단계에 마지막 「Pages 게시」가 더해집니다. GitHub 에 저장소를 만들고 Pages 로 배포합니다
운영 콘솔	끔	cob 에 `--console` 을 넘깁니다. 운영 콘솔 앱을 프로젝트에 넣습니다

「소개 페이지 (Pages)」를 켜면 카드에 「Pages 저장소」 줄이 생기고, 카드 아래쪽의 단계 줄에 → Pages 게시 가 붙습니다.
이 세 가지는 요구 문장으로 정하지 않습니다. 요구에 쓴 말은 체크에 영향을 주지 않습니다(요구 쓰기).
「확인하고 실행」으로 확정한 체크는 같은 대화의 다음 요구에서 시작값으로 이어집니다. 확인하기 전에 요구를 다시 보내면 체크는 마지막으로 확인한 계획의 값으로, 확인한 적이 없으면 위 표의 처음 상태로 돌아갑니다. 「Pages 저장소」 칸에 직접 쓴 owner/name 은 이어지지 않고, 새 카드는 다시 coco-de/<폴더 이름> 으로 시작합니다.
데모 데이터와 운영 콘솔이 만드는 파일의 정확한 구성은 cob 가 정하고, 계획에 레시피가 있는지에 따라서도 달라질 수 있습니다. 이 문서는 앱이 cob 에 넘기는 값과 cob 문서가 밝히는 결과까지만 설명합니다.

Pages 게시가 하는 일

「소개 페이지 (Pages)」를 켜고 실행하면, 검증이 끝난 뒤 마지막 단계로 아래 일이 일어납니다. 이름이 통과하면 카드의 「Pages 저장소」 줄 아래 글도 같은 말을 합니다.

GitHub 에 비공개 저장소를 만듭니다.
만든 프로젝트를 그 저장소에 push 합니다.
GitHub Pages 로 배포합니다.

이 단계는 만든 프로젝트가 다른 Git 저장소 안에 있으면 시작하기 전에 거절합니다. 생성 위치로 연 폴더가 Git 저장소인 경우입니다(실행 결과와 게시의 경고).

주의

「소개 페이지 (Pages)」는 처음부터 켜져 있고, 저장소 소유자 기본값은 coco-de 입니다. 이 앱이 프로젝트를 올려 주는 곳은 GitHub Pages 하나이고, 스토어 출시나 다른 호스팅은 없습니다. 기본 저장소 이름은 coco-de/<프로젝트 폴더 이름> 이므로, 그 소유자에 저장소를 만들 권한이 없다면 본인 GitHub 의 owner/name 으로 고치거나 체크를 꺼서 Pages 없이 시작하세요. 본인 소유자로 고쳐도 배포 빌드에 필요한 시크릿이 없으면 첫 배포가 실패할 수 있습니다(아래 「자주 겪는 문제」). 게시에는 gh 로그인이 필요하고, 비공개 저장소의 Pages 를 쓰려면 GitHub 유료 요금제가 필요하며 배포된 사이트는 기본으로 누구나 볼 수 있습니다(빠른 시작의 경고).

저장소 이름 정하기

형식은 owner/name 입니다. owner 는 영문 · 숫자와 안쪽 하이픈, name 은 영문 · 숫자 · . · _ · - 로 씁니다. coco-de/clinic-emr · my-account/site.v2 같은 이름이 맞는 모양입니다.
처음에는 프로젝트 이름에서 만든 coco-de/<폴더 이름> 이 들어 있고, 이름 칸을 고치면 저장소 칸이 따라 바뀝니다. 저장소 칸을 한 번이라도 직접 고치면 그때부터는 따라가지 않습니다.
이름을 쓰면 잠시 뒤 gh 로 그 저장소가 이미 있는지 읽기 전용으로 확인합니다. 줄 아래의 글이 결과를 알려 줍니다.

줄 아래의 글	뜻	「확인하고 실행」
「owner/name 모양으로 써 주세요 — 예: coco-de/clinic-emr」	형식이 틀렸습니다	눌러지지 않음
「GitHub 에서 `<저장소>` 확인 중…」	있는지 묻는 중입니다	눌러지지 않음
「`<저장소>` — 이미 있는 저장소입니다. 다른 이름을 쓰거나 Pages 를 끄세요.」	같은 이름이 이미 있습니다	눌러지지 않음
「저장소가 이미 있는지 확인하지 못했습니다(gh) — 있으면 게시 단계에서 멈춥니다. …」	`gh` 가 없거나, 로그인하지 않았거나, 오프라인이거나, 응답이 늦거나, 그 밖의 `gh` 오류로 확인하지 못했습니다	눌러짐
「GitHub 에 `<저장소>` 비공개 저장소를 만들고 push 한 뒤 Pages 로 배포합니다.」	만들 저장소와 하는 일을 알리는 글입니다	눌러짐

내가 볼 수 없는 저장소(다른 사람의 비공개 저장소)는 비어 있는 것으로 읽힐 수 있습니다. 그런 이름이면 확인은 통과해도 게시 단계에서 cob 가 거절합니다. 게시 단계에서 멈췄을 때 이름을 바꿔 다시 게시하는 법은 실행 결과와 게시에 있습니다.

게시를 끄고 만들었다면

Pages 를 끄고 만든 프로젝트를 나중에 이 앱에서 게시하는 단추는 없습니다. 게시 단추는 Pages 를 켜고 돌린 실행이 검증이나 게시에서 멈췄을 때만 실행 카드에 나옵니다. 게시하려면 Pages 를 켠 채로 실행하세요.

자주 겪는 문제

「이미 있는 저장소입니다」가 나옵니다

GitHub 에 같은 owner/name 이 이미 있습니다. 저장소 칸의 이름을 다른 것으로 고치거나, 「소개 페이지 (Pages)」를 꺼서 Pages 없이 시작하세요.

「저장소가 이미 있는지 확인하지 못했습니다(gh)」가 나옵니다

gh 를 찾지 못했거나, 로그인하지 않았거나, 응답이 늦은(8초) 경우 등입니다. 이 글이 보여도 「확인하고 실행」은 눌러지지만, 이미 있는 저장소라면 게시 단계에서 멈춥니다. 터미널에서 gh auth status 가 통과하는지 먼저 확인하세요. 준비물은 준비물에 있습니다.

권한이 없는 소유자에 만들려다 멈췄습니다

기본 소유자 coco-de 에 저장소를 만들 권한이 없으면 게시 단계에서 멈춥니다. 실행 카드의 「이 이름으로 게시」 양식에서 본인 GitHub 의 owner/name 으로 고쳐 다시 게시할 수 있습니다. 양식은 실행 결과와 게시에 있습니다.

「첫 Pages 배포 실패」로 게시가 멈췄습니다

저장소를 만들고 push 한 뒤 GitHub Actions 의 첫 배포가 실패했다는 뜻입니다. cob 는 「Pages 게시 실패: 첫 Pages 배포 실패」와 Actions 실행 주소를 냅니다(배포 환경이 실패하면 「Pages 환경 배포 실패」, 기다리는 시간이 넘으면 「첫 Pages 배포 확인 시간 초과」). 이 메시지는 멈춘 실행 카드의 빨간 상자에 사유로 보일 수 있고 아래쪽 「디버그 로그」에도 남습니다. cob 는 Pages 배포 빌드에 비공개 패키지를 읽는 SUBMODULE_TOKEN 시크릿이 필요하다고 안내하므로, 소유자를 본인 계정으로 고쳤다면 그 시크릿을 저장소가 쓸 수 있는지(개인 계정이면 그 저장소의 Actions 시크릿, 조직이면 저장소 또는 조직의 Actions 시크릿)부터 확인하세요. 실제 원인은 해당 Actions 실행의 로그에 있습니다.

다음 단계

실행하면 무엇이 보이는지는 실행 결과와 게시로 이어서 보세요.