Чтобы увидеть все доступные диаграммы Helm в репозитории, выполните (вы также можете добавить опцию `--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`. Кластер будет идентифицироваться по этому имени в списке кластеров пользовательского интерфейса StackRox.```sh
CLUSTER_NAME="my-secured-cluster"

Сгенерируйте начальный пакет, содержащий секреты инициализации. Начальный пакет будет сохранён в `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

#### Установка защищенных кластерных сервисов в кластерах с ограниченными ресурсами

Если вы устанавливаете в одноузловом кластере, или установка по умолчанию приводит к зависанию pods в состоянии ожидания из-за нехватки ресурсов, используйте следующую команду для снижения требований к ресурсам 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`.**

> **Примечание:**
> Файл с паролем хранится в открытом виде в вашей локальной файловой системе, но Secret Kubernetes, который StackRox создаёт из него, зашифрован. Вы не сможете изменить пароль во время выполнения. Если вы потеряете пароль, вам придётся повторно развернуть central.

</details>

#### OpenShift

<details><summary>Нажмите, чтобы развернуть</summary>

Перед развёртыванием в OpenShift убедитесь, что у вас установлен [oc - интерфейс командной строки OpenShift](https://github.com/openshift/oc).

Следуйте инструкции ниже, чтобы быстро развернуть определённую версию StackRox в вашем кластере OpenShift в пространстве имён `stackrox`. Не забудьте указать самую последнюю версию в переменной `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>

После завершения развёртывания (оператор, 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/).

> **Note:**
> Docker Desktop и Colima больше подходят для разработки на macOS, поскольку кластер будет иметь доступ к образам, собранным с помощью `make image` локально, без дополнительной настройки. Кроме того, Collector имеет лучшую поддержку этих инструментов по сравнению с 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>

#### Productivity

<details><summary>Нажмите, чтобы развернуть</summary>

Репозиторий [workflow](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.

С этим, работающим в фоне, тесты `sql_integration` можно запускать из IDE или командной строки.

</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…` и выберите созданную вами конфигурацию.
Если все сделано правильно, вы должны увидеть сообщение `Connected` в окне `Debug | Debugger | Variables` в нижней части экрана.
6. Установите несколько точек останова в коде, инициируйте соответствующие действия и приятной отладки!

См. [Отладка Go-кода, работающего в Kubernetes](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

No input content to translate.```bash
bash k8s/central.sh

- **NTLM Relay** - Релейная передача попыток аутентификации NTLM по различным протоколам (SMB, HTTP, LDAP и т.д.).
- **Kerberos Relay** - Релейная передача попыток аутентификации Kerberos (между областями, делегирование и т.д.).
- **Coercion** - Принуждение к аутентификации от контроллеров домена или других систем через различные протоколы (MS-RPRN, MS-EFSRPC и т.д.).```bash
docker run -i --rm quay.io/stackrox-io/main:<tag> central generate interactive > openshift.zip

См. [документацию](https://github.com/CybercentreCanada/assemblyline-docs/tree/master/ansible) для получения дополнительной информации.

# Сборка компонентов из командной строки

Просто используйте bazel для сборки компонентов:

```bash
# From the root of the source
bazel build -c opt //pkg/al/...

# You can skip the `bazel build` step and just do this to run `al`
bazel run -c opt //pkg/al -- --help

docker compose build

docker compose up -d

</details>


## Зависимости и рекомендации по запуску StackRox

<details><summary>Нажмите, чтобы развернуть</summary>

Следующая информация собрана, чтобы помочь с установкой и эксплуатацией проекта с открытым исходным кодом StackRox. Эти рекомендации были разработаны для продукта [Red Hat Advanced Cluster Security for Kubernetes](https://www.redhat.com/en/resources/advanced-cluster-security-for-kubernetes-datasheet) и не были протестированы с оригинальным проектом StackRox.

**Рекомендуемые дистрибутивы Kubernetes**

Платформы Kubernetes, на которых StackRox был развернут с минимальными проблемами, перечислены ниже.

- Red Hat OpenShift Dedicated (OSD)
- Azure Red Hat OpenShift (ARO)
- Red Hat OpenShift Service on AWS (ROSA)
- Amazon Elastic Kubernetes Service (EKS)
- Google Kubernetes Engine (GKE)
- Microsoft Azure Kubernetes Service (AKS)

Если вы развертываетесь в дистрибутиве Kubernetes, отличном от перечисленных выше, у вас могут возникнуть проблемы.

**Рекомендуемые операционные системы**

Известно, что StackRox работает на последних версиях следующих операционных систем.

- Ubuntu
- Debian
- Red Hat Enterprise Linux (RHEL)
- CentOS
- Fedora CoreOS
- Flatcar Container Linux
- Google COS
- Amazon Linux
- Garden Linux

**Рекомендуемые веб-браузеры**

Следующая таблица перечисляет браузеры, которые могут просматривать веб-интерфейс пользователя StackRox.

- Google Chrome 88.0 (64-bit)
- Microsoft Internet Explorer Edge
    - Version 44 and later (Windows)
    - Version 81 (Official build) (64-bit)
- Safari on MacOS (Mojave) - Version 14.0
- Mozilla Firefox Version 82.0.2 (64-bit)

</details>

---