Communitygithub.com

포트폴리오 배포 워크플로우

VS Code에서 GitHub 및 Cloudflare Pages를 통해 정적 포트폴리오 사이트를 배포하고 유지 관리하는 단계별 가이드입니다.

포트폴리오 배포 워크플로우란 무엇인가요?

이 스킬은 VS Code, GitHub, Cloudflare Pages를 사용하여 정적 포트폴리오 사이트를 배포하는 전체 워크플로우를 제공합니다. 개발자는 1회성 설정(라이브 서버, GitLens 등의 VS Code 확장 설치, GitHub 저장소 생성, 로컬 Git 초기화)을 완료한 후, Cloudflare Pages에 저장소를 연결하여 빌드 명령어 없이 정적 사이트를 배포할 수 있습니다. 또한 일간 업데이트 워크플로우(git add/commit/push)를 통해 자동 재배포를 활용할 수 있습니다. 이 워크플로우는 HTML, CSS, JavaScript로 구성된 다국어(영어/베트남어) 포트폴리오 사이트 구조를 지원하며, 프로젝트 카드, 바이오그래피, 강조 색상 등을 쉽게 업데이트할 수 있는 방법을 설명합니다. Cloudflare Pages의 무료 계층에서 커스텀 도메인 및 SSL 인증서 설정도 자동으로 처리되며, 선택적으로 GitHub 콘텐츠 로더를 사용하여 재배포 없이 콘텐츠를 업데이트할 수 있습니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add nguyenvuquochung/nguyenvuquochung-portfolio

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

포트폴리오 배포 워크플로우은(는) 무엇을 하나요?

VS Code → GitHub → Cloudflare Pages


1. 1회성 설정

1.1 VS Code 확장

시작 전에 다음 확장을 설치하세요:

  • Live Server (ritwickdey.liveserver) — 빌드 단계 없이 사이트를 로컬에서 미리보기
  • GitLens (선택 사항) — 향상된 Git 히스토리 보기

1.2 GitHub 저장소 생성

  1. github.com으로 이동 → New repository
  2. 이름: nguyenvuquochung-portfolio (폴더 이름과 일치시켜 혼동 방지)
  3. 공개 여부: Public (무료 Cloudflare Pages에 필수)
  4. README/gitignore를 추가하지 마세요 (이미 로컬에 파일이 있음)

1.3 Git 로컬 초기화

VS Code 터미널(Ctrl+`` )을 열고 실행:

git init
git add .
git commit -m "Initial commit"
git branch -M main
git remote add origin https://github.com/YOUR_USERNAME/nguyenvuquochung-portfolio.git
git push -u origin main

.gitattributes 파일에 * text=auto eol=lf가 이미 포함되어 있습니다. 이 파일은 모든 플랫폼에서 일관된 Unix 줄 끝을 보장합니다.


2. Cloudflare Pages — 첫 번째 배포

2.1 저장소 연결

  1. dash.cloudflare.com에 로그인
  2. Workers & Pages → Create application → Pages → Connect to Git
  3. GitHub 승인 후 nguyenvuquochung-portfolio 저장소 선택

2.2 빌드 설정

이 사이트는 빌드 단계가 없는 정적 사이트입니다:

설정값
프레임워크 프리셋없음
빌드 명령어(비워 둠)
빌드 출력 디렉터리/
루트 디렉터리(비워 둠)

Save and Deploy를 클릭하세요. 사이트는 약 30초 내에 https://nguyenvuquochung-portfolio.pages.dev에서 라이브로 제공됩니다.

2.3 Cloudflare DNS를 통한 커스텀 도메인

  1. Pages 프로젝트 → Custom domains → Set up a custom domain
  2. 도메인 입력 (예: nguyenvuquochung.com)
  3. Cloudflare가 DNS 레코드(CNAME이 nguyenvuquochung-portfolio.pages.dev를 가리킴)를 자동으로 추가합니다.
  4. SSL 인증서가 자동으로 프로비저닝됩니다 — 구성이 필요하지 않습니다.

도메인이 Cloudflare 외부에서 등록된 경우: 먼저 등록기관의 네임서버를 Cloudflare 네임서버로 업데이트한 후 DNS 자동 설정이 작동합니다.


3. 일간 워크플로우

콘텐츠나 코드를 업데이트할 때마다:

# 1. VS Code에서 변경 사항 저장
# 2. 스테이징, 커밋, 푸시
git add .
git commit -m "업데이트: 변경 사항 설명"
git push

