> For the complete documentation index, see [llms.txt](https://cocktailcloud.gitbook.io/cube/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/cube/reference/annotations.md).

# Annotations

쿠버네티스 어노테이션을 통해 CUBE 확장 기능을 사용할 수 있습니다. 지원하는 어노테이션을 아래와 같습니다.

## Node annotations

* `cube.acornsoft.io/protected`

`true` 로 지정하면 노드 스케일-인 수행 시 삭제 대상 노드에서 제외됩니다.

활용 예제 :

```
# master-1 노드를 삭제되지 않도록 보호합니다.
$ kubectl annotate node master-1 cube.acornsoft.io/protected=true --overwrite

# 해제
$ kubectl annotate node master-1 cube.acornsoft.io/protected-
```

* `cube.acornsoft.io/ansible-user`

노드별로 별도 SSH 사용자 접속 계정을 지정합니다.

활용 예제 :

```
# master-1 노드의 SSH 연결 계정을 "ubuntu" 로 지정합니다.
$ kubectl annotate node master-1 cube.acornsoft.io/ansible-user=ubuntu --overwrite

# 해제
$ kubectl annotate node master-1 cube.acornsoft.io/ansible-user-
```

* `cube.acornsoft.io/ansible-port`

노드별로 별도 SSH 연결 포트번호를 지정합니다.

활용 예제 :

```
# master-1 노드의 SSH 연결 포트를 3003 포트로 지정합니다.
$ kubectl annotate node master-1 cube.acornsoft.io/ansible-port=3003 --overwrite

# 해제
$ kubectl annotate node master-1 cube.acornsoft.io/ansible-port-
```


---

# 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/cube/reference/annotations.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.