GitHub 웹 페이지 배포 - GitHub web peiji baepo

이번 시간에는 그 동안 다루지 못한 Github Pages를 React에서 배포하는 방법을 알아보도록 하겠습니다.

제가 지금 현재 Windows버전으로 진행중인데 방식은 동일하니 참고하시면 되겠습니다.

우선 먼저 배포할 프로젝트를 준비해주세요.

먼저 자신의 Github 저장소를 하나 생성해줍시다.

저장소 이름, 설명을 작성후 Create repository 클릭

첫번째 comman line 부분을 오른쪽상단 아이콘을 클릭해 복사 or 아래 명령어대로 차례대로 입력

git init 
git add *
git commit -m "first commit"
git remote add origin https://github.com/Koras02/react-github-pages.git
git push -u origin master

명령어에 간단한 설명을 붙이자면

git init - 프로젝트에 git설치

git add * - .gitnore에 있는 파일 제외한 모든 파일 올리기

git commit -m "first commit" - commit 메시지 작성

git remote add origin https://github.com/Koras02/react-github-pages.git - git 저장소 연결

git push -u origin master- git master으로 push

push 가 완료되면 github 페이지로 돌아가서 새로고침하면 소스들이 올라가 있습니다.

2. Github 페이지 배포하기

먼저 프로젝트 gh-pages 패키지를 설치해주세요

npm install gh-pages --save-dev && yarn add gh-pages

설치가 완료되면 프로젝트 내 package.json 파일을 열어 "homepage" 주소를 추가해줍니다.

// ....
"homepage" : "http://Koras02.github.io/react-github-pages

형식은 http://{사용자 이름}.github.io/{저장소 이름} 으로 작성합니다.

그다음 script 부분에 predeploy, deploy 를 추가해줍니다.

"scripts" : {
  ... 
  "predeploy: "npm run build",
  "deploy": "gh-pages -d build"
}

