> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/pl/konserwacja/upgrading-your-deployment.md).
# Aktualizacja wdrożenia
{% hint style="danger" %}
Ważne jest, aby upewnić się, że wykonujesz [spójnej kopii zapasowej](/on-premises/pl/konserwacja/data-and-backups.md#performing-a-consistent-backup) **przed** przy każdej aktualizacji głównej wersji, aby umożliwić powrót do poprzedniej wersji, jeśli będzie to potrzebne.
{% endhint %}
Pole [Overleaf Toolkit↗](https://github.com/overleaf/toolkit) to repozytorium git, więc łatwo uzyskać nowe funkcje Toolkitu. Wystarczy uruchomić `bin/upgrade` polecenie i postępować zgodnie z instrukcjami wyświetlanymi na ekranie.
Warto zauważyć, że wersja obrazu Dockera (w `config/version`) jest zarządzana oddzielnie od aktualizacji kodu Toolkitu. Aktualizacja kodu Toolkitu będzie **nie** automatycznie zmieniać wersję obrazu Dockera, którego używasz. Oznacza to, że w większości przypadków możesz zaktualizować wersję Toolkitu bez aktualizowania wdrożenia.
#### Pole `bin/upgrade` Skrypt
Gdy uruchomisz `bin/upgrade` polecenie, skrypt sprawdzi, czy dostępna jest aktualizacja kodu Toolkitu, i zaproponuje aktualizację Toolkitu. Zawsze możesz odmówić tej aktualizacji, a nic się nie zmieni.
Jeśli zdecydujesz się zaktualizować kod Toolkitu, skrypt sprawdzi następnie, czy *domyślna* wersja obrazu Dockera uległa zmianie, i zaproponuje aktualizację lokalnego pliku wersji (w `config/version`) aby dopasować go do nowej domyślnej.
Jeśli zdecydujesz się przełączyć wersje, skrypt przeprowadzi Cię następnie przez proces zatrzymania usług Dockera, wykonania kopii zapasowej i ponownego uruchomienia usług Dockera. Twój stary plik wersji zostanie automatycznie skopiowany do `config/__old-version`, na wypadek gdybyś musiał wrócić do tej wersji obrazów Dockera.
{% hint style="danger" %}
Podczas wykonywania uaktualnienia Server CE/Pro zalecamy aktualizację do najnowszego wydania wdrożonej głównej wersji **przed** aktualizacją do najnowszego wydania **następnej** głównej wersji. Jeśli Twoje wdrożenie jest o więcej niż jedną główną wersję za najnowszą, będziesz musiał wykonać uaktualnienie wieloetapowe.
Na przykład, jeśli używasz 3.5.10, musisz zaktualizować do 3.5.13 -> wykonać migrację pełnej historii projektu -> 4.2.9 -> 5.5.4.
Powinieneś **nigdy** pomijaj głównych wersji (3.5.10 -> 5.5.4). Jeśli korzystasz z Toolkit i jesteś o więcej niż jedną główną wersję za najnowszą, musisz **nie** używać `bin/upgrade` skryptu, ponieważ będziesz musiał przeprowadzić ręczne uaktualnienie wieloetapowe.
{% endhint %}
{% hint style="info" %}
W przypadku środowisk air-gapped, które ręcznie importują obrazy Dockera, ustaw `PULL_BEFORE_UPGRADE=false` w swoim `config/overleaf.rc` plik.
Sprawdź proszę [tutaj](/on-premises/pl/instalacja/air-gapped-offline-deployments.md) aby uzyskać więcej informacji na temat wdrażania w środowiskach air-gapped/offline.
{% endhint %}
### Ścieżka aktualizacji
Pole `bin/upgrade` polecenie zawsze wybierze najnowszą dostępną w danym momencie wersję Server Pro/CE. Jeśli cykl aktualizacji jest rzadki, może to spowodować pominięcie głównych wersji i potencjalną aktualizację do wersji, której mogłeś się nie spodziewać.
Podczas wykonywania aktualizacji zalecamy przejście najpierw do najnowszego wydania bieżącej wersji głównej, zanim zaktualizujesz do najnowszego wydania następnej wersji głównej. Na przykład, jeśli obecnie używasz 3.3.2, a najnowszą dostępną wersją jest 5.3.1, prawidłowa ścieżka aktualizacji będzie następująca:
* 3.3.2 -> 3.5.13
* 3.5.13 -> 4.2.9
* 4.2.9 -> 5.5.1
Aby uniknąć problemów z aktualizacją, zalecamy zapoznanie się z naszymi [Informacje o wydaniu](https://docs.overleaf.com/on-premises/release-notes) przed wykonaniem jakichkolwiek aktualizacji, ponieważ niektóre wersje mogą wymagać dodatkowych kroków, takich jak ręczne zmiany w Toolkitcie, aktualizacja baz danych lub uruchomienie skryptów migracyjnych.
Jeśli jeszcze tego nie zrobiłeś, zapisz się do naszej [listy mailingowej](https://mailchi.mp/overleaf.com/community-edition-and-server-pro) aby otrzymywać powiadomienia o wydaniu nowych wersji/aktualizacji. Umożliwiłoby to planowanie regularnych okien serwisowych ściśle zgodnych z naszym harmonogramem wydań.
---
# 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://ayakaleaf-pro.ayaka.space/on-premises/pl/konserwacja/upgrading-your-deployment.md?ask=&goal=
```
`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.