> For the complete documentation index, see [llms.txt](https://docs.panther.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.panther.com/ko/panther/detections-repo/ci-cd/migrating-to-a-ci-cd-workflow.md).

# 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. 오른쪽 상단에서 다음을 클릭하세요: **업로드**.
3. 다음 **대량 업로더** 모달에서 다음을 클릭하세요 **모든 엔터티 다운로드**.
   {% endtab %}

{% tab title="옵션 2: 엔터티를 개별적으로 다운로드 " %}
**디택션 다운로드**

1. Panther Console의 왼쪽 탐색 모음에서 **탐지**.
2. 다음 타일을 클릭하세요: **필터** 아이콘. 다음에서 **Created by** 필터에서 선택 **팀에서 생성됨**.
3. 클릭합니다 **필터 적용**.
4. 디택션의 각 페이지를 다운로드하세요.
   1. 일괄 **전체 선택** 상자를 목록의 왼쪽 상단에서.
   2. 목록 상단에서, 다음을 클릭하세요 **다운로드**.

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

**도우미 다운로드**

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

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

1. Panther Console의 왼쪽 탐색 모음에서 **탐지**.
2. 다음 타일을 클릭하세요: **데이터 모델** 탭.
3. 데이터 모델 타일 오른쪽에서, 다음을 클릭하세요 **...** 그런 다음 클릭합니다 **다운로드**.
4. 각 개별 데이터 모델에 대해 반복합니다.
   {% endtab %}
   {% endtabs %}

### 단계 2: Panther Analysis Tool 옵션 사용 설정

Panther 디택션 팩이 Console에서 활성화되지 않도록 하려면, 개발자 워크플로 계정으로 직접 선언하세요:

1. Panther Console에서 다음을 클릭합니다: **설정** 왼쪽 탐색 모음 하단에서, 그런 다음 다음으로 이동하세요 **개발자 도구** > **Panther Analysis Tool**.
2. 옵션을 다음으로 전환하세요 `켜기` Panther 디택션 팩이 Console에서 활성화되지 않도록 합니다.\
   ![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. 클릭합니다 **업데이트**.
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
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://docs.panther.com/ko/panther/detections-repo/ci-cd/migrating-to-a-ci-cd-workflow.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.