/bin/bash <(curl -fsSL https://raw.githubusercontent.com/stackrox/stackrox/master/scripts/quick-helm-install.sh)

StackRox의 기본 배포에는 특정 CPU 및 메모리 요청이 있으며, 충분한 리소스를 사용할 수 없는 경우 소규모(예: 개발) 클러스터에서 실패할 수 있습니다. 리소스가 제한된 소규모 클러스터에 StackRox를 설치하려면 --small 명령줄 옵션을 사용할 수 있습니다. 이 옵션은 프로덕션 배포에는 권장되지 않습니다.

/bin/bash <(curl -fsSL https://raw.githubusercontent.com/stackrox/stackrox/master/scripts/quick-helm-install.sh) --small

스크립트는 StackRox helm 저장소를 추가하고, 관리자 비밀번호를 생성하며, stackrox-central-services를 설치하고, stackrox-secured-cluster-services 프로비저닝을 위한 init 번들을 생성한 뒤, 마지막으로 동일한 클러스터에 stackrox-secured-cluster-services를 설치합니다.

마지막으로 스크립트는 자동으로 브라우저를 열고 StackRox에 로그인합니다. 인증서가 자체 서명되어 있으므로 인증서 경고가 표시될 수 있습니다. 경고에 대한 자세한 내용은 StackRox 사용자 인터페이스(UI) 접속 섹션을 참조하십시오. 인증 후 https://localhost:8000/main/dashboard를 통해 대시보드에 접속할 수 있습니다.

먼저 StackRox Central Services가 Kubernetes 클러스터에 추가됩니다. 여기에는 UI와 Scanner가 포함됩니다. 시작하려면 stackrox/helm-charts/opensource 저장소를 Helm에 추가하십시오.

helm repo add stackrox https://raw.githubusercontent.com/stackrox/helm-charts/main/opensource/

저장소에서 사용 가능한 모든 Helm 차트를 확인하려면 다음을 실행하세요 (비릴리스 빌드도 표시하려면 --devel 옵션을 추가할 수 있습니다)

helm search repo stackrox

stackrox-central-services를 설치하려면 보안 비밀번호가 필요합니다. 이 비밀번호는 나중에 UI 로그인과 init 번들 생성 시 필요합니다.

ROX_ADMIN_PASSWORD="$(openssl rand -base64 20 | tr -d '/=+')"

여기에서 stackrox-central-services를 설치하여 클러스터에 Central 및 Scanner 구성 요소를 배포할 수 있습니다.

참고: 여러 클러스터를 보호할 계획이더라도 stackrox-central-services 인스턴스는 하나만 배포하면 됩니다.

설치를 수행하려면 클러스터 크기에 따라 다음 명령 중 하나를 선택하십시오.

기본 Central 설치

적당한 규모의 클러스터에 설치하는 경우 기본 설치 명령을 사용하십시오:

helm upgrade --install -n stackrox --create-namespace stackrox-central-services \
  stackrox/stackrox-central-services \
  --set central.adminPassword.value="${ROX_ADMIN_PASSWORD}" \
  --set central.persistence.none="true"

리소스가 제한된 클러스터에서의 중앙 설치

단일 노드 클러스터에 설치하거나, 리소스 부족으로 인해 기본 설치 시 파드가 pending 상태로 멈추는 경우, stackrox-central-services의 리소스 요구 사항을 줄이려면 대신 다음 명령을 사용하세요. 이렇게 축소된 리소스 설정은 프로덕션 환경에는 적합하지 않다는 점을 유의하세요.

helm upgrade --install -n stackrox --create-namespace stackrox-central-services \
  stackrox/stackrox-central-services \
  --set central.adminPassword.value="${ROX_ADMIN_PASSWORD}" \
  --set central.persistence.none="true" \
  --set central.resources.requests.memory=1Gi \
  --set central.resources.requests.cpu=1 \
  --set central.resources.limits.memory=4Gi \
  --set central.resources.limits.cpu=1 \
  --set central.db.resources.requests.memory=1Gi \
  --set central.db.resources.requests.cpu=500m \
  --set central.db.resources.limits.memory=4Gi \
  --set central.db.resources.limits.cpu=1 \
  --set scanner.autoscaling.disable=true \
  --set scanner.replicas=1 \
  --set scanner.resources.requests.memory=500Mi \
  --set scanner.resources.requests.cpu=500m \
  --set scanner.resources.limits.memory=2500Mi \
  --set scanner.resources.limits.cpu=2000m

다음으로, Kubernetes 노드로부터 정보를 수집하기 위해 보안 클러스터 구성 요소를 배포해야 합니다.

CLUSTER_NAME 셸 변수에 보안 클러스터의 의미 있는 클러스터 이름을 설정하십시오. 이 이름으로 StackRox UI의 클러스터 목록에서 클러스터가 식별됩니다.

CLUSTER_NAME="my-secured-cluster"

Secured Cluster Services가 통신해야 하는 Central의 엔드포인트를 설정합니다. stackrox-secured-cluster-services를 stackrox-central-services와 동일한 클러스터에 배포하는 경우 표시된 대로 두고, 그렇지 않으면 값을 Central에 접근할 수 있는 엔드포인트로 변경합니다.

CENTRAL_ENDPOINT="central.stackrox.svc:443"

초기화 시크릿을 포함하는 init 번들을 생성합니다. init 번들은 stackrox-init-bundle.yaml에 저장되며, 아래와 같이 보안이 적용된 클러스터를 프로비저닝하는 데 사용됩니다.

echo "$ROX_ADMIN_PASSWORD" | \
kubectl -n stackrox exec -i deploy/central -- bash -c 'ROX_ADMIN_PASSWORD=$(cat) roxctl --insecure-skip-tls-verify \
  central init-bundles generate stackrox-init-bundle --output -' > stackrox-init-bundle.yaml

그런 다음 stackrox-secured-cluster-services를 설치합니다(방금 생성한 init bundle과 함께).

설치를 수행하려면 클러스터 크기에 따라 다음 명령 중 하나를 선택하십시오.

기본 Secured Cluster Services 설치

적당한 규모의 클러스터에 설치하는 경우 기본 설치 명령을 사용하십시오:

helm upgrade --install -n stackrox --create-namespace stackrox-secured-cluster-services \
  stackrox/stackrox-secured-cluster-services \
  -f stackrox-init-bundle.yaml \
  --set clusterName="$CLUSTER_NAME" \
  --set centralEndpoint="$CENTRAL_ENDPOINT"

제한된 리소스를 가진 클러스터에 Secured Cluster Services 설치

단일 노드 클러스터에 설치하거나, 기본 설치 시 리소스 부족으로 인해 파드가 pending 상태로 멈추는 경우, stackrox-secured-cluster-services의 리소스 요구 사항을 줄이기 위해 다음 명령을 대신 사용하십시오. 이러한 축소된 리소스 설정은 프로덕션 환경에는 적합하지 않다는 점을 유의하십시오.