GitLab Duo CLI 사용
GitLab v19.6Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
요약
GitLab Duo CLI는 두 가지 모드로 사용할 수 있습니다: GitLab Duo CLI를 인터랙티브 모드로 사용하려면 다음과 같이 합니다: 환경에 맞는 명령을 입력해 인터랙티브 모드를 시작합니다: 터미널 창에 프롬프트 >가 나타납니다.
GitLab Duo CLI는 두 가지 모드로 사용할 수 있습니다:
- 인터랙티브 모드: GitLab UI 나 에디터 확장의 GitLab Duo Chat과 비슷한 채팅 환경을 제공합니다. 빌드 모드, 플랜 모드, 자동 모드를 지원합니다.
- 헤드리스 모드: 러너, 스크립트를 비롯한 자동화 워크플로에서 비대화식으로 사용할 수 있습니다.
사전 요구 사항#
- GitLab Duo CLI가 설치되어 있고 설정되어 있어야 합니다.
- 기본 GitLab Duo 네임스페이스가 설정되어 있거나, GitLab Duo에 접근할 수 있는 프로젝트가 열려 있어야 합니다.
인터랙티브 모드#
GitLab Duo CLI를 인터랙티브 모드로 사용하려면 다음과 같이 합니다:
-
환경에 맞는 명령을 입력해 인터랙티브 모드를 시작합니다:
glab duo cliduo-
터미널 창에 프롬프트
>가 나타납니다. 프롬프트 뒤에 질문이나 요청을 입력하고 Enter를 누릅니다.예를 들면 다음과 같습니다:
What is this repository about? Which issues need my attention? Help me implement issue 15. The pipelines in MR 23 are failing. Please help me fix them.
GitLab Duo CLI가 동작하는 중에 응답을 취소하려면 Escape를 누릅니다. GitLab Duo CLI는 현재 작업을 중단하고 프롬프트로 돌아갑니다.
프롬프트 기록을 보려면 ↑ 키를, 기록을 검색하려면 Control+R을 사용합니다.
새 세션을 시작하면 프롬프트 플레이스홀더에 GitLab Duo CLI 기능에 대한 팁이 표시될 수 있습니다.
시작 카드#
히스토리
시작 카드는 인터랙티브 모드에서 새 세션을 시작할 때 터미널에 표시됩니다. 처음 실행할 때는 온보딩 카드가, 이후 실행에서는 환영 카드가 표시됩니다. 기존 세션을 재개할 때는 카드가 표시되지 않습니다.
시작 카드는 기본적으로 활성화되어 있지만 끌 수 있습니다.
온보딩 카드#
머신에서 GitLab Duo CLI를 처음 실행하면 온보딩 카드가 MCP 서버 연결과 GitLab 마켓플레이스의 플러그인 설치를 도와줍니다.
카드에는 단계를 선택하고 실행하기 위한 탐색 안내가 표시됩니다. 완료한 단계에는 연결된 MCP 서버 수나 설치된 플러그인 수와 함께 체크 표시가 나타납니다.
카드는 두 단계를 모두 완료한 뒤에도 첫 프롬프트를 보낼 때까지 유지됩니다. 이후 실행에서는 다시 표시되지 않습니다.
환영 카드#
새 세션을 시작할 때마다 기본적으로 환영 카드가 표시됩니다. Show work items on session start 설정으로 이 카드를 끌 수 있습니다.
이 카드는 일반적인 작업을 시작하기 위한 프롬프트를 제안하고, 프롬프트를 탐색하고 실행하기 위한 탐색 안내를 표시합니다. 예를 들어 GitLab 프로젝트에서 작업하는 경우 제안되는 프롬프트는 열려 있는 머지 리퀘스트와 이슈를 바탕으로 만들어집니다. 그렇지 않으면 카드에 일반적인 예시가 표시됩니다.
본인의 머지 리퀘스트에 대한 프롬프트를 선택했고 해당 소스 브랜치가 존재하면, 프롬프트는 GitLab Duo에 먼저 그 브랜치를 체크아웃하도록 지시합니다.
Run suggested prompts as /goal sessions 설정이 활성화되어 있고 인스턴스가 GitLab 19.3 이상이면, 리뷰 피드백을 처리하는 프롬프트가
/goal세션으로 실행됩니다.시작 카드 숨기기#
시작 카드는 기본적으로 활성화되어 있습니다. 끄려면
--startup-cards를false로 설정합니다:glab duo cli --startup-cards falseduo --startup-cards false또는
STARTUP_CARDS환경 변수를false로 설정합니다. 둘 다 설정하면--startup-cards옵션이 환경 변수보다 우선합니다.상태 표시줄#
화면 하단에는 다음 정보가 표시되는 상태 표시줄이 있습니다:
- 현재 작업 디렉터리와 Git 브랜치.
- 감지된 GitLab 프로젝트, 그리고 현재 브랜치에 열린 머지 리퀘스트가 있으면 해당 머지 리퀘스트와 파이프라인 상태.
- 실행 중인
/goal세션의 진행 상황. - 구성된 MCP 서버의 상태.
모드 전환#
인터랙티브 모드에서는 작업 중에 GitLab Duo CLI를 여러 모드로 전환할 수 있습니다:
모드 권한 동작 방식 빌드 모드(기본값) 읽기·쓰기 GitLab Duo가 작업을 실행하고 프로젝트를 변경할 수 있습니다. 플랜 모드 읽기 전용 GitLab Duo가 변경 없이 프로젝트를 분석하고 계획을 만들 수 있습니다. 자동 모드 읽기·쓰기 GitLab Duo가 먼저 승인을 요청하지 않고 도구를 사용할 수 있습니다. 자세한 내용은 자동 모드를 참고합니다. 예를 들어 플랜 모드에서 GitLab Duo와 문제를 논의하며 시작한 다음, 준비가 되면 빌드 모드로 전환해 GitLab Duo에 계획을 구현하도록 지시할 수 있습니다.
GitLab Duo CLI는
>프롬프트 아래에 현재 모드를 표시합니다. 모드를 전환하려면 Tab을 누릅니다.슬래시 명령어#
히스토리
/exit슬래시 명령어가 GitLab 19.0 릴리스 기간의 GitLab Duo CLI 8.88.0에서 도입됨./doctor슬래시 명령어가 GitLab 19.0 릴리스 기간의 GitLab Duo CLI 8.94.0에서 도입됨./skills슬래시 명령어가 GitLab 19.0 릴리스 기간의 GitLab Duo CLI 8.81.0에서 도입됨./mcp슬래시 명령어가 GitLab 19.0 릴리스 기간의 GitLab Duo CLI 8.95.0에서 도입됨./goal슬래시 명령어가 GitLab 19.4 릴리스 기간의 GitLab Duo CLI 9.17.0에서 베타로 도입됨./goal슬래시 명령어가 GitLab 19.5 릴리스 기간의 GitLab Duo CLI 9.27.0에서 정식 출시됨./compact슬래시 명령어가 GitLab 19.2 릴리스 기간의 GitLab Duo CLI 8.109.0에서 도입됨./export슬래시 명령어가 GitLab 19.4 릴리스 기간의 GitLab Duo CLI 9.11.0에서 도입됨./review슬래시 명령어가 GitLab 19.4 릴리스 기간의 GitLab Duo CLI 9.14.0에서 도입됨./whatsnew슬래시 명령어가 GitLab 19.4 릴리스 기간의 GitLab Duo CLI 9.20.0에서 도입됨.
인터랙티브 모드에서는 슬래시 명령어로 GitLab Duo CLI를 구성하고 작업을 수행합니다. 프롬프트에 슬래시 명령어를 입력하고 Enter를 누릅니다.
사용할 수 있는 슬래시 명령어는 다음과 같습니다:
명령어 설명 /compact컨텍스트 공간을 절약하기 위해 대화 기록을 압축합니다. /copyGitLab Duo의 마지막 응답을 클립보드에 복사합니다. /doctorGitLab Duo CLI 환경의 진단 정보를 표시합니다. /exitGitLab Duo CLI를 종료합니다. /export세션을 이식 가능한 JSON 번들로 내보냅니다. /feedback버그 리포트나 기능 요청을 제출합니다. /goal목표를 향해 진행하는 세션을 시작합니다. GitLab 19.3 이상이 필요합니다. /help사용할 수 있는 단축키, 모드, 슬래시 명령어를 표시합니다. /mcp구성된 MCP 서버와 그 상태를 봅니다. /model현재 세션의 AI 모델을 전환합니다. /new새 채팅 세션을 시작합니다. /review코드 리뷰 서브에이전트로 변경 사항을 리뷰합니다. /sessions세션을 탐색하고 검색하고 전환합니다. /settings설정 패널을 엽니다. /skills현재 프로젝트에서 사용할 수 있는 Agent Skills를 나열합니다. /whatsnewGitLab Duo CLI의 최근 변경 사항을 표시합니다. 슬래시 명령어가 여는 패널이나 대화 상자를 닫으려면 Escape를 누릅니다.
슬래시 명령어를 직접 만들 수도 있습니다. 자세한 내용은 사용자 정의 슬래시 명령어를 참고합니다.
설정#
인터랙티브 모드에서
/settings를 입력하면 설정을 보고 변경할 수 있습니다. 자세한 내용은 GitLab Duo CLI 설정을 참고합니다.시스템 알림#
히스토리
- 시스템 알림이 GitLab 19.1 릴리스 기간의 GitLab Duo CLI 8.105.0에서 도입됨.
GitLab Duo CLI는 터미널 창에 포커스가 없는 동안 세션에 사용자의 확인이 필요할 때 (예: 작업을 마쳤거나 도구 승인이 필요할 때) 시스템 알림을 보낼 수 있습니다.
알림은 설정 패널의 Notifications 설정으로 제어합니다:
auto(기본값): 터미널에 포커스가 없을 때 시스템 알림을 보냅니다.disabled: 시스템 알림을 보내지 않습니다.
도구 승인#
히스토리
- 세션 단위 도구 승인 옵션이 GitLab 19.0에서 도입됨.
- GitLab Duo CLI 8.80.0에서 도입됨.
- 패턴 기반 도구 승인이 GitLab 19.1에서 도입됨.
- GitLab Duo CLI 8.101.0에서 도입됨.
- 패턴 기반 도구 승인이 2026년 7월 10일에 제거됨.
- GitLab Duo CLI 9.3.0에서 제거됨.
GitLab Duo는 도구를 사용해야 할 때 시작 전에 승인을 요청합니다. 예를 들어 파일을 읽거나 명령을 실행해야 할 때 요청합니다.
선택지는 다음과 같습니다:
- Approve: GitLab Duo가 해당 도구를 한 번 사용할 수 있습니다.
- Approve for session: GitLab Duo가 남은 세션 동안 같은 인수로 해당 도구를 사용할 수 있습니다. 인수가 다르면 다시 승인해야 합니다.
- Deny: GitLab Duo가 해당 도구를 사용할 수 없습니다.
NoteApprove for session 옵션을 사용하려면 관리자가 그룹이나 인스턴스에서 이 옵션을 켜야 합니다. 자세한 내용은 도구 승인을 참고합니다.
자동 모드#
히스토리
- GitLab 19.5에서
duo_auto_mode라는 이름의 기능 플래그와 함께 도입됨. 기본적으로 활성화되어 있습니다. - GitLab Duo CLI 9.22.0에서 도입됨.
Feature flag이 기능의 가용성은 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.
자동 모드에서 GitLab Duo는 승인을 요청하지 않고 도구를 사용할 수 있습니다. 설정이 허용하는 경우 GitLab Duo는 다음 작업을 수행할 수 있습니다:
- 파일을 삭제하거나 시스템을 변경하는 명령을 포함해 모든 셸 명령 실행.
- 커밋과 푸시를 포함한
git명령 실행. - 이슈, 머지 리퀘스트, 기타 GitLab 리소스 생성 또는 업데이트.
- MCP 도구 실행과 플로 시작.
자동 모드는 에이전트 도구 거버넌스를 재정의하지 않습니다. 최상위 그룹에 대해 로컬 액세스 도구 거버넌스가 켜져 있으면, Always deny로 설정된 도구는 실행되지 않으며 Always ask로 설정된 도구는 여전히 승인을 요청합니다. 자세한 내용은 GitLab Duo CLI의 자동 모드를 참고합니다.
WarningGitLab Duo는 실수를 할 수 있습니다. 파일, 이슈, 머지 리퀘스트, 웹 페이지처럼 GitLab Duo가 읽는 모든 콘텐츠에는 프롬프트 인젝션에 사용되는 악의적인 지시가 포함되어 있을 수 있습니다. 위험을 줄이려면 다음을 따릅니다:
- 신뢰하는 리포지터리와 폐기할 수 있는 브랜치에서만 자동 모드를 사용합니다.
- 민감한 자격 증명이 있는 기기나 셸에서는 자동 모드를 사용하지 않습니다.
- 세션에 머물면서 머지하기 전에 모든 변경 사항을 검토합니다.
- 자동 모드가 필요하지 않으면 빌드 모드로 다시 전환합니다.
자세한 내용은 에디터 확장 보안 고려 사항을 참고합니다.
자동 모드 켜기#
Auto mode 설정은 기본적으로 꺼져 있습니다. 자동 모드를 사용하려면 먼저 인스턴스, 그룹 또는 프로젝트에서 켜야 합니다. 그룹은 인스턴스의 설정을 상속하고, 하위 그룹과 프로젝트는 상위 그룹의 설정을 상속합니다.
사전 요구 사항:
- 관리자 액세스 권한이 있어야 합니다.
인스턴스에서 자동 모드를 켜려면 다음과 같이 합니다:
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 GitLab Duo를 선택합니다.
- Change configuration을 선택합니다.
- Auto mode 드롭다운 목록에서 다음 옵션 중 하나를 선택합니다:
- On by default: 자동 모드를 사용할 수 있습니다. 그룹과 하위 그룹이 끌 수 있습니다.
- Off by default: 자동 모드를 사용할 수 없습니다. 그룹과 하위 그룹이 켤 수 있습니다.
- Always off: 자동 모드를 사용할 수 없습니다. 그룹과 하위 그룹이 켤 수 없습니다.
- Save changes를 선택합니다.
사전 요구 사항:
- 그룹의 Owner 권한이 있어야 합니다.
그룹에서 자동 모드를 켜려면 다음과 같이 합니다:
- 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
- Settings > GitLab Duo를 선택합니다.
- Change configuration을 선택합니다.
- Auto mode 드롭다운 목록에서 다음 옵션 중 하나를 선택합니다:
- On by default: 자동 모드를 사용할 수 있습니다. 하위 그룹과 프로젝트가 끌 수 있습니다.
- Off by default: 자동 모드를 사용할 수 없습니다. 하위 그룹과 프로젝트가 켤 수 있습니다.
- Always off: 자동 모드를 사용할 수 없습니다. 하위 그룹과 프로젝트가 켤 수 없습니다.
- Save changes를 선택합니다.
상위 그룹이 자동 모드를 Always off로 설정했다면 프로젝트 설정은 잠기며 켤 수 없습니다.
사전 요구 사항:
- 프로젝트의 Maintainer 또는 Owner 권한이 있어야 합니다.
프로젝트에서 자동 모드를 켜려면 다음과 같이 합니다:
- 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
- Settings > General을 선택합니다.
- GitLab Duo를 확장합니다.
- Auto mode 토글을 켭니다.
- Save changes를 선택합니다.
자동 모드 사용#
사전 요구 사항:
- GitLab Duo CLI 9.22.0 이상.
- 프로젝트에서 자동 모드가 켜져 있어야 합니다.
자동 모드를 사용하려면 다음과 같이 합니다:
- 설정을 반영하려면 프로젝트에서 GitLab Duo CLI를 시작하거나 다시 시작합니다.
>프롬프트 아래의 모드에auto가 표시될 때까지 Tab을 누릅니다.- 프롬프트를 입력합니다. 자동 모드는 해당 프롬프트부터 적용됩니다.
자동 모드 사용을 중단하려면 Tab을 눌러 다른 모드로 전환합니다. 변경 사항은 다음 프롬프트에 적용됩니다.
자동 모드는 세션 간에 유지되지 않습니다. 기본 모드를 다르게 설정하지 않는 한 새 세션이나 재개한 세션은 모두 빌드 모드로 시작합니다.
자동 모드 문제 해결#
Tab을 눌러도
auto가 나타나지 않으면 다음과 같이 합니다:- 프로젝트에서 Auto mode 설정이 켜져 있는지 확인합니다.
- 어떤 상위 그룹도 Always off로 설정되어 있지 않은지 확인합니다.
- GitLab Duo CLI를 다시 시작합니다.
헤드리스 모드#
Warning헤드리스 모드는 통제된 샌드박스 환경에서 신중하게 사용합니다.
워크플로를 비대화식으로 실행하려면 환경에 맞는 명령을 사용합니다:
glab duo cli run을 사용합니다:glab duo cli run --goal "Your goal or prompt here"예를 들어 ESLint 명령을 실행하고 오류를 GitLab Duo CLI로 넘겨 해결할 수 있습니다:
glab duo cli run --goal "Fix these errors: $eslint_output"duo run을 사용합니다:duo run --goal "Your goal or prompt here"예를 들어 ESLint 명령을 실행하고 오류를 GitLab Duo CLI로 넘겨 해결할 수 있습니다:
duo run --goal "Fix these errors: $eslint_output"헤드리스 모드를 사용하면 GitLab Duo CLI는 다음과 같이 동작합니다:
- GitLab 19.4 이상에서는 Developer Flow를 실행합니다.
- 수동 도구 승인을 건너뛰고 모든 도구를 자동으로 승인합니다.
- 이전 대화의 컨텍스트를 유지하지 않습니다.
run명령을 실행할 때마다 새 워크플로가 시작됩니다.
이미지를 컨텍스트로 제공#
히스토리
- GitLab 19.5 릴리스 기간의 GitLab Duo CLI 9.27.0에서
dap_tool_image_input이라는 기능 플래그와 함께 도입됨. 기본적으로 비활성화됨. - GitLab 19.6에서 GitLab.com, GitLab Self-Managed, GitLab Dedicated에 대해 활성화됨.
- GitLab 19.6에서 자체 호스팅 모델 지원이 추가됨.
Feature flag이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.
사전 요구 사항:
- GitLab Duo CLI 9.27.0 이상.
- 이미지 입력을 받는 모델. 자체 호스팅 모델의 경우 관리자가 모델이 이미지를 읽는지 선언할 수 있습니다.
GitLab Duo CLI를 인터랙티브 모드 또는 헤드리스 모드로 로컬에서 실행하면 GitLab Duo는 이미지를 읽어 컨텍스트로 사용할 수 있습니다. CLI가 읽을 수 있는 이미지는 다음과 같습니다.
- 리포지터리에 있는 이미지 파일.
- 같은 프로젝트의 이슈, 머지 리퀘스트 또는 코멘트에 첨부된 이미지.
프롬프트에 이미지를 직접 업로드할 수는 없습니다. 대신 이미 존재하는 이미지를 지정합니다.
- 리포지터리의 파일은 파일 경로를 지정합니다. 예:
docs/architecture.png. - 첨부 파일은 Markdown에 나타나는 그대로 업로드 참조를 지정합니다.
예:
/uploads/<secret>/screenshot.png.
이미지 요구 사항#
이미지를 컨텍스트로 사용하려면 이미지가 다음 요구 사항을 충족해야 합니다.
- 형식: PNG, JPEG 또는 WebP 파일
- 크기: 10 MB 이하
- 크기(픽셀): 가로나 세로가 8,000픽셀을 넘지 않음
프롬프트 예시#
이슈에 첨부된 스크린샷에 나타난 UI 버그를 수정하도록 GitLab Duo CLI에 요청할 수 있습니다.
Look at the screenshot attached to issue 1234 and fix the alignment bug it shows.아키텍처 다이어그램을 설명하도록 GitLab Duo CLI에 요청할 수 있습니다.
Read docs/architecture.png, explain the data flow, and identify any single points of failure.화이트보드 사진을 설계 문서로 만들도록 GitLab Duo CLI에 요청할 수 있습니다.
Read whiteboard.jpg and turn it into a design document in docs/design.md.모델 선택#
히스토리
인터랙티브 모드나 헤드리스 모드에서 사용할 모델을 선택할 수 있습니다.
인터랙티브 모드의 경우#
선택한 모델은 세션이 바뀌어도 유지되며, 대화 도중에 컨텍스트를 잃지 않고 모델을 전환할 수 있습니다.
사전 요구 사항:
- GitLab Duo CLI 8.76.0 이상이 필요합니다.
인터랙티브 모드에서 모델을 선택하려면 다음과 같이 합니다:
- 인터랙티브 모드에서
/model을 입력하고 Enter를 누릅니다. - 화살표 키로 사용 가능한 모델 목록을 훑어보거나, 모델 이름을 입력해 목록을 필터링합니다.
- 모델을 선택하고 Enter를 눌러 해당 모델로 전환합니다.
헤드리스 모드의 경우#
선택한 모델은 세션이 바뀌면 유지되지 않습니다.
사전 요구 사항:
- GitLab Duo CLI 8.68.0 이상이 필요합니다.
헤드리스 모드에서 모델을 선택하려면 다음과 같이 합니다:
-
모델의
gitlab_identifier를 찾습니다. -
GitLab Duo CLI를 실행할 때
--model옵션이나GITLAB_DUO_MODEL환경 변수를gitlab_identifier값으로 설정합니다.--model옵션을 사용합니다:glab duo cli --model <gitlab_identifier_for_the_model>GITLAB_DUO_MODEL환경 변수를 사용합니다:GITLAB_DUO_MODEL=<gitlab_identifier_for_the_model> glab duo cli예를 들어
GPT-5-Codex - OpenAI를 사용하려면 다음과 같이 합니다:glab duo cli --model gpt_5_codexGITLAB_DUO_MODEL=gpt_5_codex glab duo cli--model옵션을 사용합니다:duo --model <gitlab_identifier_for_the_model>GITLAB_DUO_MODEL환경 변수를 사용합니다:GITLAB_DUO_MODEL=<gitlab_identifier_for_the_model> duo예를 들어
GPT-5-Codex - OpenAI를 사용하려면 다음과 같이 합니다:duo --model gpt_5_codexGITLAB_DUO_MODEL=gpt_5_codex duo세션 전환#
GitLab Duo Chat 세션은 대화 기록과 워크플로 데이터를 저장하며, GitLab Duo CLI, GitLab UI, 에디터 확장에서 공유됩니다.
예를 들어 브라우저에서 대화를 시작하고 터미널에서 이어 갈 수 있습니다.
세션을 탐색하고 전환하려면 다음과 같이 합니다:
- 인터랙티브 모드에서
/sessions를 입력하고 Enter를 누릅니다. - 화살표 키로 사용 가능한 세션 목록을 훑어보거나, 텍스트를 입력해 목록을 필터링합니다.
- 세션을 선택하고 Enter를 누릅니다.
헤드리스 모드에서 세션을 전환하려면
--existing-session-id옵션을 사용합니다.Model Context Protocol(MCP) 연결#
GitLab Duo CLI를 로컬 또는 원격 MCP 서버에 연결하려면 GitLab IDE 확장과 동일한 MCP 구성을 사용합니다. 자세한 방법은 MCP 서버 구성을 참고합니다.
관련 주제#
- GitLab Duo CLI 전체 레퍼런스
- 에디터 확장 보안 고려 사항
- GitLab CLI
- GitLab Duo Agent Platform 사용자 지정
- GitLab Duo Agent Platform 세션
문제 해결#
GitLab Duo CLI를 사용할 때 다음 문제가 발생할 수 있습니다.
인증서 오류#
다음과 같은 인증서 오류가 발생할 수 있습니다:
Error: unable to verify the first certificate Error: self-signed certificate in certificate chain이 오류는 조직이 HTTPS를 가로채는 프록시 등에 사용자 지정 인증 기관(Certificate Authority, CA)을 사용할 때 발생합니다.
인증서 오류를 해결하려면 다음 방법 중 하나를 사용합니다:
-
시스템 인증서 저장소를 사용합니다(권장):
-
CA 인증서가 운영 체제의 인증서 저장소에 설치되어 있다면 Node.js가 이를 사용하도록 구성합니다. Node.js 22.15.0, 23.9.0, 24.0.0 이상이 필요합니다.
-
GitLab Duo CLI를 컨테이너에서 실행한다면 호스트 시스템 저장소가 아니라 컨테이너의 시스템 저장소에 CA 인증서를 설치합니다.
export NODE_OPTIONS="--use-system-ca"
-
-
CA 인증서 파일을 지정합니다:
-
이전 Node.js 버전이거나 CA 인증서가 시스템 저장소에 없다면 Node.js가 인증서 파일을 직접 가리키도록 합니다. 파일은 PEM 형식이어야 합니다.
-
GitLab Duo CLI를 컨테이너에서 실행한다면 경로를 컨테이너 내부 위치로 설정합니다. 인증서 파일은 볼륨 마운트로 제공합니다.
export NODE_EXTRA_CA_CERTS=/path/to/custom-ca.pem
-
인증서 오류 무시#
그래도 인증서 오류가 계속되면 인증서 검증을 비활성화할 수 있습니다.
Warning인증서 검증을 비활성화하면 보안 위험이 있습니다. 운영 환경에서는 검증을 비활성화하지 않습니다.
인증서 오류는 잠재적인 보안 침해를 알리는 신호이므로, 비활성화해도 안전하다고 확신할 때만 인증서 검증을 비활성화합니다.
사전 요구 사항:
- 브라우저에서 인증서 체인을 확인했거나, 관리자가 이 오류를 무시해도 안전하다고 확인해야 합니다.
인증서 검증을 비활성화하려면 다음과 같이 합니다:
export NODE_TLS_REJECT_UNAUTHORIZED=0 - 인터랙티브 모드에서
-