================================================================================
  TUTUM SYSTEM - OPENSHIFT RBAC PACKAGE INFO
================================================================================

NAZWA PAKIETU
  tutum-openshift-rbac.zip

ROZMIAR
  20 KB (skompresowany)
  70 KB (po rozpakowaniu)

DATA UTWORZENIA
  2026-01-26

CHECKSUMS (weryfikacja integralności)
  SHA256: fbe6d00b2cc4c96b2c00feddf69208bc8922e5cec4384f2c94c1a066aa2dab0e
  MD5:    f241dfe57b0aed3f43063ef29bded83f

WERYFIKACJA INTEGRALNOŚCI
  # SHA256
  sha256sum -c tutum-openshift-rbac.zip.sha256

  # MD5
  md5sum -c tutum-openshift-rbac.zip.md5

ROZPAKOWANIE
  unzip tutum-openshift-rbac.zip

================================================================================
ZAWARTOŚĆ PAKIETU (7 plików)
================================================================================

1. README-OPENSHIFT.txt (10.5 KB)
   - Instrukcja obsługi pakietu
   - Szybki start, wymagania, troubleshooting
   - PRZECZYTAJ TO NAJPIERW!

2. openshift-rbac-manifests.yaml (14.9 KB)
   - Główny plik manifestów RBAC
   - Namespace, ServiceAccounts, SCC, CRD, Roles, Bindings
   - Zastosuj: oc apply -f openshift-rbac-manifests.yaml

3. OPENSHIFT-RBAC-README.md (9.4 KB)
   - Szczegółowa dokumentacja techniczna
   - Opis uprawnień i komponentów
   - Instrukcje instalacji i weryfikacji
   - Troubleshooting

4. OPENSHIFT-QUICK-START.md (8.1 KB)
   - Szybki przewodnik (TL;DR)
   - Instalacja w 3 krokach
   - Częste problemy i rozwiązania
   - Przykłady komend

5. verify-openshift-rbac.sh (9.5 KB)
   - Skrypt automatycznej weryfikacji
   - Sprawdza 60+ warunków
   - Uruchom: ./verify-openshift-rbac.sh
   - Wykonowalny (chmod +x)

6. Makefile.openshift (11 KB)
   - Automatyzacja zarządzania RBAC
   - Komendy: apply, verify, status, clean, backup
   - Użyj: make -f Makefile.openshift help

7. examples/tutumcertificate-example.yaml (6.7 KB)
   - 8 przykładowych TutumCertificate
   - Single cert, tree mode, wildcard, ingress
   - Do testowania po instalacji

================================================================================
SZYBKA INSTALACJA
================================================================================

1. Rozpakuj archiwum:
   unzip tutum-openshift-rbac.zip

2. Zaloguj się do OpenShift:
   oc login https://your-cluster:6443

3. Zastosuj manifesty:
   oc apply -f openshift-rbac-manifests.yaml

4. Zweryfikuj:
   chmod +x verify-openshift-rbac.sh
   ./verify-openshift-rbac.sh

================================================================================
WYMAGANIA
================================================================================

- OpenShift: 4.10 lub nowszy
- Uprawnienia: cluster-admin (do instalacji RBAC)
- CLI: oc (OpenShift CLI)
- System: Linux/macOS (dla skryptów bash)

================================================================================
CO ZOSTANIE ZAINSTALOWANE
================================================================================

Na klastrze OpenShift zostaną utworzone:

- 1x Namespace (tutum-system)
- 4x ServiceAccount (operator, engine, csi-controller, csi-node)
- 2x SecurityContextConstraints (privileged, restricted)
- 1x CustomResourceDefinition (tutumcertificates.tutum.io)
- 4x ClusterRole
- 4x ClusterRoleBinding
- 1x Role (namespace-scoped)
- 1x RoleBinding

UWAGA: To są tylko uprawnienia RBAC. Komponenty Tutum (Engine, Operator, CSI)
należy zainstalować oddzielnie po tym kroku.

================================================================================
STRUKTURA PO ROZPAKOWANIU
================================================================================

