GitHub 사용하기 (feat. git CLI)

* 이 글은 '제주코딩베이스캠프(링크)' 의 알잘딱깔센 GitHub 무료 강좌(링크)를 참고해 작성했습니다.

GitHub Setting😎

GitHub Repository 만들기

GitHub 에 Repository 를 만들기 위해서는 가입이 필수!!
GitHub(Link) 를 클릭하고 가입한 후에 아래 과정을 진행해주자.

"Repository 생성"

로그인 후에는 아래 사진과 같이 New 혹은 New repository 를 클릭한다.
이 후 보이는 page 에서 아래 과정을 순서대로 진행하면 된다.

Repository 이름 입력 ➡️ Public(공개) / Private(비공개) 설정 ➡️ Create Repository 클릭!

* Public / Private 는 이후에 설정을 통해 변경할 수 있다.
* Add a README file 옵션은 선택사항이며, 일반적으로는 생성 후 Repository 에 대한 소개를 작성한다.

README.md

REAEDME.md 를 이용하면 Repository 에 대한 설명을 할 수 있다.
또한 꾸미면 내 GitHub Main page 를 더 멋있게 소개할 수도 있다!!!😘

Repository 생성 시 README.md 옵션을 선택하지 않으면 아래 두번째 사진과 같은 화면을 보게 된다.🤔
내용은 아래 과정 (CLI 이용하기) 에서 설명하겠다.

참고: kay's github

내가 꾸민 README.md      //      README.md 가 없는 경우

---

GitHub 에 파일 올리기

GUI 이용하기

GitHub 의 GUI 를 이용하면 간단하게 파일을 올릴 수 있다.

파일을 올릴 repository 에 접속 ➡️ Add file 클릭 ➡️ Upload files 클릭 

위 과정을 진행하면 아래의 두번째 사진과 같은 화면이 나온다.

"Drag & Drop" 혹은 "choose your files" 를 이용해 업로드할 파일, 폴더를 선택한다.
Commit chages 에 commit 에 대한 comment 를 입력하고
Commit changes 버튼을 클릭하면 성공!!✌

 

CLI 이용하기

README.md 가 없는 경우는 위 쪽에서 본 화면에서 시작할 것이다.🤔
내용을 읽어보면 몇가지 git command 를 소개해주는데 첫 번째 과정을 따라 가보자.

우선 내가 업로드할 로컬 폴더를 열고 Git Bash 를 실행시키자.
(Git Bash 를 먼저 열고 command 로 directory 에 접근해도 된다.)
이 후 아래 소개된 Command 들을 입력하면 파일 업로드를 할 수 있다.

echo "# test" >> README.md
git init
git add README.md
git commit -m "first commit"
git branch -M main
git remote add origin git@github.com:kay0710/test.git
git push -u origin main

Command 분석하기

• README.md 생성하기
  • "# test" 라는 Text가 입력된 파일을 README.md 라는 이름과 확장자로 생성하라는 뜻이다.

 

echo "# test" >> README.md

• Git CLI 를 이용해 Commit 하기
  • Commit 과정
    • git init 하기
    • Commit 할 파일 "add" 하기
    • Commit  및 멘트 남기기
    • branch 설정하기
    • 원격 저장소 (Remote repository) 설정하기
    • push 하기
• 완료하면 로컬에서 생성한 README.md 파일이 GitHub 의 원격 저장소에 Commit 된 것을 확인할 수 있다.

git init
git add README.md
git commit -m "first commit"
git branch -M main
git remote add origin git@github.com:kay0710/test.git
git push -u origin main

PUSH Error😥

Push 를 시도할 때 아래와 같은 error 가 발생할 수 있다.
ssh key 가 설정되지 않아 발생하는 error 다.🚫

해결 방법은 가단하다.
ssh key 만들기 ➡️ GitHub 개인 계정에 등록하기

$ git push -u origin main
git@github.com: Permission denied (publickey).
fatal: Could not read from remote repository.

Please make sure you have the correct access rights and the repository exists.

해결하기😃

1. ssh key 만들기

ssh-keygen -t rsa -C “reddevil8407@naver.com”

위 명령어를 통해 ssh key 를 입력하면 ssh key 를 만들 수 있다.

처음에는 key 를 생성할 위치를 물어본다. (설정하지 않으면 default 로 ~/.ssh/id_rsa.pub 에 생성된다.)
다음은 password 설정 여부를 묻는다. (설정하지 않아도 된다.)
생성이 완료되면 "The key fingerprint is:" 라는 line 후에 본인의 ssh key 가 나오는데 ⚠️절대 공개하지 말자!!⚠️

2. 등록하기

GitHub 에 SSH key 를 동록하자.

GitHub Settins 에 SSH and GPG keys tap 에 들어가면 아래와 같은 화면이 나온다.
여기서 New SSH key 를 클릭하자.
Title 은 원하는대로 입력하고, Key 는 생성한 SSH key 를 입력해주면 된다.

🎈Key 는 이전 과정에서 ssh key 를 생성 한 후 "cat ~/.ssh/id_rsa.pub" 명령어를 통해 key 를 읽어오면 된다.

 

 

---

Tips👍

Repository 내 하위 폴더 생성하기

Projcet 를 진행하면 Repository 의 수도 늘어난다.
보다 체계적으로 관리하기 위해서는 하위 폴더의 생성이 필요하게 된다.

Repository ➡️  Add file ➡️ Create new file 을 누르면 아래와 같은 화면이 보인다.

File name 을 입력하면 파일이 생성되고
Folder name / File name 을 입력하게 되면 "Folder name" 이라는 하위 폴더에 File 이 생성된다.
동일한 방법으로 이미 업로드된 파일과 폴더도 관리할 수 있다.

Reposoitory 의 하위 폴더 활용하기

Repository 의 하위 폴더를 활용하면 웹 페이지를 만들 때 유용하다.

Main Repository 에 html 파일 만들기 ➡️ Sub Folder 생성 ➡️ Sub Folder 에 html 파일 만들기
 위의 순서로 진행하면 Repository는 아래 2번째 사진과 같아진다.

GitHub Page 생성 ➡️ main 주소 뒤에 Sub folder 명을 추가 입력
위와 같은 방식으로 접속하면 Sub page 에 만든 html 파일도 web page 로 확인할 수 있다.
* GitHub Page 생성은 이전 글 "Git & GitHub 맛보기(링크)" 를 참고 해주세요.

Main page

Sub page

참고: https://kay0710.github.io/git_test/ 

Git & GitHub 맛보기