파운데이셔널 플로

요약

파운데이셔널 플로는 GitLab 이 만들고 유지 관리하며, GitLab 유지 관리 배지([tanuki-verified])가 표시됩니다. 각 플로는 특정 문제를 해결하거나 개발 작업을 지원하도록 설계되어 있습니다. 다음 파운데이셔널 플로를 사용할 수 있습니다.

Model information

LLM: Anthropic Claude Sonnet 4

파운데이셔널 플로는 GitLab 이 만들고 유지 관리하며, GitLab 유지 관리 배지([tanuki-verified])가 표시됩니다.

각 플로는 특정 문제를 해결하거나 개발 작업을 지원하도록 설계되어 있습니다.

다음 파운데이셔널 플로를 사용할 수 있습니다.

플로	설명
Agentic Breaking Change Resolution	의존성 버전 업 머지 리퀘스트에서 브레이킹 체인지를 자동으로 해결합니다.
Code Review	AI 네이티브 분석과 피드백으로 코드 리뷰를 자동화합니다.
Convert to GitLab CI/CD	Jenkins 파이프라인을 CI/CD로 마이그레이션합니다.
Developer	이슈에서 실행 가능한 머지 리퀘스트를 만들거나 GitLab Duo Agentic Chat에서 다양한 작업을 완료합니다.
Fix CI/CD Pipeline	실패한 job을 진단하고 수정합니다.
Recommend Reviewers	머지 리퀘스트를 검토하기에 가장 적합한 리뷰어를 추천합니다.
SAST False Positive Detection	SAST 결과에서 오탐을 자동으로 식별하고 필터링합니다.
SAST Vulnerability Resolution	SAST 취약점을 해결하기 위한 머지 리퀘스트를 자동으로 생성합니다.
Secret False Positive Detection	시크릿 탐지 결과에서 오탐을 자동으로 식별하고 필터링합니다.
Security Review	머지 리퀘스트 변경 사항에서 비즈니스 로직 보안 취약점을 감지합니다.
Software Development	소프트웨어 개발 생명주기 전반에 걸친 작업에 대한 AI 생성 솔루션을 만듭니다.

개발자용#

새 파운데이셔널 플로를 만들어 GitLab에 추가하는 방법은 파운데이셔널 플로 개발 가이드를 참고합니다.

플로 실행 CI/CD 세부 정보 구성#

플로가 CI/CD를 사용해 실행되는 환경을 구성할 수 있습니다.

예를 들어 GitLab Self-Managed에서는 관리자가 파운데이셔널 플로 이미지용 사용자 지정 컨테이너 레지스트리를 구성할 수 있습니다.

자세한 내용은 플로 실행 구성을 참고합니다.

파운데이셔널 플로의 보안#

GitLab UI에서 파운데이셔널 플로는 다음 GitLab API에 접근할 수 있습니다.

서비스 계정#

파운데이셔널 플로는 서비스 계정을 사용해 작업을 완료합니다. 자세한 내용은 복합 ID 워크플로를 참고합니다.

파운데이셔널 플로가 머지 리퀘스트를 생성하면 해당 머지 리퀘스트는 서비스 계정이 아니라 플로를 시작한 실제 사용자에게 귀속됩니다. 이는 직무 분리를 요구하는 컴플라이언스 프레임워크를 준수하기 위한 조치입니다. 머지 리퀘스트 컴플라이언스 고려 사항을 참고합니다.

파운데이셔널 플로 켜기 또는 끄기#

다음 범위에서 파운데이셔널 플로를 켜거나 끌 수 있습니다.

GitLab.com: 최상위 그룹과 프로젝트.
GitLab Self-Managed: 인스턴스, 그룹, 프로젝트.

또한 플로 실행을 켜거나 꺼서 컴퓨팅 분을 소비하는 기능이 GitLab UI에서 실행될 수 있는지 제어할 수 있습니다. 이러한 기능에는 외부 에이전트, 파운데이셔널 플로, 사용자 지정 플로가 포함됩니다.

이 설정은 GitLab에서 실행되는 플로, 예를 들어 이슈나 머지 리퀘스트에서 시작하는 플로를 제어합니다.

이 설정은 IDE 나 GitLab Duo CLI 세션에서 직접 실행하는 플로는 제어하지 않습니다. 해당 세션에서는 다음 조건을 만족하면 파운데이셔널 플로를 실행할 수 있습니다.

프로젝트 또는 그룹에서 GitLab Duo Agent Platform을 사용할 수 있습니다.
해당 플로가 구독 티어에서 제공됩니다. 베타 플로는 실험 및 베타 기능이 켜져 있어야 합니다.

예를 들어 파운데이셔널 플로를 끄면 GitLab에서는 해당 플로를 더 이상 실행할 수 없지만, 사용자는 IDE 나 GitLab Duo CLI 세션에서 계속 실행할 수 있습니다.

GitLab.com에서#

사전 요구 사항:

최상위 그룹의 Owner 권한.

