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

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

이 가이드는 특정 프로젝트의 브랜치 규칙을 쿼리하기 위해 GraphiQL explorer를 사용하는 방법을 보여줍니다.

예제 쿼리는 GitLab 인스턴스에서 전체 경로(예: gitlab-org/gitlab-docs)를 기준으로 프로젝트를 찾습니다.

쿼리에서는 프로젝트의 모든 구성된 브랜치 규칙을 요청합니다.

note
HTTP 엔드포인트를 사용하여 cURL로 동일한 쿼리를 직접 실행할 수 있습니다. 더 많은 정보는 명령줄에서 시작하는 가이드를 참조하세요.

GraphiQL explorer 설정

이 절차는 복사하여 자신의 GraphiQL explorer 인스턴스에 붙여넣을 수 있는 실질적인 예제를 제공합니다:

  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 explorer 도구를 엽니다.
  3. 위에 나열된 query를 GraphiQL explorer 도구의 왼쪽 창에 붙여넣습니다.
  4. 결과를 얻기 위해 Play를 선택합니다:

    브랜치 규칙에 대한 GraphiQL explorer 쿼리

브랜치 규칙이 표시되지 않는 경우는 다음과 같을 수 있습니다:

  • 구성된 브랜치 규칙이 없습니다.
  • 귀하의 역할에 브랜치 규칙을 볼 수 있는 권한이 없습니다. 관리자는 모든 기록에 접근할 수 있습니다.

GDK에서 쿼리 실행

접근 요청 대신 GitLab Development Kit (GDK)에서 쿼리를 실행하는 것이 더 쉬울 수 있습니다.

  1. GDK 문서에서 제공된 인증 정보로 기본 관리자 root로 로그인합니다.
  2. flightjs/Flight 프로젝트에 대해 일부 브랜치 규칙이 구성되어 있는지 확인합니다.
  3. 쿼리에서 전체 경로를 교체합니다:

    query {
      project(fullPath: "flightjs/Flight") {
    
  4. GDK 인스턴스에서 GraphiQL explorer 도구 방문: http://gdk.test:3000/-/graphql-explorer.
  5. 위에 나열된 query를 GraphiQL explorer 도구의 왼쪽 창에 붙여넣습니다.
  6. 결과를 보기 위해 Play를 선택합니다.

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