InfoGrab DocsInfoGrab Docs

GitLab Duo CLI 설정

요약

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

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

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

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

사전 요구 사항#

Note

GitLab 18.11에서 19.1을 사용 중이라면 베타 및 실험 기능을 켜서 최신 버전의 GitLab Duo CLI를 사용할 수 있습니다.

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/app/scripts/install_duo_cli.sh")

Windows에서는 다음과 같이 실행합니다.

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

인증#

Note

duo를 처음 실행할 때 시스템에 glab 이 이미 설치되어 인증된 상태라면, duo는 자동으로 glab을 자격 증명 헬퍼로 사용합니다. 별도로 인증할 필요가 없습니다. 이 기능에는 glab 1.85.2 이상과 duo 8.68.0 이상이 필요합니다.

이 기능이 제공되기 전에 duo를 인증했고 대신 glab을 자격 증명 헬퍼로 사용하려면, ~/.gitlab/storage.json에서 인증 설정을 삭제합니다.

사전 요구 사항:

인증하려면 다음 단계를 수행합니다.

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

  2. Instance URL에서 https://gitlab.com을 사용하려면 Enter를 누르고, GitLab Self-Managed 또는 GitLab Dedicated 인스턴스를 사용하려면 해당 인스턴스의 URL을 입력합니다.

  3. Personal Access Token에 개인 액세스 토큰을 입력하고 Enter를 누릅니다. 토큰을 만들려면 Create a token을 선택합니다. 이 링크는 필요한 스코프가 미리 선택된 인스턴스의 개인 액세스 토큰 페이지를 엽니다.

    GitLab Duo CLI가 토큰을 검증합니다. 검증에 실패하면 Enter를 눌러 토큰을 다시 입력합니다. 토큰이 확인되면 GitLab Duo CLI가 구성을 저장하고 종료됩니다.

  4. GitLab Duo CLI를 사용하기 시작하려면 duo를 다시 실행합니다.

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

환경 변수로 구성#

히스토리

다음과 같은 경우 환경 변수로 GitLab Duo CLI를 구성합니다.

  • 대화형으로 인증할 수 없는 헤드리스 모드, CI/CD 파이프라인, 스크립트에서 GitLab Duo CLI를 실행합니다.
  • 개발자 머신을 중앙에서 구성하며 GitLab CLI와 같은 변수를 사용하려고 합니다.

사전 요구 사항:

GitLab Duo CLI, GitLab CLI, GitLab for VS Code 확장 프로그램, JetBrains IDE용 GitLab Duo 플러그인은 모두 GITLAB_HOST와 GITLAB_TOKEN을 읽습니다. 가능하면 이 공유 변수를 사용하여 하나의 구성으로 이 모든 도구를 다룰 수 있게 합니다. GitLab Duo CLI를 시작하기 전에 GITLAB_HOST와 GITLAB_TOKEN을 설정합니다.

변수 설명
GITLAB_HOST GitLab 인스턴스 URL 또는 호스트 이름. 예: https://gitlab.example.com. http:// 또는 https://를 생략하면 GitLab Duo CLI는 https://를 사용합니다.
GITLAB_TOKEN GITLAB_HOST의 개인 액세스 토큰.

예를 들면 다음과 같습니다.

export GITLAB_HOST="https://gitlab.example.com"
export GITLAB_TOKEN="<your-personal-access-token>"

GitLab Duo CLI는 다음 변수도 읽습니다.

변수 설명
GITLAB_URL 또는 GITLAB_BASE_URL http:// 또는 https://를 포함한 GitLab 인스턴스 URL. 예: https://gitlab.example.com. GITLAB_HOST보다 우선합니다.
GITLAB_OAUTH_TOKEN 인증 토큰. GITLAB_TOKEN이 설정되지 않은 경우에만 사용합니다.

GitLab Duo CLI는 이 변수를 다음과 같이 읽습니다.

  • GITLAB_TOKEN은 duo config edit로 저장한 토큰과 GitLab CLI 자격 증명보다 우선합니다.
  • GITLAB_HOST, GITLAB_URL, GITLAB_BASE_URL 없이 GITLAB_TOKEN만 설정하면 GitLab Duo CLI는 duo config edit로 저장한 인스턴스나 https://gitlab.com으로 토큰을 보냅니다. GITLAB_TOKEN은 항상 GITLAB_HOST와 함께 설정합니다.
  • GitLab Duo CLI는 GITLAB_CLIENT_ID를 읽지 않습니다.

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

  • HTTP_PROXY 또는 http_proxy: HTTP 요청용 프록시 URL.
  • HTTPS_PROXY 또는 https_proxy: HTTPS 요청용 프록시 URL.
  • NO_PROXY 또는 no_proxy: 프록시에서 제외할 호스트를 쉼표로 구분한 목록.

개인 액세스 토큰을 환경 변수에 저장하지 않으려면 대신 OAuth로 인증합니다. GitLab Duo CLI를 GitLab CLI와 함께 사용하고 GITLAB_TOKEN이나 GITLAB_OAUTH_TOKEN은 설정하지 않습니다. GitLab CLI는 GITLAB_HOST와 GITLAB_CLIENT_ID를 직접 읽습니다.

관련 주제#