저장후 터미널 창을 열고 npm run deploy & yarn deploy 를 실행해 줍니다.

 이렇게 deploy가 성공했습니다. 직접 github pages를 확인하기 위해 본인이 push 했던 레포지토리로 가서

 Settings -> Options에서 Github Pages 에서 확인하실수 있습니다.

 (사이트에서 README.md 파일 내용이 나올 경우 Github Pages의 Source 부분 gh-pages branch로 변경시

 사이트가 정상적으로 배포됨

 이렇게 뜬다면 배포 성공!

3. 배포시 주의사항 ( 2021.10.08 )

다른 프로젝트를 배포하는 과정에서

homepage : "http://{사용자 이름}.github.io/{저장소 이름}"로 설정된 주소로 접속시 404 페이지가 나올 경우

http://{사용자이름}.github.io/{저장소이름}/index.html 로 접속하면 이상없이 페이지가 나온다.

참고

[React] 프로젝트 GitHub Pages 배포하기

React 프로젝트 GitHub Pages로 배포하기 (create-react-app)

velog.io

github pages 로 실습을 하는데 문제가 생겼다면 netlify.com 을 이용하는 아래 수업을 참고해주세요. 
netlify.com 으로 웹호스팅 하기 바로가기

---

직접 웹서버를 운영하는 일은 쉽지 않은 일입니다.
우선 컴퓨터가 있어야 하고요,
컴퓨터가 냉장고처럼 항상 켜져 있어야 합니다.
웹서버라는 프로그램을 배워서 설치해야 합니다.
또 인터넷을 통해서
외부로 정보를 전송할 수 있게
설정을 해야 합니다.
쉽지 않습니다.

그래서
이런 일을 대행해 주는 회사들이 있습니다.
인터넷에 연결된 컴퓨터 하나 하나를 호스트라고 합니다.
이런 컴퓨터를 빌려주는 사업을 호스팅이라고 합니다.
웹서버를 전문적으로 빌려주는 비즈니스를
웹호스팅 업체라고 부릅니다.

수많은 웹호스팅 업체가 있습니다.
그 중에서
무료이고, 유명한 서비스를 이용할 것입니다.

바로 github(https://github.com)의 pages 기능입니다.

이 서비스는
프로그래머들에게는 성지와 같은
중요한 서비스입니다.
전세계의 수많은 오픈소스들이
이곳에서 만들어지고 있거든요.
 

이 서비스 자체는
우리 수업의 주제는 아니니까
나중에 살펴보시면 됩니다.

우리는 github가 제공하는 여러 기능 중
웹호스팅 기능을 이용해서
우리의 홈페이지를 운영할 것입니다.

회원가입하시고(sign up),
로그인해 주세요(sign in)

저장소(repository)라는 것을
생성해 주셔야 합니다.
저장소는 소스코드를 보관하는 곳이라고
생각하시면 됩니다.
New 버튼을 누르면 됩니다.

아래와 같은 화면이 나오는데 저장소를 생성하는 화면입니다.

1. Repository name 에는 프로젝트의 이름을 적어 주세요. 저의 경우 web1이라고 할 것입니다.
2. public(공개), private(비공개)는 저장소의 공개여부를 정하는 것입니다. public으로 해 주세요. (누구나 여러분의 소스코드를 볼 수 있습니다)

저장소 생성하기(Create repository) 버튼을 눌러주세요.

아래와 같은 화면이 나타날 것입니다.

이 중에서 uploading an existing file라는 부분을 클릭해 주세요. 아래와 같은 페이지가 뜰 거에요.

1. 작업한 파일을 드래그 앤 드롭 합니다. 

2. 변경된 내용을 적습니다. 파일이 변경될 때마다 업로드를 해야 하기 때문에 변경된 내용을 적어줍니다.
3. Commit changes 버튼을 누르세요. 업로드가 시작됩니다.

업로드가 끝나면 아래와 같이 파일의 목록이 보입니다.

그럼 우리가 업로드한 웹페이지를 인터넷을 통해서 서비스 해봅시다. Settings 버튼을 선택합니다.

사이드 바에서 Pages를 선택합니다. 

Branch를 main 혹은 master를 선택하고 Save 버튼을 누릅니다.

그럼 아래와 같이 주소가 표시됩니다. (물론 주소는 각자 다르겠죠?)

이 주소로 방문해 보시면 자신이 만든 웹페이지가 보일 것입니다. (혹시 나오지 않는다면 5분 후에 다시 접속해 보세요)

감동적이지 않나요?
이제
내가 만든 웹페이지를
전세계 사람들에게 서비스할 수 있게 되었습니다.
축하합니다.
 

그럼 우리가 한 일을 이론적으로 정리해보겠습니다.

삼자가 있습니다. my는 여러분의 컴퓨터입니다. visitor는 여러분의 웹페이지를 보고 싶어하는 사람입니다.

여러분의 컴퓨터는 현재로서는 컨텐츠를 서비스 할 수 없습니다.  우리는 github의 pages 기능을 이용했습니다. github에 파일들을 업로드하고, pages 기능을 활성화하면 github의 서버 컴퓨터에 웹서버가 켜집니다. 그리고 우리에게 웹서버의 주소를 알려줍니다.

이제 웹서버의 주소를 방문자에게 알려주면 방문자는 나의 컴퓨터가 아닌 github의 컴퓨터에 설치된 웹서버에 접속하게 됩니다.

웹서버를 직접 운영하는 것에 비해서
웹호스팅을 이용하면
쉽습니다.

단점은
인터넷의 원리가 감춰져 있다는 것입니다.

하지만
현업에서 웹서버를 직접 운영하는 경우는 많지 않아요.
웹서버를 운영하기 위해서는 많은 노하우가 필요하거든요.

우리는 github를 사용했지만
미래에는 이 서비스를 이용하지 못할 수도 있습니다.
또 github pages는 제약이 많은 서비스이기도 합니다.
중요한 것은 github의 사용법이 아니고,
여러분이 필요한 웹호스팅을 찾아내는 능력입니다.

우리는 HTML만으로 웹페이지를 만들었습니다.
HTML은 웹브라우저가 해석하기 때문에
서버쪽에서 특별히 해 줄 일이 없습니다.
이런 특성을 정적(static)이라고 합니다.
자연스럽게 HTML만으로 만들어진 웹사이트를
호스팅하는 서비스 중에는 무료가 많습니다.

그럼 동적(dynamic)인 것이 있냐고요?
있습니다. 나중에 배울 php나 python, ruby, java와 같은
기술을 이용하려면 대체로 비용을 내야 합니다.
이런 기술을 활용하기 전까지는
유료 서비스를 이용할 필요가 전혀 없습니다.

아래와 같이 검색하시면
여러분의 목적에 맞는 웹호스팅을 찾을 수 있습니다.

free static web hosting

현시점에서 추천 드리고 싶은 서비스들은 이런 것들이 있습니다.

• https://bitballoon.com
• http://neocities.org
• Azure Blob
• Google Cloud Storage
• Amazon S3

하지만 미래에는 없어졌을 수도 있고,
더 좋은 서비스도 있을 수 있기 때문에
더욱 중요한 것은 검색을 통해서
찾아낼 수 있는 능력이라는 것을 기억해 주세요.

자주 묻는 질문

질문 : 아래와 같은 오류가 뜹니다. Please verify your email address Before you can contribute on GitHub, we need you to verify your email address. An email containing verification instructions was sent to 이메일 주소.
답변 : 회원가입 후에 이메일 인증을 해야 한다는 의미입니다. 이메일로 가셔서 Verify email address 누르시면 됩니다. 

완성한 웹사이트를 알려주세요.

다른 사람들의 웹사이트를 구경하세요.