Lobsters

Forgejo v17.0 is available

Forgejo v17.0 출시

Forgejo v17.0은 저장소 안 문서의 절대 링크 처리, Actions 실행·작업 API와 요약 표시, Bitbucket Data Center 마이그레이션 등을 개선한 자체 호스팅 코드 협업 플랫폼의 새 버전입니다. 저장소 문서 링크와 웹훅 동작에는 호환성을 깨는 변경이 있어 업그레이드 전에 백업과 수동 이전 절차를 확인해야 합니다.

에디터 노트

v17.0에서 운영자가 가장 먼저 처리할 일은 웹훅 이전입니다. 새 workflow run 이벤트는 기존 이벤트와 헤더 및 payload 키가 달라 수신기 호환성을 확인해야 하고 자동 변환도 지원하지 않습니다. 완료 알림 시점도 모든 job 종료 뒤로 바뀌므로 기존 자동화가 알림을 소비하는 방식에 영향을 줍니다. 저장소 문서의 절대 링크를 저장소 루트 기준으로 바꾸는 변경은 다른 Git forge와의 호환성을 높인다는 설명과 맞닿아 있습니다. 다만 이슈와 풀 리퀘스트 설명 및 댓글에서는 인스턴스 루트 기준 동작이 유지돼 링크 해석 규칙이 문서 위치마다 다릅니다. AGit 기능 기여자는 이를 큰 이정표라고 평가하며 후속 개선 아이디어도 있다고 밝혔지만, 댓글만으로 실제 사용 범위나 효과를 판단할 근거는 없습니다.

AI 요약

Forgejo v17.0이 2026년 10월 15일 출시됐습니다. 이번 버전은 저장소 문서 링크 해석을 다른 Git forge와 맞추고, Forgejo Actions 관리 기능과 Git LFS 화면을 보강했습니다. Bitbucket Data Center에서 저장소와 풀 리퀘스트 정보를 가져오는 기능도 추가했습니다. v17.0은 LTS 버전이 아니며 지원은 2027년 1월 28일까지 이어집니다.

링크와 웹훅 변경

렌더링한 저장소 문서에서 저장소 내부 리소스를 가리키는 절대 링크는 이제 인스턴스 루트가 아니라 해당 저장소 루트를 기준으로 해석합니다. 이전 동작과 호환되지 않는 변경이며, 이슈와 풀 리퀘스트 설명 및 댓글의 절대 링크는 계속 인스턴스 루트를 기준으로 처리합니다. Forgejo는 이 변경으로 다른 Git forge와의 호환성이 높아져 마이그레이션이 쉬워진다고 설명합니다.

Actions 웹훅의 기존 action run 이벤트는 workflow run 이벤트로 대체됩니다. 기존 웹훅을 새 이벤트로 자동 이전할 수는 없습니다. X-*-Event, X-*-Event-Type 헤더와 action 키가 달라 기존 수신기가 깨질 수 있기 때문입니다. 실행 완료 알림도 모든 작업이 끝난 뒤에만 전송됩니다. 운영자는 수신기가 새 형식을 처리하는지 확인한 뒤 웹훅을 직접 바꿔야 합니다. 기존 이벤트는 더 이상 개선되지 않으며 이후 Forgejo 버전에서 제거될 예정입니다. 별도로 workflow job 상태 변경 웹훅도 추가돼 waiting, cancelled 같은 상태를 골라 알림을 받을 수 있습니다.

Forgejo Actions와 Git 기능

HTTP API로 완료된 전체 workflow run이나 개별 job을 다시 실행할 수 있습니다. 실행 중인 run도 이미 끝난 개별 job이라면 다시 실행할 수 있습니다. job 로그는 문자열 필터와 특정 단계 필터를 지원하며 NDJSON 형식으로도 받을 수 있습니다. 개별 job 정보를 조회하는 엔드포인트도 추가됐습니다.

Forgejo Runner 13.2 이상이 만든 job summary를 로그 위에 표시합니다. summary는 Markdown 문서이며 표, Mermaid 다이어그램, KaTeX 수식을 쓸 수 있습니다. 단계에서 $FORGEJO_STEP_SUMMARY 파일에 내용을 기록하면 됩니다. GitHub 호환을 위해 $GITHUB_STEP_SUMMARY도 지원합니다. AGit ref에는 풀 리퀘스트 작성자와 유지 관리자가 직접 push하고 pull할 수 있게 됐습니다. Git LFS 설정의 탐색과 개요 화면을 개선했고, 특정 LFS 파일을 참조하는 커밋을 찾는 화면과 포인터 처리도 보강했습니다.

협업과 마이그레이션

이슈, 풀 리퀘스트, 댓글 작성 중 #을 입력하면 이슈와 풀 리퀘스트를 자동 완성하고, !는 풀 리퀘스트만 검색합니다. 조직에 사용자를 추가할 때 즉시 가입시키지 않고 초대장을 보내는 설정도 생겼습니다. 초대는 조직 프로필에 표시되고 이메일로 전달되며 기본 만료 기간은 14일입니다. 인증 제공자는 별도 동작 없이 사용자를 조직에 추가할 수 있습니다. 여러 팀에 사용자를 한 번에 추가하거나 초대하는 기능도 제공하며 댓글의 Markdown 원문을 메뉴에서 복사할 수 있습니다.

Bitbucket Data Center에서 저장소를 가져올 때 풀 리퀘스트, 리뷰, 댓글, 여러 줄 댓글, 스레드와 답글도 가져올 수 있습니다. 인증에는 HTTP access token이 필요하며 HTTPS SCM Hosting을 활성화해야 합니다. Gogs, GitLab, Gitea, Forgejo에서 저장소를 가져올 때 저장소 아바타 이미지도 함께 이전합니다. FUNDING.yml이 있는 저장소와 사용자 또는 조직 프로필에는 기부 옵션을 보여주는 Donate 버튼이 나타납니다. 이 기능은 현재 웹 인터페이스에서만 제공됩니다.

업그레이드와 지원 기간

Forgejo는 업그레이드 전에 전체 백업을 만들고 릴리스 노트의 호환성 변경 사항을 읽으라고 권고합니다. 백업 및 복원 안내서에는 복원에 필요한 주요 비밀 정보도 설명돼 있습니다. 17.0 컨테이너 태그는 최신 17.0.Y 패치 버전을 따라갑니다. 릴리스 일정상 주요 버전은 3개월마다 나오며 v17.0 지원은 2027년 1월 28일 종료됩니다.

Lobsters 반응

  • @oliverpool — AGit push 기능과 문서 개편에 기여했습니다. 궁금한 점이 있으면 답하겠습니다. 더 개선할 아이디어도 있지만 이번 버전은 큰 이정표입니다.

원문: Forgejo / 번역·요약: Trawling

원문 보기 ↗토론 보기 ↗