> 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/backup.md).

# 백업

## 1. 백업 생성 전 사전 작업

* 백업을 생성하기 위해서는 <mark style="color:red;">저장소를 생성</mark>해야 합니다. [**여기**](/cocktail-cloud-online/backup-restore/storage-registration.md)를 참고하세요.

## 2. 백업 생성 페이지 접속

1. &#x20;\[백업·복원] - \[백업] 섹션을 선택합니다.

<figure><img src="/files/UJXJD6jZAheclg92Ti33" alt=""><figcaption><p>[화면] 백업 페이지 접속</p></figcaption></figure>

2. \[생성] 버튼을 클릭합니다.

<figure><img src="/files/D0rfcJ2cmQGKuT2d0ckj" alt=""><figcaption><p>[화면] 백업 생성 페이지 접속</p></figcaption></figure>

## 3. 백업 정보 입력

1. 백업 정보를 입력합니다.

<figure><img src="/files/wuszLOntgFRWPATYI5Wl" alt=""><figcaption><p>[화면] 백업 정보 입력</p></figcaption></figure>

### 3.1 기본 설정

{% hint style="info" %}
백업으로 보호할 클러스터와 데이터 저장소를 선택합니다.
{% endhint %}

<figure><img src="/files/eDQ7mW9cQ6zM7kW3AKvI" alt=""><figcaption><p>[화면] 기본 설정 입력</p></figcaption></figure>

<table><thead><tr><th width="163">항목(*는 필수)</th><th>내용</th></tr></thead><tbody><tr><td>이름*</td><td><ul><li>생성할 백업의 이름</li></ul></td></tr><tr><td>클러스터 선택*</td><td><ul><li>백업할 클러스터</li></ul></td></tr><tr><td>저장소 선택*</td><td><ul><li>저장소를 선택</li><li>Read Write 권한이 있는 저장소만 선택 가능</li></ul></td></tr><tr><td>백업 보존 기간*</td><td><ul><li>백업 보존 기간</li><li>시간 단위로 숫자만 기입</li></ul></td></tr></tbody></table>

### 3.2 백업 범위

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

<figure><img src="/files/YbXP15xDff7jKUILIRuR" alt=""><figcaption><p>[화면] 백업 범위 입력</p></figcaption></figure>

#### 1. 백업 가능한 리소스 상세 보기

* <img src="/files/eDDdQZ8n2ZaxOY80aawf" alt="" data-size="line">버튼은 선택 가능한 리소스 목록과 해당 리소스들의 세부 정보를 제공하는 화면으로 연결됩니다.<br>

  <figure><img src="/files/bkPFdGVtAXf2OGbEMXaQ" alt=""><figcaption></figcaption></figure>
* 괄호 안의 숫자는 백업 가능한 리소스의 전체 갯수를 의미합니다.

#### 2. 백업 범위

* 백업 범위는 \[전체 클러스터]를 선택하여 전체 클러스터를 백업하거나, \[네임스페이스 선택]으로 특정 네임스페이스만 선택할 수 있습니다.

* \[네임스페이스 선택]을 선택하면 아래와 같이 추가 항목이 표시됩니다.<br>

  <figure><img src="/files/zWRqpl5ZoAhxqRc18uuj" alt=""><figcaption><p>[화면] 네임스페이스 선택</p></figcaption></figure>

* <img src="/files/Wh8uxmi7jGI1BofyprKr" alt="" data-size="line">아이콘을 클릭하여 네임스페이스를 선택하고, \[적용] 버튼을 클릭합니다.<br>

  <figure><img src="/files/pycx9igFPvbcPjupiM0c" alt=""><figcaption><p>[화면] 네임스페이스 선택</p></figcaption></figure>

* 선택된 네임스페이스를 확인합니다.<br>

  <figure><img src="/files/gynACmqoiGpymjQ4vIZc" alt=""><figcaption><p>[화면] 선택된 네임스페이스 확인</p></figcaption></figure>

#### 3. 라벨 선택기

* 백업 시 라벨 선택기를 사용하면 특정 라벨이나 라벨 조건에 해당하는 리소스만을 대상으로 백업을 수행할 수 있습니다.
* <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>

#### 4. 리소스

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

  <figure><img src="/files/19Lre1RnXM593G3UVIJ8" alt=""><figcaption><p>[화면] 리소스 선택</p></figcaption></figure>

### 3.3 스케쥴

<figure><img src="/files/56mCDmvupQHcOIST5Ef3" alt=""><figcaption><p>[화면] 복원 생성 - 스케쥴</p></figcaption></figure>

* 스케쥴은 '사용하지 않음'을 선택하면 <mark style="color:red;">즉시 한 번만 백업이 실행</mark>되지만, '스케쥴 실행'을 선택하면 원하는 시간(지정된 주기)에 따라 자동으로 백업이 실행됩니다.
* 스케쥴 실행'을 선택한 경우, 백업은 <mark style="color:red;">즉시 실행되지 않고, 지정된 시간에 자동</mark>으로 실행됩니다.
* cron 표현식이나 @every notation을 사용하여 원하는 시간 혹은 주기를 지정할 수 있습니다.

<pre><code><strong>#1 UTC time 사용하는 Cron 표현식으로 정의
</strong>   * * * * *
   │ │ │ │ │
   │ │ │ │ └─ 요일 (0-6, 0과 7은 일요일)
   │ │ │ └─── 월 (1-12)
   │ │ └───── 날짜 (1-31)
   │ └─────── 시간 (0-23)
   └───────── 분 (0-59)
   