상단 바에서 Search or go to를 선택하고 최상위 그룹을 찾습니다.
Settings > GitLab Duo를 선택합니다.
Change configuration을 선택합니다.
Flow execution 아래에서 Allow flow execution과 Allow foundational flows 체크박스를 선택합니다.
켜려는 각 파운데이셔널 플로의 체크박스를 선택합니다.
Save changes를 선택합니다.

최상위 그룹에서 파운데이셔널 플로를 끄면, 해당 그룹을 기본 GitLab Duo 네임스페이스로 사용하는 사용자는 어떤 네임스페이스에서도 파운데이셔널 플로에 접근할 수 없습니다.

사전 요구 사항:

프로젝트의 Maintainer 또는 Owner 권한.
최상위 그룹에서 플로 실행과 파운데이셔널 플로가 켜져 있어야 합니다.

상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
왼쪽 사이드바에서 Settings > General을 선택합니다.
GitLab Duo를 확장합니다.
GitLab Duo, Allow flow execution, Allow foundational flows 토글을 켭니다.
Save changes를 선택합니다.

GitLab Self-Managed에서#

히스토리

이미지 레지스트리의 전체 이미지 참조가 GitLab 19.0에서 도입되었습니다.
이미지 레지스트리의 레지스트리 경로 접두사가 GitLab 19.5에서 도입되었습니다.

사전 요구 사항:

관리자 접근 권한.

오른쪽 상단에서 Admin을 선택합니다.
왼쪽 사이드바에서 GitLab Duo를 선택합니다.
Change configuration을 선택합니다.
Flow execution 아래에서 Allow flow execution과 Allow foundational flows 체크박스를 선택합니다.
선택 사항. Image registry 텍스트 상자에 다음 중 하나를 입력합니다.
- 해당 레지스트리의 기본 이미지를 사용하려면 레지스트리 호스트 이름(예: registry.example.com).
- 프록시 캐시 프로젝트와 같이 해당 경로의 기본 이미지를 사용하려면 /로 끝나는 레지스트리 경로 접두사(예: harbor.example.com/proxy/).
- 이미지를 전체로 재정의하려면 전체 이미지 참조(예: registry.example.com/group/project/image:tag). 경로가 포함된 그 밖의 값은 전체 이미지 참조로 사용됩니다.
기본값인 registry.gitlab.com을 사용하려면 비워 둡니다.
Save changes를 선택합니다.

사전 요구 사항:

그룹의 Maintainer 또는 Owner 권한.
인스턴스에서 플로 실행과 파운데이셔널 플로가 켜져 있어야 합니다.

상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
왼쪽 사이드바에서 Settings > General을 선택합니다.
GitLab Duo features를 확장합니다.
Flow execution 아래에서 Allow flow execution과 Allow foundational flows 체크박스를 선택합니다.
최상위 그룹에 한해, 켜려는 각 파운데이셔널 플로의 체크박스를 선택합니다.
Save changes를 선택합니다.

그룹에서 켜면 파운데이셔널 플로를 모든 하위 그룹과 프로젝트에서 사용할 수 있습니다.

사전 요구 사항:

프로젝트의 Maintainer 또는 Owner 권한.
인스턴스와 그룹에서 플로 실행과 파운데이셔널 플로가 켜져 있어야 합니다.

상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
왼쪽 사이드바에서 Settings > General을 선택합니다.
GitLab Duo를 확장합니다.
GitLab Duo, Allow flow execution, Allow foundational flows 토글을 켭니다.
Save changes를 선택합니다.

파운데이셔널 플로

GitLab v19.5

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

원문 보기

번역일: 2026-10-15

요약

Model information

LLM: Anthropic Claude Sonnet 4

파운데이셔널 플로는 GitLab 이 만들고 유지 관리하며, GitLab 유지 관리 배지([tanuki-verified])가 표시됩니다.

각 플로는 특정 문제를 해결하거나 개발 작업을 지원하도록 설계되어 있습니다.

다음 파운데이셔널 플로를 사용할 수 있습니다.

플로	설명
Agentic Breaking Change Resolution	의존성 버전 업 머지 리퀘스트에서 브레이킹 체인지를 자동으로 해결합니다.
Code Review	AI 네이티브 분석과 피드백으로 코드 리뷰를 자동화합니다.
Convert to GitLab CI/CD	Jenkins 파이프라인을 CI/CD로 마이그레이션합니다.
Developer	이슈에서 실행 가능한 머지 리퀘스트를 만들거나 GitLab Duo Agentic Chat에서 다양한 작업을 완료합니다.
Fix CI/CD Pipeline	실패한 job을 진단하고 수정합니다.
Recommend Reviewers	머지 리퀘스트를 검토하기에 가장 적합한 리뷰어를 추천합니다.
SAST False Positive Detection	SAST 결과에서 오탐을 자동으로 식별하고 필터링합니다.
SAST Vulnerability Resolution	SAST 취약점을 해결하기 위한 머지 리퀘스트를 자동으로 생성합니다.
Secret False Positive Detection	시크릿 탐지 결과에서 오탐을 자동으로 식별하고 필터링합니다.
Security Review	머지 리퀘스트 변경 사항에서 비즈니스 로직 보안 취약점을 감지합니다.
Software Development	소프트웨어 개발 생명주기 전반에 걸친 작업에 대한 AI 생성 솔루션을 만듭니다.