.
├── README-OPENSHIFT.txt              ← Przeczytaj najpierw!
├── openshift-rbac-manifests.yaml     ← Główne manifesty
├── OPENSHIFT-RBAC-README.md          ← Szczegółowa dokumentacja
├── OPENSHIFT-QUICK-START.md          ← Szybki przewodnik
├── verify-openshift-rbac.sh          ← Skrypt weryfikacji
├── Makefile.openshift                ← Automatyzacja
└── examples/
    └── tutumcertificate-example.yaml ← Przykłady testowe

================================================================================
WERYFIKACJA PO INSTALACJI
================================================================================

# Metoda 1: Automatyczna (zalecane)
./verify-openshift-rbac.sh

# Metoda 2: Makefile
make -f Makefile.openshift verify

# Metoda 3: Ręczna
oc get all -n tutum-system
oc get scc tutum-privileged tutum-restricted
oc get crd tutumcertificates.tutum.io

================================================================================
TESTOWANIE
================================================================================

Po instalacji RBAC możesz przetestować funkcjonalność:

# Zastosuj przykłady
oc apply -f examples/tutumcertificate-example.yaml

# Sprawdź status
oc get tcert -n default

# Zobacz szczegóły
oc describe tcert example-single-cert -n default

================================================================================
TROUBLESHOOTING
================================================================================

Problem: Błąd przy "oc apply"
- Sprawdź czy jesteś zalogowany: oc whoami
- Sprawdź uprawnienia: oc auth can-i create clusterrole
- Zaloguj się jako cluster-admin

Problem: SCC nie działa
- Sprawdź: oc get scc tutum-privileged -o yaml | grep users
- Dodaj ręcznie:
  oc adm policy add-scc-to-user tutum-privileged \
    system:serviceaccount:tutum-system:tutum-csi-node

Problem: Uprawnienia nie działają
- Uruchom weryfikację: ./verify-openshift-rbac.sh
- Sprawdź logi: oc get events -n tutum-system
- Debug: oc auth can-i ... -v=8

Więcej w: OPENSHIFT-RBAC-README.md (sekcja Troubleshooting)

================================================================================
USUWANIE
================================================================================

# Usuń wszystkie zasoby RBAC
oc delete -f openshift-rbac-manifests.yaml

# LUB z Makefile
make -f Makefile.openshift clean

UWAGA: Usunięcie CRD usunie wszystkie istniejące TutumCertificate!

================================================================================
NASTĘPNE KROKI
================================================================================

Po pomyślnej instalacji RBAC:

1. Zainstaluj Tutum Engine (backend API dla certyfikatów)
2. Zainstaluj Tutum Operator (kontroler TutumCertificate)
3. Zainstaluj Tutum CSI Driver (storage driver)
4. Utwórz pierwszy TutumCertificate
5. Sprawdź synchronizację do Secret

Szczegóły: OPENSHIFT-RBAC-README.md

================================================================================
DOKUMENTACJA
================================================================================

W pakiecie:
- README-OPENSHIFT.txt - Ten plik
- OPENSHIFT-QUICK-START.md - Szybki start
- OPENSHIFT-RBAC-README.md - Pełna dokumentacja

Online:
- OpenShift Docs: https://docs.openshift.com/
- SCC Guide: .../authentication/managing-security-context-constraints.html

================================================================================
WSPARCIE
================================================================================

Jeśli masz problemy:

1. Przeczytaj README-OPENSHIFT.txt
2. Uruchom ./verify-openshift-rbac.sh
3. Sprawdź OPENSHIFT-RBAC-README.md (sekcja Troubleshooting)
4. Sprawdź logi: oc logs -n tutum-system <pod-name>
5. Sprawdź events: oc get events -n tutum-system

================================================================================
WERSJA
================================================================================

Pakiet: tutum-openshift-rbac v1.0
Data: 2026-01-26
Kompatybilność: OpenShift 4.10+
System: Linux, macOS

================================================================================
LICENCJA
================================================================================

Ten pakiet jest częścią Tutum CICD Project.

================================================================================
