InfoGrab DocsInfoGrab Docs

조직 릴리스 프로세스

요약

조직 기능은 조직 플래그(organization flag) 뒤에 게이트한 다음, 그 플래그를 고정된 공유 스테이지(stage) 사다리를 따라 올리는 방식으로 출시합니다. 이 모델은 기능의 대상 사용자가 넓어지기만 한다는 한 가지 원칙에 바탕을 둡니다.

조직 기능은 조직 플래그(organization flag) 뒤에 게이트한 다음, 그 플래그를 고정된 공유 스테이지(stage) 사다리를 따라 올리는 방식으로 출시합니다. 스테이지는 Experimental, Internal, Beta, Limited Availability(LA), GA입니다.

이 모델은 기능의 대상 사용자가 넓어지기만 한다는 한 가지 원칙에 바탕을 둡니다. 대상 사용자는 두 축을 따라 넓어집니다. 세그먼트는 기능에 접근할 수 있는 사용자로, Organizations 팀에서 GitLab 팀 멤버, 참여를 선택한 고객, 점차 늘어나는 고객 비율, 전체 사용자 순으로 확장됩니다. 플랫폼은 기능이 실행되는 위치로, GitLab.com에서 시작해 GA 시점에는 GitLab Self-Managed와 GitLab Dedicated까지 확장됩니다. 각 스테이지는 이렇게 넓어지는 면 위의 한 지점입니다. 더 높은 스테이지는 두 축 중 하나 또는 양쪽 모두에서 대상 사용자를 넓히며, 결코 좁히지 않습니다.

바꾸는 것은 스테이지 하나뿐입니다. 스테이지는 스테이지마다 하나씩, 이미 해당 스테이지의 대상 사용자와 롤아웃이 구성된 소수의 고정된 공유 스테이지 플래그(stage flag)(org_stage_*)가 뒷받침합니다. 플래그를 새로 만들거나 그 액터 또는 백분율을 조정하지 않습니다. 기능을 진전시키려면 머지 리퀘스트에서 조직 플래그의 스테이지를 올리며, 그러면 그 스테이지의 롤아웃을 그대로 물려받습니다. 이것이 각 기능이 자기 기능 플래그를 소유하고 자기 롤아웃을 직접 구동하는 일반적인 GitLab 기능 플래그 워크플로와 이 프로세스가 달라지는 핵심 지점입니다.

핸드북에는 스테이지, 대상 사용자, 대상 플랫폼, 롤아웃 규칙 같은 세부 사항이 있습니다. Organizations 릴리스 스테이지를 참조합니다. 해당 페이지는 제품과 디자인을 포함해 Organizations를 작업하는 모든 사람을 위해 작성된 정본(source of truth)입니다. 이 페이지는 엔지니어링 가이드입니다.

아직 모든 기능이 이 프로세스를 따르는 것은 아닙니다. 기능 하나, 즉 조직 생성에 대한 감사 결과는 조직이 생성되는 방식을 참조합니다. 조직 생성 경로 중 일부는 현재 릴리스 레이어를 사용하지 않습니다.

기능을 출시하는 단계는 네 가지입니다.

  1. 릴리스 레이어로 기능을 게이트합니다.
  2. 시작 스테이지에서 조직 플래그를 등록합니다.
  3. 릴리스 스펙 헬퍼로 기능을 테스트합니다.
  4. Stable에 도달할 때까지 스테이지를 따라 진전시킵니다.

기능 게이트하기#

기능 코드와 기능 플래그 라이브러리 사이에 있는 릴리스 레이어 Organizations::Release로 기능을 감쌉니다. 기능 플래그를 직접 확인하지 말고 조직 플래그가 활성화되어 있는지 이 레이어에 확인합니다.

return unless Organizations::Release.enabled?(:ui_for_organizations, actor)