개발자용#

새 파운데이셔널 플로를 만들어 GitLab에 추가하는 방법은 파운데이셔널 플로 개발 가이드를 참고합니다.

플로 실행 CI/CD 세부 정보 구성#

플로가 CI/CD를 사용해 실행되는 환경을 구성할 수 있습니다.

예를 들어 GitLab Self-Managed에서는 관리자가 파운데이셔널 플로 이미지용 사용자 지정 컨테이너 레지스트리를 구성할 수 있습니다.

자세한 내용은 플로 실행 구성을 참고합니다.

파운데이셔널 플로의 보안#

GitLab UI에서 파운데이셔널 플로는 다음 GitLab API에 접근할 수 있습니다.

서비스 계정#

파운데이셔널 플로는 서비스 계정을 사용해 작업을 완료합니다. 자세한 내용은 복합 ID 워크플로를 참고합니다.

파운데이셔널 플로 켜기 또는 끄기#

다음 범위에서 파운데이셔널 플로를 켜거나 끌 수 있습니다.

GitLab.com: 최상위 그룹과 프로젝트.
GitLab Self-Managed: 인스턴스, 그룹, 프로젝트.

이 설정은 GitLab에서 실행되는 플로, 예를 들어 이슈나 머지 리퀘스트에서 시작하는 플로를 제어합니다.

프로젝트 또는 그룹에서 GitLab Duo Agent Platform을 사용할 수 있습니다.
해당 플로가 구독 티어에서 제공됩니다. 베타 플로는 실험 및 베타 기능이 켜져 있어야 합니다.

GitLab.com에서#

사전 요구 사항:

최상위 그룹의 Owner 권한.

상단 바에서 Search or go to를 선택하고 최상위 그룹을 찾습니다.
Settings > GitLab Duo를 선택합니다.
Change configuration을 선택합니다.
Flow execution 아래에서 Allow flow execution과 Allow foundational flows 체크박스를 선택합니다.
켜려는 각 파운데이셔널 플로의 체크박스를 선택합니다.
Save changes를 선택합니다.

사전 요구 사항:

프로젝트의 Maintainer 또는 Owner 권한.
최상위 그룹에서 플로 실행과 파운데이셔널 플로가 켜져 있어야 합니다.

상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
왼쪽 사이드바에서 Settings > General을 선택합니다.
GitLab Duo를 확장합니다.
GitLab Duo, Allow flow execution, Allow foundational flows 토글을 켭니다.
Save changes를 선택합니다.

GitLab Self-Managed에서#

히스토리

이미지 레지스트리의 전체 이미지 참조가 GitLab 19.0에서 도입되었습니다.
이미지 레지스트리의 레지스트리 경로 접두사가 GitLab 19.5에서 도입되었습니다.

사전 요구 사항:

관리자 접근 권한.

오른쪽 상단에서 Admin을 선택합니다.
왼쪽 사이드바에서 GitLab Duo를 선택합니다.
Change configuration을 선택합니다.
Flow execution 아래에서 Allow flow execution과 Allow foundational flows 체크박스를 선택합니다.
선택 사항. Image registry 텍스트 상자에 다음 중 하나를 입력합니다.
- 해당 레지스트리의 기본 이미지를 사용하려면 레지스트리 호스트 이름(예: registry.example.com).
- 프록시 캐시 프로젝트와 같이 해당 경로의 기본 이미지를 사용하려면 /로 끝나는 레지스트리 경로 접두사(예: harbor.example.com/proxy/).
- 이미지를 전체로 재정의하려면 전체 이미지 참조(예: registry.example.com/group/project/image:tag). 경로가 포함된 그 밖의 값은 전체 이미지 참조로 사용됩니다.
기본값인 registry.gitlab.com을 사용하려면 비워 둡니다.
Save changes를 선택합니다.

사전 요구 사항:

그룹의 Maintainer 또는 Owner 권한.
인스턴스에서 플로 실행과 파운데이셔널 플로가 켜져 있어야 합니다.

상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
왼쪽 사이드바에서 Settings > General을 선택합니다.
GitLab Duo features를 확장합니다.
Flow execution 아래에서 Allow flow execution과 Allow foundational flows 체크박스를 선택합니다.
최상위 그룹에 한해, 켜려는 각 파운데이셔널 플로의 체크박스를 선택합니다.
Save changes를 선택합니다.

그룹에서 켜면 파운데이셔널 플로를 모든 하위 그룹과 프로젝트에서 사용할 수 있습니다.

사전 요구 사항:

프로젝트의 Maintainer 또는 Owner 권한.
인스턴스와 그룹에서 플로 실행과 파운데이셔널 플로가 켜져 있어야 합니다.

상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
왼쪽 사이드바에서 Settings > General을 선택합니다.
GitLab Duo를 확장합니다.
GitLab Duo, Allow flow execution, Allow foundational flows 토글을 켭니다.
Save changes를 선택합니다.