GitLab 기능 폐기

이 페이지에는 GitLab 기능을 제거하거나 파괴적인 변경을 언제하고 어떻게 해야하는지에 대한 정보가 포함되어 있습니다.

이 페이지에서 사용된 용어에 대한 자세한 내용은 용어를 참조하십시오.

기능은 언제 폐기될 수 있나요?

폐기는 폐기된 기능 제거 일정에 발표되어야 합니다.

폐기는 제거를 의도하는 일정 이전에 늦어도 세 번째 이동표시점 전에 발표되어야 합니다.

폐기에 대한 공지는 폐기에 대한 코드 변경을 도입하는 Merge Request에 포함시키지 마십시오. 기존 폐기 항목을 만들기 위해 별도의 MR을 사용하십시오. 폐기 기록을 만드는 단계에 대한 자세한 내용은 폐기 문서 갱신을 참조하십시오.

폐기, 지원 종료, 제거 프로세스

폐기된 기능에 대한 커뮤니티 기여는 어떻게 처리되나요?

폐기된 기능에 대한 개발은 1우선순위/1심각도 버그 수정에 제한됩니다. 폐기된 기능에 대한 커뮤니티 기여는 거의 마일스톤 기획 중에 우선순위를 받기 어렵습니다.

그러나 GitLab에서는 팀 구성원에게 대리 결정을 부여합니다. 그러므로 기여에 관련된 팀 구성원은 자유롭게 검토하고 Merge할 수 있습니다.

기능을 언제 제거/변경할 수 있나요?

기능 또는 구성은 주요 릴리스에서만 제거/변경될 수 있습니다.

이들은 사전에 폐기되어야 합니다.

API 제거의 경우 GraphQL 및 GitLab API 지침을 참조하십시오.

구성 제거의 경우 Omnibus 폐기 정책을 참조하십시오.

버전 및 업그레이드 세부 정보는 릴리스 및 유지 정책을 참조하십시오.

중요 변경 사항을 소규모 릴리스에서 요청하는 방법

GitLab Self-Managed형 패키지는 의미론적 버전이 지정되고 유지 정책을 준수합니다. 본 프로세스는 베타 또는 실험 기능이 아닌 일반적으로 사용 가능한 기능 및 API에 적용됩니다.

이 유지 정책은 예상치 못한 변경 사항이 비즈니스에 손상을 초래하고 신뢰를 침해할 수 있으므로 고객이 변화에 대비할 수 있도록 하기 위해 산업 전반에서 널리 사용되는 명확하고 예측 가능한 패턴을 설정함으로써, 고객들이 이를 준비할 수 있는 시간을 확실하게 제공하기 위해 존재합니다. GitLab은 많은 고객에게 중요한 비즈니스 응용 프로그램이며, 뜻밖의 변경은 손해를 입힐 수 있기 때문입니다.

소규모 릴리스에서 중요 변경 사항을 도입하는 것은 정책에 어긋납니다. 왜냐하면 이는 고객들을 방해할 수 있고, 그들의 비즈니스에 영향을 미치지 않도록하기 위해 모든 소규모 릴리스마다 중요 변경 사항을 확인해야 한다는 요소를 도입한다는 것입니다. 이것은 GitLab이 고객이 GitLab과의 비즈니스를 가능한 쉽게하는 것을 목표로 하는 것과 일치하지 않으며 강력히 권장되지 않습니다.

우리의 정책을 어긴 중요 변경 사항, 특히 소규모 릴리스에서 중요 변경 사항을 배포하는 것은 GitLab이 중요한 결과에 중점을 둔 경우에만 예약됩니다.

소규모 릴리스에서 중요 변경 사항을 도입하기 위해서는 PM 및 EM이 다음과 같은 프로세스를 따라 예외를 요청해야 합니다:

  1. 중요 변경 사항 예외 템플릿을 사용하여 제품 이슈 추적기에 새 이슈를 엽니다
  2. 제목은 Breaking change exception: Description 형식을 따르어야 합니다.
  3. 중요 변경 사항의 영향 평가 제공
    1. 영향을 받는 고객 수는?
    2. 중요 변경 없이 동일한 결과를 얻을 수 있나요? (즉, 삭제 없음)
    3. 중요 변경은 다음 주요 릴리스 또는 다음 예정된 업그레이드 중지(예: 데이터베이스 시나리오 등)까지 기다릴 수 있나요?
    4. 변경으로 인해 고객이 동일한 작업을 수행할 수 있는 대체품이 무엇인가요?
    5. 고객이 대체품으로 이동하는 것이 얼마나 어려운가요? 이주 계획이 있나요?
  4. 통신 계획을 제공하고 목표 소규모 릴리스를 포함한 명확한 타임라인을 설정합니다.
  5. 관련된 고객에게 정보를 공유할 수 있도록 지원 및 고객 성공에 통지합니다.
  6. 해당 지역의 개발 본부장, 제품 관리 본부장 및 고객 지원 본부장의 승인을 획득합니다.
  7. CPO 및 CTO의 승인을 획득합니다.

폐기 및 삭제 문서 갱신

폐기 및 삭제 문서는 gitlab/data/deprecations에 위치한 YAML 파일에서 생성됩니다.

YAML 파일이 추가되거나 편집 또는 삭제될 때 폐기 및 삭제 문서를 갱신하려면:

  1. 명령줄에서 gitlab-org/gitlab 프로젝트의 로컬 복제로 이동합니다.
  2. data/deprecations 하위에 있는 YAML 파일을 만들거나 편집하거나 삭제합니다.

  3. 폐기 및 삭제 문서를 컴파일합니다: 

    bin/rake gitlab:docs:compile_deprecations

  4. 필요한 경우 다음으로 문서가 최신 상태인지 확인할 수 있습니다: 

    bin/rake gitlab:docs:check_deprecations
  5. 갱신된 문서를 커밋하고 변경 사항을 푸시합니다.
  6. 폐기 및 삭제 템플릿을 사용하여 Merge Request을 생성합니다.

관련 핸드북 페이지:

관련 문서 갱신

기능이 폐기되고 제거되면 관련 문서를 갱신하십시오.