이 레이어는 조직 플래그의 스테이지를 조회하고 해당 스테이지의 공유 스테이지 플래그에 대해 액터를 확인합니다. 앞선 스테이지의 캐스케이드 스테이지 플래그도 확인하므로 결과는 앞선 스테이지에서 나올 수 있습니다. 앞선 스테이지는 앞으로 캐스케이드됩니다를 참조합니다. 액터는 스테이지 플래그가 롤아웃되는 대상으로, 현재 사용자나 조직 같은 것입니다. 스테이지 플래그의 인스턴스 전체 게이트를 확인하려면 nil을 전달합니다.

이 레이어는 직접적인 Feature.enabled? 확인과 마찬가지로 액터를 기능 플래그 라이브러리로 그대로 전달합니다. 공유 스테이지 플래그는 백분율 롤아웃에서 액터 유형별로 버킷을 나누므로, 조직 플래그의 모든 호출 위치에서 일관된 액터 유형을 전달합니다. 스테이지 플래그를 운영하는 방식을 참조합니다.

앞선 스테이지는 앞으로 캐스케이드됩니다#

한 스테이지에서 기능을 볼 수 있는 액터는 기능이 이후 스테이지로 진전되어도 그 접근 권한을 유지합니다. 대상 사용자는 넓어지기만 하므로 앞선 스테이지의 더 작은 대상 사용자는 결코 빠지지 않습니다. 따라서 Beta 스테이지의 기능은 Beta 대상 사용자뿐 아니라 Experimental 대상 사용자에게도 활성화됩니다.

Organizations::Release.enabled?는 이를 반영합니다. 이 메서드는 플래그 자체의 스테이지 플래그와 앞선 모든 캐스케이드 스테이지 플래그를 확인합니다. Experimental, Internal, Beta는 캐스케이드됩니다. LA 스테이지는 독립적인 백분율 버킷으로 롤아웃되며 중첩되지 않고, GA는 이미 모든 사용자에게 켜져 있습니다.

프론트엔드에 플래그 노출#

프론트엔드 코드를 게이트하려면 push_frontend_feature_flag로 기능 플래그를 푸시하는 방식과 마찬가지로 컨트롤러에서 조직 플래그를 푸시합니다.

push_frontend_organization_release(:ui_for_organizations, actor)

이 헬퍼는 레이어를 통해 조직 플래그를 해석하고 그 결과를 조직 플래그 자체의 이름으로 푸시합니다. 프론트엔드 코드는 gon.features.uiForOrganizations를 읽으며 뒷받침하는 스테이지 플래그와 분리된 상태로 유지됩니다. 기능을 다른 스테이지로 진전시켜도 프론트엔드를 변경할 필요가 없습니다.

조직 플래그 등록하기#

config/organizations_release.yml에 조직 플래그를 선언합니다.

flags:
  - name: ui_for_organizations
    description: Browse and manage an organization through its dedicated UI.
    stage: experimental
  • name: Organizations::Release.enabled?에 전달하는 식별자.
  • stage: 기능이 시작하는 스테이지로, 보통 experimental입니다. experimental, internal, beta, la_25, la_50, la_75, la_100, ga 중 하나입니다.

기능 테스트하기#

모든 스펙에서 사용할 수 있는 stub_organization_release로 스펙에서 조직 플래그를 고정합니다.

stub_organization_release(ui_for_organizations: true)
stub_organization_release(ui_for_organizations: false)

한 번의 호출로 여러 플래그를 전달할 수 있으며, 반복 호출은 누적됩니다.

이 헬퍼는 stub_feature_flags가 일반 플래그를 스텁하는 것과 같은 방식으로 각 조직 플래그에 대해 Organizations::Release.enabled?를 스텁합니다. 공유 org_stage_* 스테이지 플래그는 건드리지 않습니다. 이렇게 하면 기능의 스테이지나 같은 스테이지의 다른 기능과 무관하게 하나의 기능을 고정할 수 있으며, 기능이 다른 스테이지로 진전되어도 스펙이 계속 동작합니다.

스텁하지 않은 플래그는 실제 enabled?를 사용합니다. 일반 기능 플래그와 마찬가지로 스테이지 플래그는 테스트에서 기본적으로 활성화되어 있으므로, 비활성화하지 않으면 게이트된 코드가 실행됩니다. 일반적인 용도는 비활성화된 경우를 고정하는 것입니다.

