중앙 보안 클러스터 서비스가 통신할 엔드포인트를 설정합니다. stackrox-secured-cluster-services를 stackrox-central-services와 동일한 클러스터에 배포하는 경우 표시된 대로 그대로 두고, 그렇지 않으면 Central에 액세스할 수 있는 엔드포인트로 값을 변경합니다.```sh
CENTRAL_ENDPOINT="central.stackrox.svc:443"

그런 다음 stackrox-secured-cluster-services를 (방금 생성한 init 번들과 함께) 설치하십시오.

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

#### 기본 보안 클러스터 서비스 설치

적당한 크기의 클러스터에 설치하는 경우 기본 설치 명령을 사용하십시오:```sh
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"

</details>

<details>
<summary>Helm 차트에 대한 추가 정보</summary>

Helm 설치를 추가로 사용자 정의하려면 다음 문서를 참조하십시오:

* <https://docs.openshift.com/acs/installing/installing_other/install-central-other.html#install-using-helm-customizations-other>
* <https://docs.openshift.com/acs/installing/installing_other/install-secured-cluster-other.html#configure-secured-cluster-services-helm-chart-customizations-other>

</details>

### 스크립트를 통한 설치

`deploy` 스크립트는 다음을 수행합니다:

1. **StackRox Central Services** 시작
2. 클러스터 구성 및 서비스 ID 생성
3. 해당 구성과 자격 증명을 사용하여 **StackRox Secured Cluster Services** 배포

원하는 버전을 사용하려면 셸에서 환경 변수 `MAIN_IMAGE_TAG`를 설정할 수 있습니다.

커밋을 체크아웃하면 스크립트는 기본적으로 해당 커밋에 해당하는 이미지를 실행합니다. 필요한 경우 이미지를 가져옵니다.

추가 단계는 오케스트레이터에 따라 다릅니다.

#### Kubernetes 배포판 (EKS, AKS, GKE)

<details><summary>펼치려면 클릭</summary>

아래 가이드에 따라 `stackrox` 네임스페이스의 Kubernetes 클러스터에 특정 버전의 StackRox를 빠르게 배포하세요. 특정 버전을 설치하려면 `MAIN_IMAGE_TAG`에 정의/설정했는지 확인하십시오. 그렇지 않으면 최신 나이틀리 빌드가 설치됩니다.

원하는 작업 디렉터리에서 다음을 실행하십시오:```
git clone [email protected]:stackrox/stackrox.git
cd stackrox
MAIN_IMAGE_TAG=VERSION_TO_USE ./deploy/deploy.sh

After a few minutes, all resources should be deployed. The process will complete with this message.

**Credentials for the 'admin' user can be found in the `./deploy/openshift/central-deploy/password` file.**

> **Note:**
> While the password file is stored in plaintext on your local filesystem, the Kubernetes Secret StackRox uses is encrypted, and you will not be able to alter the secret at runtime. If you loose the password, you will have to redeploy central.

</details>

#### Docker Desktop, Colima, or minikube

<details><summary>Click to Expand</summary>

Run the following in your working directory of choice:```
git clone [email protected]:stackrox/stackrox.git
cd stackrox
MAIN_IMAGE_TAG=latest ./deploy/deploy-local.sh

그런 다음 웹 브라우저에서 https://localhost:8000/로 이동하세요.

**사용자 이름** = 기본 사용자는 `admin`입니다.

**비밀번호 (Helm)**   = 비밀번호는 수동 설치 후 `$ROX_ADMIN_PASSWORD`에 있거나, 빠른 설치 스크립트의 끝에 출력됩니다.

**비밀번호 (스크립트)** = 비밀번호는 스크립트 설치의 경우 `/deploy/<orchestrator>/central-deploy/password.txt` 폴더에 위치합니다.

</details>

---
## 개발

