若要查看仓库中所有可用的 Helm Chart，请运行（可以添加 `--devel` 选项以显示非发布版本）```sh
helm search repo stackrox

从这里开始，您可以安装 stackrox-central-services 以在集群中部署 Central 和 Scanner 组件。

> **注意：**
> 即使您计划保护多个集群，也只需要部署一个 stackrox-central-services 实例。

要执行安装，请根据集群大小选择以下命令之一：

#### 默认 Central 安装

如果您要在大小合适的集群中安装，请使用默认安装命令：```sh
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"

</details>

<details><summary>安装 StackRox 安全集群服务</summary>

接下来，需要部署安全集群组件，用于从 Kubernetes 节点收集信息。

在 `CLUSTER_NAME` shell 变量中为安全集群设置一个有意义的集群名称。该集群将在 StackRox UI 的集群列表中以此名称标识。```sh
CLUSTER_NAME="my-secured-cluster"

生成一个包含初始化秘密的 init bundle。init bundle 将保存在 `stackrox-init-bundle.yaml` 中，你将使用它来配置安全集群，如下所示。```sh
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

#### 在资源受限的集群中安装安全集群服务

如果你在单节点集群中安装，或者默认安装导致 Pod 因资源不足而卡在 Pending 状态，请改用以下命令以降低 stackrox-secured-cluster-services 的资源需求。请记住，这些降低后的资源设置不适合生产环境。```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" \
  --set sensor.resources.requests.memory=500Mi \
  --set sensor.resources.requests.cpu=500m \
  --set sensor.resources.limits.memory=500Mi \
  --set sensor.resources.limits.cpu=500m

几分钟后，所有资源应已部署完成。

**'admin' 用户的凭据可在 `./deploy/k8s/central-deploy/password` 文件中找到。**

> **注意：**
> 密码文件以明文形式存储在本地文件系统中，但 StackRox 据此创建的 Kubernetes Secret 是加密的。运行期间无法更改密码。如果丢失密码，则必须重新部署 central。

</details>

#### OpenShift

<details><summary>点击展开</summary>

在 OpenShift 上部署之前，请确保已安装 [oc - OpenShift Command Line](https://github.com/openshift/oc)。

按照以下指南，在 `stackrox` 命名空间中快速将特定版本的 StackRox 部署到你的 OpenShift 集群。请确保将最新的标签添加到 `MAIN_IMAGE_TAG` 变量中。

在你选择的工作目录中运行以下命令：```
git clone [email protected]:stackrox/stackrox.git
cd stackrox
MAIN_IMAGE_TAG=VERSION_TO_USE ./deploy/deploy.sh

几分钟后，所有资源应部署完成。

**'admin'用户的凭据可以在 `./deploy/k8s/deploy-local/password` 文件中找到。**

</details>

## 访问 StackRox 用户界面 (UI)

<details><summary>点击展开</summary>

部署完成后（Operator、Helm 或脚本安装），应存在端口转发，因此您可以连接到 https://localhost:8000/。运行以下命令```sh
kubectl port-forward -n 'stackrox' svc/central "8000:443"

更多信息，请参阅 <https://github.com/nodejs/node-gyp/issues/569>

</details>

#### 克隆 StackRox
<details><summary>点击展开</summary>```bash
# Create a GOPATH: this is the location of your Go "workspace".
# (Note that it is not – and must not – be the same as the path Go is installed to.)
# The default is to have it in ~/go/, or ~/development, but anything you prefer goes.
# Whatever you decide, create the directory, set GOPATH, and update PATH:
export GOPATH=$HOME/go # Change this if you choose to use a different workspace.
export PATH=$PATH:$GOPATH/bin
# You probably want to permanently set these by adding the following commands to your shell
# configuration (e.g. ~/.bash_profile)

cd $GOPATH
mkdir -p bin pkg
mkdir -p src/github.com/stackrox
cd src/github.com/stackrox
git clone [email protected]:stackrox/stackrox.git

现在，你需要*自己*搭建一个Kubernetes集群，然后再继续。
开发可以在GCP或本地进行，使用[Docker Desktop](https://docs.docker.com/desktop/kubernetes/)、[Colima](https://github.com/abiosoft/colima#kubernetes)或[minikube](https://minikube.sigs.k8s.io/docs/start/)。

> **注意：**
> Docker Desktop和Colima更适合macOS开发，因为集群可以直接访问本地使用`make image`构建的镜像而无需额外配置。此外，Collector对这些工具的支持比minikube更好，因为minikube的驱动可能不可用。```bash
# To keep the StackRox Central's Postgres DB state between database upgrades and restarts, set:
$ export STORAGE=pvc

# To save time on rebuilds by skipping UI builds, set:
$ export SKIP_UI_BUILD=1

# To save time on rebuilds by skipping CLI builds, set:
$ export SKIP_CLI_BUILD=1

# When you deploy locally make sure your kube context points to the desired kubernetes cluster,
# for example Docker Desktop.
# To check the current context you can call a workflow script:
$ roxkubectx

# To deploy locally, call:
$ ./deploy/deploy-local.sh

# Now you can access StackRox dashboard at https://localhost:8000
# or simply call another workflow script:
$ logmein

</details>

#### 生产力

<details><summary>点击展开</summary>

[工作流仓库](https://github.com/stackrox/workflow) 包含一些帮助脚本，它们支持我们的开发工作流。使用 `roxhelp --list-all` 探索更多命令。```bash
# Change directory to rox root
$ cdrox

# Handy curl shortcut for your StackRox central instance
# Uses https://localhost:8000 by default or ROX_BASE_URL env variable
# Also uses the admin credentials from your last deployment via deploy.sh
$ roxcurl /v1/metadata

# Run quickstyle checks, faster than stackrox's "make style"
$ quickstyle

# The workflow repository includes some tools for supporting
# working with multiple inter-dependent branches.
# Examples:
$ smart-branch <branch-name>    # create new branch
    ... work on branch...
$ smart-rebase                  # rebase from parent branch
    ... continue working on branch...
$ smart-diff                    # check diff relative to parent branch
    ... git push, etc.

With that running in the background, `sql_integration` tests can be triggered from IDE or command-line.

</details>

#### 调试

<details><summary>点击展开</summary>

**Kubernetes 调试器设置**

使用 GoLand，您可以在 IDE 中运行单元测试时自然地使用断点和调试器。

如果您想要调试本地甚至远程部署，请按照以下步骤操作。

1. 通过导出 `DEBUG_BUILD=yes` 在本地创建调试构建：   ```bash
   $ DEBUG_BUILD=yes make image

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. 设置一些代码断点，触发相应操作，尽情调试！

更多信息，请参阅 [Debugging go code running in Kubernetes](https://github.com/stackrox/dev-docs/blob/main/docs/knowledge-base/%5BBE%5D%20Debugging-go-code-running-in-Kubernetes.md)。
</details>

## Generating Portable Installers

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

\u2060```bash
bash k8s/central.sh

根据提供的输入，没有实际待翻译的内容。因此，输出为空。```bash
docker run -i --rm quay.io/stackrox-io/main:<tag> central generate interactive > openshift.zip

（无内容，翻译结果为空）```bash
bash openshift/central.sh