알 수 없는 플래그 이름은 잘못 입력한 기능 플래그와 마찬가지로 오류를 발생시킵니다.

스테이지 해석과 캐스케이드는 org_stage_* 플래그를 직접 구동하는 spec/lib/organizations/release_spec.rb에서 테스트합니다.

스테이지를 따라 진전시키기#

stage를 한 단계씩 올려 기능을 진전시킵니다. 변경할 때마다 머지 리퀘스트를 만듭니다.

Mermaid 다이어그램 (2줄)
소스 코드 보기
flowchart LR
    Add["Register flag<br>stage: experimental"] --> internal --> beta --> la_25 --> la_50 --> la_75 --> la_100 --> ga --> Stable["Stable<br>remove the flag"]

모든 스테이지가 필수는 아닙니다. 경로는 핸드북이 정의합니다. 요약하면 다음과 같습니다.

스테이지 필수 여부 참고
Experimental 선택 사항 적절한 경우 건너뜁니다. 조직 플래그는 Internal이나 Beta에서 시작할 수 있습니다.
Internal 선택 사항 적절한 경우 건너뜁니다. 조직 플래그는 Experimental에서 바로 Beta로 갈 수 있습니다.
Beta 필수 건너뛰지 않습니다.
LA 25, 50, 75 선택 사항 중간 단계는 건너뛸 수 있습니다.
LA 100 GA 이전에 필수 조직 플래그는 GA 이전에 LA 100에 도달합니다.
GA 선택 사항 GitLab Self-Managed와 GitLab Dedicated의 릴리스 지점입니다. 사소한 변경은 바로 Stable로 정착할 수 있습니다.
Stable 종결 모든 조직 플래그는 여기서 끝나며, 기능은 더 이상 게이트되지 않습니다.

기능을 롤백하려면 같은 방식으로 조직 플래그의 stage를 낮춥니다.

GA에 도달하려면 org_stage_ga를 default_enabled: true로 배포해야 합니다. 이 스테이지 플래그가 기능을 GitLab Self-Managed와 GitLab Dedicated로 전달합니다.

Stable에 도달한다는 것은 시스템을 완전히 벗어난다는 뜻입니다. 조직 플래그의 config/organizations_release.yml 항목을 제거하고, Organizations::Release.enabled? 호출 위치를 조건 없는 동작으로 대체합니다. 공유 스테이지 플래그는 그 스테이지에 있는 다른 조직 플래그를 위해 그대로 남습니다. Stable은 설정하는 stage 값이 아닙니다.

위험도가 높은 기능은 공유 스테이지 플래그를 전혀 사용하지 않고 자체 기능 플래그를 사용할 수 있습니다.

스테이지 플래그를 운영하는 방식#

보통은 이 부분을 다룰 일이 없습니다. 기능을 진전시키는 일은 stage 변경입니다(스테이지를 따라 진전시키기 참조). 이 섹션은 공유 스테이지 플래그가 어떻게 설정되고 유지되는지에 대한 내용입니다.

각 스테이지는 lib/organizations/release/stage.rb에 정의된 공유 ops 스테이지 플래그 하나에 대응합니다.

스테이지 스테이지 플래그
Experimental org_stage_experimental
Internal org_stage_internal
Beta org_stage_beta
LA 25 to 100 org_stage_la_25 to org_stage_la_100
GA org_stage_ga (default_enabled: true)

여기의 ChatOps 명령은 개별 조직 플래그가 아니라 이 공유 스테이지 플래그를 구성합니다. 스테이지 플래그의 구성은 해당 스테이지의 모든 조직 플래그에 동일합니다. 스테이지 플래그는 공유되므로, 그 스테이지의 모든 조직 플래그가 게이트를 공유하며 액터는 어느 게이트든 하나에 부합하면 기능을 보게 됩니다. Flipper는 스테이지 플래그의 게이트를 논리 OR로 결합하므로, 스테이지 플래그 하나가 여러 대상 사용자를 동시에 지원할 수 있습니다.

