8.2. roxctl central
중앙 서비스와 관련된 명령입니다.
사용법
$ roxctl central [command] [flags]
명령 | 설명 |
---|---|
| RHACS(Red Hat Advanced Cluster Security for Kubernetes) 데이터베이스 및 인증서의 백업을 만듭니다. |
| 중앙 서비스의 인증서 체인을 다운로드합니다. |
| 데이터베이스 작업을 제어합니다. |
| Central 서비스를 디버깅합니다. |
| Central 배포에 대한 오케스트레이터 오브젝트가 포함된 필수 YAML 구성 파일을 생성합니다. |
| Central용 번들을 초기화합니다. |
| 중앙 인스턴스에 로그인하여 토큰을 가져옵니다. |
| 사용자 인증서 권한 부여 공급자를 관리합니다. |
| 현재 사용자와 해당 인증 방법에 대한 정보를 표시합니다. |
8.2.1. 상위 명령에서 상속된 roxctl 중앙 명령 옵션
roxctl central
명령은 상위 roxctl
명령에서 상속된 다음 옵션을 지원합니다.
옵션 | 설명 |
---|---|
|
보안 연결을 위한 사용자 정의 CA 인증서 파일 경로를 지정합니다. 또는 |
|
연결 성능을 개선하기 위해 |
|
서비스에 연결할 엔드포인트를 설정합니다. 또는 |
|
모든 연결에 대해 강제로 HTTP/1을 사용합니다. 또는 |
|
비보안 연결 옵션을 활성화합니다. 또는 |
|
TLS 인증서 검증을 건너뜁니다. 또는 |
|
색상 출력을 비활성화합니다. 또는 |
|
기본 인증의 암호를 지정합니다. 또는 |
|
암호화되지 않은 연결을 사용합니다. 또는 |
|
SNI에 사용할 TLS 서버 이름을 설정합니다. 또는 |
|
인증을 위해 지정된 파일에 제공된 API 토큰을 사용합니다. 또는 |
이러한 옵션은 roxctl central
명령의 모든 하위 명령에 적용됩니다.
8.2.2. roxctl 중앙 백업
RHACS 데이터베이스 및 인증서의 백업을 생성합니다.
사용법
$ roxctl central backup [flags]
옵션 | 설명 |
---|---|
|
인증서를 백업하도록 지정합니다. 외부 데이터베이스를 사용하는 경우 이 옵션은 인증서가 있는 백업 번들을 생성하는 데 사용됩니다. 기본값은 |
| 백업을 저장할 위치를 지정합니다. 동작은 지정된 경로에 따라 다릅니다.
|
|
API 요청에 대한 타임아웃을 지정합니다. 요청의 최대 기간을 나타냅니다. 기본값은 |
8.2.3. roxctl 중앙 인증서
중앙 서비스의 인증서 체인을 다운로드합니다.
사용법
$ roxctl central cert [flags]
옵션 | 설명 |
---|---|
|
PEM 인증서를 저장할 파일 이름을 지정합니다. |
|
API 요청을 다시 시도한 후 타임아웃을 지정합니다. 값이 0이면 다시 시도하지 않고 전체 요청 기간이 대기됩니다. 기본값은 |
|
요청의 최대 기간을 나타내는 API 요청의 시간 제한을 지정합니다. 기본값은 |
8.2.4. roxctl 중앙 로그인
중앙 인스턴스에 로그인하여 토큰을 가져옵니다.
사용법
$ roxctl central login [flags]
옵션 | 설명 |
---|---|
|
요청의 최대 기간을 나타내는 API 요청의 시간 제한을 지정합니다. 기본값은 |
8.2.5. roxctl central whoami
현재 사용자와 해당 인증 방법에 대한 정보를 표시합니다.
사용법
$ roxctl central whoami [flags]
옵션 | 설명 |
---|---|
|
API 요청을 다시 시도한 후 타임아웃을 지정합니다. 값이 0이면 다시 시도하지 않고 전체 요청 기간이 대기됩니다. 기본값은 |
|
요청의 최대 기간을 나타내는 API 요청의 시간 제한을 지정합니다. 기본값은 |
8.2.6. roxctl central db
데이터베이스 작업을 제어합니다.
사용법
$ roxctl central db [flags]
옵션 | 설명 |
---|---|
|
요청의 최대 기간을 나타내는 API 요청의 시간 제한을 지정합니다. 기본값은 |
8.2.6.1. roxctl central db restore
이전 백업에서 RHACS 데이터베이스를 복원합니다.
사용법
$ roxctl central db restore <file> [flags] 1
- 1
- &
lt;file
>의 경우 복원할 데이터베이스 백업 파일을 지정합니다.
옵션 | 설명 |
---|---|
|
|
|
|
8.2.6.2. roxctl central db generate
중앙 데이터베이스 번들을 생성합니다.
사용법
$ roxctl central db generate [flags]
옵션 | 설명 |
---|---|
|
|
|
로컬 파일 시스템에서 Helm 템플릿의 경로를 지정합니다. 자세한 내용은 |
|
|
8.2.6.3. roxctl central db generate k8s
중앙의 데이터베이스 구성 요소를 배포하기 위한 Kubernetes YAML 파일을 생성합니다.
사용법
$ roxctl central db generate k8s [flags]
옵션 | 설명 |
---|---|
|
사용하려는 중앙 데이터베이스 이미지를 지정합니다. 지정하지 않으면 |
|
컨테이너 이미지의 기본 설정을 지정합니다. 이미지가 다운로드되는 리포지토리, 이미지 이름 및 태그 형식을 제어합니다. 기본값은 |
|
배포 번들을 저장할 디렉터리를 지정합니다. 기본값은 |
8.2.6.4. roxctl central db restore cancel
진행 중인 중앙 데이터베이스 복원 프로세스를 취소합니다.
사용법
$ roxctl central db restore cancel [flags]
옵션 | 설명 |
---|---|
|
|
8.2.6.5. roxctl central db restore status
진행 중인 데이터베이스 복원 프로세스에 대한 정보를 표시합니다.
사용법
$ roxctl central db restore status [flags]
8.2.6.6. roxctl central db generate k8s pvc
Central에서 PVC(영구 볼륨 클레임)에 대한 Kubernetes YAML 파일을 생성합니다.
사용법
$ roxctl central db generate k8s pvc [flags]
옵션 | 설명 |
---|---|
|
Central 데이터베이스의 외부 볼륨 이름을 지정합니다. 기본값은 |
|
중앙 데이터베이스의 외부 볼륨 크기(GB)를 지정합니다. 기본값은 |
| Central 데이터베이스의 스토리지 클래스 이름을 지정합니다. 기본 스토리지 클래스가 구성된 경우 선택 사항입니다. |
8.2.6.7. roxctl central db generate openshift
Red Hat OpenShift 클러스터에 Central 데이터베이스 인스턴스를 배포하기 위한 OpenShift YAML 매니페스트를 생성합니다.
사용법
$ roxctl central db generate openshift [flags]
옵션 | 설명 |
---|---|
|
사용하려는 중앙 데이터베이스 이미지를 지정합니다. 지정하지 않으면 |
|
컨테이너 이미지의 기본 설정을 지정합니다. 이미지가 다운로드되는 리포지토리, 이미지 이름 및 태그 형식을 제어합니다. 기본값은 |
|
배포에 Red Hat OpenShift 주요 버전 3 또는 4를 지정합니다. 기본값은 |
|
배포 번들을 저장할 디렉터리를 지정합니다. 기본값은 |
8.2.6.8. roxctl central db generate k8s hostpath
Central에서 hostpath 볼륨 유형을 사용하여 데이터베이스 배포에 대한 Kubernetes YAML 매니페스트를 생성합니다.
사용법
$ roxctl central db generate k8s hostpath [flags]
옵션 | 설명 |
---|---|
|
호스트의 경로를 지정합니다. 기본값은 |
|
노드 선택기 키를 지정합니다. 유효한 값에는 |
| 노드 선택기 값을 지정합니다. |
8.2.6.9. roxctl central db generate openshift pvc
Central의 PVC(영구 볼륨 클레임)를 사용하여 데이터베이스 배포에 대한 OpenShift YAML 매니페스트를 생성합니다.
사용법
$ roxctl central db generate openshift pvc [flags]
옵션 | 설명 |
---|---|
--name 문자열 |
Central 데이터베이스의 외부 볼륨 이름을 지정합니다. 기본값은 |
--size uint32 |
중앙 데이터베이스의 외부 볼륨 크기(GB)를 지정합니다. 기본값은 |
--storage-class string | Central 데이터베이스의 스토리지 클래스 이름을 지정합니다. 기본 스토리지 클래스가 구성된 경우 선택 사항입니다. |
8.2.6.10. roxctl central db generate openshift hostpath
Central 데이터베이스에 hostpath 외부 볼륨을 추가합니다.
사용법
$ roxctl central db generate openshift hostpath [flags]
옵션 | 설명 |
---|---|
|
호스트의 경로를 지정합니다. 기본값은 |
|
노드 선택기 키를 지정합니다. 유효한 값에는 |
| 노드 선택기 값을 지정합니다. |
8.2.7. roxctl 중앙 디버그
Central 서비스를 디버깅합니다.
사용법
$ roxctl central debug [flags]
8.2.7.1. roxctl central debug db
데이터베이스 디버깅을 제어합니다.
사용법
$ roxctl central debug db [flags]
옵션 | 설명 |
---|---|
|
요청의 최대 기간을 나타내는 API 요청의 시간 제한을 지정합니다. 기본값은 |
8.2.7.2. roxctl 중앙 디버그 로그
현재 로그 수준을 검색합니다.
사용법
$ roxctl central debug log [flags]
옵션 | 설명 |
---|---|
|
모듈을 설정할 로그 수준을 지정합니다. 유효한 값에는 |
| 명령을 적용할 모듈을 지정합니다. |
|
API 요청을 다시 시도한 후 타임아웃을 지정합니다. 값이 0이면 다시 시도하지 않고 전체 요청 기간이 대기됩니다. 기본값은 |
|
API 요청에 대한 시간 제한을 지정합니다. 이는 요청의 최대 기간입니다. 기본값은 |
8.2.7.3. roxctl 중앙 디버그 덤프
Central에 대한 디버그 정보가 포함된 번들을 다운로드합니다.
사용법
$ roxctl central debug dump [flags]
옵션 | 설명 |
---|---|
|
|
| 번들 콘텐츠의 출력 디렉터리를 지정합니다. 기본값은 현재 디렉터리 내에서 자동으로 생성된 디렉터리 이름입니다. |
|
API 요청에 대한 시간 제한을 지정합니다. 이는 요청의 최대 기간입니다. 기본값은 |
8.2.7.4. roxctl central debug db stats
중앙 데이터베이스의 통계를 제어합니다.
사용법
$ roxctl central debug db stats [flags]
8.2.7.5. roxctl central debug authz-trace
디버깅을 위해 Central에서 권한 부여 추적을 활성화하거나 비활성화합니다.
사용법
$ roxctl central debug authz-trace [flags]
옵션 | 설명 |
---|---|
|
요청의 최대 기간을 나타내는 API 요청의 시간 제한을 지정합니다. 기본값은 |
8.2.7.6. roxctl central debug db stats reset
중앙 데이터베이스의 통계를 재설정합니다.
사용법
$ roxctl central debug db stats reset [flags]
8.2.7.7. roxctl central debug download-diagnostics
플랫폼에 대한 진단 정보의 스냅샷이 포함된 번들을 다운로드합니다.
사용법
$ roxctl central debug download-diagnostics [flags]
옵션 | 설명 |
---|---|
| 로그를 수집하려는 센서 클러스터의 쉼표로 구분된 목록을 지정합니다. |
| 진단 번들을 저장할 출력 디렉터리를 지정합니다. |
| 센서 클러스터에서 로그를 수집할 타임스탬프를 지정합니다. |
|
요청의 최대 기간을 지정하는 API 요청의 시간 제한을 지정합니다. 기본값은 |
8.2.8. roxctl central generate
Central을 배포하는 오케스트레이터 오브젝트가 포함된 필수 YAML 구성 파일을 생성합니다.
사용법
$ roxctl central generate [flags]
옵션 | 설명 |
---|---|
| 키와 인증서를 복원할 백업 번들의 경로를 지정합니다. |
|
|
|
로컬 파일 시스템에서 Helm 템플릿의 경로를 지정합니다. 자세한 내용은 |
| 기본값으로 사용할 PEM 인증서 번들 파일을 지정합니다. |
| 기본값으로 사용할 PEM 개인 키 파일을 지정합니다. |
|
|
| 관리자 암호를 지정합니다. 기본값은 자동으로 생성됩니다. |
| 암호화되지 않은 노출에 사용할 포트 또는 끝점을 쉼표로 구분된 목록으로 지정합니다. |
8.2.8.1. roxctl central generate k8s
Kubernetes 클러스터에 Central을 배포하는 데 필요한 YAML 구성 파일을 생성합니다.
사용법
$ roxctl central generate k8s [flags]
옵션 | 설명 |
---|---|
|
사용할 중앙 데이터베이스 이미지를 지정합니다. 지정하지 않으면 |
| Central에서 선언적 구성 마운트로 추가할 구성 맵 목록을 지정합니다. |
| Central에서 선언적 구성 마운트로 추가할 보안 목록을 지정합니다. |
|
Telemetry를 활성화할지 여부를 지정합니다. 기본값은 |
|
컨테이너 이미지의 기본 설정을 지정합니다. 지정된 설정은 이미지가 다운로드되는 리포지토리, 이미지 이름 및 태그 형식을 제어합니다. 기본값은 |
|
지정된 Istio 버전을 지원하는 배포 파일을 생성합니다. 유효한 값에는 |
|
Central을 일시 중단할 메서드를 지정합니다. 유효한 값에는 |
|
사용하려는 기본 이미지를 지정합니다. 지정하지 않으면 |
|
인터넷에 연결하지 않도록 RHACS를 오프라인 모드로 실행할지 여부를 지정합니다. 기본값은 |
|
배포 번들을 저장할 디렉터리를 지정합니다. 기본값은 |
|
사용할 배포 도구를 지정합니다. 유효한 값에는 |
|
사용할 스캐너 데이터베이스 이미지를 지정합니다. 지정하지 않으면 |
| 사용하려는 스캐너 이미지를 지정합니다. 지정하지 않으면 '--image-defaults"에 해당하는 기본값이 사용됩니다. |
8.2.8.2. roxctl central generate k8s pvc
Central에서 PVC(영구 볼륨 클레임)에 대한 Kubernetes YAML 파일을 생성합니다.
사용법
$ roxctl central generate k8s pvc [flags]
옵션 | 설명 |
---|---|
|
Central 데이터베이스의 외부 볼륨 이름을 지정합니다. 기본값은 |
|
중앙 데이터베이스의 외부 볼륨 크기(GB)를 지정합니다. 기본값은 |
| Central 데이터베이스의 스토리지 클래스 이름을 지정합니다. 기본 스토리지 클래스가 구성된 경우 선택 사항입니다. |
|
Central의 외부 볼륨 이름을 지정합니다. 기본값은 |
|
Central의 외부 볼륨 크기(GB)를 지정합니다. 기본값은 |
| Central의 스토리지 클래스 이름을 지정합니다. 기본 스토리지 클래스가 구성된 경우 선택 사항입니다. |
8.2.8.3. roxctl central generate openshift
Red Hat OpenShift 클러스터에 Central을 배포하는 데 필요한 YAML 구성 파일을 생성합니다.
사용법
$ roxctl central generate openshift [flags]
옵션 | 설명 |
---|---|
|
사용하려는 중앙 데이터베이스 이미지를 지정합니다. 지정하지 않으면 |
| Central에서 선언적 구성 마운트로 추가할 구성 맵 목록을 지정합니다. |
| Central에서 선언적 구성 마운트로 추가할 보안 목록을 지정합니다. |
|
Telemetry를 활성화할지 여부를 지정합니다. 기본값은 |
|
컨테이너 이미지의 기본 설정을 지정합니다. 이미지가 다운로드되는 리포지토리, 이미지 이름 및 태그 형식을 제어합니다. 기본값은 |
|
지정된 Istio 버전을 지원하는 배포 파일을 생성합니다. 유효한 값에는 |
|
중앙 노출 방법을 지정합니다. 유효한 값에는 |
|
사용하려는 기본 이미지를 지정합니다. 지정하지 않으면 |
|
인터넷에 연결하지 않도록 RHACS를 오프라인 모드로 실행할지 여부를 지정합니다. 기본값은 |
|
Red Hat OpenShift 4 모니터링과 통합을 지정합니다. 기본값은 |
| 배포에 Red Hat OpenShift 주요 버전 3 또는 4를 지정합니다. |
|
배포 번들을 저장할 디렉터리를 지정합니다. 기본값은 |
|
사용할 배포 도구를 지정합니다. 유효한 값에는 |
|
사용할 스캐너 데이터베이스 이미지를 지정합니다. 지정하지 않으면 |
|
사용하려는 스캐너 이미지를 지정합니다. 지정하지 않으면 |
8.2.8.4. roxctl central generate interactive
Central에서 대화형 리소스를 생성합니다.
사용법
$ roxctl central generate interactive [flags]
8.2.8.5. roxctl central generate k8s hostpath
hostpath 볼륨 유형을 사용하여 Central 인스턴스를 배포하기 위한 Kubernetes YAML 매니페스트를 생성합니다.
사용법
$ roxctl central generate k8s hostpath [flags]
옵션 | 설명 |
---|---|
|
Central 데이터베이스의 호스트 경로를 지정합니다. 기본값은 |
|
Central 데이터베이스의 노드 선택기 키를 지정합니다. 유효한 값에는 |
| Central 데이터베이스의 노드 선택기 값을 지정합니다. |
|
호스트의 경로를 지정합니다. 기본값은 |
|
노드 선택기 키를 지정합니다. 유효한 값에는 |
| 노드 선택기 값을 지정합니다. |
8.2.8.6. roxctl central generate openshift pvc
Central에 PVC(영구 볼륨 클레임)를 배포하기 위한 OpenShift YAML 매니페스트를 생성합니다.
사용법
$ roxctl central generate openshift pvc [flags]
옵션 | 설명 |
---|---|
|
Central 데이터베이스의 외부 볼륨 이름을 지정합니다. 기본값은 |
|
중앙 데이터베이스의 외부 볼륨 크기(GB)를 지정합니다. 기본값은 |
| Central 데이터베이스의 스토리지 클래스 이름을 지정합니다. 기본 스토리지 클래스가 구성된 경우 선택 사항입니다. |
|
Central의 외부 볼륨 이름을 지정합니다. 기본값은 |
|
Central의 외부 볼륨 크기(GB)를 지정합니다. 기본값은 |
| Central의 스토리지 클래스 이름을 지정합니다. 기본 스토리지 클래스가 구성된 경우 선택 사항입니다. |
8.2.8.7. roxctl central generate openshift hostpath
Red Hat OpenShift의 배포 정의에 hostpath 외부 볼륨을 추가합니다.
사용법
$ roxctl central generate openshift hostpath [flags]
옵션 | 설명 |
---|---|
|
Central 데이터베이스의 호스트 경로를 지정합니다. 기본값은 |
|
노드 선택기 키를 지정합니다. 유효한 값에는 |
| Central 데이터베이스의 노드 선택기 값을 지정합니다. |
|
호스트의 경로를 지정합니다. 기본값은 |
|
노드 선택기 키를 지정합니다. 유효한 값에는 |
| 노드 선택기 값을 지정합니다. |
8.2.9. roxctl central init-bundles
Central에서 번들을 초기화합니다.
사용법
$ roxctl central init-bundles [flag]
옵션 | 설명 |
---|---|
|
API 요청을 다시 시도한 후 타임아웃을 지정합니다. 값이 |
|
요청의 최대 기간을 나타내는 API 요청의 시간 제한을 지정합니다. 기본값은 |
8.2.9.1. roxctl central init-bundles 목록
Central에서 사용 가능한 초기화 번들을 나열합니다.
사용법
$ roxctl central init-bundles list [flags]
8.2.9.2. roxctl central init-bundles 취소
Central에서 하나 이상의 클러스터 초기화 번들을 취소합니다.
사용법
$ roxctl central init-bundles revoke <init_bundle_ID or name> [<init_bundle_ID or name> ...] [flags] 1
- 1
- &
lt;init_bundle_ID 또는 name
>의 경우 취소하려는 초기화 번들의 ID 또는 이름을 지정합니다. 공백을 사용하여 구분된 여러 ID 또는 이름을 제공할 수 있습니다.
8.2.9.3. roxctl central init-bundles fetch-ca
Central에서 CA(인증 기관) 번들을 가져옵니다.
사용법
$ roxctl central init-bundles fetch-ca [flags]
옵션 | 설명 |
---|---|
| CA 구성을 저장하는 데 사용할 파일을 지정합니다. |
8.2.9.4. roxctl central init-bundles generate
새 클러스터 초기화 번들을 생성합니다.
사용법
$ roxctl central init-bundles generate <init_bundle_name> [flags] 1
- 1
- &
lt;init_bundle_name
> 의 경우 생성할 초기화 번들의 이름을 지정합니다.
옵션 | 설명 |
---|---|
|
새로 생성된 초기화 번들을 Helm 구성 형식으로 저장하는 데 사용할 파일을 지정합니다. |
|
새로 생성된 초기화 번들을 Kubernetes 시크릿 형식으로 저장하는 데 사용할 파일을 지정합니다. 다음을 사용하여 표준을 생성할 수 있습니다. |
8.2.10. roxctl central userpki
사용자 인증서 권한 부여 공급자를 관리합니다.
사용법
$ roxctl central userpki [flags]
8.2.10.1. roxctl central userpki list
모든 사용자 인증서 인증 공급자를 표시합니다.
사용법
$ roxctl central userpki list [flags]
옵션 | 설명 |
---|---|
|
JSON 출력을 활성화합니다. 기본값은 |
|
API 요청을 다시 시도한 후 타임아웃을 지정합니다. 값이 0이면 다시 시도하지 않고 전체 요청 기간이 대기됩니다. 기본값은 |
|
요청의 최대 기간을 나타내는 API 요청의 시간 제한을 지정합니다. 기본값은 |
8.2.10.2. roxctl 중앙 사용자pki create
새 사용자 인증서 인증 공급자를 생성합니다.
사용법
$ roxctl central userpki create name [flags]
옵션 | 설명 |
---|---|
| 루트 CA 인증서의 PEM 파일을 지정합니다. 여러 인증서 파일을 지정할 수 있습니다. |
|
API 요청을 다시 시도한 후 타임아웃을 지정합니다. 값이 0이면 다시 시도하지 않고 전체 요청 기간이 대기됩니다. 기본값은 |
| 이 공급자의 사용자에 대한 최소 액세스 역할을 지정합니다. |
|
요청의 최대 기간을 나타내는 API 요청의 시간 제한을 지정합니다. 기본값은 |
8.2.10.3. roxctl central userpki delete
사용자 인증서 인증 공급자를 삭제합니다.
사용법
$ roxctl central userpki delete id|name [flags]
옵션 | 설명 |
---|---|
|
|
|
API 요청을 다시 시도한 후 타임아웃을 지정합니다. 값이 0이면 다시 시도하지 않고 전체 요청 기간이 대기됩니다. 기본값은 |
|
요청의 최대 기간을 나타내는 API 요청의 시간 제한을 지정합니다. 기본값은 |