Skip to main content

이 버전의 GitHub Enterprise는 다음 날짜에 중단되었습니다. 2026-03-17. 중요한 보안 문제에 대해서도 패치 릴리스가 이루어지지 않습니다. 더 뛰어난 성능, 향상된 보안, 새로운 기능을 위해 최신 버전의 GitHub Enterprise Server로 업그레이드합니다. 업그레이드에 대한 도움말은 GitHub Enterprise 지원에 문의하세요.

pack 추가

선택적 버전 범위를 가진 QL 라이브러리 팩 목록을 현재 패키지의 종속성으로서 추가한 다음 설치합니다.

누가 이 기능을 사용할 수 있나요?

CodeQL은(는) 다음 리포지토리 유형에 사용할 수 있습니다.

이 기사에서

데이터 재사용 코드ql-cli.man-pages-version-note %}

개요

Shell
codeql pack add <options>... -- <scope/name[@range]>...

Description

선택적 버전 범위를 가진 QL 라이브러리 팩 목록을 현재 패키지의 종속성으로서 추가한 다음 설치합니다.

이 명령은 현재 패키지의 qlpack.yml 파일을 수정합니다. 서식 및 주석은 제거될 것입니다.

          `v2.6.0`부터 사용할 수 있습니다.

Options

기본 옵션

<scope/name[@range]>...

          \[필수] 종속성 목록에 추가되는 팩의 범위, 이름 및 선택적 버전 범위입니다.

버전 범위를 지정하지 않거나 ‘최신’으로 설정하면 최신 버전의 팩이 다운로드됩니다. 이때 다운로드된 버전과 호환되는 모든 버전을 허용하는 qlpack.yml에 종속성이 추가됩니다.

단일 버전이 지정된 경우 해당 버전의 팩이 다운로드되고, 지정된 버전과 호환되는 모든 버전을 허용하는 qlpack.yml 파일에 종속성이 추가됩니다.

버전 범위가 지정된 경우, 지정된 범위를 충족하는 팩의 최신 버전이 다운로드되고, 지정된 버전 범위로 qlpack.yml 파일에 종속성이 추가됩니다.

--dir=<dir>

패키지의 루트 디렉터리입니다.

--registries-auth-stdin

          \<registry\_url>
          =
          \<token> 쌍을 쉼표로 구분한 목록을 전달하여 GitHub Enterprise Server 컨테이너 레지스트리에 인증합니다.

예를 들어, https://containers.GHEHOSTNAME1/v2/=TOKEN1,https://containers.GHEHOSTNAME2/v2/=TOKEN2을 전달하여 두 개의 GitHub Enterprise Server 인스턴스에 인증할 수 있습니다.

이것은 CODEQL_REGISTRIES_AUTH 및 GITHUB_TOKEN 환경 변수를 재정의합니다. github.com 컨테이너 레지스트리 인증만 필요한 경우, 대신에 더 간단한 --github-auth-stdin 옵션을 사용할 수 있습니다.

--github-auth-stdin

GitHub Apps 토큰 또는 개인용 액세스 토큰을 github.com에 전달하여 표준 입력을 통해 github.com 컨테이너 레지스트리에 인증합니다.

          `--registries-auth-stdin`을(를) 전달하거나 CODEQL\_REGISTRIES\_AUTH 환경 변수를 사용하여 GitHub Enterprise Server 컨테이너 레지스트리에 인증할 수 있습니다.

이것은 GITHUB_TOKEN 환경 변수를 재정의합니다.

--[no-]allow-prerelease

사전 릴리스 버전 한정자(예: X.Y.Z-qualifier)가 있는 팩의 사용을 허용합니다. 이 플래그가 없다면, 사전 릴리스 팩은 무시될 것입니다.

          `v2.11.3`부터 사용할 수 있습니다.

일반 옵션

-h, --help

이 도움말 텍스트를 표시합니다.

-J=<opt>

          \[고급] 명령을 실행하는 JVM에 옵션을 제공합니다.

(옵션에 공백이 포함되면 제대로 처리되지 않을 수 있는 점에 유의해야 합니다.)

-v, --verbose

출력되는 진행률 메시지 수를 점차적으로 늘립니다.

-q, --quiet

출력되는 진행률 메시지 수를 점차적으로 줄입니다.

--verbosity=<level>

          \[고급] 세부 정보 표시 수준을 명시적으로 오류, 경고, 진행률, 진행률+, 진행률++, 진행률+++ 중 하나로 설정합니다. 
          `-v` 및 `-q`를 재정의합니다.

--logdir=<dir>

          \[고급] 지정한 디렉터리에 상세 로그를 하나 이상의 파일로 작성하며, 생성된 이름에는 타임스탬프와 실행 중인 하위 명령 이름을 포함합니다.

(로그 파일 이름을 직접 작성하려면 대신 --log-to-stderr를 사용하고 stderr를 원하는 위치로 리디렉션하세요.)

--common-caches=<dir>

          \[고급] 다운로드한 QL 팩 및 컴파일된 쿼리 계획 등 CLI를 여러 번 실행해도 지속되는 디스크의 캐시된 데이터의 위치를 제어합니다. 명시적으로 설정하지 않으면, 기본적으로 사용자의 홈 디렉터리에 이름이 지정된 `.codeql` 디렉터리로 설정됩니다. 디렉터리가 아직 없는 경우에는 만들어집니다.

          `v2.15.2`부터 사용할 수 있습니다.