Experimental, Internal, Beta 스테이지 플래그는 특정 액터나 기능 그룹을 활성화합니다.

/chatops run feature set --group=gitlab-org/organizations org_stage_experimental true
/chatops run feature set --feature-group=gitlab_team_members org_stage_internal true
/chatops run feature set --group=a-customer-group org_stage_beta true

Internal은 gitlab_team_members 기능 그룹에 활성화되고, Beta는 고객 그룹을 대상으로 합니다.

액터는 다형(polymorphic)입니다. 특정 액터 게이트는 GitLab이 기능 플래그 액터로 지원하는 모든 유형(Feature::SUPPORTED_MODELS), 즉 조직, 사용자, 그룹 등을 받습니다. 특정 조직이나 특정 사용자처럼 기능을 받아야 하는 액터에 대해 스테이지 플래그를 활성화합니다. 액터 유형은 기능이 호출 위치에서 확인하는 유형과 일치해야 하며, 그렇지 않으면 게이트에 해당되지 않습니다.

LA 스테이지 플래그는 액터의 백분율을 사용하며, 각 스테이지 플래그 이름에 있는 백분율로 설정합니다.

/chatops run feature set org_stage_la_25 25 --actors
/chatops run feature set org_stage_la_50 50 --actors

시간의 백분율이 아니라 액터의 백분율을 사용합니다. 액터의 백분율은 특정 액터를 롤아웃 안이나 밖에 일관되게 유지하지만, 시간의 백분율은 확인할 때마다 다시 추첨합니다.

공유 스테이지 플래그에는 두 가지 결과가 따릅니다.

  • 액터의 백분율에는 확인 시점에 액터가 필요합니다. nil을 전달하는 확인은 불리언 게이트나 특정 액터 게이트에만 일치하고 백분율 게이트에는 일치하지 않습니다.
  • 액터의 백분율은 액터를 유형별로 버킷에 나눕니다. 같은 스테이지의 조직 플래그 두 개를 한 요청에서 서로 다른 액터 유형으로 확인하면, 롤아웃이 하나는 포함하고 다른 하나는 제외할 수 있으므로 주어진 조직 플래그에는 일관된 액터 유형을 전달합니다.

GA 스테이지 플래그는 default_enabled: true로 출시되는 유일한 플래그입니다. 이 플래그는 핸드브레이크를 유지한 채 모든 배포에 도달합니다. 핸드브레이크는 GitLab.com과 GitLab Self-Managed에서 동작하지만, 기능 플래그를 수정할 수 없는 GitLab Dedicated에서는 효과가 없습니다.

릴리스 상태 표#

doc/development/organizations/release_status.md는 레지스트리에서 생성되며 직접 편집하지 않습니다. 스테이지를 변경한 뒤에는 다시 생성합니다.

bin/rake gitlab:organizations:release:docs

이 표에는 Experimental부터 GA까지 현재 롤아웃 프로세스에 있는 조직 플래그가 표시됩니다. Stable에 도달한 조직 플래그는 스테이지 플래그 시스템을 벗어나 표에서 제외됩니다.

용어#

  • 기능(Feature): Organizations 팀이 출시하는 제품 기능으로, 릴리스 프로세스에 있는 동안 게이트됩니다.
  • 조직 플래그(Organization flag): 개발자가 config/organizations_release.yml에 선언하고 Organizations::Release.enabled?로 확인하는 항목입니다. 하나의 기능을 게이트하며 하나의 스테이지에 위치합니다.
  • 스테이지(Stage): Experimental이나 GA 같은 릴리스 프로세스의 한 단계입니다.
  • 스테이지 플래그(Stage flag): 스테이지마다 하나씩 있는 공유 org_stage_* 기능 플래그 중 하나입니다. 한 스테이지의 모든 조직 플래그는 해당 스테이지의 스테이지 플래그로 게이트됩니다.

