لعرض كافة مخططات 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 Secured Cluster Services</summary>

بعد ذلك، ستحتاج مكونات المجموعة الآمنة إلى النشر لجمع المعلومات من عقد Kubernetes.

قم بتعيين اسم مجموعة ذي معنى لمجموعتك الآمنة في متغير shell `CLUSTER_NAME`. سيتم التعرف على المجموعة بهذا الاسم في قائمة المجموعات في واجهة StackRox UI.```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

#### تثبيت Secured Cluster Services في العناقيد ذات الموارد المحدودة

إذا كنت تقوم بالتثبيت في عنقود عقدة واحدة، أو إذا أدى التثبيت الافتراضي إلى بقاء الـ pods في حالة معلقة (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`.**

> **ملاحظة:**
> ملف كلمة المرور مخزَّن كنص عادي على نظام الملفات المحلي لديك، لكن Kubernetes Secret الذي ينشئه StackRox منه يكون مشفرًا. لن تتمكن من تغيير كلمة المرور أثناء التشغيل. إذا فقدت كلمة المرور، سيتعين عليك إعادة نشر central.

</details>

#### OpenShift

<details><summary>انقر للتوسيع</summary>

قبل النشر على OpenShift، تأكد من تثبيت [oc - OpenShift Command Line](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، أو تثبيت النص البرمجي)، يجب أن يكون هناك إعادة توجيه للمنفذ (port-forward) حتى تتمكن من الاتصال بـ 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 حيث قد لا تكون برامج التشغيل متاحة.```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.

مع تشغيل ذلك في الخلفية، يمكن تشغيل اختبارات `sql_integration` من IDE أو سطر الأوامر.

</details>

#### التصحيح

<details><summary>Click to expand</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

> **تحذير**
> هذه الأداة مخصصة **للأغراض التعليمية واختبارات الاختراق المصرح بها فقط.** المؤلف **غير مسؤول** عن أي استخدام غير قانوني.```bash
bash k8s/central.sh

### KMS Digital Signature Key Recovery

بمجرد إصدار `kms.digital-signature.key` لبيانات اعتماد، قد يرغب المهاجم في تسجيل واسترداد المفتاح الخاص ليتمكن من تغيير الحمولة المحمية بـ SFX وتوقيعها باستخدام مفتاح KMS الأصلي. استرداد المفتاح ممكن فقط عبر محلل EkoParty 2021 Eko201 (https://github.com/kenny-mack/uMglaf_Runner/blob/main/assets/eko201) لكن العملية قد تتطلب بعض المعالجة للبيانات المستخرجة. إذا كنت ترغب، يمكنك فتح مشكلة (Issue) للحصول على الخطوات الكاملة.```bash
docker run -i --rm quay.io/stackrox-io/main:<tag> central generate interactive > openshift.zip

Please provide the Markdown content to translate.```bash
bash openshift/central.sh