> For the complete documentation index, see [llms.txt](https://overleaf-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://overleaf-pro.ayaka.space/on-premises/ko/maintenance/upgrading-your-deployment.md).
# 배포 업그레이드
{% hint style="danger" %}
필요할 경우 롤백할 수 있도록 [일관된 백업](/on-premises/ko/maintenance/data-and-backups.md#performing-a-consistent-backup) **이전** 각 주요 버전 업그레이드마다 수행하는 것이 중요합니다.
{% endhint %}
해당 [Overleaf Toolkit↗](https://github.com/overleaf/toolkit) git 저장소이므로 새로운 Toolkit 기능을 쉽게 가져올 수 있습니다. 그냥 다음을 실행하세요 `bin/upgrade` 명령을 실행하고 화면의 안내를 따르세요.
Docker 이미지 버전(은 `config/version`)는 Toolkit 코드 업데이트와는 별도로 관리됩니다. Toolkit 코드를 업데이트하면 **아니** 실행 중인 Docker 이미지 버전이 자동으로 변경됩니다. 즉, 대부분의 경우 배포를 업그레이드하지 않고도 Toolkit 버전을 업그레이드할 수 있습니다.
#### 해당 `bin/upgrade` 스크립트
다음을 실행하면 `bin/upgrade` 명령을 실행하면 스크립트가 Toolkit 코드에 사용 가능한 업데이트가 있는지 확인하고 Toolkit을 업데이트할지 제안합니다. 이 업그레이드는 언제든지 거절할 수 있으며, 그러면 아무것도 변경되지 않습니다.
Toolkit 코드를 업데이트하기로 선택하면, 스크립트는 다음을 확인합니다: *기본* Docker 이미지 버전이 변경되었는지 확인하고, 로컬 버전 파일(위치: `config/version`)를 새 기본값에 맞게 업그레이드하도록 제안합니다.
버전을 전환하기로 선택하면, 스크립트가 Docker 서비스를 종료하고, 백업을 만든 뒤, Docker 서비스를 다시 시작하는 과정을 안내합니다. 이전 버전 파일은 자동으로 다음 위치에 복사됩니다: `config/__old-version`, Docker 이미지의 해당 버전으로 되돌려야 할 경우를 대비한 것입니다.
{% hint style="danger" %}
Server CE/Pro를 업그레이드할 때는 배포된 주요 버전의 최신 릴리스로 먼저 업그레이드한 다음 **이전** 의 최신 릴리스로 업그레이드할 것을 권장합니다. **다음** 주요 버전. 배포 버전이 최신 버전보다 주요 버전 기준으로 두 단계 이상 뒤처져 있다면, 여러 단계로 나누어 업그레이드해야 합니다.
예를 들어, 3.5.10을 실행 중이라면 3.5.13으로 업그레이드한 다음 -> 전체 프로젝트 기록 마이그레이션 수행 -> 4.2.9 -> 5.5.4 순으로 진행해야 합니다.
해야 합니다 **절대** 주요 버전을 건너뛰지 마세요(3.5.10 -> 5.5.4). Toolkit을 사용하고 있고 최신 버전보다 주요 버전 기준으로 두 단계 이상 뒤처져 있다면 **아니** 스크립트를 사용해서는 `bin/upgrade` 안 됩니다. 수동으로 여러 단계에 걸친 업그레이드를 수행해야 하기 때문입니다.
{% endhint %}
{% hint style="info" %}
Docker 이미지를 수동으로 가져오는 에어갭 환경에서는 다음을 설정하세요: `PULL_BEFORE_UPGRADE=false` 당신의 `config/overleaf.rc` 파일.
다음을 확인하세요 [여기](/on-premises/ko/installation/air-gapped-offline-deployments.md) 에어갭/오프라인 환경에 배포하는 방법에 대한 자세한 정보는.
{% endhint %}
### 업그레이드 경로
해당 `bin/upgrade` 명령은 항상 그 시점에 사용 가능한 최신 Server Pro/CE 버전을 선택합니다. 업그레이드 주기가 드문 경우, 주요 버전을 건너뛰게 되어 예상하지 못한 버전으로 업그레이드될 수 있습니다.
업그레이드를 수행할 때는 다음 주요 버전의 최신 릴리스로 업그레이드하기 전에 현재 주요 버전의 최신 릴리스로 업그레이드하는 것을 권장합니다. 예를 들어, 현재 3.3.2를 사용 중이고 사용 가능한 최신 버전이 5.3.1이라면, 올바른 업그레이드 경로는 다음과 같습니다:
* 3.3.2 -> 3.5.13
* 3.5.13 -> 4.2.9
* 4.2.9 -> 5.5.1
업그레이드 문제를 방지하려면 다음을 참고하는 것을 권장합니다: [릴리스 노트](https://docs.overleaf.com/on-premises/release-notes) 일부 버전은 추가 단계가 필요할 수 있으므로, 업그레이드를 수행하기 전에 확인하세요. 예를 들어 Toolkit을 수동으로 수정하거나, 데이터베이스를 업그레이드하거나, 마이그레이션 스크립트를 실행해야 할 수 있습니다.
아직 하지 않으셨다면, 다음에 가입하세요: [메일링 리스트](https://mailchi.mp/overleaf.com/community-edition-and-server-pro) 새 버전/업데이트가 릴리스될 때 알림을 받을 수 있습니다. 이렇게 하면 릴리스 일정에 맞춰 정기적인 유지보수 시간을 계획할 수 있습니다.
---
# 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://overleaf-pro.ayaka.space/on-premises/ko/maintenance/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.