[Git·GitOps 04] Ubuntu 24.04에 Git 설치하고 저장소 준비하기

Ubuntu 24.04에서는 기본 APT 저장소로 Git을 설치할 수 있습니다. 패키지 목록을 갱신한 뒤 Git과 SSH 클라이언트를 설치하고, 실제로 실행되는 버전을 확인하면 됩니다. 최신 기능이 당장 필요한 상황이 아니라면 이 경로부터 시작하는 편이 관리하기 쉬워요.

실습은 sudo 가능한 일반 계정의 터미널을 기준으로 합니다. Ubuntu 24.04 컨테이너에서 설치와 Git 동작을 확인했으며, WSL의 배포판 설치나 Windows 화면 조작은 이 검증에 포함하지 않았습니다.

Git·GitOps 전체 연재 · 04 / 24

이 글의 목차

1. 패키지 목록을 갱신하고 설치한다

cat /etc/os-release
sudo apt update
apt-cache policy git
sudo apt install -y git openssh-client ca-certificates
git --version
command -v git

apt update는 패키지 목록을 새로 받는 명령이며 설치된 모든 프로그램을 업그레이드하지는 않습니다. apt-cache policy git의 Candidate는 현재 저장소에서 설치 후보로 선택한 버전입니다. 실제 확인 환경에서는 Git 2.43.0이 설치되었습니다.

서명이나 인증서 오류가 발생하면 검증 옵션을 끄지 않습니다. 시스템 시각, CA 인증서, 저장소 주소, 사내 프록시의 인증서 배포 상태를 확인합니다. Git 설치 문제와 이후 Git 서버의 인증 문제는 별개입니다.

2. 작성 정보와 기본 브랜치를 지정한다

git config --global user.name "Your Name"
git config --global user.email "you@example.com"
git config --global init.defaultBranch main
git config --show-origin --get user.name
git config --show-origin --get user.email

main은 이 연재가 사용하는 첫 브랜치 이름입니다. 기존 프로젝트가 master나 다른 이름을 사용한다고 해서 설치 과정에서 바꿀 필요는 없습니다. 기본 브랜치 변경은 원격 서버, 보호 규칙, CI 설정까지 함께 영향을 줄 수 있어요.

이름과 이메일은 커밋 기록에 들어갑니다. 비공개 저장소라도 외부로 전달한 커밋에는 정보가 포함될 수 있으므로 회사의 계정 정책을 따릅니다. 개인 프로젝트와 업무 프로젝트의 값이 다르면 각 저장소의 로컬 설정을 사용합니다.

3. 홈 디렉터리에 작업 폴더를 만든다

mkdir -p ~/git-lab
cd ~/git-lab
mkdir ubuntu-check
cd ubuntu-check
git init -b main
printf '# Ubuntu Git lab\n' > README.md
git add README.md
git commit -m "Add Ubuntu lab README"
git log -1 --oneline
git status --short --branch

커밋 해시는 실행 시점과 작성 정보에 따라 달라집니다. 문서의 예시 해시와 같아야 하는 값이 아니에요. 마지막 상태에서 파일 변경이 없고 브랜치가 main이면 로컬 기록을 남긴 것입니다.

Permission denied가 나오면 pwd, id, ls -ld . .git부터 확인합니다. Git 명령 앞에 sudo를 붙여 넘기면 다음 작업에서 소유권 문제가 더 커질 수 있습니다. 시스템 경로의 서버 저장소와 개인 작업 폴더는 관리 주체를 나눕니다.

WSL과 서버 Ubuntu의 차이

Git의 명령은 같지만 파일을 어디에 보관하는지, SSH 키가 어느 계정에 있는지가 달라집니다. WSL 터미널의 ~/.ssh와 Windows 사용자의 .ssh는 같은 위치라고 가정하지 않습니다. Git Credential Manager와 SSH 에이전트도 실제 사용하는 환경을 확인해 연결해야 합니다.

서버 Ubuntu에서는 SSH 접속이 끊겨도 이미 만든 커밋이 사라지지는 않습니다. 다만 다른 서버로 푸시하지 않았다면 그 서버의 디스크에만 이력이 남습니다. 서버 스냅샷이나 파일 백업을 Git 원격 저장소와 혼동하지 마세요.

별도 PPA는 필요가 생겼을 때 선택한다

배포판 버전이 공식 사이트의 최신 버전보다 낮아도 바로 잘못된 설치는 아닙니다. 필요한 명령의 지원 여부와 배포판 보안 업데이트 정책을 기준으로 판단합니다. 새로운 기능이 필요한 경우에는 조직이 허용한 저장소인지 확인하고 변경 범위를 기록합니다.

설치 후에는 5편에서 사용할 git-lab 폴더만 있으면 됩니다. Ubuntu의 Git 패키지 정보와 Git의 Linux 설치 안내에서 배포판별 설치 경로를 확인할 수 있습니다.

이전 글 · [Git·GitOps 03] Rocky Linux 9에 Git 설치하고 작업 계정 설정하기 · 다음 글 · [Git·GitOps 05] 첫 저장소 만들기: add·commit·status·diff를 쓰는 순서 · 연재 목록과 예제 파일