GitLab 시작하기

GitLab을 실제로 쓰려면 계정과 프로젝트(저장소)를 만들고, 안전한 인증 수단을 설정한 뒤, 로컬 코드를 원격 저장소로 보내야 합니다. Git 명령 자체는 이미 익숙하다고 보고, GitLab에서 어디를 눌러야 하는지에 초점을 둡니다.

학습 목표

• GitLab 계정과 새 프로젝트를 생성한다.
• SSH 키를 만들어 GitLab에 등록한다.
• 로컬 저장소를 GitLab 원격에 연결하고 push한다.

계정과 프로젝트 만들기

먼저 gitlab.com에 가입하거나, 회사가 운영하는 self-hosted GitLab 주소로 로그인합니다.

프로젝트(GitLab에서 저장소를 부르는 단위)는 화면 우상단의 New project / New 메뉴에서 만듭니다.

• Create blank project: 빈 저장소를 새로 만든다.
• Create from template: 기본 구조가 잡힌 템플릿에서 시작한다.
• Import project: 다른 서비스(예: GitHub)에서 가져온다.

프로젝트를 만들 때 이름, 네임스페이스(개인 또는 그룹), 가시성(Private/Internal/Public)을 정합니다. README를 자동 생성하지 않고 빈 저장소로 만들면 로컬 코드를 그대로 올리기 편합니다.

SSH 키 등록

매번 비밀번호를 입력하지 않고 안전하게 push/pull 하려면 SSH 키를 등록하는 방식이 편리합니다. 키가 없다면 새로 만듭니다.

ssh-keygen -t ed25519 -C "your_email@example.com"

생성된 공개 키 내용을 확인합니다.

cat ~/.ssh/id_ed25519.pub

출력된 문자열 전체를 복사한 뒤, GitLab에서 다음 경로로 등록합니다.

• 오른쪽 위 아바타 > Edit profile > SSH Keys
• Key 입력란에 공개 키를 붙여넣고 만료일(선택)을 정한 뒤 Add key

등록이 끝나면 연결을 확인합니다.

ssh -T git@gitlab.com

Welcome to GitLab 메시지가 보이면 정상입니다. self-hosted라면 git@회사도메인 형태로 바꿔 확인합니다.

로컬 저장소를 원격에 연결하기

이미 로컬에서 작업 중인 프로젝트가 있다면, GitLab 프로젝트 페이지에 표시된 원격 주소를 추가하고 push합니다. 프로젝트의 Clone 버튼에서 SSH 주소를 복사할 수 있습니다.

# 아직 git 저장소가 아니라면
git init

# GitLab 프로젝트를 원격으로 추가
git remote add origin git@gitlab.com:내네임스페이스/내프로젝트.git

# 첫 커밋 후 push
git add .
git commit -m "first commit"
git push -u origin main

-u 옵션으로 추적 관계를 한 번 설정해 두면, 이후에는 git push만으로 같은 브랜치에 올라갑니다.

이미 GitLab에서 만든 빈 프로젝트라면 화면에 위와 거의 같은 명령 안내가 표시되므로 그대로 따라 하면 됩니다.

새 프로젝트를 clone 해서 시작하기

반대로 GitLab에 먼저 만든 프로젝트를 로컬로 가져와 시작할 수도 있습니다.

git clone git@gitlab.com:내네임스페이스/내프로젝트.git
cd 내프로젝트

이후에는 평소 쓰던 Git 흐름(브랜치 생성, 커밋, push)을 그대로 사용하면 됩니다.

요약

GitLab 사용의 시작은 계정과 프로젝트 생성, 그리고 SSH 키 등록입니다. 키를 등록하면 비밀번호 없이 안전하게 push/pull 할 수 있습니다. 로컬 저장소는 git remote add origin으로 GitLab 원격에 연결하고 push하면 되며, 반대로 git clone으로 가져와 시작할 수도 있습니다. 다음 강의에서는 협업의 핵심인 Merge Request를 다룹니다.