# CI/CD 워크플로로 마이그레이션하기

Panther는 디택션 콘텐츠를 관리하기 위해 Console과 CI/CD 워크플로를 동시에 사용하는 것을 지원하지 않습니다. Panther Console에서 디택션을 관리하는 방식에서 CI/CD 워크플로를 통해 관리하는 방식으로 전환하고 싶고, 아직 해당 `panther-analysis` repo를 클론하거나 포크하지 않았다면, 아래 절차를 따르세요:

{% hint style="info" %}
이 페이지에서는 CI/CD 워크플로로의 초기 마이그레이션을 수행하는 방법을 설명합니다. 이미 CI/CD를 사용하고 있으며, [디택션 팩](/ko/detections/panther-managed/packs.md) 를 Panther Console에서 사용하지 않는 방식으로 마이그레이션하려면, 대신 [이 Knowledge Base 문서를](https://help.panther.com/articles/9211266919-how-can-i-transition-to-using-panther-with-just-a-ci-cd-workflow-for-our-cloned-repo) 를 따르세요.
{% endhint %}

### 1단계: Console에서 생성된 콘텐츠 다운로드

CI/CD는 업로드에 포함된 모든 항목을 덮어쓰며, 여기에는 규칙, 정책, 전역 헬퍼, 데이터 모델이 포함됩니다. Panther가 관리하는 enrichment provider 헬퍼, 전역 헬퍼 또는 데이터 모델의 자체 복사본을 만든 경우, 이들도 다운로드해야 합니다.

사용 가능한 옵션은 두 가지입니다. 모든 엔터티를 한 번에 일괄 다운로드하거나, 엔터티를 개별적으로 다운로드할 수 있습니다:

{% tabs %}
{% tab title="옵션 1: 모든 엔터티를 일괄 다운로드" %}
이 옵션을 사용하면 Panther Console에서 모든 디택션, 전역 헬퍼, 저장된 검색, 데이터 모델을 다운로드할 수 있습니다. 이 다운로드에는 활성화된 모든 항목(표준 Panther 규칙 포함)이 포함되며, 모든 파일이 하나의 폴더 아래에 출력됩니다. 파일을 올바른 저장소 구조로 옮겨야 합니다.

1. Panther Console의 왼쪽 탐색 모음에서 다음을 클릭하세요. **탐지.**
2. 오른쪽 상단에서 다음을 클릭하세요. **Upload**.
3. 다음에서 **Bulk Uploader** 모달에서 다음을 클릭하세요. **Download all entities**.
   {% endtab %}

{% tab title="옵션 2: 엔터티를 별도로 다운로드 " %}
**탐지 다운로드**

1. Panther Console의 왼쪽 탐색 모음에서 다음을 클릭하세요. **Detections**.
2. 다음을 클릭하세요. **필터** 아이콘. 다음에서 **작성자** 필터, 선택 **팀에서 작성**.
3. 다음을 클릭하세요. **필터 적용**.
4. 탐지의 각 페이지를 다운로드합니다.
   1. 대량을 확인 **모두 선택** 목록의 왼쪽 위 모서리에 있는 상자.
   2. 목록 상단에서, 클릭합니다 **Download**.

탐지는 버전 관리 시스템에 통합할 수 있는 zip 파일로 다운로드됩니다.

**도우미 다운로드**

1. Panther Console의 왼쪽 탐색 모음에서 다음을 클릭하세요. **탐지.**
2. 다음을 클릭하세요. **도우미** 탭.
3. 도우미 타일의 오른쪽에서, 클릭합니다 **...** 그다음 클릭합니다 **Download**.
4. 각 개별 도우미에 대해 반복합니다.

**데이터 모델 다운로드**

1. Panther Console의 왼쪽 탐색 모음에서 다음을 클릭하세요. **Detections**.
2. 다음을 클릭하세요. **데이터 모델** 탭.
3. 데이터 모델 타일의 오른쪽에서 클릭합니다 **...** 그다음 클릭합니다 **Download**.
4. 각 개별 데이터 모델마다 반복합니다.
   {% endtab %}
   {% endtabs %}

### 2단계: Developer Workflow 옵션을 활성화합니다

콘솔에서 Panther 디택션 Packs가 활성화되지 않도록 하려면, 개발자 워크플로 계정으로 자가 선언합니다:

1. Panther Console에서 다음으로 이동합니다 **설정 > 일반**.
2. 다음을 클릭하세요. **개발자 워크플로**.
3. 옵션을 다음으로 전환합니다 **ON** Panther 디택션 Packs가 콘솔에서 활성화되지 않도록 합니다.\
   ![Under the "Developer Workflows" tab, there is an option called "We use the Panther Analysis Tool to manage our detections." There is a toggle switch next to it, which is enabled.](/files/868d10ebfba1d19c6f7f72864bc0196d0f266ad1)

### 3단계: 사용자를 읽기 전용으로 표시합니다

사용자가 Panther Console에서 소스 제어와 충돌할 수 있는 편집을 하지 못하도록 하려면, 사용자를 읽기 전용으로 표시합니다:

1. Panther Console에서 다음으로 이동합니다 **설정 > 사용자**.
2. 사용자 목록에서 CI/CD 워크플로를 사용 중인 개발자를 찾습니다.
3. 다음을 클릭하세요. **...** 사용자 타일의 오른쪽에 있습니다. 나타나는 드롭다운 메뉴에서 다음을 클릭합니다. **편집**.
4. 사용자의 역할을 읽기 전용으로 변경합니다.
5. 다음을 클릭하세요. **Update**.
6. CI/CD 워크플로를 사용 중인 각 개발자에 대해 이 단계를 반복합니다.

### 4단계: CI/CD 워크플로 설정

* 다음 중 하나를 참조하세요 [GitHub Actions를 통한 Panther 콘텐츠 관리](/ko/panther/detections-repo/ci-cd/deployment-workflows/github-actions.md) 또는 [CircleCI를 통한 Panther 콘텐츠 관리](/ko/panther/detections-repo/ci-cd/deployment-workflows/circle-ci.md) CI/CD 워크플로를 설정합니다.


---

# Agent Instructions: 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:

```
GET https://docs.panther.com/ko/panther/detections-repo/ci-cd/migrating-to-a-ci-cd-workflow.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.