GitLab 기능 폐기

이 페이지에는 GitLab 기능을 제거하거나 중단하는 방법과 시기에 대한 정보가 포함되어 있습니다.

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

기능이 폐기될 수 있는 시점은?

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

폐기는 삭제를 의도한 지워에 선행되는 세 번째 마일스톤 전까지 발표되어야 합니다.

폐기에 대한 발표를 폐기에 대한 코드 변경을 도입하는 병합 요청에 포함시키지 마십시오. 폐기 항목을 만들기 위해 별도의 병합 요청을 사용하세요. -> 폐기 항목 업데이트를 참조하세요.

폐기, 지원 종료, 제거 과정

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

폐기된 기능에 대한 개발은 우선순위 1/심각도 1 버그 수정으로 제한됩니다. 폐기된 기능에 대한 커뮤니티 기여는 마일스톤 계획 중에 우선순위를 받기 어려울 것입니다.

그러나 GitLab에서는 우리의 팀 구성원들에게 권한을 부여합니다. 따라서 해당 기여와 관련된 팀 구성원이 재량에 따라 검토하고 병합할 수 있습니다.

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

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

미리 폐기되어야 합니다.

API 제거의 경우 GraphQL 및 GitLab API 가이드라인을 참조하세요.

구성 제거의 경우 Omnibus 폐기 정책을 참조하세요.

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

소규모 릴리스에서 중단 변경 요청

GitLab 자체 관리 패키지는 의미론적 버전이 지정되며 저희의 유지 보수 정책을 따릅니다. 이 프로세스는 베타 또는 실험적이 아닌 일반적으로 이용 가능한 기능 및 API에 적용됩니다.

이 유지 보수 정책은 고객이 소프트웨어 산업에서 널리 사용되는 명확하고 예측 가능한 방식을 통해 혼란스럽지 않게 혁신적인 변화에 대비할 수 있도록 하는 데 목적이 있습니다. GitLab은 많은 고객에게 비즈니스에 큰 영향을 미칠 수 있는 중요한 애플리케이션입니다. 뜻밖의 변경으로 인해 손해를 입히고 신뢰를 훼손시킬 수 있기 때문입니다.

소규모 릴리스에서 중단 변경 사항을 도입하는 것은 정책에 반하는 것입니다. 왜냐하면 이는 고객에게 혼란을 일으키며 그들의 비즈니스가 영향을 받지 않도록 하기 위해 모든 소규모 릴리스마다 중단 변경 사항을 확인해야 하기 때문입니다. 이것은 가능한 한 GitLab과의 비즈니스를 쉽게 처리할 수 있도록 하는 것이 목표에 부합하지 않으며 강력히 권장되지 않습니다.

정책을 위반하는 것, 특히 소규모 릴리스에서 중단 변경 사항을 배포하는 것은 GitLab이 변경을 지연시키는 것이 전반적으로 고객에게 더 부정적인 영향을 끼칠 경우에 한하여 예외를 허용하는 경우에만 적용됩니다. 특별히 예외를 승인하는 데 가장 중요한 시각은 고객 결과입니다.

소규모 릴리스에서 중단 변경을 도입하려면 예외 요청을 목적으로 PM 및 EM이 다음 프로세스를 준수해야 합니다:

  1. Breaking Change Exception 템플릿을 사용하여 제품 이슈 추적기에 새로운 이슈를 엽니다
  2. 제목은 Breaking change exception: Description 형식을 따릅니다.
  3. 중단 변경의 영향 평가를 제공합니다.
    1. 영향을 받는 고객 수는 얼마나 되나요?
    2. 중단 변경 없이 동일한 결과를 얻을 수 있나요? (즉, 제거 없음)
    3. 중단 변경을 다음 주요 릴리스나 예를 들어 데이터베이스 시나리오의 다음 예정된 업그레이드 중지까지 기다릴 수 있나요?
    4. 변경이 내성을 깰 수 있는 대체품이 무엇인가요?
    5. 대체품으로 작업을 똑같이 수행하는 대안은 고객에게 얼마나 어려운가요? 이를 위한 이주 계획이 있나요?
  4. 명확한 타임라인을 포함하여 커뮤니케이션 계획을 수립합니다. 그리고 대상이 되는 소규모 릴리스를 정합니다.
  5. Support 및 Customer Success에게 정보를 공유할 수 있도록 통보합니다.
  6. 해당 지역의 개발 이사, 제품 관리 이사 및 고객 지원 이사의 승인을 획득합니다.
  7. 최고 제품 책임자 및 최고 기술 책임자의 승인을 획득합니다.

폐기 및 제거 문서 업데이트

폐기 및 제거 문서는 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. 폐기 및 제거 템플릿을 사용하여 병합 요청을 만듭니다.

관련 핸드북 페이지:

관련 문서 업데이트

기능이 폐지되고 제거될 때, 관련 문서를 업데이트하세요.