Cloudflare Pages가 푸시를 감지하고 자동으로 재배포합니다. 약 30초 내에 라이브로 제공됩니다.


4. 프로젝트 구조

nguyenvuquochung-portfolio/
├── index.html          ← HTML 골격 (7개 가상 페이지, 모든 레이아웃)
├── style.css           ← 모든 CSS (변수, 애니메이션, 페이지 시스템)
├── js/
│   ├── content.js      ← 다국어 텍스트 데이터 (const C = {en, vi})
│   ├── about.js        ← renderP2() — About Me 페이지 렌더러
│   ├── contact.js      ← goToPage7 / goToPage1FromP7
│   ├── production.js   ← P3_PROJECTS 배열 + 렌더/내비게이션 (초록색)
│   ├── director.js     ← P4_PROJECTS 배열 + 렌더/내비게이션 (파란색)
│   ├── assistant.js    ← P5_PROJECTS 배열 + 렌더/내비게이션 (빨간색)
│   ├── editor.js       ← P6_PROJECTS 배열 + 렌더/내비게이션 (노란색)
│   └── main.js         ← 핵심 엔진: 커서, 물리, 전환, 내비게이션, 로더
├── .gitattributes      ← LF 줄 끝 강제
└── SKILL.md            ← 이 파일

스크립트 로드 순서

스크립트는 다음 순서로 로드되어야 합니다 (index.html에 이미 설정됨):

content.js → about.js → contact.js → production.js → director.js → assistant.js → editor.js → main.js

main.js가 마지막인 이유는 다른 모든 파일에 정의된 함수를 호출하기 때문입니다.


5. 콘텐츠 업데이트

바이오그래피 / 인용문 / 필모그래피 변경

js/content.js를 편집하세요 — C 객체에 모든 다국어 텍스트가 있습니다:

const C = {
  en: { sub: "...", about: [...], films: [...], ... },
  vi: { sub: "...", about: [...], films: [...], ... }
};

역할 페이지에 프로젝트 카드 추가

해당 js/*.js 파일을 편집하세요. 예: 감독 프로젝트 (js/director.js):

const P4_PROJECTS = [
  {
    id: 'my-new-film',
    title: 'Tên Phim',
    en: 'Film Title',
    year: '2025',
    desc: '프로젝트에 대한 간단한 설명.',
    img: ''           // 비워 두거나 URL 추가
  },
  // ... 기존 항목
];

새 프로젝트는 해당 역할 배열(js/assistant.js, js/director.js, js/production.js, js/editor.js)의 상단에 추가하여 해당 페이지에서 먼저 표시되도록 하세요. 표시 순서는 최근에 추가된 항목이 상단에 오도록 삽입 순서를 따라야 합니다.

강조 색상 변경

style.css의 :root 블록을 편집하세요:

:root {
  --green:  #00e676;   /* 제작 */
  --blue:   #1a6fff;   /* 감독 */
  --red:    #ff1a1a;   /* 조감독 */
  --yellow: #ffe000;   /* 편집자 */
}

6. Cloudflare 콘텐츠 로더 (선택 사항)

main.js에는 GitHub-raw 콘텐츠 로더가 포함되어 있습니다. 재배포 없이 콘텐츠를 업데이트하려면 GitHub에 content.json을 호스팅하고 main.js 상단에서 다음 상수를 구성하세요:

const GITHUB_OWNER  = 'your-username';
const GITHUB_REPO   = 'nguyenvuquochung-portfolio';
const GITHUB_BRANCH = 'main';
const GITHUB_PATH   = 'content.json';

설정하면 사이트가 로드될 때마다 업데이트된 콘텐츠를 가져옵니다. 비활성화하려면 비워 두세요.


7. 문제 해결

문제해결 방법
사이트가 이전 버전을 표시함강력 새로고침: Ctrl+Shift+R. Cloudflare 캐시 제거: Pages → Caching → Purge cache
커스텀 도메인이 작동하지 않음Cloudflare DNS에 CNAME 레코드가 있는지 확인. 전파까지 최대 5분 대기
JS 오류 X is not definedindex.html에서 스크립트 로드 순서 확인. main.js가 마지막이어야 함
인물 사진이 다시 로드되면 초기화됨예상된 동작입니다. 인물 사진은 메모리에만 저장됩니다. 지속성을 위해 GitHub 콘텐츠 로더를 사용하세요
Cloudflare가 이메일 디코드 스크립트를 삽입함정상 동작입니다. 이메일 난독화를 위해 자동으로 <script> 태그를 래핑합니다

관련 스킬