프로젝트의 브랜치 규칙 디렉터리

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

이 안내서는 GraphiQL 탐색기를 사용하여 특정 프로젝트의 브랜치 규칙을 쿼리하는 방법을 보여줍니다.

예시 쿼리는 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. 위의 쿼리를 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. 위의 쿼리를 GraphiQL 탐색기 도구의 왼쪽 창에 붙여넣습니다.
  6. 결과를 보려면 실행을 선택합니다.

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