프로젝트의 브랜치 규칙 목록

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

이 가이드에서는 GraphiQL 탐색기를 사용하여 주어진 프로젝트의 브랜치 규칙을 쿼리하는 방법을 보여줍니다.

예시 쿼리는 예를 들어 gitlab-org/gitlab-docs와 같은 전체 경로로 GitLab 인스턴스에서 프로젝트를 찾습니다. 이 쿼리에서는 프로젝트의 모든 구성된 브랜치 규칙을 요청합니다.

note
동일한 쿼리를 cURL을 사용하여 HTTP 엔드포인트를 통해 직접 실행할 수 있습니다. 자세한 정보는 커맨드 라인 시작 안내를 확인하세요.

GraphiQL 탐색기 설정

이 절차는 GraphiQL 탐색기의 자체 인스턴스에 복사하여 붙여넣을 수 있는 구체적인 예제를 제공합니다:

  1. 다음 코드 일부를 복사하세요.

     query {
     project(fullPath: "gitlab-org/gitlab-docs") {
         branchRules {
             nodes {
             name
             isDefault
             isProtected
             matchingBranchesCount
             createdAt
             updatedAt
             branchProtection {
                 allowForcePush
                 codeOwnerApprovalRequired
                 mergeAccessLevels {
                     nodes {
                     accessLevel
                     accessLevelDescription
                     user {
                         name
                     }
                     group {
                         name
                     }
                     }
                 }
                 pushAccessLevels {
                     nodes {
                     accessLevel
                     accessLevelDescription
                     user {
                         name
                     }
                     group {
                         name
                     }
                     }
                 }
                 unprotectAccessLevels {
                     nodes {
                     accessLevel
                     accessLevelDescription
                     user {
                         name
                     }
                     group {
                         name
                     }
                     }
                 }
             }
             externalStatusChecks {
                 nodes {
                     id
                     name
                     externalUrl
                 }
             }
             approvalRules {
                 nodes {
                     id
                     name
                     type
                     approvalsRequired
                     eligibleApprovers {
                         nodes {
                         name
                         }
                     }
                 }
             }
             }
         }
     }
     }
    
  2. GraphiQL 탐색기 도구를 엽니다.
  3. 위에 나열된 query를 GraphiQL 탐색기 도구의 왼쪽 창에 붙여넣으세요.
  4. 실행을 선택하여 이 결과를 얻으세요.

    브랜치 규칙을 위한 GraphiQL 탐색기 쿼리

만약 브랜치 규칙이 표시되지 않는다면, 이는 다음과 같은 이유일 수 있습니다:

  • 브랜치 규칙이 구성되지 않았을 수 있습니다.
  • 귀하의 역할에게 브랜치 규칙을 볼 수 있는 권한이 없을 수 있습니다. 관리자는 모든 레코드에 액세스할 수 있습니다.

GDK에서 쿼리 실행

액세스 요청을 대신하여, GitLab Development Kit (GDK)에서 쿼리를 실행하는 것이 더 쉬울 수 있습니다.

  1. 기본 관리자인 rootGDK 설명서에서 자격 증명을 사용하여 로그인하세요.
  2. flightjs/Flight 프로젝트에 일부 브랜치 규칙이 구성되어 있는지 확인하세요.
  3. 쿼리에서 전체 경로를 대체하세요.

     query {
     project(fullPath: "flightjs/Flight") {
    
  4. GDK 인스턴스에서 GraphiQL 탐색기 도구를 방문하세요: http://gdk.test:3000/-/graphql-explorer.
  5. 위에 나열된 query를 GraphiQL 탐색기 도구의 왼쪽 창에 붙여넣으세요.
  6. 결과를 보려면 실행을 선택하세요.

각 필드에 대한 자세한 정보는 GraphQL API 리소스를 참조하세요.