InfoGrab DocsInfoGrab Docs

에이전트 구성 파일 구문

요약

agent-config.yml 파일은 프로젝트의 CI/CD에서 플로우가 실행되는 방식을 구성합니다. 사용 방법에 대한 자세한 내용은 플로우 실행 구성을 참조하세요. 구성 파일은 프로젝트의 기본 브랜치에서만 읽힙니다. 다음 예시는 사용 가능한 모든 구성 옵션을 사용합니다:

agent-config.yml 파일은 프로젝트의 CI/CD에서 플로우가 실행되는 방식을 구성합니다. 이 파일은 프로젝트 리포지터리의 .gitlab/duo/agent-config.yml 경로에 배치합니다.

사용 방법에 대한 자세한 내용은 플로우 실행 구성을 참조하세요.

Note

구성 파일은 프로젝트의 기본 브랜치에서만 읽힙니다. 다른 브랜치에 커밋된 파일은 해당 브랜치에서 플로우가 실행되더라도 무시됩니다.

지원되는 키#

키 유형 설명
image 문자열 플로우 실행에 사용할 Docker 이미지. 최소 1자, 최대 512자.
setup_script 문자열 또는 문자열 배열 플로우가 시작되기 전에 실행할 셸 명령.
network_policy 객체 실행 환경에 대한 네트워크 액세스 규칙. 자세한 내용은 네트워크 정책 구성을 참조하세요.
network_policy.allowed_domains 문자열 배열 플로우가 액세스할 수 있는 도메인. 최대 1000개 항목.
network_policy.denied_domains 문자열 배열 플로우가 액세스할 수 없는 도메인. 최대 1000개 항목.
network_policy.include_recommended_allowed 불리언 GitLab이 권장하는 허용 도메인을 포함합니다. 기본값: false.
network_policy.allow_all_unix_sockets 불리언 모든 Unix 소켓 연결을 허용합니다. 기본값: false.
cache 객체 플로우 실행 간에 보존할 파일 및 디렉터리. 자세한 내용은 캐싱 구성을 참조하세요.
cache.paths 문자열 또는 문자열 배열 캐시할 경로. 캐싱이 적용되려면 필수입니다.
cache.key 문자열 또는 객체 캐시 키. 생략하면 기본 키가 사용됩니다.
cache.key.files 문자열 배열 SHA 기반 캐시 키를 생성하는 데 사용되는 파일. 최대 2개 파일.
cache.key.prefix 문자열 캐시 키를 구성하기 위해 파일 SHA와 결합되는 접두사. files가 필요합니다.

전체 예시#

다음 예시는 사용 가능한 모든 구성 옵션을 사용합니다:

# Custom Docker image
image: python:3.11

# Setup script to run before the flow
setup_script:
  - apt-get update && apt-get install -y build-essential
  - pip install --upgrade pip
  - pip install -r requirements.txt

# Cache configuration
cache:
  key:
    files:
      - requirements.txt
      - Pipfile.lock
    prefix: python-deps
  paths:
    - .cache/pip
    - venv/

# Network configuration
network_policy:
  include_recommended_allowed: true
  allow_all_unix_sockets: true
  allowed_domains:
    - my-own-site.com
  denied_domains:
    - malicious.com

에이전트 구성 파일 구문

GitLab v19.3
Tier: [Free](/19.3/subscriptions/gitlab_credits/#for-the-free-tier), Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
원문 보기

요약

agent-config.yml 파일은 프로젝트의 CI/CD에서 플로우가 실행되는 방식을 구성합니다. 사용 방법에 대한 자세한 내용은 플로우 실행 구성을 참조하세요. 구성 파일은 프로젝트의 기본 브랜치에서만 읽힙니다. 다음 예시는 사용 가능한 모든 구성 옵션을 사용합니다:

agent-config.yml 파일은 프로젝트의 CI/CD에서 플로우가 실행되는 방식을 구성합니다. 이 파일은 프로젝트 리포지터리의 .gitlab/duo/agent-config.yml 경로에 배치합니다.

사용 방법에 대한 자세한 내용은 플로우 실행 구성을 참조하세요.

Note

구성 파일은 프로젝트의 기본 브랜치에서만 읽힙니다. 다른 브랜치에 커밋된 파일은 해당 브랜치에서 플로우가 실행되더라도 무시됩니다.

지원되는 키#

키 유형 설명
image 문자열 플로우 실행에 사용할 Docker 이미지. 최소 1자, 최대 512자.
setup_script 문자열 또는 문자열 배열 플로우가 시작되기 전에 실행할 셸 명령.
network_policy 객체 실행 환경에 대한 네트워크 액세스 규칙. 자세한 내용은 네트워크 정책 구성을 참조하세요.
network_policy.allowed_domains 문자열 배열 플로우가 액세스할 수 있는 도메인. 최대 1000개 항목.
network_policy.denied_domains 문자열 배열 플로우가 액세스할 수 없는 도메인. 최대 1000개 항목.
network_policy.include_recommended_allowed 불리언 GitLab이 권장하는 허용 도메인을 포함합니다. 기본값: false.
network_policy.allow_all_unix_sockets 불리언 모든 Unix 소켓 연결을 허용합니다. 기본값: false.
cache 객체 플로우 실행 간에 보존할 파일 및 디렉터리. 자세한 내용은 캐싱 구성을 참조하세요.
cache.paths 문자열 또는 문자열 배열 캐시할 경로. 캐싱이 적용되려면 필수입니다.
cache.key 문자열 또는 객체 캐시 키. 생략하면 기본 키가 사용됩니다.
cache.key.files 문자열 배열 SHA 기반 캐시 키를 생성하는 데 사용되는 파일. 최대 2개 파일.
cache.key.prefix 문자열 캐시 키를 구성하기 위해 파일 SHA와 결합되는 접두사. files가 필요합니다.

전체 예시#

다음 예시는 사용 가능한 모든 구성 옵션을 사용합니다:

# Custom Docker image
image: python:3.11

# Setup script to run before the flow
setup_script:
  - apt-get update && apt-get install -y build-essential
  - pip install --upgrade pip
  - pip install -r requirements.txt

# Cache configuration
cache:
  key:
    files:
      - requirements.txt
      - Pipfile.lock
    prefix: python-deps
  paths:
    - .cache/pip
    - venv/

# Network configuration
network_policy:
  include_recommended_allowed: true
  allow_all_unix_sockets: true
  allowed_domains:
    - my-own-site.com
  denied_domains:
    - malicious.com