> For the complete documentation index, see [llms.txt](https://cocktailcloud.gitbook.io/cocktail-cloud-online/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cocktailcloud.gitbook.io/cocktail-cloud-online/backup-restore/restore.md).

# 복원

Cocktail 복원은 특정 시점의 쿠버네티스 상태로 시스템을 복원하여 시스템 장애, 사용자 오류, 또는 다른 예기치 못한 상황에 대응합니다.

## 1. 복원 생성 전 사전 작업

* 복원을 생성하기 위해서는 반드시 <mark style="color:red;">완료된 상태의 복원 지점</mark>이 있어야 합니다. [**여기**](/cocktail-cloud-online/backup-restore/backup.md)를 참고하세요.

## 2. 복원 지점 선택

1. \[백업/복원] - \[복원 지점] 섹션을 선택한 후, 복원하려는 복원 지점의 이름을 클릭합니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FbhM2WdxFW2X72AmrKz8g%2Fimage.png?alt=media&amp;token=c106cf71-b5d5-419c-a571-05bf42d184ac" alt=""><figcaption><p>[화면] 복원 지점 목록</p></figcaption></figure>

2. \[복원] 버튼을 클릭합니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FhfwRsg26HJC1CVusqK7F%2Fimage.png?alt=media&amp;token=66a694f8-1b40-4d9e-9d5b-6dff2777b37e" alt=""><figcaption><p>[화면] 복원 지점 - 복원</p></figcaption></figure>

## 3. 복원 정보 입력

1. 복원 정보를 입력합니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FhgHFFjULwvfUmzQirZXF%2Fimage.png?alt=media&amp;token=731abd98-4a60-4038-9e3c-646f1713fe5a" alt=""><figcaption><p>[화면] 복원 생성</p></figcaption></figure>

### 3.1 복원 범위

{% hint style="info" %}
복원 범위는 전체 클러스터 또는 특정 네임스페이스 선택, 라벨 선택기, 그리고 복원할 리소스를 선택합니다.
{% endhint %}

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2F7bPD8jgumpi9dpsf1zRn%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202024-01-10%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%205.25.20.png?alt=media&amp;token=07cb5c49-8e6f-439a-9c94-6180e8e9a8f1" alt=""><figcaption><p>[화면] 복원 생성 - 복원 범위</p></figcaption></figure>

#### 1. 복원 범위

* 복원 범위는 \[전체 클러스터]를 선택하여 전체 클러스터를 복원하거나, \[네임스페이스 선택]으로 특정 네임스페이스만 선택할 수 있습니다.
* \[네임스페이스 선택]을 선택하면, 아래와 같이 추가 항목이 표시됩니다.

  <figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FCYMFjRHKUOtO4fSSpN1i%2F%E1%84%87%E1%85%A9%E1%86%A8%E1%84%8B%E1%85%AF%E1%86%AB%20-%20%E1%84%82%E1%85%A6%E1%84%8B%E1%85%B5%E1%86%B7%E1%84%89%E1%85%B3%E1%84%91%E1%85%A6%E1%84%8B%E1%85%B5%E1%84%89%E1%85%B3%20%E1%84%92%E1%85%A1%E1%86%BC%E1%84%86%E1%85%A9%E1%86%A8.png?alt=media&amp;token=fecb6855-85a5-4dcf-943f-eb089d260138" alt=""><figcaption><p>[화면] 복원 생성 - 네임스페이스</p></figcaption></figure>
* <img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FeE7xCx3N1hTytzIAccxE%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202024-01-10%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%201.28.15.png?alt=media&amp;token=81283cd2-d2de-4864-a633-0d7f7409e007" alt="" data-size="line">아이콘을 클릭하여 네임스페이스를 선택합니다.&#x20;
* 새로운 혹은 또 다른 네임스페이스로 복원하고 싶은 경우, \[배포 네임스페이스 명]에 네임스페이스 이름을 적습니다.
* \[적용] 버튼을 클릭합니다.<br>

  <figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FdB4119JFLNFwwo22JDyY%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202024-01-10%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%205.34.50.png?alt=media&amp;token=04f2e4e1-34e8-4c1c-a636-8f9c761a6bff" alt=""><figcaption><p>[화면] 복원 생성 - 네임스페이스 팝업</p></figcaption></figure>
* 선택된 네임스페이스를 확인합니다.<br>

  <figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FA4Wgs7EXq8HG4hATdoAN%2F%E1%84%87%E1%85%A9%E1%86%A8%E1%84%8B%E1%85%AF%E1%86%AB%20%E1%84%89%E1%85%A2%E1%86%BC%E1%84%89%E1%85%A5%E1%86%BC%20-%20%E1%84%82%E1%85%A6%E1%84%8B%E1%85%B5%E1%86%B7%E1%84%89%E1%85%B3%E1%84%91%E1%85%A6%E1%84%8B%E1%85%B5%E1%84%89%E1%85%B3.png?alt=media&amp;token=8d661a06-386d-4acd-968d-121815689ba7" alt=""><figcaption><p>[화면] 복원 생성 - 네임스페이스 확인</p></figcaption></figure>

#### 2. 라벨 선택기

* 복원 시 라벨 선택기를 사용하면 특정 라벨이나 라벨 조건에 해당하는 리소스만을 대상으로 복원을 수행할 수 있습니다.
* <img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FTxItgd10MoLJeeiSPAAI%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202024-01-10%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%201.36.49.png?alt=media&amp;token=5479bae0-33a9-479a-ae28-66bfd8b1e345" alt="" data-size="line">아이콘을 클릭하여 이름과 값을 입력합니다.
* 복원 대상은 <mark style="color:red;">모든 지정된 라벨 조건을 만족</mark>하는 리소스로 제한됩니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2Fgit-blob-5c8d0219aa0ddc4d469aed1d8e6d8b6af8c59e00%2Fimage.png?alt=media" alt="" width="432"><figcaption><p>[화면] 복원 생성 - 라벨 선택기</p></figcaption></figure>

#### 3. 리소스

* 리소스에서 \[전체 리소스]를 선택하면 클러스터 내의 모든 리소스를 복원 대상으로 설정하고, \[리소스 선택]을 선택하면 특정 리소스만을 선택적으로 복원할 수 있습니다.
* \[리소스 선택]을 선택하면 아래와 같이 추가 항목이 표시됩니다.

#### 4. 스토리지 클래스 변경

* 스토리지 클래스 변경은 새로운 클러스터로 데이터를 복원할 때 해당 클러스터에서 사용하는 스토리지 클래스로 변경할 수 있는 옵션입니다.
* <img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FTxItgd10MoLJeeiSPAAI%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202024-01-10%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%201.36.49.png?alt=media&amp;token=5479bae0-33a9-479a-ae28-66bfd8b1e345" alt="" data-size="line">아이콘을 클릭하여 Old Storage Class와 New Storage Class를 선택합니다.
* \[적용] 버튼을 클릭합니다.<br>

  <figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FqSpM3TxGAl36oF5obeVG%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202024-01-10%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%206.03.35.png?alt=media&amp;token=0663db82-da63-4be4-827f-91dbac23361e" alt=""><figcaption></figcaption></figure>

### 3.2 복원 대상

{% hint style="info" %}
복원 대상 설정은 복원할 클러스터와 해당 복원 이름을 지정합니다.
{% endhint %}

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FFuNsMiNBVs4j4aDoudb7%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202024-01-10%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%206.07.26.png?alt=media&amp;token=3bfe3a6c-20ee-481b-872c-54b27914bb79" alt=""><figcaption><p>[화면] 복원 생성 - 복원 대상 설정</p></figcaption></figure>

<table><thead><tr><th width="198">항목(*는 필수)</th><th>설명</th></tr></thead><tbody><tr><td>복원 대상 클러스터*</td><td>복원할(이관될) 클러스터</td></tr><tr><td>복원 이름*</td><td>복원 이름</td></tr></tbody></table>

## 4. 복원 정보 실행

1. \[실행] 버튼을 클릭합니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FuuPRjZCWbedtnQI5zYYw%2Fimage.png?alt=media&amp;token=e4548b7c-1882-4be4-ac09-9a8722f1184f" alt=""><figcaption><p>[화면] 복원 생성 - 실행</p></figcaption></figure>

2. 아래 메시지를 확인하고, \[ok] 버튼을 클릭합니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FKi4hxr1aU7b9c9ljAy97%2Fimage.png?alt=media&amp;token=20257328-a62f-46bb-a1d7-5039c0e9bc1a" alt=""><figcaption><p>[화면] 복원 생성 - 실행 팝업</p></figcaption></figure>

## 5. 복원 확인

1. 생성한 복원은 복원 이력 목록에서 확인할 수 있습니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FUcEabB2pMB3s4EiNrPhj%2Fimage.png?alt=media&amp;token=99482f80-7cbc-4187-a9ba-c33092489ecc" alt=""><figcaption><p>[화면] 복원 이력 목록</p></figcaption></figure>

2. 해당 복원의 세부 정보를 확인하려면 복원 이름을 클릭하세요.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FyD9DZo8LkrLXuVezsNiM%2Fimage.png?alt=media&amp;token=9df0bae6-daf6-41a2-b7e4-6a93a831c808" alt=""><figcaption><p>[화면] 복원 이력 목록 - 이름</p></figcaption></figure>

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2Fw0MpEI4asCDubmIg7wxo%2Fimage.png?alt=media&amp;token=6749410e-6447-4c73-8cb9-c6638c19befe" alt=""><figcaption><p>[화면] 복원 상세</p></figcaption></figure>

## 6. 복원 삭제

1. &#x20;\[백업/복원] - \[복원 이력] 섹션으로 이동하여 목록에서 삭제하고자 하는 항목을 체크합니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2Fvo1oSSwSM8QiKpqsg9hO%2Fimage.png?alt=media&amp;token=af260212-5b81-467e-8217-d45a86eceeda" alt=""><figcaption><p>[화면] 복원 이력 - 체크 박스</p></figcaption></figure>

2. \[삭제] 버튼을 클릭합니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FCvvUVRdDW0pDuyW9HSr5%2Fimage.png?alt=media&amp;token=d978db11-83d9-498d-be9a-a9c43c6f74f9" alt=""><figcaption><p>[화면] 복원 이력 - 삭제</p></figcaption></figure>

3. \[ok] 버튼을 클릭합니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FbyvOS5T97TXYKrUucIPf%2Fimage.png?alt=media&amp;token=26dcfe3d-9ffb-49e0-9d47-f713848a48cc" alt=""><figcaption><p>[화면] 복원 이력 - 삭제 팝업</p></figcaption></figure>

{% hint style="danger" %}

* 같은 클러스터 내의 백업의 경우 복원 지점의 백업된 리소스를 삭제하는 경우 <mark style="color:red;">복원 이력이 함께 삭제되므로</mark> 주의해야 합니다.
* 다른 클러스터로의 백업의 경우 복원 지점의 백업된 리소스를 삭제하는 경우 복원 이력이 삭제되지는 않으나 복원 이력에서 백업 정보를 조회할 수 없습니다.&#x20;
  {% endhint %}