GitLab 에이전트 구성

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

작업 공간을 설정할 때 GitLab 에이전트를 원격 개발용으로 구성해야 합니다. 원격 개발 설정은 remote_development 아래의 에이전트 구성 파일에서 사용할 수 있습니다.

원격 개발 설정

설정 필수여부 기본값 설명
enabled 예 false GitLab 에이전트의 원격 개발 기능이 활성화되었는지 여부를 나타냅니다.
dns_zone 예 없음 작업 공간이 있는 DNS 영역입니다.
gitlab_workspaces_proxy 아니오 gitlab-workspaces gitlab-workspaces-proxy가 설치된 네임스페이스입니다.
network_policy 아니오 network_policy에서 확인 작업 공간의 방화벽 규칙입니다.
default_resources_per_workspace_container 아니오 {} 작업 공간 컨테이너 당 CPU 및 메모리의 기본 요청 및 제한입니다.
max_resources_per_workspace 아니오 {} 작업 공간 당 CPU 및 메모리의 최대 요청과 제한입니다.
workspaces_quota 아니오 -1 GitLab 에이전트 당 최대 작업 공간 수입니다.
workspaces_per_user_quota 아니오 -1 사용자 당 최대 작업 공간 수입니다.
note
설정에 잘못된 값이 있으면 해당 값을 수정할 때까지 어떠한 설정도 업데이트할 수 없습니다.

enabled

이 설정을 사용하여 다음을 정의합니다:

  • GitLab 에이전트가 GitLab 인스턴스와 통신할 수 있는지 여부
  • GitLab 에이전트로 작업 공간을 생성할 수 있는지 여부

기본값은 false입니다.

에이전트 구성에서 원격 개발을 활성화하려면 enabled를 true로 설정하세요: 

remote_development:
  enabled: true

원격 개발이 비활성화된 경우, 관리자는 Kubernetes 클러스터에서 실행 중인 모든 작업 공간을 매뉴얼으로 삭제해야 합니다.

dns_zone

이 설정을 사용하여 작업 공간이 있는 URL의 DNS 영역을 정의합니다.

구성 예: 

remote_development:
  dns_zone: "<workspaces.example.dev>"

gitlab_workspaces_proxy

이 설정을 사용하여 gitlab-workspaces-proxy가 설치된 네임스페이스를 정의합니다. gitlab_workspaces_proxy.namespace의 기본값은 gitlab-workspaces입니다.

구성 예: 

remote_development:
  gitlab_workspaces_proxy:
    namespace: "<custom-gitlab-workspaces-proxy-namespace>"

network_policy

이 설정을 사용하여 각 작업 공간의 네트워크 정책을 정의합니다. 이 설정은 작업 공간의 네트워크 트래픽을 제어합니다.

기본값은 다음과 같습니다: 

remote_development:
  network_policy:
    enabled: true
    egress:
      - allow: "0.0.0.0/0"
        except:
          - "10.0.0.0/8"
          - "172.16.0.0/12"
          - "192.168.0.0/16"

이 구성에서:

  • enabled가 true이므로 각 작업 공간에 대한 네트워크 정책이 생성됩니다.
  • egress 규칙은 인터넷(0.0.0.0/0)으로부터의 모든 트래픽을 허용하되, 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16과 같은 IP CIDR 범위로의 트래픽은 제외됩니다.

네트워크 정책의 동작은 Kubernetes 네트워크 플러그인에 따라 다릅니다. 자세한 내용은 Kubernetes 문서를 참조하세요.

network_policy.enabled

이 설정을 사용하여 각 작업 공간의 네트워크 정책이 생성되는지 여부를 정의합니다. 기본값은 true입니다.

network_policy.egress

이 설정을 사용하여 작업 공간에서의 대상 IP CIDR 범위 디렉터리을 정의하여 트래픽을 허용합니다.

다음과 같은 경우에 egress 규칙을 정의합니다:

  • GitLab 인스턴스가 사설 IP 범위에 있는 경우
  • 작업 공간이 사설 IP 범위상의 클라우드 리소스에 액세스해야 하는 경우

구성 예: 

remote_development:
  network_policy:
    egress:
      - allow: "0.0.0.0/0"
        except:
          - "10.0.0.0/8"
          - "172.16.0.0/12"
          - "192.168.0.0/16"
      - allow: "172.16.123.1/32"

