Linux 패키지에는 사용자에게 다양한 구성 옵션을 제공하는 여러 라이브러리와 서비스가 포함됩니다.

라이브러리와 서비스가 업데이트되면서 구성 옵션이 변경되고 더 이상 사용되지 않게 됩니다. 유지 관리성을 높이고 작동하는 설정을 유지하기 위해 다양한 구성을 제거해야 합니다.

구성 지원 중단#

정책#

Linux 패키지는 최소 하나의 메이저 버전 동안 구성을 유지합니다. 지원 중단된 구성이 다음 메이저 릴리스에서 사용 가능하다고 보장할 수 없습니다. 자세한 내용은 예시를 참조하세요.

공지#

구성이 더 이상 사용되지 않으면 다음을 통해 지원 중단을 발표합니다:

• https://about.gitlab.com/blog/의 릴리스 블로그 게시물. 블로그 게시물 항목에는 목표 제거 날짜와 함께 지원 중단 공지가 포함됩니다.
• 설치/재구성 출력(해당되는 경우).
• https://docs.gitlab.com/의 공식 문서. 문서 업데이트에는 수정된 구문(해당되는 경우) 또는 구성 제거 날짜가 포함됩니다.

절차#

이 섹션에서는 구성 지원 중단 및 제거에 필요한 단계를 나열합니다.

두 가지 유형의 구성을 구별할 수 있습니다:

• 민감한 구성: 주요 서비스 중단을 일으킬 수 있는 구성(데이터 무결성, 설치 무결성 또는 사용자가 설치에 접근하는 것을 방지하는 경우 등)
• 일반 구성: 기능을 사용할 수 없게 만들 수 있지만 설치를 계속 사용할 수 있는 구성(기본 프로젝트/그룹 설정 변경 또는 다른 구성 요소와의 통신 문제 등)

지원 중단 및 제거 절차도 구별해야 합니다.

구성 지원 중단#

지원 중단 절차는 민감한 구성과 일반 구성 모두 비슷합니다. 유일한 차이점은 제거 목표 날짜입니다.

공통 단계:

1. 지원 중단 유형 및 기타 필요한 정보에 대한 세부 정보가 포함된 이슈를 omnibus-gitlab 이슈 트래커에 생성합니다. deprecation 레이블을 적용합니다.
2. 지원 중단된 구성의 제거 목표를 결정합니다.
3. 공지 섹션에 명시된 대로 각 항목에 대한 지원 중단 공지를 작성합니다.

제거 목표:

일반 구성의 경우 제거 목표는 항상 다음 메이저 릴리스 날짜여야 합니다. 날짜를 알 수 없는 경우 다음 메이저 버전을 참조할 수 있습니다.

민감한 구성의 경우 좀 더 복잡합니다. 다음 메이저 릴리스가 2개의 마이너 릴리스 이내인 경우 다음 메이저 릴리스에서 민감한 구성을 제거하지 않는 것을 목표로 해야 합니다(이 숫자는 보안 백포트 릴리스 정책과 일치하도록 선택되었습니다).

몇 가지 예시는 아래 표를 참조하세요:

구성 제거#

지원 중단이 발표되고 제거 목표가 설정되면 이슈의 마일스톤이 제거 목표 버전과 일치하도록 변경되어야 합니다.

이슈의 최종 댓글에는 다음이 포함되어야 합니다:

• 릴리스 블로그 게시물 섹션에 대한 텍스트 스니펫.
• 변경 사항을 도입하는 문서 머지 리퀘스트(또는 문서 스니펫) 링크.
• 다음 중 하나:
  • 구성을 제거하는 초안 머지 리퀘스트 링크.
  • 수행해야 할 작업에 대한 세부 정보.

예시#

GitLab 버전 10.0에서 /etc/gitlab/gitlab.rb의 사용자 구성 gitlab_rails['configuration'] = true가 도입되었습니다. GitLab 버전 10.4.0에서 이 구성 옵션의 이름을 변경해야 하는 새 변경 사항이 도입되었습니다. 새 구성 옵션은 gitlab_rails['better_configuration'] = true입니다. 개발팀은 이전 구성을 새 구성으로 변환하고 지원 중단 절차를 시작합니다.

이는 두 구성 옵션이 GitLab 버전 10 전체에서 유효함을 의미합니다. 즉, GitLab 10.8.0에서 gitlab_rails['configuration'] = true를 설정한 경우 gitlab_rails['better_configuration'] = true를 설정한 것과 동일하게 기능이 계속 작동합니다. 그러나 이전 버전의 구성을 설정하면 설치/업그레이드/재구성 실행 끝에 지원 중단 공지가 출력됩니다.

GitLab 11에서 gitlab_rails['configuration'] = true는 더 이상 작동하지 않으며 /etc/gitlab/gitlab.rb의 구성을 새 유효 구성으로 수동으로 변경해야 합니다. 참고 이 구성 옵션이 민감한 경우이고 설치 또는 데이터의 무결성을 위험에 빠뜨릴 수 있는 경우 설치 또는 업그레이드가 중단됩니다.