> For the complete documentation index, see [llms.txt](https://docs.eximee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.eximee.com/eksploatacja-aplikacji/designer/srodowiska.md).

# Moduł Środowiska

{% hint style="info" %}
Dostępność funkcjonalności zależy od licencji i może nie być dostępna we wszystkich wdrożeniach.
{% endhint %}

Moduł służy do zarządzania szablonami wniosków. Umożliwia:

* podgląd wersji wybranego wniosku na dostępnych środowiskach,
* migrację szablonu wniosku (razem z jego zależnościami) pomiędzy środowiskami,
* wycofanie ostatniej migracji wniosku na konkretnym środowisku (rollback),
* uruchomienie wybranego wniosku na wybranym środowisku w symulatorze (patrz Symulator wniosków),
* pobranie paczki biznesowej (szablonu wniosku wraz z zależnościami niezbędnymi do uruchomienia go na środowisku).

## Wyświetlenie informacji o wniosku na środowiskach

Po przejściu do modułu wyświetla się przycisk **WNIOSEK**.

<figure><img src="/files/7tO2W1mLQbRytIY9WmMq" alt=""><figcaption><p><em><strong>Ilustracja 1.</strong> Zakładka "Środowiska"</em></p></figcaption></figure>

Po wybraniu z listy wniosku wyświetli się opublikowana i najwyższa wersja wniosku na każdym z dostępnych środowisk:

<figure><img src="/files/eeS6aHsHy0a0aVTYKL7O" alt=""><figcaption><p><em><strong>Ilustracja 2.</strong> Stan wniosku na poszczególnych środowiskach</em></p></figcaption></figure>

## Uruchomienie wniosku

Kliknięcie w przycisk przy opublikowanej wersji przekierowuje do modułu symulatora wniosków wybierając automatycznie środowisko, z którego nastąpiło przekierowanie.

## Migracja szablonu

Aby zmigrować wniosek wraz z zależnościami na wyższe środowisko, należy kliknąć strzałkę pomiędzy kafelkami:

<figure><img src="/files/OgRcS4iOhpISnV4ruKBj" alt=""><figcaption><p><em><strong>Ilustracja 3.</strong> Strzałka migrująca wniosek na wyższe środowisko</em></p></figcaption></figure>

Spowoduje to migrację oraz opublikowanie szablonu w najwyższej wersji na wskazane środowisko. Dodatkowo na środowisko do odpowiednich katalogów zostaną zaimportowane pliki niezbędne do prawidłowego działania wniosku.

Migracja szablonu wykonywana jest tylko na pierwszym środowisku, ze względu na wspólną bazę dla wszystkich instancji LANa. Zależności dla wniosku natomiast są dostarczane na wszystkie instancje.

### Walidacja podczas migracji szablonu

Przed migracją szablonu wraz z zależnościami odbywa się walidacja spójności środowiska. Walidator sprawdza czy zależności nałożone na docelowe środowisko nie wprowadzą niespójności. Jeśli walidator natrafi na jakieś problemy, wyświetli użytkownikowi listę oraz treść ostrzeżeń. W tym momencie użytkownik może zdecydować czy mimo wszystko chce wymusić migrację na docelowe środowisko.

<figure><img src="/files/0wCbpXG03Ua6JozN6Hl2" alt=""><figcaption><p><em><strong>Ilustracja 4.</strong> Komunikat błędu migracji</em></p></figcaption></figure>

## Menu akcji środowiska

Aby otworzyć menu akcji środowiska należy nacisnąć na przycisk **Otwórz menu akcji** znajdujący się w prawym górnym rogu kafla środowiska.

<figure><img src="/files/r7zjuq2NGciLFDwQjDzB" alt=""><figcaption><p><em><strong>Ilustracja 5.</strong> Menu akcji środowiska</em></p></figcaption></figure>

### Eksport szablonu

Kliknięcie w menu akcji w opcję **Eksportuj paczkę** spowoduje zbudowanie pliku zip zawierającego szablon wniosku w najnowszej wersji na danym środowisku wraz z zależnościami potrzebnymi do jego uruchomienia.

<figure><img src="/files/r5E65UO7nL6lIhEb0gcA" alt=""><figcaption><p><em><strong>Ilustracja 6.</strong> Menu zawierające polecenie eksportu paczki</em></p></figcaption></figure>

Plik zostanie zapisany w repozytorium Nexus'a. W odpowiedzi w przeglądarce pojawi się popup z linkiem do paczki w Nexusie.

<figure><img src="/files/cigNHBB2kkL0CNXOQQnd" alt=""><figcaption><p><em><strong>Ilustracja 7.</strong> Okno z linkiem do paczki</em></p></figcaption></figure>

* Eksport szablonu z repozytorium wykonywany jest z pierwszego środowiska, ze względu na wspólną bazę dla wszystkich instancji LANa.
* Widocznością opcji eksportu steruje flaga z konfiguracji środowisk (`bundleExporter`).

### Rollback środowiska

Opcja **Rollback** służy do przywrócenia na danym środowisku ostatniej kopii zapasowej katalogów z zależnościami wniosków. Kopie zapasowe tworzone są w momencie migracji na środowisko dowolnego wniosku posiadającego zależności. Każde środowisko posiada własną kopię zapasową dla każdego z migrowanych wcześniej wniosków.

* Rollback szablonu wykonywany jest tylko na pierwszym środowisku, ze względu na wspólną bazę dla wszystkich instancji LANa.
* Widocznością tej opcji steruje flaga z konfiguracji środowisk (`migrationTarget`).

Jeżeli nie została wcześniej sfinalizowana żadna migracja, opcja będzie wyszarzona, ponieważ nie ma dostępnej paczki, którą można byłoby przywrócić.

## Konfiguracja środowisk

Listę dostępnych "kafelków" środowisk należy skonfigurować w pliku, do którego ścieżkę należy podać w parametrach instalacyjnych paczki (`EXIMEE_CONSOLE_ENVIRONMENTS_CONFIGURATION_PATH`). Kolejność podanych środowisk określa jednocześnie kierunek migracji.

```json
[
  {
    "name": "Środowisko1",
    "lanHosts": [
      "lan.adres.test"
    ],
    "migrationTarget": false,
    "bundleExporter": false
  },
  {
    "name": "Środowisko2",
    "lanHosts": [
      "lan.test.eximee",
      "lan2.test.eximee"
    ],
    "migrationTarget": true,
    "bundleExporter": true
  }
]
```

### Znaczenie poszczególnych atrybutów:

* **`name`** – nazwa środowiska wyświetlana na kafelku.
* **`lanHosts`** – tablica instancji LANa na danym środowisku (ważne, żeby to były tylko hosty – bez np. protokołu `http://` czy portu).
* **`migrationTarget`** – flaga określająca, czy na dane środowisko można migrować wnioski.
* **`bundleExporter`** – flaga określająca, czy z danego środowiska można eksportować paczkę wniosku z zależnościami.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.eximee.com/eksploatacja-aplikacji/designer/srodowiska.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.