8.9. roxctl 이미지


특정 이미지에서 실행할 수 있는 명령입니다.

사용법

$ roxctl image [command] [flags]

표 8.61. 사용 가능한 명령
명령설명

확인

이미지에 빌드 시간 정책 위반이 있는지 확인하고 보고합니다.

스캔

지정된 이미지를 스캔하고 검사 결과를 반환합니다.

표 8.62. 옵션
-t,--timeout 기간요청의 최대 기간을 나타내는 API 요청의 시간 제한을 설정합니다. 기본값은 10m0s 입니다.

8.9.1. 상위 명령에서 상속된 roxctl image 명령 옵션

roxctl image 명령은 상위 roxctl 명령에서 상속된 다음 옵션을 지원합니다.

옵션설명

--CA 문자열

보안 연결을 위한 사용자 정의 CA 인증서 파일 경로를 지정합니다. 또는 ROX_CA_CERT_FILE 환경 변수를 사용하여 파일 경로를 지정할 수 있습니다.

--direct-grpc

연결 성능을 개선하기 위해 --direct-grpc 를 설정합니다. 또는 ROX_DIRECT_GRPC_CLIENT 환경 변수를 true 로 설정하면 직접 gRPC를 활성화할 수 있습니다. 기본값은 false입니다.

-e,--endpoint string

서비스에 연결할 엔드포인트를 설정합니다. 또는 ROX_ENDPOINT 환경 변수를 사용하여 엔드포인트를 설정할 수 있습니다. 기본값은 localhost:8443 입니다.

--force-http1

모든 연결에 대해 강제로 HTTP/1을 사용합니다. 또는 ROX_CLIENT_FORCE_HTTP1 환경 변수를 true 로 설정하여 HTTP/1을 강제로 사용할 수 있습니다. 기본값은 false입니다.

--insecure

비보안 연결 옵션을 활성화합니다. 또는 ROX_INSECURE_CLIENT 환경 변수를 true 로 설정하면 비보안 연결 옵션을 활성화할 수 있습니다. 기본값은 false입니다.

--insecure-skip-tls-verify

TLS 인증서 검증을 건너뜁니다. 또는 ROX_INSECURE_CLIENT_SKIP_TLS_VERIFY 환경 변수를 true 로 설정하면 TLS 인증서 검증을 건너뛸 수 있습니다. 기본값은 false입니다.

--no-color

색상 출력을 비활성화합니다. 또는 ROX_NO_COLOR 환경 변수를 true 로 설정하면 색상 출력을 비활성화할 수 있습니다. 기본값은 false입니다.

-p,--password 문자열

기본 인증의 암호를 지정합니다. 또는 ROX_ADMIN_PASSWORD 환경 변수를 사용하여 암호를 설정할 수 있습니다.

--plaintext

암호화되지 않은 연결을 사용합니다. 또는 ROX_PLAINTEXT 환경 변수를 true 로 설정하면 암호화되지 않은 연결을 활성화할 수 있습니다. 기본값은 false입니다.

-s,--server-name 문자열

SNI에 사용할 TLS 서버 이름을 설정합니다. 또는 ROX_SERVER_NAME 환경 변수를 사용하여 서버 이름을 설정할 수 있습니다.

--token-file 문자열

인증을 위해 지정된 파일에 제공된 API 토큰을 사용합니다. 또는 ROX_API_TOKEN 환경 변수를 사용하여 토큰을 설정할 수 있습니다.

참고

이러한 옵션은 roxctl image 명령의 모든 하위 명령에 적용됩니다.

8.9.2. roxctl 이미지 검사

지정된 이미지를 스캔하고 검사 결과를 반환합니다.

사용법

$ roxctl image scan [flags]

표 8.63. 옵션
옵션설명

--cluster 문자열

이미지 검사를 위임할 클러스터 이름 또는 ID를 지정합니다.

--compact-output

JSON 출력을 컴팩트 형식으로 출력합니다. 기본값은 false입니다.

--fail

취약점이 발견되면 실패합니다. 기본값은 false입니다.

-f, --force

