리포지토리에서 릴리스 관리

릴리스를 만들어 번들로 묶고 사용자에게 프로젝트의 반복을 제공할 수 있습니다.

누가 이 기능을 사용할 수 있나요?

Repository collaborators and people with write access to a repository can create, edit, and delete a release.

Tool navigation

이 문서의 내용

릴리스 관리 정보

릴리스 정보, 기여자의 @mentions, 이진 파일에 대한 링크를 사용하여 새 릴리스를 만들고 기존 릴리스를 편집하거나 삭제할 수 있습니다. 릴리스 API를 사용하여 릴리스를 만들고, 수정하고, 삭제할 수도 있습니다. 자세한 내용은 REST API 설명서에서 릴리스에 대한 REST API 엔드포인트을(를) 참조하세요.

GitHub Marketplace의 특정 릴리스에서 작업을 게시할 수도 있습니다. 자세한 내용은 GitHub Marketplace에서 작업 게시을(를) 참조하세요.

Git 대용량 파일 스토리지(Git LFS) 개체가 각 릴리스에 대해 GitHub에서 생성되는 ZIP 파일 및 tarball에 포함되는지 여부를 선택할 수 있습니다. 자세한 내용은 리포지토리의 보관 계층에 있는 Git LFS 개체 관리을(를) 참조하세요.

릴리스 만들기

  1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.

  2. 파일 목록의 오른쪽에서 릴리스를 클릭합니다.

    리포지토리의 기본 페이지 스크린샷. "릴리스"라는 레이블이 지정된 링크가 주황색 윤곽선으로 강조 표시되어 있습니다.

  3. 페이지의 상단에서 새 릴리스 작성을 클릭합니다.

  4. 릴리스의 태그를 선택하려면 태그 선택 드롭다운 메뉴를 선택합니다.

    • 기존 태그를 사용하려면 태그를 클릭합니다.
    • 새 태그를 만들려면 릴리스의 버전 번호를 입력한 다음 새 태그 만들기를 클릭합니다.

  5. 새 태그를 만든 후 대상 드롭다운 메뉴를 선택하고 릴리스할 프로젝트가 포함된 분기를 클릭합니다.

  6. 필요에 따라 설명 필드 위의 이전 태그 드롭다운 메뉴를 선택하고 이전 릴리스를 식별하는 태그를 클릭합니다.

    "새 릴리즈" 양식의 스크린샷. "이전 태그: 자동" 드롭다운 메뉴가 주황색 윤곽선으로 강조 표시됩니다.

  7. "릴리스 타이틀" 필드에 릴리스의 제목을 입력합니다.

  8. "이 릴리스 설명" 필드에 릴리스에 대한 설명을 입력합니다. 설명에서 모든 사용자를 @mention하면 게시된 릴리스에 멘션된 모든 사용자의 아바타 목록이 있는 기여자 섹션이 포함됩니다. 또는 릴리스 정보 생성을 클릭하여 릴리스 정보를 자동으로 생성할 수 있습니다.

  9. 필요에 따라 릴리스에 컴파일된 프로그램과 같은 이진 파일을 포함하려면 이진 상자에서 파일을 끌어서 놓거나 수동으로 선택합니다.

  10. 릴리스가 프로덕션에 사용할 준비가 되지 않았으며 불안정할 수 있음을 사용자에게 알리려면 시험판입니다를 선택합니다.

  11. 필요에 따라 최신 릴리스로 설정을 선택합니다. 이 옵션을 선택하지 않으면 의미 체계 버전 관리에 따라 최신 릴리스 레이블이 자동으로 할당됩니다.

  12. 필요에 따라 GitHub Discussions이(가) 리포지토리에서 사용하도록 설정된 경우 릴리스에 대한 토론을 만듭니다.

    • 이 릴리스에 대한 토론 만들기를 선택합니다.
    • 범주 드롭다운 메뉴를 선택하고 릴리스 토론의 범주를 클릭합니다.

  13. 릴리스를 공개할 준비가 되면 릴리스 게시를 클릭합니다. 나중에 릴리스에서 작업하려면 초안 저장을 클릭합니다. 그런 다음, 리포지토리에 대한 릴리스 피드에 게시되거나 초안 작성된 릴리스를 볼 수 있습니다. 자세한 내용은 리포지토리의 릴리스 및 태그 보기을(를) 참조하세요.

Note

GitHub CLI에 대한 자세한 내용은 GitHub CLI 정보을(를) 참조하세요.

  1. 릴리스를 만들려면 gh release create 하위 명령을 사용합니다. tag를 릴리스에 대해 원하는 태그로 바꿉니다.

    gh release create TAG

  2. 대화형 프롬프트의 안내를 따릅니다. 또는 인수를 지정하여 이러한 프롬프트를 건너뛸 수 있습니다. 가능한 인수에 대한 자세한 내용은 GitHub CLI 설명서를 참조하세요. 예를 들어 이 명령은 지정된 제목과 참고를 포함한 시험판을 만듭니다.

    gh release create v1.3.2 --title "v1.3.2 (beta)" --notes "this is a 공개 미리 보기 release" --prerelease

노트에서 GitHub 사용자를 @mention하면 게시된 릴리스에 멘션된 모든 사용자의 아바타 목록이 있는 Contributors 섹션이 포함됩니다.

릴리스 편집

  1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.

  2. 파일 목록의 오른쪽에서 릴리스를 클릭합니다.

    리포지토리의 기본 페이지 스크린샷. "릴리스"라는 레이블이 지정된 링크가 주황색 윤곽선으로 강조 표시되어 있습니다.

  3. 편집하려는 릴리스 옆의 아이콘을 클릭합니다.

    릴리스 목록의 릴리스 스크린샷. 연필 아이콘이 주황색 윤곽선으로 강조 표시됩니다.

  4. 양식 릴리스에 대한 세부 정보를 편집한 다음 릴리스 업데이트를 클릭합니다. 설명에서 GitHub 사용자 @mentions를 추가하거나 제거하는 경우 해당 사용자는 릴리스의 기여자 섹션에 있는 아바타 목록에서 추가되거나 제거됩니다.

  1. 릴리스를 편집하려면 gh release edit 하위 명령을 사용합니다. TAG를 편집하려는 릴리스를 나타내는 태그로 바꿉니다. 예를 들어 릴리스 제목을 편집하려면 다음 코드를 사용합니다. 이때 NEW-TITLE을 업데이트된 제목으로 바꿉니다.

    gh release edit TAG -t "NEW-TITLE"

    가능한 인수에 대한 자세한 내용은 GitHub CLI 설명서를 참조하세요.

릴리스 삭제

  1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.

  2. 파일 목록의 오른쪽에서 릴리스를 클릭합니다.

    리포지토리의 기본 페이지 스크린샷. "릴리스"라는 레이블이 지정된 링크가 주황색 윤곽선으로 강조 표시되어 있습니다.

  3. 페이지 오른쪽에서 삭제할 릴리스 옆에 있는 을 클릭합니다.

    릴리스 목록의 릴리스 스크린샷. 휴지통 아이콘이 주황색 윤곽선으로 강조 표시됩니다.

  4. 이 릴리스 삭제를 클릭합니다.

  1. 릴리스를 삭제하려면 gh release delete 하위 명령을 사용합니다. tag를 삭제할 릴리스의 태그로 바꿉니다. -y 플래그를 사용하여 확인을 건너뜁니다.

    gh release delete TAG -y