선언형 파이프라인

선언형 파이프라인은 YAML 파일을 사용하여 코드로 완전히 Qlik Talend Data Integration 파이프라인 프로젝트를 정의하고, 구성하고, 배포할 수 있게 해줍니다.파일을 모든 통합 개발 환경 또는 버전 제어 시스템에서 편집한 다음, 배포하여 프로젝트를 생성하거나 업데이트합니다.

선언형 파이프라인은 언제 사용해야 하나요?

선언적 파이프라인을 사용하여 승격:

• 공동 작업

• 지속적 통합 / 지속적 배포

• 다른 환경으로의 반복 가능한 배포

• API 기반 자동화

일반적인 사용 사례는 다음과 같습니다.

• 지속적인 통합 및 개발 자동화를 위해 코드에서 파이프라인을 정의합니다.

• 동일한 파이프라인 구성을 여러 환경(개발, 검증, 프로덕션)에 배포합니다.

• 프로젝트 또는 팀 간에 파이프라인 정의를 재사용하고 공유합니다.

• Automate 수동 작업 없이 대규모 프로젝트 생성을 Automate합니다.

작동 방식

파이프라인 프로젝트는 프로젝트의 작업 및 데이터세트를 반영하는 폴더 구조로 구성된 YAML 파일 세트로 표현됩니다.YAML 파일은 읽기, 차이점 확인, 검토, 재사용 및 자동화 생성이 더 쉽습니다.

기존 프로젝트를 YAML로 내보내고, 파일을 편집한 다음, 다시 가져와 변경 사항을 적용할 수 있습니다.프로젝트가 버전 제어에 연결되어 있는 경우, YAML 파일은 GitHub 리포지토리에서 직접 사용할 수 있습니다.

YAML 파일 구조에 대한 자세한 내용은 다음을 참조하십시오. 파이프라인 구성 가져오기 및 편집.

일반적인 워크플로

시작하기 전에, 개발 환경과 버전 제어를 설정해야 합니다.자세한 내용은 선언형 파이프라인 시작하기을 참조하십시오.

일반적인 선언적 파이프라인 워크플로는 다음과 같습니다:

1. 파이프라인 구성 가져오기

   기존 프로젝트를 YAML로 내보내거나, 버전 제어에서 가져오거나, 템플릿에서 시작할 수 있습니다.

   파이프라인 구성 가져오기 및 편집

2. 파이프라인 구성 편집

   개발 환경에서 YAML 파일을 수정하세요.작업을 추가하고, 소스 선택을 변경하고, 설정을 업데이트할 수 있습니다.

   개발자 가이드: 선언형 파이프라인

3. 파이프라인 구성의 유효성을 검사합니다.

   파이프라인을 배포하기 전에 파일의 구문 및 의미 오류를 검사합니다.

   파이프라인 구성의 유효성 검사

4. 파이프라인 구성 배포

   프로젝트를 생성하거나 업데이트하려면 Qlik Talend Data Integration에 파일을 가져오세요.

   파일을 버전 제어에 커밋하고 Qlik Talend Data Integration에서 프로젝트에 버전 제어로부터 적용을 수행할 수도 있습니다.

   파이프라인 구성 배포

버전 제어와의 관계

프로젝트가 버전 제어에 연결되면, YAML 파일은 GitHub 리포지토리에 직접 저장됩니다.YAML 파일을 GitHub 또는 모든 IDE에서 편집한 다음 변경 내용을 프로젝트에 다시 적용할 수 있습니다.

프로젝트를 버전 제어에 연결하는 방법에 대한 자세한 내용은 버전 제어로 파이프라인 프로젝트 관리을(를) 참조하십시오.

AI 비서를 사용하여 파이프라인 구성

AI 비서(예: GitHub Copilot 또는 Anthropic Claude)를 사용하여 YAML 구성 생성 및 편집을 간소화하세요.정확도와 프로젝트 표준 준수를 보장하려면, 다음 모범 사례를 팔로우하십시오:

1. 고성능 모델 선택 — 복잡한 YAML 생성 및 스키마 준수를 위해 표준 또는 '자동' 모델 대신 프리미엄 대규모 컨텍스트 모델(예: Anthropic Claude Sonnet 4.6 이상)을 사용하세요.고급 모델은 복잡한 파이프라인 스키마를 정확하게 해석하고 더 정확한 구성을 생성합니다.

2. 프로젝트별 AI 지침 구성 — 모델에 프로젝트 컨텍스트를 제공하여 AI 생성 구성 품질을 향상시킵니다.VS Code 작업 영역의 루트에 지침 파일을 만듭니다.다음 중 하나를 선택합니다.

   • CLAUDE.md (Anthropic Claude 코드 확장용)

   • .github/copilot-instructions.md (GitHub Copilot용)

   지시 파일의 내용은 다음과 같습니다:

   This is a Qlik Talend Cloud Pipeline (QTCP) project. Before any project advice or YAML edits, I MUST read the source of truth first:
   https://raw.githubusercontent.com/qlik-oss/schemas/refs/heads/main/qtcp/ai-instructions.md