GitLab CLI(glab)를 통해 GitLab Duo CLI를 사용할 수 있습니다. GitLab CLI를 사용하면 다른 GitLab 기능에도 액세스할 수 있으며, OAuth 또는 개인 액세스 토큰으로 한 번만 인증하면 됩니다.

또는 GitLab Duo CLI(duo)를 독립형 AI 도구로 설치하여 사용하고, 개인 액세스 토큰으로 별도로 인증할 수도 있습니다.

두 설정 모두 인터랙티브 모드와 헤드리스 모드를 지원하며, 모든 GitLab Duo CLI 옵션, 명령어, 기능을 사용할 수 있습니다.

사전 조건#

• GitLab 19.2 이상.

• GitLab Duo Agent Platform 사전 조건.

• GitLab Self-Managed 및 GitLab Dedicated의 경우, GitLab Duo CLI 액세스가 켜져 있는지 확인합니다.

  [!note] GitLab 18.11에서 19.1을 사용 중인 경우, 베타 및 실험 기능을 켜서 최신 버전의 GitLab Duo CLI를 사용할 수 있습니다.

GitLab CLI와 함께 사용#

사전 조건:

• GitLab CLI 1.107.0 이상.

• GitLab CLI가 인증되어 있어야 합니다.

GitLab CLI를 통해 GitLab Duo CLI를 사용하도록 설정하려면:

1. GitLab Duo CLI용 glab 명령어를 실행합니다:

   glab duo cli
   

2. 프롬프트에 따라 GitLab Duo CLI 바이너리를 설치합니다.

GitLab CLI가 인증을 자동으로 처리하므로, 곧바로 GitLab Duo CLI를 사용할 수 있습니다.

GitLab CLI 없이 사용#

GitLab Duo CLI를 독립형 도구로 사용하려면, 설치한 다음 인증합니다.

설치#

GitLab Duo CLI를 컴파일된 바이너리로 설치하려면, 설치 스크립트를 다운로드하여 실행합니다.

macOS 및 Linux에서:

bash <(curl --fail --silent --show-error --location "https://gitlab.com/gitlab-org/editor-extensions/gitlab-lsp/-/raw/main/packages/cli/scripts/install_duo_cli.sh")

Windows에서:

irm "https://gitlab.com/gitlab-org/editor-extensions/gitlab-lsp/-/raw/main/packages/cli/scripts/install_duo_cli.ps1" | iex

인증#

사전 조건:

• api 권한이 있는 개인 액세스 토큰.

인증하려면:

1. 터미널에서 duo를 실행합니다. GitLab Duo CLI를 처음 실행하면 구성 화면이 나타납니다.

2. GitLab Instance URL을 입력한 다음 Enter를 누릅니다:

   • GitLab.com의 경우 https://gitlab.com을 입력합니다.

   • GitLab Self-Managed 또는 GitLab Dedicated의 경우 인스턴스 URL을 입력합니다.

3. GitLab Token에 개인 액세스 토큰을 입력합니다.

4. 저장하고 CLI를 종료하려면 Enter를 누릅니다.

5. CLI를 다시 시작하려면 터미널에서 duo를 실행합니다.

초기 설정 후 구성을 수정하려면 duo config edit를 사용합니다.

환경 변수로 인증#

사전 조건:

• api 권한이 있는 개인 액세스 토큰.

GitLab Duo CLI는 표준 프록시 환경 변수를 따릅니다:

• HTTP_PROXY 또는 http_proxy: HTTP 요청용 프록시 URL.

• HTTPS_PROXY 또는 https_proxy: HTTPS 요청용 프록시 URL.

• NO_PROXY 또는 no_proxy: 프록시에서 제외할 호스트의 쉼표로 구분된 목록.

환경 변수로 인증하려면:

1. GITLAB_TOKEN 또는 GITLAB_OAUTH_TOKEN을 개인 액세스 토큰으로 설정합니다.

   export GITLAB_TOKEN="<your-personal-access-token>"
   

2. 선택 사항. GITLAB_BASE_URL 또는 GITLAB_URL을 사용자 정의 GitLab 인스턴스 URL로 설정합니다. 예를 들어 https://gitlab.example.com입니다. 기본값은 https://gitlab.com입니다.

   export GITLAB_BASE_URL="<your-instance-url>"
   

이 방법은 대화형 인증이 불가능한 헤드리스 모드, CI/CD 파이프라인 및 스크립트 워크플로에 유용합니다.

관련 주제#

• GitLab Duo CLI 전체 레퍼런스

• 편집기 확장 프로그램 보안 고려 사항

• GitLab CLI