이 구성에서 작업 공간에서 트래픽이 허용될 경우:

  • 대상 IP가 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16이 아닌 범위인 경우
  • 대상 IP가 172.16.123.1/32인 경우

default_resources_per_workspace_container

이 설정을 사용하여 작업 공간 컨테이너 당 CPU 및 메모리의 기본 요청 및 제한을 정의합니다. (devfile)[index.md#devfile]에서 정의한 모든 리소스는 이 설정을 덮어씁니다.

default_resources_per_workspace_container에는 requests 및 limits가 필요합니다. 가능한 CPU 및 메모리 값에 대한 자세한 내용은 Kubernetes의 Resource units를 참조하세요.

이 값 중 하나라도 변경하면 기존 작업 공간은 즉시 다시 시작되어 변경 사항이 적용됩니다.

구성 예: 

remote_development:
  default_resources_per_workspace_container:
    requests:
      cpu: "0.5"
      memory: "512Mi"
    limits:
      cpu: "1"
      memory: "1Gi"

max_resources_per_workspace

이 설정을 사용하여 작업 공간 당 CPU 및 메모리의 최대 요청 및 제한을 정의합니다.

max_resources_per_workspace에는 requests 및 limits가 필요합니다. 가능한 CPU 및 메모리 값에 대한 자세한 내용은 다음을 참조하세요:

이 값 중 하나라도 변경하면 기존 작업 공간은 즉시 다시 시작되어 변경 사항이 적용됩니다. requests 및 limits에 설정한 값보다 많은 리소스를 요청 및 제한하는 경우 작업 공간이 실패합니다.

구성 예: 

remote_development:
  max_resources_per_workspace:
    requests:
      cpu: "1"
      memory: "1Gi"
    limits:
      cpu: "2"
      memory: "2Gi"

정의하는 최대 리소스는 부팅 작업(프로젝트 리포지터리 복제 등의 초기화 작업)에 필요한 리소스도 포함해야 합니다.

workspaces_quota

- 도입됨 GitLab 16.9에서.

이 설정을 사용하여 GitLab 에이전트의 최대 작업 공간 수를 설정합니다.

에이전트의 작업 공간 수가 정의된 workspaces_quota에 도달한 경우, 새 작업 공간을 생성할 수 없습니다. workspaces_quota가 0으로 설정된 경우도 새 작업 공간을 생성할 수 없습니다.

이 설정은 에이전트의 기존 작업 공간에는 영향을 미치지 않습니다.

기본 값은 -1 (무제한)입니다. 가능한 값은 -1 이상입니다.

예시 구성: 

remote_development:
  workspaces_quota: 10

workspaces_per_user_quota

- 도입됨 GitLab 16.9에서.

이 설정은 사용자당 최대 작업 공간 수를 설정하는 데 사용됩니다.

사용자의 작업 공간 수가 정의된 workspaces_per_user_quota에 도달한 경우, 해당 사용자에 대해 새 작업 공간을 생성할 수 없습니다. workspaces_per_user_quota가 0으로 설정된 경우도 새 작업 공간을 생성할 수 없습니다.

이 설정은 사용자의 기존 작업 공간에는 영향을 미치지 않습니다.

기본 값은 -1 (무제한)입니다. 가능한 값은 -1 이상입니다.

예시 구성: 

remote_development:
  workspaces_per_user_quota: 3

원격 개발로 사용자 액세스 구성하기

user_access 모듈을 구성하여 GitLab 자격 증명으로 연결된 Kubernetes 클러스터에 액세스할 수 있습니다. 이 모듈은 remote_development 모듈과 독립적으로 구성되고 실행됩니다.

같은 GitLab 에이전트에 user_access와 remote_development를 구성할 때 주의하세요. remote_development 클러스터는 사용자 자격 증명(예: 개인 액세스 토큰)을 쿠버네티스 비밀로 관리합니다. user_access의 잘못된 구성은 쿠버네티스 API를 통해 이러한 개인 데이터에 액세스할 수 있게 할 수 있습니다.

user_access를 구성하는 자세한 정보는 Kubernetes 액세스 구성을 참조하십시오.