> 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).

# 복원

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

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

## 2. 복원 지점 선택

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

<figure><img src="/files/O7eTHZRC4FoK0YTpPPOO" alt=""><figcaption><p>[화면] 복원 지점 목록</p></figcaption></figure>

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

<figure><img src="/files/b8ELLOzwoMSHLcicbtyV" alt=""><figcaption><p>[화면] 복원 지점 - 복원</p></figcaption></figure>

## 3. 복원 정보 입력

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

<figure><img src="/files/eYfwpwQpm1fMhFqY2Ei1" alt=""><figcaption><p>[화면] 복원 생성</p></figcaption></figure>

### 3.1 복원 범위

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

<figure><img src="/files/uzUviToHoBBMzUvr9N3w" alt=""><figcaption><p>[화면] 복원 생성 - 복원 범위</p></figcaption></figure>

#### 1. 복원 범위

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

  <figure><img src="/files/ANS90kA3G0CzDKCRLuVV" alt=""><figcaption><p>[화면] 복원 생성 - 네임스페이스</p></figcaption></figure>
* <img src="/files/Wh8uxmi7jGI1BofyprKr" alt="" data-size="line">아이콘을 클릭하여 네임스페이스를 선택합니다.&#x20;
* 새로운 혹은 또 다른 네임스페이스로 복원하고 싶은 경우, \[배포 네임스페이스 명]에 네임스페이스 이름을 적습니다.
* \[적용] 버튼을 클릭합니다.<br>

  <figure><img src="/files/r2ugI1dkfbKrLUhsuzwu" alt=""><figcaption><p>[화면] 복원 생성 - 네임스페이스 팝업</p></figcaption></figure>
* 선택된 네임스페이스를 확인합니다.<br>

  <figure><img src="/files/axZXGRlj5Cv3WdoSo8Rj" alt=""><figcaption><p>[화면] 복원 생성 - 네임스페이스 확인</p></figcaption></figure>

#### 2. 라벨 선택기

* 복원 시 라벨 선택기를 사용하면 특정 라벨이나 라벨 조건에 해당하는 리소스만을 대상으로 복원을 수행할 수 있습니다.
* <img src="/files/UMFU0bQheavezUOM5MGG" alt="" data-size="line">아이콘을 클릭하여 이름과 값을 입력합니다.
* 복원 대상은 <mark style="color:red;">모든 지정된 라벨 조건을 만족</mark>하는 리소스로 제한됩니다.

<figure><img src="/files/9CIsTLruwYPOlcedP7Gy" alt="" width="432"><figcaption><p>[화면] 복원 생성 - 라벨 선택기</p></figcaption></figure>

#### 3. 리소스

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

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

* 스토리지 클래스 변경은 새로운 클러스터로 데이터를 복원할 때 해당 클러스터에서 사용하는 스토리지 클래스로 변경할 수 있는 옵션입니다.
* <img src="/files/UMFU0bQheavezUOM5MGG" alt="" data-size="line">아이콘을 클릭하여 Old Storage Class와 New Storage Class를 선택합니다.
* \[적용] 버튼을 클릭합니다.<br>

  <figure><img src="/files/egDQOo4FrgBhE2pRayYL" alt=""><figcaption></figcaption></figure>

### 3.2 복원 대상

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

<figure><img src="/files/1iBuiAQ0IQTJUfAMD7dE" 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="/files/Tcij5EYHmyb3uGLZhMRB" alt=""><figcaption><p>[화면] 복원 생성 - 실행</p></figcaption></figure>

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

<figure><img src="/files/rv2X3IeyeTDZe0xMDXuI" alt=""><figcaption><p>[화면] 복원 생성 - 실행 팝업</p></figcaption></figure>

## 5. 복원 확인

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

<figure><img src="/files/qKMwSOzHclWOjJC95fsU" alt=""><figcaption><p>[화면] 복원 이력 목록</p></figcaption></figure>

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

<figure><img src="/files/ACCZEjoi1upFnvr6e4wE" alt=""><figcaption><p>[화면] 복원 이력 목록 - 이름</p></figcaption></figure>

<figure><img src="/files/uACkjkqHMXKQu2mh5bMC" alt=""><figcaption><p>[화면] 복원 상세</p></figcaption></figure>

## 6. 복원 삭제

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

<figure><img src="/files/V7KGwjaxOPALcJzz2DCW" alt=""><figcaption><p>[화면] 복원 이력 - 체크 박스</p></figcaption></figure>

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

<figure><img src="/files/dU63Iic2R2WCKR6XoBDD" alt=""><figcaption><p>[화면] 복원 이력 - 삭제</p></figcaption></figure>

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

<figure><img src="/files/CWJG1RDVcXvQar1Wn90H" alt=""><figcaption><p>[화면] 복원 이력 - 삭제 팝업</p></figcaption></figure>

{% hint style="danger" %}

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


---

# 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://cocktailcloud.gitbook.io/cocktail-cloud-online/backup-restore/restore.md?ask=<question>&goal=<endgoal>
```

`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.