---
title: "Config Group 생성 및 관리"
slug: "cdss-configgroup"
status: "update"
updated: 2026-09-17T09:09:18Z
published: 2026-09-17T09:09:18Z
canonical: "guide-fin.ncloud-docs.com/cdss-configgroup"
---

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

# Config Group 생성 및 관리

Config Group은 Cluster에 적용된 Kafka 설정 파일을 관리하는 기능입니다. Cluster에 적용할 Kafka 설정 파일을 생성하고 삭제하는 방법과 Kafka Config 설정을 변경하는 방법을 설명합니다.

## Config Group 화면

Config Group의 화면 구성은 다음과 같습니다.

![cdss-configgroup_dashboard_ko](https://cdn.document360.io/0406ed95-101f-4cde-8dd8-308d03444a94/Images/Documentation/cdss-configgroup_dashboard_ko.png)

| 항목 | 설명 |
| --- | --- |
| ① Config Group 생성 | Config Group 생성 |
| ② Config 편집 | Config Group의 상세 정보 수정 |
| ③ 삭제 | Config Group 삭제 |
| ④ Config Group 목록 | 생성된 Config Group 목록 - **Config Group Name**: Config Group 이름 - **Version**: Config Group을 적용할 수 있는 Kafka의 Version. Cluster의 Kafka Version이 동일한 경우에만 Config Group 설정 가능 - **Description**: Config Group에 대한 설명. 사용자가 직접 작성(최대 255자). **[EDIT]** 버튼을 클릭하여 자유롭게 수정 가능 - **Cluster List**: 해당 Config Group을 사용 중인 Cluster 목록 확인 |

## Config Group 생성

Config Group을 생성할 수 있습니다. Config Group을 생성하면 자동으로 기본값이 지정되므로 별도로 설정 값을 지정할 필요가 없습니다. Config Group을 생성하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Big Data & Analytics** > **Cloud Data Streaming Service** > **Config Group** 메뉴를 차례대로 클릭해 주십시오.
2. **[Config Group 생성]** 버튼을 클릭해 주십시오.
3. Config Group 생성 창이 나타나면 필요한 정보를 입력해 주십시오.  

![config_group_create.png](https://cdn.document360.io/0406ed95-101f-4cde-8dd8-308d03444a94/Images/Documentation/config_group_create.png)
  - Version: 생성하려는 Config Group의 Kafka 버전 선택
  - Config Group Name: Config Group의 이름 입력
    - 영문 소문자, 숫자, 하이픈(-)만 입력 가능. 첫 글자와 마지막 글자에는 하이픈(-) 입력 불가
    - 최소 3자 이상, 30자 이하 입력 가능
  - Description: Config Group에 대한 간단한 설명 작성
4. **[확인]** 버튼을 클릭해 주십시오.
5. Config Group이 생성되었는지 확인해 주십시오.

## Config Group 편집

Cluster 생성 시 Config에 기본값이 적용되므로 사용자는 Config 값을 별도로 지정하지 않아도 됩니다. 하지만 Kafka Config 설정 변경이 필요한 경우, Config Group 편집 기능을 사용하여 사용자가 직접 변경할 수 있습니다. 사용자가 Kafka Config 설정을 임의로 변경하는 과정에서 클러스터가 정상적으로 동작하지 않을 수 있으므로, Kafka에 대한 기본 지식이 있는 경우에만 Config Group을 변경해 주십시오. Config Group을 편집하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Big Data & Analytics** > **Cloud Data Streaming Service** > **Config Group** 메뉴를 차례대로 클릭해 주십시오.
2. 편집할 Config Group의 체크 박스를 클릭한 후 **[Config 편집]** 버튼을 클릭해 주십시오.
  - Kafka의 설정 파일(server.properties)에서 변경 가능한 설정 항목이 나타납니다.
3. Kafka Config 설정을 변경해 주십시오.
  - 설정 값에 대한 설명은 [Apache Kafka Documentation](https://kafka.apache.org/documentation/#configuration)을 참조해 주십시오.
4. Config를 기본값으로 재설정하려면 **[기본값으로 재설정]** 버튼을 클릭해 주십시오.
5. Config 편집이 완료되면 **[확인]** 버튼을 클릭해 주십시오.  

![cdss-configgroup_edit01_ko](https://cdn.document360.io/0406ed95-101f-4cde-8dd8-308d03444a94/Images/Documentation/cdss-configgroup_edit01_ko.png)

참고

- 편집을 완료했더라도 Cluster를 재시작하기 전에는 Cluster에 반영되지 않습니다. Config Group을 적용하는 방법에 대한 자세한 설명은 [Cluster에 Config Group 적용](/docs/cdss-configgroup#Cluster%EC%97%90ConfigGroup%EC%A0%81%EC%9A%A9)을 참조해 주십시오.
- 모든 Properties를 지원하는 것은 아니며, Properties 추가가 필요한 경우에는 고객 센터로 문의해 주십시오.

주의

- 사용자 임의로 Config 값을 수정하여 Cluster가 정상 동작하지 않는 경우, 네이버클라우드는 운영에 대한 책임을 보장하지 않습니다.
- Config 값을 수정한 후 Cluster가 정상 동작하지 않을 경우, **[기본값으로 재설정]** 버튼을 클릭하면 기본값으로 다시 설정할 수 있습니다.

## Cluster에 Config Group 적용

Cluster에 Config Group을 적용하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Big Data & Analytics** > **Cloud Data Streaming Service** > **Cluster** 메뉴를 차례대로 클릭해 주십시오.
2. Config Group을 적용할 Cluster의 상세 정보 영역에서 ConfigGroup의 ![cdss-cluster-popupicon](https://cdn.document360.io/0406ed95-101f-4cde-8dd8-308d03444a94/Images/Documentation/cdss-cluster-popupicon.png) 아이콘을 클릭해 주십시오.  

![cdss-configgroup_cluster01_ko](https://cdn.document360.io/0406ed95-101f-4cde-8dd8-308d03444a94/Images/Documentation/cdss-configgroup_cluster01_ko.png)
3. Config Group 변경 창이 나타나면 적용할 Config Group을 선택한 후 **[확인]** 버튼을 클릭해 주십시오.  

![cdss-configgroup_cluster02_ko](https://cdn.document360.io/0406ed95-101f-4cde-8dd8-308d03444a94/Images/Documentation/cdss-configgroup_cluster02_ko.png)
4. Config Group 변경 확인 창이 나타나면 **[확인]** 버튼을 클릭해 주십시오.
  - Cluster에 Config Group의 변경된 내용이 적용된 후 Cluster가 재시작됩니다.

주의

Cluster에 Config Group을 적용할 경우, Config Group의 변경된 내용이 적용된 후 Cluster가 재시작됩니다. Cluster 재시작 시 서비스가 일시적으로 중단되므로 Config Group을 적용하기 전에 Cluster를 재시작해도 문제가 없는 상태인지 미리 확인해 주십시오.

## Config Group 삭제

더 이상 사용하지 않는 Config Group을 삭제할 수 있습니다. 단 Config Group을 사용하고 있는 Cluster가 있을 경우에는 삭제할 수 없으므로 해당 Config Group을 사용하고 있는 Cluster를 삭제하거나 Cluster의 Config Group을 변경해야 합니다.

Config Group을 삭제하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Big Data & Analytics** > **Cloud Data Streaming Service** > **Config Group** 메뉴를 차례대로 클릭해 주십시오.
2. 삭제할 Config Group의 체크 박스를 클릭한 후 **[삭제]** 버튼을 클릭해 주십시오.
3. 삭제 창이 나타나면 **[확인]** 버튼을 클릭해 주십시오.

참고

Config Group이 적용된 Cluster를 확인하려면 Cluster List의 ![cdss-cluster-popupicon](https://cdn.document360.io/0406ed95-101f-4cde-8dd8-308d03444a94/Images/Documentation/cdss-cluster-popupicon.png)을 클릭해 주십시오.