중앙의 캐시를 무시하고 스캐너에서 새로 다시 가져옵니다. 기본값은 false입니다.

--headers 문자열

테이블 형식 출력에 출력할 헤더를 지정합니다. 기본값은 COMPONENT , VERSION ,CVE,SEVERITY, LINK 입니다.

--headers-as-comments

CSV 테이블 형식 출력에서 헤더를 주석으로 출력합니다. 기본값은 false입니다.

- I ,--image 문자열

이미지 이름 및 검사에 대한 참조를 지정합니다. 예를 들어 nginx:latest 또는 nginx@sha256:…​.

-a,--include-sno Cryostated

검사 결과에 sno Cryostated 및 unsnoounceed CVE를 포함합니다. 기본값은 false입니다.

--merge-output

표 형식 출력에서 중복 셀을 병합합니다. 기본값은 true입니다.

--no-header

테이블 형식 출력에 대한 헤더를 출력하지 마십시오. 기본값은 false입니다.

-o,--output 문자열

출력 형식을 지정합니다. 출력 형식에는 ,csv,json, sarif 가 포함됩니다.

-r,--retries int

오류로 종료하기 전에 재시도 횟수를 지정합니다. 기본값은 3입니다.

-d,--retry-delay int

재시도 횟수를 초 단위로 대기하도록 시간을 설정합니다. 기본값은 3입니다.

--row-jsonpath-expressions string

JSON 오브젝트에서 행을 생성하려면 JSON 경로 표현식을 지정합니다. 자세한 내용은 roxctl image scan --help 명령을 실행합니다.

--severity 문자열

출력에 포함할 심각도 목록입니다. 이를 사용하여 특정 심각도를 필터링합니다. 기본값은 LOW,MODERATE,중요, CRITICAL 입니다.

8.9.3. roxctl 이미지 검사

이미지에 빌드 시간 정책 위반이 있는지 확인하고 보고합니다.

사용법

$ roxctl image check [flags]

표 8.64. 옵션
옵션설명

-c,--categories 문자열

실행할 정책 카테고리 목록입니다. 기본적으로 모든 정책 범주가 사용됩니다.

--cluster 문자열

평가 컨텍스트로 사용할 클러스터 이름 또는 ID를 정의합니다.

--compact-output

JSON 출력을 컴팩트 형식으로 출력합니다. 기본값은 false입니다.

-f, --force

이미지의 중앙 캐시를 무시하고 스캐너에서 새 가져오기를 강제 적용합니다. 기본값은 false입니다.

--headers 문자열

표 형식 출력에 출력할 헤더를 정의합니다. 기본값은 POLICY,SEVERITY,BREAKS BUILD,DESCRIPTION ,VIOLATION, REMEDIATION 입니다.

--headers-as-comments

CSV 테이블 형식 출력에서 헤더를 주석으로 출력합니다. 기본값은 false입니다.

- I ,--image 문자열

이미지 이름 및 참조를 지정합니다. 예를 들면 nginx:latest 또는 nginx@sha256:…​ 입니다.

--JUnit-suite-name 문자열

JUnit 테스트 모음의 이름을 설정합니다. 기본값은 image-check 입니다.

--merge-output

표 형식 출력에서 중복 셀을 병합합니다. 기본값은 false입니다.

--no-header

테이블 형식 출력에 대한 헤더를 출력하지 마십시오. 기본값은 false입니다.

-o,--output 문자열

출력 형식을 선택합니다. 출력 형식에는 junit,sarif,table,csv, json 이 포함됩니다. 기본값은 table 입니다.

-r,--retries int

오류로 종료하기 전에 재시도 횟수를 설정합니다. 기본값은 3입니다.

-d,--retry-delay int

재시도 횟수를 초 단위로 대기하도록 시간을 설정합니다. 기본값은 3입니다.

--row-jsonpath-expressions string

JSON 경로 표현식을 사용하여 JSON 오브젝트에서 행을 생성합니다. 자세한 내용은 roxctl image check --help 명령을 실행합니다.

--send-notifications

위반 시 알림을 보낼지 여부를 정의합니다. 기본값은 false입니다.

Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

© 2024 Red Hat, Inc.