조직 릴리스 프로세스

GitLab v19.6
원문 보기

요약

조직 기능은 조직 플래그(organization flag) 뒤에 게이트한 다음, 그 플래그를 고정된 공유 스테이지(stage) 사다리를 따라 올리는 방식으로 출시합니다. 이 모델은 기능의 대상 사용자가 넓어지기만 한다는 한 가지 원칙에 바탕을 둡니다.

조직 기능은 조직 플래그(organization flag) 뒤에 게이트한 다음, 그 플래그를 고정된 공유 스테이지(stage) 사다리를 따라 올리는 방식으로 출시합니다. 스테이지는 Experimental, Internal, Beta, Limited Availability(LA), GA입니다.

이 모델은 기능의 대상 사용자가 넓어지기만 한다는 한 가지 원칙에 바탕을 둡니다. 대상 사용자는 두 축을 따라 넓어집니다. 세그먼트는 기능에 접근할 수 있는 사용자로, Organizations 팀에서 GitLab 팀 멤버, 참여를 선택한 고객, 점차 늘어나는 고객 비율, 전체 사용자 순으로 확장됩니다. 플랫폼은 기능이 실행되는 위치로, GitLab.com에서 시작해 GA 시점에는 GitLab Self-Managed와 GitLab Dedicated까지 확장됩니다. 각 스테이지는 이렇게 넓어지는 면 위의 한 지점입니다. 더 높은 스테이지는 두 축 중 하나 또는 양쪽 모두에서 대상 사용자를 넓히며, 결코 좁히지 않습니다.

바꾸는 것은 스테이지 하나뿐입니다. 스테이지는 스테이지마다 하나씩, 이미 해당 스테이지의 대상 사용자와 롤아웃이 구성된 소수의 고정된 공유 스테이지 플래그(stage flag)(org_stage_*)가 뒷받침합니다. 플래그를 새로 만들거나 그 액터 또는 백분율을 조정하지 않습니다. 기능을 진전시키려면 머지 리퀘스트에서 조직 플래그의 스테이지를 올리며, 그러면 그 스테이지의 롤아웃을 그대로 물려받습니다. 이것이 각 기능이 자기 기능 플래그를 소유하고 자기 롤아웃을 직접 구동하는 일반적인 GitLab 기능 플래그 워크플로와 이 프로세스가 달라지는 핵심 지점입니다.

핸드북에는 스테이지, 대상 사용자, 대상 플랫폼, 롤아웃 규칙 같은 세부 사항이 있습니다. Organizations 릴리스 스테이지를 참조합니다. 해당 페이지는 제품과 디자인을 포함해 Organizations를 작업하는 모든 사람을 위해 작성된 정본(source of truth)입니다. 이 페이지는 엔지니어링 가이드입니다.

아직 모든 기능이 이 프로세스를 따르는 것은 아닙니다. 기능 하나, 즉 조직 생성에 대한 감사 결과는 조직이 생성되는 방식을 참조합니다. 조직 생성 경로 중 일부는 현재 릴리스 레이어를 사용하지 않습니다.

기능을 출시하는 단계는 네 가지입니다.

  1. 릴리스 레이어로 기능을 게이트합니다.
  2. 시작 스테이지에서 조직 플래그를 등록합니다.
  3. 릴리스 스펙 헬퍼로 기능을 테스트합니다.
  4. Stable에 도달할 때까지 스테이지를 따라 진전시킵니다.

기능 게이트하기#

기능 코드와 기능 플래그 라이브러리 사이에 있는 릴리스 레이어 Organizations::Release로 기능을 감쌉니다. 기능 플래그를 직접 확인하지 말고 조직 플래그가 활성화되어 있는지 이 레이어에 확인합니다.

return unless Organizations::Release.enabled?(:ui_for_organizations, actor)

