728x90
create-react-app으로 생성해서 개발이 완료된 프로젝트를 github pages를 통해 배포하는 방법을 알아보겠습니다.
-
프로젝트 구조
yarn build
build 명령어가 완료되면 프로젝트 root 위치에 build 폴더가 생성됩니다.
터미널 창에서 보면 아래와 같은 결과를 볼 수 있습니다.
https://cra.link/deployment
위 사이트에 접속해보면 여러 방법으로 배포하는 방법이 자세하게 나와있습니다.
AWS Amplify, Azure, firebase, github pages, Heroku, Netlify 등등
다른 방법은 직접 해보시고 여기서는 Github페이지를 통해 배포하는 방법을 설명합니다.
(해당 기능은 react-scripts@0.2.0 이상에서 사용할 수 있습니다)
★ 1단계 : package.json 파일에서 homepage 추가
"homepage" : "https://myusername.github.io/my-app"
myusername, my-app 이름을 잘 모르겠다면 터미널 창에서 아래 명령어를 통해 확인 할 수 있습니다.
git remote -v
★ 2단계 : gh-pages 추가, package.json파일에 deploy 스크립트 추가
//터미널
yarn add gh-pages
yarn add gh-pages
//package.json 파일에 아래 부분 추가
★ 3단계 : deploy 명령어 실행
yarn deploy
★ 4단계 : 프로젝트 페이지인 경우 Github프로젝트 설정의 Github페이지 옵션이 gh-pages 분기를 사용하도록 설정되어있는지 확인합니다.
1~4단계까지가 완료되면 hompage url 주소로 접근이 가능합니다.
# 하지만 이렇게 4단계 까지 확인 후 hompage에 적었던 url 주소로 접속을 해도 404 페이지가 뜬다면???
1)프로젝트 public폴더에 404.html파일을 만듭니다.
//404.html
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Single Page Apps for GitHub Pages</title>
<script type="text/javascript">
// Single Page Apps for GitHub Pages
// https://github.com/rafrex/spa-github-pages
// Copyright (c) 2016 Rafael Pedicini, licensed under the MIT License
// ---------------------------------------------- ------------------------
// This script takes the current url and converts the path and query
// string into just a query string, and then redirects the browser
// to the new url with only a query string and hash fragment,
// e.g. http://www.foo.tld/one/two?a=b& c=d#qwe, becomes
// http://www.foo.tld/?p=/one/two& q=a=b~and~c=d#qwe
// Note: this 404.html file must be at least 512 bytes for it to work
// with Internet Explorer (it is currently > 512 bytes)
// If you're creating a Project Pages site and NOT using a custom domain,
// then set segmentCount to 1 (enterprise users may need to set it to > 1).
// This way the code will only replace the route part of the path, and not
// the real directory in which the app resides, for example:
// https://username.github.io/repo-name/one/two? a=b&c=d#qwe becomes
// https://username.github.io/repo-name/? p=/one/two&q=a=b~and~c=d#qwe
// Otherwise, leave segmentCount as 0.
var segmentCount = 1;
var l = window.location;
l.replace(
l.protocol + '//' + l.hostname + (l.port ? ':' + l.port : '') +
l.pathname.split('/').slice(0, 1 + segmentCount).join('/') + '/?p=/' +
l.pathname.slice(1).split('/').slice (segmentCount).join('/').replace(/&/g, '~and~') +
(l.search ? '&q=' + l.search.slice(1) .replace(/&/g, '~and~') : '') +
l.hash
);
</script>
</head>
<body>
</body>
</html>
2)public 폴더에 있는 index.html 파일에 아래 스크립트문 추가합니다.
....생략....
<!-- Start Single Page Apps for GitHub Pages -->
<script type="text/javascript">
// Single Page Apps for GitHub Pages
// https://github.com/rafrex/spa-github-pages
// Copyright (c) 2016 Rafael Pedicini, licensed under the MIT License
// ----------------------------------------------------------------------
// This script checks to see if a redirect is present in the query string
// and converts it back into the correct url and adds it to the
// browser's history using window.history.replaceState(...),
// which won't cause the browser to attempt to load the new url.
// When the single page app is loaded further down in this file,
// the correct url will be waiting in the browser's history for
// the single page app to route accordingly.
(function (l) {
if (l.search) {
var q = {};
l.search.slice(1).split('&').forEach(function (v) {
var a = v.split('=');
q[a[0]] = a.slice(1).join('=').replace(/~and~/g, '&');
});
if (q.p !== undefined) {
window.history.replaceState(null, null,
l.pathname.slice(0, -1) + (q.p || '') +
(q.q ? ('?' + q.q) : '') +
l.hash
);
}
}
}(window.location))
</script>
<!-- End Single Page Apps for GitHub Pages -->
....생략....
그리고 다시 배포 명령어 재실행.
yarn deploy
이상입니다. 끝!
728x90
'Programming > React' 카테고리의 다른 글
| husky와 lint-staged로 git hook 관리하기(코드 포맷 자동화) (2) | 2020.12.10 |
|---|---|
| Prettier, lint-staged, husky 등 설정파일 별도의 파일로 관리하기 (0) | 2020.12.09 |
| 리액트 프로젝트에서 ESLint로 문법 검사하기 (0) | 2020.12.09 |
| 리액트 프로젝트에서 Prettier로 코드 스타일 통일하기 (0) | 2020.12.09 |
| [React] react state 배열 수정하기 (0) | 2020.11.26 |
댓글