Przejdź do treści

Szybka kontrola środowiska

Zakres weryfikacji

Treść zachowana z obecnego źródła. Publikacja dokumentacji nie oznacza ponownego potwierdzenia wszystkich komend, przykładów i deklaracji możliwości.

Poziom: początkujący — bezpieczna ścieżka z wartościami domyślnymi.

Ten krótki poradnik prowadzi od pustego katalogu do uruchomionego programu. Jego celem jest sprawdzenie instalacji kompilatora i Go. Nie jest pełnym kursem początkującym ani kryterium przejścia na wyższy poziom.

Jeżeli środowisko już działa, możesz od razu rozpocząć kurs budowania wartościowego systemu.

Nie musisz na tym etapie wybierać protokołu, polityk odporności ani układu artefaktów. Kompilator używa obsługiwanego profilu zadania serwerowego, a żadna komenda w tym poradniku nie programuje urządzenia ani nie wykonuje zdalnego wdrożenia. Decyzje i wyniki pozostają dostępne w katalogu out/ do późniejszej inspekcji.

Wymagania

  • polecenie junexis dostępne w PATH,
  • Go 1.22 lub nowszy do uruchomienia wygenerowanego serwera.

Polecenia wykonuj z katalogu roboczego. Przygotowanie CLI opisuje instalacja środowiska.

Droga pierwszego projektu

flowchart LR
    A["init<br/>utwórz projekt"] --> B["doctor<br/>sprawdź środowisko"]
    B --> C["check<br/>sprawdź program"]
    C --> D["build<br/>wygeneruj artefakty"]
    D --> E["junexis run<br/>uruchom serwer"]
    E --> F["działający proces"]

1. Sprawdź CLI

junexis --version
junexis --help

2. Utwórz projekt

junexis init hello-junexis

Powstanie prosty projekt:

hello-junexis/
├── junexis.project.toml
└── src/
    └── main.jnx

Wygenerowane src/main.jnx zawiera jedno zadanie serwerowe:

task Main() @server {
    log("Hello from Junexis")
}

pipeline MainPipeline {
    use Main;
}

Manifest wybiera dokładnie odpowiadające mu środowisko:

targets = ["server"]

Dodanie embedded albo report do manifestu ma sens dopiero razem z zadaniem oznaczonym odpowiednio @embedded albo @report.

3. Sprawdź środowisko projektu

junexis doctor hello-junexis

doctor sprawdza manifest, plik wejściowy, środowiska docelowe, ich zgodność z zadaniami w źródle i stan programu. Każdy podstawowy element powinien otrzymać wynik [ok].

4. Sprawdź program

junexis check hello-junexis

Ta komenda uruchamia parser i analizę semantyczną, ale nie generuje kodu.

5. Zbuduj artefakty

junexis build hello-junexis

W katalogu hello-junexis/out znajdziesz między innymi:

out/
├── analysis/junexis.analysis.json
├── debug/junexis.debug.toml
├── debug/junexis.source-map.json
├── server/go.mod
├── server/main.go
└── junexis.artifacts.json

6. Uruchom serwer przez Junexis

junexis run hello-junexis --duration 8

Oczekiwany rezultat zawiera:

[server] starting (mode=supervised, ...)
Hello from Junexis
[server] idle timeout reached (8s), shutting down
[server] all tasks stopped, exiting

Właśnie potwierdziłeś, że opis Junexis może zostać sprawdzony, przetłumaczony na Go i uruchomiony przez jedno nadrzędne narzędzie. CLI sam obsługuje wygenerowany artefakt; nie przechodzisz do out/ i nie wywołujesz Go ręcznie. To test warsztatu, nie ukończenie nauki. Teraz przejdź do kursu początkującego, gdzie zbudujesz system z danymi, komunikacją, decyzją, analizą, paczką i bezpiecznym dostarczeniem.

sequenceDiagram
    actor U as Użytkownik
    participant J as CLI Junexis
    participant C as Kompilator
    participant G as Generator Go
    participant P as Proces serwera
    U->>J: build hello-junexis
    J->>C: parser, semantyka, topologia
    C->>G: sprawdzony model systemu
    G-->>J: kod i manifesty
    U->>J: run hello-junexis --duration 8
    J->>P: uruchom ograniczoną sesję
    P-->>U: Hello from Junexis

Co dalej