- 기여할 계획이 있으면 [**풀 리퀘스트 가이드라인**](https://github.com/stackrox/stackrox/blob/HEAD/.github/contributing.md)부터 시작하세요.
- 중요하지 않은 코드 제출의 경우 [**shepherding**](https://github.com/stackrox/stackrox/blob/HEAD/.github/shepherding.md)을 참고하세요.
- [**AI 정책**](https://github.com/stackrox/stackrox/blob/HEAD/.github/using-llms.md)을 확인하세요.
- **Go 코딩 스타일 가이드**: [go-coding-style.md](https://github.com/stackrox/stackrox/blob/HEAD/.github/go-coding-style.md)
- **UI 개발 문서**: [ui/README.md](https://github.com/stackrox/stackrox/blob/HEAD/ui/README.md)를 참조하세요.
- **E2E 개발 문서**: [qa-tests-backend/README.md](https://github.com/stackrox/stackrox/blob/HEAD/qa-tests-backend/README.md)를 참조하세요.

### 빠른 시작

#### 빌드 도구

다음 도구들은 코드를 테스트하고 이미지를 빌드하는 데 필요합니다:

<details><summary>클릭하여 펼치기</summary>

* [Make](https://www.gnu.org/software/make/)
* [Go](https://golang.org/dl/)
* `make reinstall-dev-tools`를 사용하여 설치할 수 있는 다양한 Go 린터.
* [ui/README.md](https://github.com/stackrox/stackrox/blob/HEAD/ui/README.md#Build-Tooling)에 명시된 UI 빌드 도구.
* [Docker](https://docs.docker.com/get-docker/)
  * 참고: Docker Desktop은 이제 대규모 엔터프라이즈 회사의 경우 유료 구독이 필요합니다.
  * 일부 StackRox 개발자들은 [Colima](https://github.com/abiosoft/colima)를 권장합니다.
* [Xcode](https://developer.apple.com/xcode/) 명령줄 도구 (macOS 전용)
* [Bats](https://github.com/sstephenson/bats)는 특정 셸 테스트를 실행하는 데 사용됩니다.
  `brew install bats` 또는 `npm install -g bats`로 얻을 수 있습니다.
* [oc](https://mirror.openshift.com/pub/openshift-v4/x86_64/clients/ocp/stable/) OpenShift CLI 도구
* 셸 스크립트 린팅을 위한 [shellcheck](https://github.com/koalaman/shellcheck#installing).

**Xcode - macOS 전용**

일반적으로 brew를 통해 이미 설치되어 있을 것입니다.
그러나 golang x/tools를 빌드할 때 오류가 발생하면,
먼저 EULA에 동의했는지 확인하세요:

1. Xcode를 시작합니다.
2. 새로운 빈 앱 프로젝트를 빌드합니다.
3. 에뮬레이터에서 빈 프로젝트 앱을 시작합니다.
4. 에뮬레이터와 Xcode를 모두 닫은 다음,
5. 다음 명령어를 실행하세요: ```bash
 xcode-select --install
 sudo xcode-select --switch /Library/Developer/CommandLineTools # Enable command line tools
 sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

</details>

#### 로컬 개발

<details><summary>클릭하여 펼치기</summary>

더 나은 경험을 위해, [워크플로 스크립트](#productivity)를 미리 설치하세요.```bash
$ cd $GOPATH/src/github.com/stackrox/stackrox
$ make install-dev-tools
$ make image

자세한 내용은 [Installation via Scripts](#installation-via-scripts)를 참조하십시오. 환경 변수에 대한 자세한 내용은
[deploy/README.md](https://github.com/stackrox/stackrox/blob/master/deploy/README.md#env-variables)를 참조하십시오.

</details>

#### 일반 Makefile 대상

<details><summary>펼쳐보려면 클릭</summary>```bash
# Build image, this will create `stackrox/main` with a tag defined by `make tag`.
$ make image

# Compile all binaries
$ make main-build-dockerized

# Displays the docker image tag which would be generated
$ make tag

# Note: there are integration tests in some components, and we currently
# run those manually. They will be re-enabled at some point.
$ make test

# Apply and check style standards in Go and JavaScript
$ make style

# enable pre-commit hooks for style checks
$ make init-githooks

# Compile and restart only central
$ make fast-central

# Compile only sensor
$ make fast-sensor

# Only compile protobuf
$ make proto-generated-srcs

</details>

#### GoLand 구성

<details><summary>펼쳐보기</summary>

GoLand를 사용하여 개발한다면, 다음 설정이 도움이 될 수 있습니다.


`Protocol Buffers` 플러그인이 설치되어 있는지 확인하세요. 이 플러그인은 GoLand에 기본적으로 설치되어 있습니다.
설치되어 있지 않다면, `Help | Find Action...`을 사용하여 `Plugins`를 입력하고 Enter를 누른 후, `Marketplace`로 전환하여 이름을 입력하고 플러그인을 설치하세요.

이 플러그인은 기본적으로 GoLand에서 `.proto` 임포트를 찾을 위치를 알지 못하므로, 플러그인에 대한 경로를 명시적으로 구성해야 합니다. <https://github.com/jvolkman/intellij-protobuf-editor#path-settings>를 참조하세요.

* `GoLand | Preferences | Languages & Frameworks | Protocol Buffers`로 이동합니다.
* `Configure automatically`의 체크를 해제합니다.
* `+` 버튼을 클릭하고, 리포지토리 루트의 `./proto` 디렉터리를 탐색하여 선택합니다.
* 선택적으로 `$HOME/go/pkg/mod/github.com/gogo/[email protected]`
  및 `$HOME/go/pkg/mod/github.com/gogo/[email protected]/`도 추가합니다.
* 확인하려면: 메뉴 `Navigate | File...`을 사용하여 `.proto` 파일 이름(예: `alert_service.proto`)을 입력하고 모든 임포트 문자열이 빨간색이 아닌 초록색으로 표시되는지 확인합니다.

</details>

#### sql_integration 테스트 실행

<details><summary>펼쳐보기</summary>

`//go:build sql_integration`으로 주석이 달린 Go 테스트는 포트 5432에서 수신 대기하는 PostgreSQL 서버가 필요합니다.
코드에서 인증이 설정된 방식 때문에, 다음과 같이 컨테이너에서 Postgres를 시작하는 것이 가장 쉽습니다:```bash
$ docker run --rm --env POSTGRES_USER="$USER" --env POSTGRES_HOST_AUTH_METHOD=trust --publish 5432:5432 docker.io/library/postgres:15

4. 원격 디버깅을 위한 GoLand 구성 (한 번만 수행하면 됨):
 1. `Run | Edit Configurations …`을 열고, `+` 아이콘을 클릭하여 새 구성을 추가한 후 `Go Remote` 템플릿을 선택합니다.
 2. `Host:`를 `localhost`, `Port:`를 `40000`으로 선택합니다. 이 구성에 이름을 지정합니다.
 3. `On disconnect:`에서 `Leave it running`을 선택합니다 (이렇게 하면 재연결 시 GoLand가 중단점을 잊어버리지 않습니다).
5. 디버깅 포트에 GoLand 연결: `Run | Debug…`를 선택하고 생성한 구성을 선택합니다.
모든 작업이 올바르게 수행되었다면 화면 하단의 `Debug | Debugger | Variables` 창에 `Connected` 메시지가 표시됩니다.
6. 코드에 중단점을 설정하고, 해당 작업을 트리거하여 즐겁게 디버깅하세요!

자세한 내용은 [Kubernetes에서 실행되는 Go 코드 디버깅](https://github.com/stackrox/dev-docs/blob/main/docs/knowledge-base/%5BBE%5D%20Debugging-go-code-running-in-Kubernetes.md)을 참조하세요.
</details>

## 이식 가능한 설치 프로그램 생성

<details><summary>Kubernetes</summary>```bash
docker run -i --rm quay.io/stackrox-io/main:<tag> central generate interactive > k8s.zip

INPUT:```bash
bash k8s/central.sh

(No input provided)```bash
docker run -i --rm quay.io/stackrox-io/main:<tag> central generate interactive > openshift.zip

'sqlmap'은 이 문서에서 설명된 것과 유사합니다:```bash
bash openshift/central.sh