릴리스 (Release)

릴리스(Release)는 특정 상태의 소프트웨어를 이용자가 받아 쓰거나 업데이트할 수 있도록 내놓는 배포본 또는 그 공개 과정입니다. 보통 버전과 변경 설명, 필요한 파일을 함께 제공합니다. 소스의 변경 이력을 가리키는 태그나 실제 서버에 반영하는 배포와 연결되지만, 각각이 일어난 시점과 결과는 구별합니다.

버전과 배포 파일의 묶음

GitHub의 릴리스 소개는 소프트웨어와 릴리스 노트, 바이너리 파일 링크 등을 묶어 다른 사람이 사용할 수 있도록 제공하는 기능을 설명합니다. 이용자는 어떤 변경이 들어갔는지 읽고 필요한 파일을 내려받습니다. 소스 코드만 필요한 이용자와 설치 파일이 필요한 이용자가 다르므로, 제공한 파일의 종류도 함께 확인합니다.

GitHub 릴리스는 저장소 이력의 특정 지점을 표시하는 Git 태그를 바탕으로 합니다. 태그와 릴리스를 서로 다른 시점에 만들 수 있어 태그 날짜와 릴리스 날짜가 같다고 보장되지 않습니다. 저장소에 태그가 있다는 사실만으로 설치 파일이 포함된 릴리스까지 공개됐다고 볼 수도 없습니다. 버전 변경을 조사할 때는 각 기록이 무엇을 가리키는지 구분합니다.

릴리스 노트에는 추가 기능과 수정 내용, 사용자가 주의할 변경을 설명합니다. 변경한 모든 파일 이름보다 이용자가 어떤 동작 차이를 겪는지가 판단에 도움이 됩니다. 제거한 설정이나 바뀐 입력 형식이 있다면 기존 사용자에게 필요한 이전 방법도 연결할 수 있습니다. 자동으로 모은 커밋 목록은 출발점이 될 수 있지만 실제 영향 설명까지 자동으로 정확해지는 것은 아닙니다.

버전 번호와 호환성의 의미

유의적 버전 명세 SemVer 2.0.0은 공개 API를 기준으로 MAJOR.MINOR.PATCH 번호를 정하는 규칙을 설명합니다. 호환되지 않는 API 변경에는 MAJOR, 호환되는 기능 추가에는 MINOR, 호환되는 버그 수정에는 PATCH를 올립니다. 이 해석은 프로젝트가 해당 규칙을 채택하고 무엇을 공개 API로 삼는지 정했을 때 적용할 수 있습니다.

숫자가 세 부분으로 나뉘어 있다는 이유만으로 모든 제품이 SemVer를 엄격하게 따른다고 가정하지 않습니다. 날짜 기반 번호나 자체 규칙을 사용하는 프로젝트도 있습니다. 같은 작은 버전 변경처럼 보여도 실제로 바뀐 동작은 릴리스 노트와 변경 안내에서 확인합니다. 호환성 표시는 업데이트를 판단하는 근거이며, 사용 중인 기능의 검증은 따로 필요합니다.

SemVer는 정식 버전 앞에 시험 상태를 나타내는 프리릴리스 표기도 정의합니다. GitHub에서도 정식 사용 준비가 끝나지 않은 릴리스를 pre-release로 표시할 수 있습니다. 어떤 기능이 안정적이라고 약속됐는지는 프로젝트의 설명을 따릅니다. 시험판을 평가했다면 이후 정식 버전의 동작과 같은 결과로 취급하지 않고 확인한 정확한 버전을 남깁니다.

공개 상태와 실제 적용의 구분

GitHub의 릴리스 관리 문서는 초안 저장과 릴리스 공개를 나누어 제공합니다. 필요한 파일과 설명을 준비해도 초안 상태라면 이용자에게 배포된 결과와 다릅니다. 새 릴리스가 공개됐더라도 자신의 서버나 앱이 그 버전을 자동으로 사용한다고 보장되지 않으므로 설치와 배포 상태를 따로 확인합니다.

운영자가 업데이트할 때는 사용할 파일과 버전, 기존 환경의 설정을 함께 대조합니다. 이전 파일이 캐시에 남거나 다른 경로의 실행 파일이 호출되면 다운로드한 버전과 실제 실행 버전이 다를 수 있습니다. 적용 뒤 버전 표시와 주요 기능을 확인하면 이 차이를 찾기 쉽습니다. 문제가 생겼을 때 돌아갈 버전과 되돌릴 수 없는 데이터 변경이 있는지도 함께 살핍니다.

프로젝트를 복구하려면 릴리스 이름뿐 아니라 실제 필요한 자산을 보관합니다. 자동 생성된 소스 압축 파일에 외부 데이터나 별도로 배포한 큰 파일이 모두 들어 있다고 가정하지 않습니다. 배포 파일의 출처와 확인한 해시, 대응하는 소스 태그를 연결하면 다른 파일을 같은 이름의 릴리스로 혼동하는 일을 줄일 수 있습니다. 검증 결과도 파일과 버전을 기준으로 남깁니다.