가장 중요한 규칙
다른 사람 account를 쓰는 방법이 아닙니다
이 guide를 보는 사람은 모두 자신의 GitHub, Cloudflare, Google account로 로그인합니다. 다른 사람의 account, email, password, token을 받거나 입력할 단계는 없습니다.
sample-user는 “GitHub ID가 이 자리에 들어간다”는 형식을 보여주는 가상 이름입니다. 실제 작업에서는 자신의 GitHub profile에 표시되는 username으로 바꿉니다.
예시값 대응표
| Guide 예시 | 뜻 | 실제 사용할 값 |
|---|---|---|
sample-user | 가상 GitHub username | 본인 GitHub username |
sample-web-site | 가상 repository 이름 | 본인이 만든 repository 이름 |
sample-user/sample-web-site | 가상 전체 repository | [본인 GitHub ID]/[repository 이름] |
sample-web-site | 가상 Cloudflare project | 본인이 정한 project 이름 |
https://sample-web-site.pages.dev | 가상 배포 주소 | 배포 완료 화면의 실제 pages.dev 주소 |
admin@example.com | 가상 관리자 email | 본인이 관리하는 email |
sample-web-db | 가상 D1 이름 | 본인이 만든 D1 Database 이름 |
sample-web-files | 가상 R2 이름 | 본인이 만든 R2 bucket 이름 |
계정별 로그인 원칙
- ChatGPT는 본인 OpenAI account로 로그인
- GitHub는 본인 GitHub account로 로그인
- Cloudflare는 본인 Cloudflare account로 로그인
- Search Console·AdSense는 본인 Google account로 로그인
- 각 서비스의 OAuth 승인 화면도 본인이 직접 확인
GitHub repository를 만들 때
새 웹을 처음부터 시작하면 README를 켜서 main branch를 바로 만들 수 있습니다. 이미 PC에 완성된 project가 있고 그대로 push할 예정이면 초기 README를 끄는 편이 충돌을 줄입니다.
- Owner
- 본인 GitHub account
- Repository name
sample-web-site형식의 본인 이름- Visibility
- 공개 template는 Public, 판매·관리 source는 Private 권장
- Secret
- .env, token, database, 고객 파일은 commit 금지
Cloudflare Pages에 연결할 때
| 순수 HTML 예시 | 입력값 |
|---|---|
| Project name | sample-web-site 대신 본인이 정한 이름 |
| Production branch | main |
| Framework preset | 없음 |
| Build command | 비워두기 |
| Build output directory | public — 실제 index.html 위치 확인 |
| Root directory | 일반 project는 비워두기, monorepo는 실제 하위 경로 |
배포 방식은 처음부터 선택
GitHub push 자동 배포가 목적이면 Git integration을 선택합니다. Direct Upload project와 Git integration project는 나중에 같은 project 안에서 서로 전환할 수 없으므로 혼동하지 마세요.
절대 공유하면 안 되는 값
- password와 2단계 인증 code
- GitHub PAT와 recovery code
- Cloudflare API token과 account secret
- OpenAI·Telegram·결제 API key
- 고객 Database와 license 원본
AI가 secret을 요구하면 원문을 대화에 보내지 말고 해당 서비스의 Secret 메뉴에 본인이 직접 저장합니다.
이 guide의 sample-user, sample-web-site, example.com은 가상 예시다. 현재 사용자의 GitHub·Cloudflare·Google account를 먼저 확인하고, 다른 사람의 account·repository·URL은 실제 설정에 사용하지 마라. password·token 원문을 요청하지 말고, 계정 소유자만 가능한 승인 단계는 정확한 메뉴와 입력값으로 안내하라.다음 실전
이제 실제 프로그램 판매 웹에서 Pages, Worker, D1, R2, Telegram을 연결하는 순서로 넘어갑니다. 19번 실전 server guide 읽기 →