> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plasma.org/llms.txt
> Use this file to discover all available pages before exploring further.

# 업그레이드

> 소프트웨어 업데이트, 합의 업그레이드 및 유지 관리

## 업그레이드가 중요한 이유

Plasma의 아키텍처는 고처리량 스테이블코인 네이티브 사용 사례를 지원하기 위해 빠르게 진화합니다. 적시 업그레이드는:

* 보안 취약점으로부터 보호
* 결제 워크로드에 대한 성능 향상
* Plasma의 합의 계층 및 RPC 인터페이스와의 호환성 유지

오래된 노드는 동기화 실패, 성능 저하 또는 보안 문제를 경험할 수 있습니다. 비검증 노드는 종종 결제 앱을 위한 중요한 RPC 트래픽을 제공하므로 최신 상태를 유지하는 것이 필수적입니다.

<Note>
  대부분의 비검증 노드 업그레이드는 15\~30분의 다운타임이 필요합니다. 새로운 기능이나 합의 변경 사항을 도입하는 메이저 릴리스는 더 긴 동기화 시간이 필요할 수 있습니다.
</Note>

## 업그레이드 유형

<Columns cols={3}>
  <Card title="보안 패치" href="#security-patches">
    결제 인프라 보호를 위한 중요 수정
  </Card>

  <Card title="기능 업데이트" href="#feature-updates">
    결제 애플리케이션을 위한 새 기능
  </Card>

  <Card title="성능 최적화" href="#performance-optimisations">
    대용량 트랜잭션 처리를 위한 개선
  </Card>
</Columns>

### 보안 패치

보안 패치는 비검증 클라이언트, Reth 또는 종속성의 취약점을 해결합니다.

**예시:**

* 상태 불일치 또는 합의 비동기화 취약점
* RPC 접근 제어 및 인증 수정
* 암호화 라이브러리 업데이트

이러한 패치는 출시 즉시 적용해야 합니다.

### 기능 업데이트

기능 릴리스는 새로운 프로토콜 기능이나 새 애플리케이션 패턴 지원을 가능하게 합니다.

**예시:**

* 무료 USD₮ 전송 개선
* 사용자 정의 가스 토큰 지원
* 새롭거나 확장된 RPC 메서드
* 상태 쿼리 최적화
* 지갑 및 거래소 통합 개선

### 성능 최적화

성능 중심 릴리스는 실행 속도, 동기화 효율 및 리소스 사용량을 개선합니다.

**예시:**

* 더 빠른 데이터베이스 읽기와 쓰기
* 부하에서 감소된 RPC 지연
* 메모리 및 CPU 효율 개선
* 합의 동기화 개선

## 업그레이드 절차

비검증 노드 업그레이드는 일반적으로 새 Docker 이미지를 가져오고, 구성을 업데이트하고, 서비스를 재시작하는 작업을 포함합니다.

<Steps>
  <Step title="애플리케이션에 알림">
    연결된 서비스에 계획된 유지 관리에 대해 알립니다.
  </Step>

  <Step title="호환성 확인">
    새 비검증 클라이언트 버전이 현재 합의 엔드포인트와 작동하는지 확인합니다.
  </Step>

  <Step title="구성 업데이트">
    향상된 기능에 대한 새 구성 옵션을 적용합니다. 사용자 정의 가스 토큰 지원, 무료 트랜잭션 처리 또는 결제 애플리케이션 RPC 인터페이스에 영향을 미치는 변경 사항에 특별히 주의를 기울이세요.
  </Step>

  <Step title="RPC 엔드포인트 테스트">
    업그레이드 후 결제 애플리케이션 호환성을 확인합니다.
  </Step>

  <Step title="트랜잭션 처리 모니터링">
    USD₮ 전송 및 사용자 정의 가스 작업에 대한 정상 작동을 확인합니다.
  </Step>
</Steps>

<Tip>
  여러 비검증 노드를 운영할 때는 단계별로 업그레이드를 배포하세요. 주요 결제 인프라를 업그레이드하기 전에 비중요 인스턴스부터 시작하고, 첫 업그레이드된 노드를 신중하게 모니터링한 후 진행하세요.
</Tip>

## 업그레이드 후 검증

업그레이드 후 합의 계층과의 전체 동기화를 확인하고 핵심 기능을 검증하세요.

<Check>**합의 동기화**: 블록 높이가 네트워크와 정렬</Check>
<Check>**RPC 기능**: 결제 애플리케이션에서 사용하는 주요 엔드포인트 테스트</Check>
<Check>**성능 베이스라인**: 업그레이드 후 메트릭을 이전 베이스라인과 비교</Check>
<Check>**모니터링**: 모니터링 및 알림 시스템이 계속 운영되는지 검증</Check>

<Tip>
  구성 변경과 관찰된 동작을 문서화하세요. 이는 향후 업그레이드 및 문제 해결의 신뢰성을 향상시킵니다. 일반적인 문제는 [문제 해결 가이드](./troubleshooting)를 참조하세요.
</Tip>

## 롤백 절차

### 롤백이 필요한 시점

다음을 관찰하면 롤백하세요:

* 합의 동기화 실패
* 심각한 RPC 성능 저하
* 애플리케이션 비호환성
* 보안 회귀
* 잔액 또는 전송에 영향을 미치는 데이터 불일치

### 롤백 방법

<Steps>
  <Step title="서비스 중지">
    비검증 노드 서비스를 중지합니다.
  </Step>

  <Step title="이미지 및 구성 되돌리기">
    이전 Docker 이미지 및 구성으로 되돌립니다.
  </Step>

  <Step title="재시작 및 재동기화">
    서비스를 재시작하고 네트워크와 재동기화합니다.
  </Step>

  <Step title="기능 검증">
    RPC 엔드포인트 및 트랜잭션 기능을 다시 테스트합니다.
  </Step>

  <Step title="팀에 알림">
    애플리케이션 팀에 복원을 알립니다.
  </Step>
</Steps>

## 모범 사례

### 자동화 및 모니터링

* 가능한 경우 이미지 가져오기 및 구성 업데이트 자동화
* 버전 관리된 구성으로 변경 추적
* 업그레이드 중 관측 가능성 향상
* 재시작 후 RPC 오류율, 동기화 상태 및 트랜잭션 처리량을 면밀히 모니터링

## 일반적인 문제 해결

업그레이드 후 문제가 발생하면:

* **합의 동기화**: 엔드포인트 연결성, 자격 증명 및 허용 목록 상태 확인
* **RPC 오류**: 구성, 버전 호환성 및 업데이트된 인터페이스 검증
* **성능 회귀**: 리소스 사용량 모니터링 및 릴리스 노트 검토

Plasma 비검증 노드 업그레이드는 스테이블코인 기반 애플리케이션을 위한 신뢰할 수 있고 안전한 RPC 인프라를 유지하는 데 필수적입니다. 구조화된 업그레이드 및 검증 절차를 따르면 위험을 최소화하고 원활한 성능을 보장합니다.