[DevOps] 다양한 사용자가 GitLab 환경을 사용할 때 설정가이드

0. GITLAB INSTALL

https://estar987.tistory.com/entry/GitLAB-%EC%84%A4%EC%B9%98

GitLAB 설치

 

1. GIT 초기 설정

GitLab을 사용하기 위해선 먼저 Git 환경을 설정해야 합니다.

1-1. 사용자 정보 설정

Git을 사용하기 위해서는 사용자 정보를 설정해야 합니다. 이는 커밋 기록에 사용자 정보를 포함시키기 위한 필수 단계입니다.

 

git config --global user.name "사용자 이름"
git config --global user.email "사용자 이메일"

 

2. 로컬 GIT 저장소 생성 및 초기화

mkdir <사용할 디렉터리 경로>
git init

 

3. 원격 저장소 연결

GitLab의 프로젝트와 로컬 저장소를 연결하려면 원격 저장소를 추가해야 합니다.

 

3-1 원격 저장소 추가

git remote add origin http://<GitLab 서버 IP>:<포트>/<프로젝트 경로>.git

git remote add origin http://192.168.207.212:8443/root/test.git

 

3-2 원격 저장소 확인

현재 연결된 원격 저장소를 확인하려면 다음 명령을 실행합니다.

# git remote -v
origin  http://192.168.207.212:8443/root/test.git (fetch)
origin  http://192.168.207.212:8443/root/test.git (push)

 

4. 로컬 작업과 커밋

GitLab과 원활히 연동하기 위해선 로컬에서 파일을 추가하고 커밋해야 합니다.

4-1 파일 추가 및 커밋(모든 파일 추가 후 커밋)

git add .
git commit -m "Initial commit"

 

5. 브랜치 설정

Git 기본 브랜치는 master로 설정되지만, 최신 표준에서는 main 브랜치를 사용합니다.

5-1 브랜치 이름 변경

git branch -M main

 

6. 원격 저장소와 동기화

커밋 후에는 로컬 변경 사항을 원격 저장소에 푸시합니다.

 

6-1 기본 푸시

git push -u origin main

 

6-2. 오류: 원격 저장소와 충돌

제가 접한 오류 입니다. 아래와 같은 오류가 발생한다면 다음 같이 해결하시면 됩니다.

 

ERR LOG

Updates were rejected because the remote contains work that you do not have locally.

 

해결 방법: 원격 저장소와 병합

1. 원격 저장소의 변경 사항을 가져와 병합
2. 병합 후 푸시

git pull --rebase origin main
git push -u origin main

 

7. 다중 원격 저장소 사용

Git은 하나의 로컬 저장소에서 여러 원격 저장소를 관리할 수 있습니다.

 

7-1 추가 원격 저장소 설정

추가 원격 저장소를 설정하려면 고유한 이름을 지정합니다.

git remote add <원격 저장소 이름> <URL>
git remote add backup http://192.168.207.210:8443/root/newtest.git

 

7-2. 다중 원격 저장소로 푸시

각 원격 저장소에 명시적으로 푸시합니다.

git push origin main
git push backup main

 

8. 일반적인 오류 및 해결 방법

오류 1 

• GITLAB은 상당히 무거운 파일이기 때문에 가상 머신으로 테스트 할 시 RAM 용량을 16기가 이상으로 설정해 주세요(8GB, 4GB에서 웹페이지가 안 올라오는 등 정상적인 구동이 되지 않았습니다.

오류 2( fatal: src refspec main does not match any)

• 원인 : 브랜치에 커밋이 는 경우 발생
• 해결 : 1. 파일 추가 및 커밋 , 2. 브랜치 이름 설정

git add .
git commit -m "Initial commit"
git branch -M main

 

오류 3( fatal: Could not read from remote repository)

• 원인 : 원격 저장소 URL이 잘못되었거나, 접근 권한이 없는 경우 발생
• 해결 : 1. 원격 저장소 확인 , 2. URL 수정

git remote -v
git remote set-url origin <올바른 URL>