#2 @every notation : "@every 6h", "@every 24h","@every 168h"
   최대 단위가 시간(시간, 분, 초 조합 가능)
</code></pre>

## 4. 백업 정보 저장

1. \[저장] 버튼을 클릭합니다.

<figure><img src="/files/5nqprLBDb3u9yVk4N0NO" alt=""><figcaption><p>[화면] 백업 정보 저장</p></figcaption></figure>

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

<figure><img src="/files/k1I57RzOykMuU1siDTOS" alt=""><figcaption><p>[화면] 백업 정보 저장</p></figcaption></figure>

## 5. 백업 확인

### 5.1 백업 확인

1. 생성한 백업은 백업 목록에서 확인할 수 있습니다.

<figure><img src="/files/s8b8vNbJhsimekDEVNyL" alt=""><figcaption><p>[화면] 백업 목록</p></figcaption></figure>

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

<figure><img src="/files/jAP4gcvl5hzktB1eXSB5" alt=""><figcaption><p>[화면] 백업 목록</p></figcaption></figure>

<figure><img src="/files/rTgYHMcv3H0f0BllUhsF" alt=""><figcaption><p>[화면] 백업 상세</p></figcaption></figure>

{% hint style="info" %}
최근 실행 상태는 가장 최근에 실행된 백업으로 인해 생성된 복원 지점의 상태를 나타냅니다. 상태에 대한 자세한 설명은 [여기](https://cocktailcloud.gitbook.io/cocktail-cloud-online/backup-restore/pages/Lp0ukvXD5gJH3Exeundv#id-5.)를 참고하세요.
{% endhint %}

### 5.2 복원 지점 확인

1. 해당 백업이 실행되면 복원 지점이 추가됩니다.\
   스케쥴 백업일 경우, 일정에 맞춰 백업이 실행되고, 복원 지점이 추가됩니다.

<figure><img src="/files/VV6cenunmy3F2DCIkIkC" alt=""><figcaption><p>[화면] 백업 상세</p></figcaption></figure>

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

<figure><img src="/files/y3DACKON7N5Df8WH4tN6" alt=""><figcaption><p>[화면] 백업 상세 - 복원 지점 상세</p></figcaption></figure>

3. 모든 복원 지점 목록은 \[백업/복원] - \[복원 지점]에서 확인할 수 있습니다.

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

4. 해당 복원 지점의 세부 정보를 확인하려면 복원 지점 이름을 클릭하세요.&#x20;

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

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

## 6. 스케쥴 백업 실행/정지

1. 해당 스케쥴 백업의 상세 화면으로 이동합니다.

<figure><img src="/files/8AhBPGHJuWsjGy7OY19k" alt=""><figcaption><p>[화면] 백업 목록</p></figcaption></figure>

2. \[스케쥴 일시중지] 버튼을 클릭합니다.

<figure><img src="/files/g1bYV6bDp5XNa1TGtz7g" alt=""><figcaption><p>[화면] 스케쥴 백업 상세</p></figcaption></figure>

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

<figure><img src="/files/Y8zqdpPVOUcgdt4gVQel" alt=""><figcaption><p>[화면] 스케쥴 일시 중지</p></figcaption></figure>

4. 스케쥴이 중지된 것을 확인합니다.

<figure><img src="/files/A7WyjsA4C8UNrghtXiev" alt=""><figcaption><p>[화면] 스케쥴 중지 확인</p></figcaption></figure>

5. 다시 스케쥴을 시작하길 원하는 경우, <img src="/files/29nylxK4L3L97Ft8y6ke" alt="" data-size="line">버튼을 클릭하여 위 작업을 반복하세요.

## 7. 즉시 실행

{% hint style="info" %}
백업을 즉시 실행할 경우, 백업이 실행되어 복원 지점이 생성됩니다.
{% endhint %}

1. 해당 백업의 상세 화면으로 이동합니다.

<figure><img src="/files/R2obTGjAXCNaXZNmUbCF" alt=""><figcaption><p>[화면] 백업 목록</p></figcaption></figure>

2. \[즉시 실행] 버튼을 클릭합니다.

<figure><img src="/files/HdjQfybsLlWbS37BHYWk" alt=""><figcaption><p>[화면] 백업 상세 - 즉시 실행</p></figcaption></figure>

3. 생성된 복원 지점을 확인하세요.

<figure><img src="/files/AsUtDC9mH3F6edMWj4cm" alt=""><figcaption><p>[화면] 백업 상세 - 즉시 실행 - 복원 지점 생성</p></figcaption></figure>

## 8. 복제

{% hint style="info" %}
복제는 이전에 생성한 백업 설정을 기반으로 새로운 설정을 추가하거나 기존 설정을 수정하여 새로운 백업을 저장할 수 있습니다.
{% endhint %}

1. 해당 백업의 상세 화면으로 이동합니다.

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

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

<figure><img src="/files/9nXcUL69l73Uk0XVyRHW" alt=""><figcaption><p>[화면] 백업 상세 - 복제</p></figcaption></figure>

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

<figure><img src="/files/p2uzsjPZTRXC7xTEpRe5" alt=""><figcaption><p>[화면] 백업 복제 확인 팝업창</p></figcaption></figure>

4. 새로운 설정을 추가하거나 기존 설정을 수정합니다.

<figure><img src="/files/vQeX7MV5DllwyAJ8GRpj" alt=""><figcaption><p>[화면] 백업 복제</p></figcaption></figure>


---

# 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/backup.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.