첫 번째 사이트
GitHub 저장소를 연결하고 처음으로 게시해 보세요.
이 연습은 빠른 시작보다 더 심층적입니다. 리포지토리를 연결하고 Showly가 생성하는 사이트 매니페스트를 살펴보고 편집기에서 직접 변경한 후 출시합니다.
저장소 연결
Workspace 홈에서 사이트 연결을 클릭합니다. GitHub 앱 대화상자가 열립니다. 선택하다:
- 저장소를 소유한 조직 또는 개인 계정
- 연결하려는 저장소
GitHub 앱은 선택한 저장소에 대한 콘텐츠: 읽기 및 쓰기를 요청합니다. GitHub 브랜치별로가 아니라 저장소 수준에서 이를 허용합니다. 제품 정책에 따라 Showly는 showly/* 접두사 아래의 분기에만 커밋됩니다. 기본 브랜치로 푸시되지 않습니다.
승인 후 작업공간에 저장소가 가져오는 중 상태로 나타납니다.
사이트 매니페스트 검토
가져오기 단계에서는 가져온 작업공간에 showly.json 매니페스트를 작성합니다. 이는 자동 감지된 시작점입니다. Showly 저장소를 검사하고 값을 제안합니다. 나중에 모든 필드를 검토하고 재정의할 수 있습니다. 다음과 같습니다.
{
"rootDirectory": ".",
"runtime": "node",
"runtimeVersion": "22",
"packageManager": "pnpm",
"installCommand": "pnpm install",
"buildCommand": "pnpm build",
"output": {
"directory": ".next"
}
}프레임워크는 자동으로 감지되므로(Showly Astro, Vite, Next.js 내보내기 및 일반 정적 HTML 인식) 매니페스트에서 설정한 필드가 아닙니다.
매니페스트는 모든 빌드와 모든 에이전트 컨텍스트 쿼리에 사용되는 정보의 소스 Showly입니다. 저장소의 빌드 프로세스가 변경되면 매니페스트를 편집하세요. Showly의 자동 감지에 맞서지 마세요. 전체 스키마 및 필드 참조는 사이트 매니페스트를 참조하세요.
환경 변수 설정
사이트의 환경 패널을 열고 빌드 및 런타임에 필요한 변수를 설정합니다. Showly 저장소에서 비밀을 읽지 않습니다. 환경별로 설정하므로(preview, production) 미리보기 빌드는 프로덕션과 다른 값을 사용할 수 있습니다.
편집기에서 변경하기
Showly 편집기는 파일 트리 옆에 채팅 패널을 엽니다. 노력하다:
짧은 소개와 함께 새로운 경로 /about를 추가하세요.
에이전트는 생성할 파일을 나열하는 변경 계획으로 응답합니다. 계획 적용을 클릭하면 격리된 작업공간에서 패치를 구체화하고 빌드하고 미리보기를 제작할 수 있습니다.
빌드는 queued → building를 거쳐 ready에 도달합니다(일반적으로 작은 변경에는 1분 미만이 소요됩니다). ready에 도달하면 미리보기 URL이 미리보기 패널에 나타납니다. 이 패널을 열어 격리된 미리보기 배포에서 변경 사항을 실시간으로 확인하세요. 대신 빌드가 failed로 끝나면 배포를 확장하여 빌드 로그를 읽고 문제(종종 매니페스트의 빌드 명령 또는 런타임 설정)를 수정한 후 다시 적용하세요.
게시
릴리스 패널에서 출시하려는 ready 미리보기를 선택하세요. 게시에는 OTP/MFA 등록이 필요하지 않습니다.
승인할 수 있는 사람은 귀하의 계획에 따라 다릅니다. 승인 워크플로가 활성화된 계획에서 게시 요청에는 owner 또는 admin의 승인이 한 번 필요하며 요청자는 자체 승인할 수 없습니다. Free 및 Pro에는 두 번째 검토자가 없습니다. 게시를 클릭하거나 상담원의 2단계 publish_site 확인을 사용하세요.
방금 운동한 내용
- GitHub 가져오기 → 사이트 매니페스트
- 환경별 환경 변수
- 채팅 → 계획 변경 → 패치 → 미리보기
- 승인 → 제작출시
이것이 전체 게시 루프입니다. Showly의 모든 이후 작업 흐름은 이 동일한 경로의 변형입니다.