학습일지

[스나이퍼팩토리] 한컴AI아카데미(26.05.22) GitHub

cd-record 2026. 5. 23. 12:47

 

Git 명령어

1. 중요 파일 잘못 올렸을 때

git rm --cached -r hancomAIacademy
git commit -m "Clean up repository root"

2. 에러코드

error: failed to push some refs to 'https://github.com/ramcd01/hancomAIacademy.git'

❓ 왜 이런 일이 생겼을까요?

  1. GitHub 웹사이트에서 직접 파일을 수정하거나 추가했을 때: (예: GitHub에서 직접 README.md를 편집했거나, 저장소를 만들 때 .gitignore나 License 파일을 자동으로 생성한 경우)
  2. 내 컴퓨터에는 아직 그 파일들이 없는데, 내가 내 컴퓨터에서 만든 새 파일을 push(업로드) 하려고 하니까 깃이 "잠깐! 인터넷(GitHub)에 너한테 없는 최신 파일이 먼저 올라와 있어! 그거부터 가져와서 합치고 다시 올려!" 하고 막아서는 것입니다.

1단계: GitHub의 최신 변경사항 내 컴퓨터로 가져오기

git pull origin main
  • 상황 A (정상 처리): 이 명령어를 쳤을 때 GitHub에 있던 파일들이 내 컴퓨터로 슥 다운로드되면서 합쳐지면 성공입니다! 바로 3단계(git push)로 넘어가시면 됩니다.
  • 상황 B (경고창 등장): 만약 줄바꿈이나 서로 다른 설정 때문에 합치는 방식을 정하라는 경고문이 나오면, 아래 2단계를 실행해 주세요.

2단계: (1단계에서 에러나 경고가 날 때만) 안전하게 합치기 설정

만약 pull이 거부되거나 'rebase' 관련 메시지가 뜬다면, 깃에게 "서로 역사가 달라도 일단 안전하게 합쳐줘"라고 알려줘야 합니다. 아래 명령어를 치고 다시 pull을 시도합니다.

git pull origin main --rebase

(만약 이래도 안 된다면, 역사 자체가 아예 무관하다고 판단하는 것이니 git pull origin main --allow-unrelated-histories를 입력하시면 강제로 합쳐집니다.)

3단계: 다시 GitHub에 업로드하기

내 컴퓨터와 GitHub의 상태가 똑같아졌으니, 파일 다시 올리기!

git push origin main

 

깃허브 페이지스

본인의 소스코드를 웹사이트 형태로 무료로 인터넷에 배포(호스팅)하는 과정

 

1. "public 했을 때 github에 코드 다 집어넣었을 때 기준"

  • 의미: GitHub Pages로 웹사이트를 무료 배포하려면 기본적으로 저장소(Repository)가 Public(전체 공개) 상태여야 합니다.
  • 코드를 GitHub에 업로드(Push)해 둔 상태여야만 깃허브가 그 코드를 읽어서 웹사이트로 빌드(조립)할 수 있습니다.

2. "branch를 /docs 에서 /root로 바꾸기"

  • 의미: 깃허브에게 "내 웹사이트의 메인 화면(일반적으로 index.html)이 어디에 있는지" 위치를 알려주는 설정입니다.
  • 📂 /docs: 저장소 내의 docs라는 특정 폴더 안에 있는 코드를 기반으로 웹사이트를 만들라는 뜻입니다.
  • 📂 /root: 저장소의 최상위 경로(가장 바깥 공간)에 있는 코드를 기반으로 웹사이트를 만들라는 뜻입니다.
  • 사용자가 설정을 /root로 바꿨다는 것은, index.html 같은 메인 파일들을 폴더 안이 아니라 가장 바깥에 꺼내두었기 때문에 깃허브가 거기를 바라보도록 기준점을 변경해 준 것입니다.

3. "바로 위 주소에 visit site로 들어갈 수 있게 해줌"

  • 의미: 배포 설정이 성공적으로 완료되어 실제 인터넷 주소(URL)가 생성되었다는 뜻입니다.
  • 깃허브가 코드를 웹사이트로 만드는 데 성공하면 설정 화면 상단에 [https://유저이름.github.io/저장소이름](https://유저이름.github.io/저장소이름) 형태의 주소가 뜹니다. 그 옆의 [Visit site] 버튼을 누르면 내 컴퓨터 화면으로만 보던 웹페이지가 실제 인터넷 브라우저에서 열리게 됩니다.

4. "unpublish site 는 비활성화"

  • 의미: 현재 웹사이트가 정상적으로 실시간 반영(배포)되고 있는 상태임을 나타냅니다.
  • 'Unpublish site(사이트 배포 취소)' 버튼이 비활성화(누를 수 있게 활성화된 상태)되어 있다는 것은, 원할 때 언제든 이 버튼을 눌러서 배포 중인 웹사이트를 다시 내릴(비공개로 전환할) 준비가 되어 있다는 뜻입니다.

 

 

 

 

 

 

 

 

——————————————————————————

본 후기는 [한글과컴퓨터x한국생산성본부x스나이퍼팩토리] 한컴 AI 아카데미 (B-log) 리뷰로 작성 되었습니다.