이 레이어는 조직 플래그의 스테이지를 조회하고 해당 스테이지의 공유 스테이지 플래그에 대해 액터를 확인합니다. 앞선 스테이지의 캐스케이드 스테이지 플래그도 확인하므로 결과는 앞선 스테이지에서 나올 수 있습니다. 앞선 스테이지는 앞으로 캐스케이드됩니다를 참조합니다. 액터는 스테이지 플래그가 롤아웃되는 대상으로, 현재 사용자나 조직 같은 것입니다. 스테이지 플래그의 인스턴스 전체 게이트를 확인하려면 nil을 전달합니다.

이 레이어는 직접적인 Feature.enabled? 확인과 마찬가지로 액터를 기능 플래그 라이브러리로 그대로 전달합니다. 공유 스테이지 플래그는 백분율 롤아웃에서 액터 유형별로 버킷을 나누므로, 조직 플래그의 모든 호출 위치에서 일관된 액터 유형을 전달합니다. 스테이지 플래그를 운영하는 방식을 참조합니다.

앞선 스테이지는 앞으로 캐스케이드됩니다#

한 스테이지에서 기능을 볼 수 있는 액터는 기능이 이후 스테이지로 진전되어도 그 접근 권한을 유지합니다. 대상 사용자는 넓어지기만 하므로 앞선 스테이지의 더 작은 대상 사용자는 결코 빠지지 않습니다. 따라서 Beta 스테이지의 기능은 Beta 대상 사용자뿐 아니라 Experimental 대상 사용자에게도 활성화됩니다.

Organizations::Release.enabled?는 이를 반영합니다. 이 메서드는 플래그 자체의 스테이지 플래그와 앞선 모든 캐스케이드 스테이지 플래그를 확인합니다. Experimental, Internal, Beta는 캐스케이드됩니다. LA 스테이지는 독립적인 백분율 버킷으로 롤아웃되며 중첩되지 않고, GA는 이미 모든 사용자에게 켜져 있습니다.

프론트엔드에 플래그 노출#

프론트엔드 코드를 게이트하려면 push_frontend_feature_flag로 기능 플래그를 푸시하는 방식과 마찬가지로 컨트롤러에서 조직 플래그를 푸시합니다.

push_frontend_organization_release(:ui_for_organizations, actor)

이 헬퍼는 레이어를 통해 조직 플래그를 해석하고 그 결과를 조직 플래그 자체의 이름으로 푸시합니다. 프론트엔드 코드는 gon.features.uiForOrganizations를 읽으며 뒷받침하는 스테이지 플래그와 분리된 상태로 유지됩니다. 기능을 다른 스테이지로 진전시켜도 프론트엔드를 변경할 필요가 없습니다.

조직 플래그 등록하기#

config/organizations_release.yml에 조직 플래그를 선언합니다.

flags:
  - name: ui_for_organizations
    description: Browse and manage an organization through its dedicated UI.
    stage: experimental
  • name: Organizations::Release.enabled?에 전달하는 식별자.
  • stage: 기능이 시작하는 스테이지로, 보통 experimental입니다. experimental, internal, beta, la_25, la_50, la_75, la_100, ga 중 하나입니다.

기능 테스트하기#

모든 스펙에서 사용할 수 있는 stub_organization_release로 스펙에서 조직 플래그를 고정합니다.

stub_organization_release(ui_for_organizations: true)
stub_organization_release(ui_for_organizations: false)

한 번의 호출로 여러 플래그를 전달할 수 있으며, 반복 호출은 누적됩니다.

이 헬퍼는 stub_feature_flags가 일반 플래그를 스텁하는 것과 같은 방식으로 각 조직 플래그에 대해 Organizations::Release.enabled?를 스텁합니다. 공유 org_stage_* 스테이지 플래그는 건드리지 않습니다. 이렇게 하면 기능의 스테이지나 같은 스테이지의 다른 기능과 무관하게 하나의 기능을 고정할 수 있으며, 기능이 다른 스테이지로 진전되어도 스펙이 계속 동작합니다.

스텁하지 않은 플래그는 실제 enabled?를 사용합니다. 일반 기능 플래그와 마찬가지로 스테이지 플래그는 테스트에서 기본적으로 활성화되어 있으므로, 비활성화하지 않으면 게이트된 코드가 실행됩니다. 일반적인 용도는 비활성화된 경우를 고정하는 것입니다.

