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

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

이 안내서는 주어진 프로젝트에서 브랜치 규칙을 쿼리하는 방법을 보여줍니다.

GraphiQL 탐색기를 설정하는 방법을 보여주는 예제 쿼리는 GitLab 인스턴스에 있는 프로젝트를 찾습니다. 예를 들어 gitlab-org/gitlab-docs와 같은 전체 경로로 프로젝트를 요청합니다. 쿼리에서는 프로젝트의 모든 구성된 브랜치 규칙을 요청합니다.

참고: 같은 쿼리를 직접 HTTP 엔드포인트에 cURL을 사용하여 실행할 수 있습니다. 자세한 내용은 command line의 안내를 참조하십시오.

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 개발 키트 (GDK)에서 쿼리를 실행하는 것이 더 쉬울 수 있습니다.

  1. GDK 문서에서 루트 사용자 root의 기본 자격 증명으로 로그인합니다.
  2. flightjs/Flight 프로젝트에 일부 브랜치 규칙이 구성되어 있는지 확인합니다.
  3. 쿼리에서 전체 경로를 대체합니다.

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

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