플로 실행 구성

GitLab Duo Agent Platform 플로를 실행하는 CI/CD 환경, 설정 스크립트, 캐싱, ID 토큰, 러너를 구성하는 방법을 설명합니다.

히스토리 GitLab 18.3에서 도입 되었습니다. 플로는 에이전트를 사용해 작업을 실행합니다. GitLab UI에서 실행하는 플로는 CI/CD를 사용합니다. IDE에서 실행하는 플로는 로컬에서 실행됩니다. 플로가 CI/CD로 실행되는 환경을 구성할 수 있습니다. 자체 러너를 사용 하거나 job에서 변수를 지정 할 수도 있습니다. 실행기 아키텍처 # 히스토리 GitLab 19.4에서 npm 패키지 대신 사전 컴파일된 바이너리를 사용하도록 변경 되었습니다. 플로가 CI/CD에서 실행되면 러너는 다음을 수행합니다. GitLab 패키지 레지스트리에서 운영 체제와 아키텍처에 맞는 GitLab Duo CLI 바이너리를 다운로드합니다. Node.js와 npm 은 필요하지 않습니다. WebSocket을 사용해 GitLab Duo Workflow Service에 연결하는 GitLab Duo CLI를 실행합니다. AI 모델의 지시에 따라 도구(파일 작업, Git 명령)를 실행합니다. 실행기 버전은 GitLab이 관리하며 정기 릴리스의 일부로 업데이트됩니다. CI/CD 실행 구성 # 플로가 CI/CD에서 실행되는 방식을 사용자 지정하려면 프로젝트에 에이전트 구성 파일을 생성합니다. 지원되는 키와 해당 유형의 목록은 agent-config.yml 참조 를 참고합니다. Note 사전 정의된 CI/CD 변수를 agent-config.yml 을 구성하는 데 사용할 수 없습니다. 플로를 실행하는 job에는 변수 를 사용해야 합니다. 에이전트 구성 파일 생성 # 히스토리 GitLab Duo로 에이전트 구성 파일을 생성하는 기능이 GitLab 19.5에서 duo_agent_readiness_settings 라는 기능 플래그와 함께 도입 되었습니다. 기본적으로 활성화되어 있습니다. Feature flag 이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다. GitLab Duo로 에이전트 구성 파일을 생성하거나 수동으로 만들 수 있습니다. Generate with GitLab Duo Create manually 사전 요구 사항: 프로젝트에서 Maintainer 또는 Owner 권한이 있어야 합니다. 프로젝트에서 플로 실행이 켜져 있어야 합니다. 파일을 생성하려면 다음을 수행합니다. 상단 바에서 Search or go to 를 선택하고 프로젝트를 찾습니다. 왼쪽 사이드바에서 Settings > General 을 선택합니다. GitLab Duo 를 펼칩니다. Agent configuration file 행에서 Generate 를 선택합니다. GitLab Duo가 파일을 생성하고 이를 프로젝트에 추가하는 머지 리퀘스트를 엽니다. 머지 리퀘스트를 리뷰하고 준비되면 머지합니다. 파일이 이미 기본 브랜치에 있거나 파일을 추가하는 머지 리퀘스트가 열려 있으면, Agent configuration file 행에 해당 항목으로 연결되는 링크가 대신 표시됩니다. 파일을 수동으로 생성하려면 다음을 수행합니다. 프로젝트 리포지터리에 .gitlab/duo