알 수 없는 플래그 이름은 잘못 입력한 기능 플래그와 마찬가지로 오류를 발생시킵니다.

스테이지 해석과 캐스케이드는 org_stage_* 플래그를 직접 구동하는 spec/lib/organizations/release_spec.rb에서 테스트합니다.

스테이지를 따라 진전시키기#

stage를 한 단계씩 올려 기능을 진전시킵니다. 변경할 때마다 머지 리퀘스트를 만듭니다.

Mermaid 다이어그램 (2줄)
소스 코드 보기
flowchart LR
    Add["Register flag<br>stage: experimental"] --> internal --> beta --> la_25 --> la_50 --> la_75 --> la_100 --> ga --> Stable["Stable<br>remove the flag"]

모든 스테이지가 필수는 아닙니다. 경로는 핸드북이 정의합니다. 요약하면 다음과 같습니다.

스테이지 필수 여부 참고
Experimental 선택 사항 적절한 경우 건너뜁니다. 조직 플래그는 Internal이나 Beta에서 시작할 수 있습니다.
Internal 선택 사항 적절한 경우 건너뜁니다. 조직 플래그는 Experimental에서 바로 Beta로 갈 수 있습니다.
Beta 필수 건너뛰지 않습니다.
LA 25, 50, 75 선택 사항 중간 단계는 건너뛸 수 있습니다.
LA 100 GA 이전에 필수 조직 플래그는 GA 이전에 LA 100에 도달합니다.
GA 선택 사항 GitLab Self-Managed와 GitLab Dedicated의 릴리스 지점입니다. 사소한 변경은 바로 Stable로 정착할 수 있습니다.
Stable 종결 모든 조직 플래그는 여기서 끝나며, 기능은 더 이상 게이트되지 않습니다.

기능을 롤백하려면 같은 방식으로 조직 플래그의 stage를 낮춥니다.

GA에 도달하려면 org_stage_ga를 default_enabled: true로 배포해야 합니다. 이 스테이지 플래그가 기능을 GitLab Self-Managed와 GitLab Dedicated로 전달합니다.

Stable에 도달한다는 것은 시스템을 완전히 벗어난다는 뜻입니다. 조직 플래그의 config/organizations_release.yml 항목을 제거하고, Organizations::Release.enabled? 호출 위치를 조건 없는 동작으로 대체합니다. 공유 스테이지 플래그는 그 스테이지에 있는 다른 조직 플래그를 위해 그대로 남습니다. Stable은 설정하는 stage 값이 아닙니다.

위험도가 높은 기능은 공유 스테이지 플래그를 전혀 사용하지 않고 자체 기능 플래그를 사용할 수 있습니다.

스테이지 플래그를 운영하는 방식#

보통은 이 부분을 다룰 일이 없습니다. 기능을 진전시키는 일은 stage 변경입니다(스테이지를 따라 진전시키기 참조). 이 섹션은 공유 스테이지 플래그가 어떻게 설정되고 유지되는지에 대한 내용입니다.

각 스테이지는 lib/organizations/release/stage.rb에 정의된 공유 ops 스테이지 플래그 하나에 대응합니다.

스테이지 스테이지 플래그
Experimental org_stage_experimental
Internal org_stage_internal
Beta org_stage_beta
LA 25 to 100 org_stage_la_25 to org_stage_la_100
GA org_stage_ga (default_enabled: true)

여기의 ChatOps 명령은 개별 조직 플래그가 아니라 이 공유 스테이지 플래그를 구성합니다. 스테이지 플래그의 구성은 해당 스테이지의 모든 조직 플래그에 동일합니다. 스테이지 플래그는 공유되므로, 그 스테이지의 모든 조직 플래그가 게이트를 공유하며 액터는 어느 게이트든 하나에 부합하면 기능을 보게 됩니다. Flipper는 스테이지 플래그의 게이트를 논리 OR로 결합하므로, 스테이지 플래그 하나가 여러 대상 사용자를 동시에 지원할 수 있습니다.

