PIERWSZE KROKI

Twoje pierwsze uruchomienie lokalne.

Zrozum punkt wyjścia, zanim go uruchomisz. Poniższe polecenia pochodzą z README; nie zastępują instrukcji budowania i bezpieczeństwa wybranego wydania.

1. Przygotuj odizolowane środowisko.

Użyj wersji JDK i Maven wymaganych przez wybrane wydanie. README podaje polecenia; RUNNING.md i VERSIONS.md w repozytorium wymieniają dokładne wymagania dla budowanego wydania.

Nie wystawiaj startera do niezaufanej sieci. Przed startem ogranicz dostęp przychodzący do portu 6727 za pomocą mechanizmów sieciowych środowiska. Przykładowy adres z 127.0.0.1 nie gwarantuje, że nasłuch jest związany wyłącznie z pętlą zwrotną.

2. Zbuduj z katalogu głównego źródeł. bash

mvn clean install

Źródło: README.md, Quick start. Uruchom w wybranej kopii źródeł — nie na tej witrynie.

3. Uruchom agregat TAR. bash

cd starter/platform/server
java --add-opens java.base/java.lang=ALL-UNNAMED \
  -cp "target/dependency/org.apache.sling.feature.launcher/lib/*" \
  org.apache.sling.feature.launcher.impl.Main \
  -f target/slingfeature-tmp/feature-libre-tar.json \
  -u "file://$PWD/target/artifacts" \
  -p /tmp/libre/data -c /tmp/libre/cache/artifacts

Sekwencja poleceń dosłownie z README. Ścieżki w /tmp to lokalne przykłady szybkiego startu, a nie zalecenie dotyczące trwałego magazynu produkcyjnego. Potwierdź flagi środowiska uruchomieniowego i ścieżki względem wybranego wydania.

4. Otwórz lokalną instancję.

README używa adresu http://127.0.0.1:6727/. Podczas eksploracji utrzymuj środowisko w izolacji. Katalog podany launcherowi w -p to sling.home, a repozytorium znajduje się pod nim; nie traktuj katalogu danych jak jednorazowej pamięci podręcznej artefaktów.

5. Sprawdź udokumentowany endpoint tożsamości. bash

curl --user YOUR_USER \
  http://127.0.0.1:6727/api/identity/v1/me

Użyj przygotowanego użytkownika lokalnego. curl poprosi o hasło. To żądanie odczytu; zapisy klientów maszynowych mają osobny wymóg znacznika CSRF.

6. Wybierz następny przewodnik.

Przeczytaj o architekturze, zanim zmienisz magazyn lub usuniesz funkcje. Przeczytaj przewodnik po API, zanim napiszesz kod integracji. Przejrzyj przewodnik po bezpieczeństwie przed szerszym wystawieniem do sieci. Publiczne API witryny i moduł treści wymagają kompozycji z włączoną obsługą witryn; to polecenie startera ich nie zakłada.

Kilka przydatnych odpowiedzi.

Czy udane budowanie dowodzi, że środowisko uruchomieniowe jest gotowe?

Nie. Analiza funkcji i aktywacja w czasie działania odpowiadają na różne pytania. Uruchom kompozycję i wykonaj testy integracyjne oraz kontrole stanu przewidziane dla wydania.

Czy mogę później przełączyć magazyn jedną flagą?

Nie. Architektura opisuje osobne agregaty TAR i Mongo. Przeniesienie istniejących treści między nimi to migracja wymagająca transferu i weryfikacji.