GitLab Duo CLI 설정

GitLab v19.6
Tier: Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
원문 보기

요약

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

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

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

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

사전 요구 사항#

Note

GitLab 18.11에서 19.1을 사용 중이라면 베타 및 실험 기능을 켜서 최신 버전의 GitLab Duo CLI를 사용할 수 있습니다.

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/app/scripts/install_duo_cli.sh")

Windows에서는 다음과 같이 실행합니다.

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

인증#

Note

duo를 처음 실행할 때 시스템에 glab 이 이미 설치되어 인증된 상태라면, duo는 자동으로 glab을 자격 증명 헬퍼로 사용합니다. 별도로 인증할 필요가 없습니다. 이 기능에는 glab 1.85.2 이상과 duo 8.68.0 이상이 필요합니다.

이 기능이 제공되기 전에 duo를 인증했고 대신 glab을 자격 증명 헬퍼로 사용하려면, ~/.gitlab/storage.json에서 인증 설정을 삭제합니다.

사전 요구 사항:

인증하려면 다음 단계를 수행합니다.

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

  2. Instance URL에서 https://gitlab.com을 사용하려면 Enter를 누르고, GitLab Self-Managed 또는 GitLab Dedicated 인스턴스를 사용하려면 해당 인스턴스의 URL을 입력합니다.

  3. Personal Access Token에 개인 액세스 토큰을 입력하고 Enter를 누릅니다. 토큰을 만들려면 Create a token을 선택합니다. 이 링크는 필요한 스코프가 미리 선택된 인스턴스의 개인 액세스 토큰 페이지를 엽니다.

    GitLab Duo CLI가 토큰을 검증합니다. 검증에 실패하면 Enter를 눌러 토큰을 다시 입력합니다. 토큰이 확인되면 GitLab Duo CLI가 구성을 저장하고 종료됩니다.

  4. GitLab Duo CLI를 사용하기 시작하려면 duo를 다시 실행합니다.

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

환경 변수로 구성#

히스토리

다음과 같은 경우 환경 변수로 GitLab Duo CLI를 구성합니다.

  • 대화형으로 인증할 수 없는 헤드리스 모드, CI/CD 파이프라인, 스크립트에서 GitLab Duo CLI를 실행합니다.
  • 개발자 머신을 중앙에서 구성하며 GitLab CLI와 같은 변수를 사용하려고 합니다.

사전 요구 사항:

GitLab Duo CLI, GitLab CLI, GitLab for VS Code 확장 프로그램, JetBrains IDE용 GitLab Duo 플러그인은 모두 GITLAB_HOST와 GITLAB_TOKEN을 읽습니다. 가능하면 이 공유 변수를 사용하여 하나의 구성으로 이 모든 도구를 다룰 수 있게 합니다. GitLab Duo CLI를 시작하기 전에 GITLAB_HOST와 GITLAB_TOKEN을 설정합니다.

변수 설명
GITLAB_HOST GitLab 인스턴스 URL 또는 호스트 이름. 예: https://gitlab.example.com. http:// 또는 https://를 생략하면 GitLab Duo CLI는 https://를 사용합니다.
GITLAB_TOKEN GITLAB_HOST의 개인 액세스 토큰.

예를 들면 다음과 같습니다.

export GITLAB_HOST="https://gitlab.example.com"
export GITLAB_TOKEN="<your-personal-access-token>"

GitLab Duo CLI는 다음 변수도 읽습니다.

변수 설명
GITLAB_URL 또는 GITLAB_BASE_URL http:// 또는 https://를 포함한 GitLab 인스턴스 URL. 예: https://gitlab.example.com. GITLAB_HOST보다 우선합니다.
GITLAB_OAUTH_TOKEN 인증 토큰. GITLAB_TOKEN이 설정되지 않은 경우에만 사용합니다.

GitLab Duo CLI는 이 변수를 다음과 같이 읽습니다.

  • GITLAB_TOKEN은 duo config edit로 저장한 토큰과 GitLab CLI 자격 증명보다 우선합니다.
  • GITLAB_HOST, GITLAB_URL, GITLAB_BASE_URL 없이 GITLAB_TOKEN만 설정하면 GitLab Duo CLI는 duo config edit로 저장한 인스턴스나 https://gitlab.com으로 토큰을 보냅니다. GITLAB_TOKEN은 항상 GITLAB_HOST와 함께 설정합니다.
  • GitLab Duo CLI는 GITLAB_CLIENT_ID를 읽지 않습니다.

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

  • HTTP_PROXY 또는 http_proxy: HTTP 요청용 프록시 URL.
  • HTTPS_PROXY 또는 https_proxy: HTTPS 요청용 프록시 URL.
  • NO_PROXY 또는 no_proxy: 프록시에서 제외할 호스트를 쉼표로 구분한 목록.

개인 액세스 토큰을 환경 변수에 저장하지 않으려면 대신 OAuth로 인증합니다. GitLab Duo CLI를 GitLab CLI와 함께 사용하고 GITLAB_TOKEN이나 GITLAB_OAUTH_TOKEN은 설정하지 않습니다. GitLab CLI는 GITLAB_HOST와 GITLAB_CLIENT_ID를 직접 읽습니다.

관련 주제#