Experimental, Internal, Beta 스테이지 플래그는 특정 액터나 기능 그룹을 활성화합니다.

/chatops run feature set --group=gitlab-org/organizations org_stage_experimental true
/chatops run feature set --feature-group=gitlab_team_members org_stage_internal true
/chatops run feature set --group=a-customer-group org_stage_beta true

Internal은 gitlab_team_members 기능 그룹에 활성화되고, Beta는 고객 그룹을 대상으로 합니다.

액터는 다형(polymorphic)입니다. 특정 액터 게이트는 GitLab이 기능 플래그 액터로 지원하는 모든 유형(Feature::SUPPORTED_MODELS), 즉 조직, 사용자, 그룹 등을 받습니다. 특정 조직이나 특정 사용자처럼 기능을 받아야 하는 액터에 대해 스테이지 플래그를 활성화합니다. 액터 유형은 기능이 호출 위치에서 확인하는 유형과 일치해야 하며, 그렇지 않으면 게이트에 해당되지 않습니다.

LA 스테이지 플래그는 액터의 백분율을 사용하며, 각 스테이지 플래그 이름에 있는 백분율로 설정합니다.

/chatops run feature set org_stage_la_25 25 --actors
/chatops run feature set org_stage_la_50 50 --actors

시간의 백분율이 아니라 액터의 백분율을 사용합니다. 액터의 백분율은 특정 액터를 롤아웃 안이나 밖에 일관되게 유지하지만, 시간의 백분율은 확인할 때마다 다시 추첨합니다.

공유 스테이지 플래그에는 두 가지 결과가 따릅니다.

  • 액터의 백분율에는 확인 시점에 액터가 필요합니다. nil을 전달하는 확인은 불리언 게이트나 특정 액터 게이트에만 일치하고 백분율 게이트에는 일치하지 않습니다.
  • 액터의 백분율은 액터를 유형별로 버킷에 나눕니다. 같은 스테이지의 조직 플래그 두 개를 한 요청에서 서로 다른 액터 유형으로 확인하면, 롤아웃이 하나는 포함하고 다른 하나는 제외할 수 있으므로 주어진 조직 플래그에는 일관된 액터 유형을 전달합니다.

GA 스테이지 플래그는 default_enabled: true로 출시되는 유일한 플래그입니다. 이 플래그는 핸드브레이크를 유지한 채 모든 배포에 도달합니다. 핸드브레이크는 GitLab.com과 GitLab Self-Managed에서 동작하지만, 기능 플래그를 수정할 수 없는 GitLab Dedicated에서는 효과가 없습니다.

릴리스 상태 표#

doc/development/organizations/release_status.md는 레지스트리에서 생성되며 직접 편집하지 않습니다. 스테이지를 변경한 뒤에는 다시 생성합니다.

bin/rake gitlab:organizations:release:docs

이 표에는 Experimental부터 GA까지 현재 롤아웃 프로세스에 있는 조직 플래그가 표시됩니다. Stable에 도달한 조직 플래그는 스테이지 플래그 시스템을 벗어나 표에서 제외됩니다.

용어#

  • 기능(Feature): Organizations 팀이 출시하는 제품 기능으로, 릴리스 프로세스에 있는 동안 게이트됩니다.
  • 조직 플래그(Organization flag): 개발자가 config/organizations_release.yml에 선언하고 Organizations::Release.enabled?로 확인하는 항목입니다. 하나의 기능을 게이트하며 하나의 스테이지에 위치합니다.
  • 스테이지(Stage): Experimental이나 GA 같은 릴리스 프로세스의 한 단계입니다.
  • 스테이지 플래그(Stage flag): 스테이지마다 하나씩 있는 공유 org_stage_* 기능 플래그 중 하나입니다. 한 스테이지의 모든 조직 플래그는 해당 스테이지의 스테이지 플래그로 게이트됩니다.