<!-- wp:paragraph -->
<p>이 매뉴얼은 Dify의 공식 GitHub 릴리스 노트를 참조하여 Docker Compose로 설치된 Dify를 최신 버전으로 안전하게 업그레이드하는 방법을 안내합니다.</p>
<!-- /wp:paragraph -->

<!-- wp:paragraph -->
<p>업그레이드 작업은 몇 가지 간단한 명령어로 이루어지며, 기존에 사용하던 데이터(앱, 문서, 채팅 기록 등)는 보존됩니다.</p>
<!-- /wp:paragraph -->

<!-- wp:separator -->
<hr class="wp-block-separator has-alpha-channel-opacity"/>
<!-- /wp:separator -->

<!-- wp:heading {"level":3} -->
<h3 class="wp-block-heading"><strong>업그레이드 전 준비사항</strong></h3>
<!-- /wp:heading -->

<!-- wp:list -->
<ul class="wp-block-list"><!-- wp:list-item -->
<li><strong>터미널(Terminal) 또는 명령 프롬프트(Command Prompt)</strong>: 서버에 접속하여 명령어를 실행할 수 있는 환경이 필요합니다.</li>
<!-- /wp:list-item -->

<!-- wp:list-item -->
<li><strong>Dify 설치 폴더</strong>: <code>git clone</code>으로 Dify를 처음 설치했던 폴더의 위치를 알아야 합니다. 일반적으로 폴더 이름은 <code>dify</code> 입니다.</li>
<!-- /wp:list-item --></ul>
<!-- /wp:list -->

<!-- wp:separator -->
<hr class="wp-block-separator has-alpha-channel-opacity"/>
<!-- /wp:separator -->

<!-- wp:heading {"level":3} -->
<h3 class="wp-block-heading"><strong>업그레이드 절차 (단계별 안내)</strong></h3>
<!-- /wp:heading -->

<!-- wp:paragraph -->
<p>아래의 절차를 순서대로 따라 진행하세요. 모든 명령어는 Dify가 설치된 서버의 터미널에서 실행해야 합니다.</p>
<!-- /wp:paragraph -->

<!-- wp:heading {"level":4} -->
<h4 class="wp-block-heading"><strong>1단계: Dify 작업 폴더로 이동</strong> 및 docker-compose.yaml 백업</h4>
<!-- /wp:heading -->

<!-- wp:paragraph -->
<p>먼저, Dify의 <code>docker</code> 폴더로 이동합니다. 이 폴더에는 <code>docker-compose.yaml</code>  (dify를 설치하기 위한 docker 셋업 스크립트) 설정 파일이 있습니다.</p>
<!-- /wp:paragraph -->

<!-- wp:code -->
<pre class="wp-block-code"><code># Dify를 클론한 최상위 폴더로 이동합니다.
cd dify

# docker 폴더로 들어갑니다.
cd docker
cp docker-compose.yaml docker-compose.yaml.$(date +%s).bak</code></pre>
<!-- /wp:code -->

<!-- wp:heading {"level":4} -->
<h4 class="wp-block-heading"><strong>2단계: 최신 버전 코드 가져오기</strong></h4>
<!-- /wp:heading -->

<!-- wp:paragraph -->
<p>Git을 사용하여 GitHub 저장소에서 최신 버전의 Dify 코드를 로컬 컴퓨터로 가져옵니다. <code>docker-compose.yaml</code> 파일의 변경 사항을 포함한 최신 설정이 업데이트됩니다.</p>
<!-- /wp:paragraph -->

<!-- wp:code -->
<pre class="wp-block-code"><code>git checkout main
git pull origin main
</code></pre>
<!-- /wp:code -->

<!-- wp:heading {"level":4} -->
<h4 class="wp-block-heading"><strong>3단계: 현재 실행 중인 Dify 서비스 중지</strong></h4>
<!-- /wp:heading -->

<!-- wp:paragraph -->
<p>업그레이드를 위해 현재 실행되고 있는 모든 Dify 관련 Docker 컨테이너를 안전하게 중지합니다.</p>
<!-- /wp:paragraph -->

<!-- wp:code -->
<pre class="wp-block-code"><code>docker compose down</code></pre>
<!-- /wp:code -->

<!-- wp:paragraph -->
<p><strong>참고:</strong> 이 명령은 컨테이너를 중지하고 제거하지만, 연결된 볼륨에 저장된 데이터는 삭제되지 않으므로 안전합니다.</p>
<!-- /wp:paragraph -->

<!-- wp:heading {"level":4} -->
<h4 class="wp-block-heading"><strong>4단계: </strong>데이타 백업</h4>
<!-- /wp:heading -->

<!-- wp:code -->
<pre class="wp-block-code"><code>sudo tar -cvf volumes-$(date +%s).tgz volumes</code></pre>
<!-- /wp:code -->

<!-- wp:heading {"level":4} -->
<h4 class="wp-block-heading"><strong>5단계: Dify 재시작</strong></h4>
<!-- /wp:heading -->

<!-- wp:paragraph -->
<p>이제 최신 버전의 설정과 이미지로 Dify 서비스를 다시 시작합니다. <code>-d</code> 옵션은 컨테이너를 백그라운드에서 실행하도록 합니다.</p>
<!-- /wp:paragraph -->

<!-- wp:code -->
<pre class="wp-block-code"><code>docker compose up -d</code></pre>
<!-- /wp:code -->

<!-- wp:separator -->
<hr class="wp-block-separator has-alpha-channel-opacity"/>
<!-- /wp:separator -->

<!-- wp:heading {"level":3} -->
<h3 class="wp-block-heading"><strong>업그레이드 완료 확인</strong></h3>
<!-- /wp:heading -->

<!-- wp:paragraph -->
<p>모든 컨테이너가 정상적으로 실행되면 업그레이드 절차가 완료된 것입니다. 웹 브라우저를 열어 Dify에 접속한 후, 새로운 기능이나 변경 사항이 적용되었는지 확인해 보세요.</p>
<!-- /wp:paragraph -->

<!-- wp:paragraph -->
<p>문제가 발생할 경우, <code>docker compose logs -f</code> 명령어를 실행하여 실시간 로그를 확인하면 원인을 파악하는 데 도움이 될 수 있습니다.</p>
<!-- /wp:paragraph -->