조직 개발 가이드

GitLab 조직(Organization) 개발 지침으로, 현재 단계의 목표, 데이터베이스 설계, Current.organization 사용법, 라우팅, 격리 테스트, 프론트엔드 가이드라인을 설명합니다.

Organization 이니셔티브 는 GitLab.com과 GitLab Self-Managed 사이의 기능 동등성 확보에 초점을 둡니다. 기능 팀을 위한 지침 # 이 섹션에서는 조직 수준에서 기능을 만들기 전에 고려할 사항을 설명합니다. Organizations를 Beta 로 출시하는 목표 마일스톤은 19.4(2026-09-11)입니다. 이전에는 GitLab Self-Managed의 인스턴스 수준에서 구현한 기능을 GitLab.com의 최상위 그룹용으로 다시 구현해야 했습니다. Organizations는 이 중복을 없앱니다. 이제 기본 방침은 양쪽을 모두 아우르는 조직 수준에서 기능을 만드는 것입니다. 예를 들어 Artifact Registry는 조직을 기준점 으로 사용합니다. 모든 기능에 조직 수준 범위가 필요한 것은 아니며, Organizations가 아직 Beta로 출시되지 않았으므로 알아 두어야 할 주요 고려 사항이 있습니다. 자세한 내용은 다음 섹션에서 확인할 수 있습니다. 기능을 만들기 전에 Slack( #g_organizations )으로 팀에 연락해 사용 사례를 논의합니다. 기능에 조직 수준 범위가 필요한지 판단 # 모든 기능이 조직 수준에 속하지는 않습니다. 대부분의 기능은 그룹, 프로젝트, 사용자 수준에 계속 묶여 있어야 합니다. 이는 대부분의 기능이 인스턴스나 TLG 수준을 대상으로 하지 않던 기존 방식과 같습니다. 조직 안의 여러 그룹에 걸치는 기능은 그룹 수준으로 범위를 두되 그룹 간 이동을 제공해야 합니다. 이것만으로는 조직 수준 버전을 새로 만들 근거가 되지 않습니다. 조직 수준의 거버넌스나 설정이 분명히 필요한 경우에만 조직 수준에서 기능을 만듭니다. 자세한 내용은 Organizations Charter ( https://docs.google.com/document/d/1ldPftCifCDkdw3_3JKOnFjdwNHGIgbHIbW8HEc92i1Y/edit , 내부 접근 권한 필요) 를 참고합니다. 조직 수준 기능에 맞는 역할 설계 # 조직 수준 역할은 그룹 및 프로젝트 역할과 별개입니다. 기능을 설계할 때는 다음을 따릅니다. 각 조직 역할(Owner, User)이 수행할 수 있는 동작을 정의합니다. 그룹 수준 역할이 조직 수준 역할에 그대로 대응한다고 가정하지 않습니다. 기능에 새 조직 수준 권한이 필요한지, 아니면 기존 역할로 충분한지 검토합니다. 자세한 내용은 조직 사용자 문서 를 참고합니다. 최상위 그룹을 자체 조직으로 이전하도록 요구(GitLab.com) # 조직 컨텍스트에 의존하는 기능은 TLG가 자체 조직 안에 있어야 합니다. 현재 GitLab.com의 기본 조직에는 TLG 소유자가 Organization Owner가 아닌 TLG가 포함돼 있기 때문입니다. 이를 organization.default? 같은 검사로 강제하지 않습니다. GitLab Self-Managed와 GitLab Dedicated는 정상적으로 기본 조직 안에서 동작하므로, 그런 검사는 이들까지 막게 됩니다. 대신 조직 수준 기능