목표: 지원되는 패키지를 활용하여 통합 기능을 준비하고 실제 Stream을 배포합니다. 패키지 설치와 데이터 수집 실행은 서로 다른 작업입니다.
Marketplace Lifecycle, Signing, Registry, AI Builder는 현재 개발 브랜치에 존재하는 기능입니다. 고정된 GA 릴리스에서 모두 검증된 것으로 간주하지 않습니다. UI 메뉴나 Install 버튼이 없으면 해당 버전에서는 제공되지 않는 것이므로 기존 Built-in Connector를 사용하세요.
이 사례는 이미 구성된 Connector·Destination·Stream을 전제로 합니다. 아직 생성하지 않았다면 커넥터별 수집 가이드에서 먼저 수집 Source를 설정하세요. 이후 이 페이지의 구체적인 단계를 수행하고 실제 Logs와 Destination/격리 기록을 검증합니다. 화면 캡처는 기존 테스트 증빙으로, 실제 결과를 대신하지 않습니다.
Connectors (/connectors)에서 배포된 버전이 제공하는 Marketplace / Browse Integrations 메뉴를 찾습니다. 패키지 관리 화면은 Administration → Connector Catalog (/admin/connector-catalog)에 나타날 수도 있습니다.
사용하려는 Vendor/Product를 검색합니다.
세부 화면에서 패키지 Origin, Package Version, Vendor API Version, 제공 Streams, 인증 방식, 호환성, License/Provenance, Trust/Support Tier를 확인합니다.
Imported 또는 Community 상태를 실제 Vendor API까지 검증한 Verified와 동일하게 취급하지 않습니다.
가능한 경우 Install을 선택합니다. 오프라인 설치는 현재 버전과 관리자 정책이 지원하는 Upload/Signed Bundle 경로만 사용합니다.
Registry에 Installed Version이 표시되는지 확인합니다.
Install만으로 Credential 생성, Stream Enable, Polling 시작, 실행 중 Stream 수정, Checkpoint 갱신이 발생해서는 안 됩니다.패키지 YAML/JSON에는 Secret이나 임의 실행형 Python/JavaScript/Shell 코드를 넣지 않습니다.
Upgrade / Rollback / Uninstall 전에는 의존 중인 Stream, Mapping, API Version 호환성과 변경 영향을 확인합니다. 패키지 업데이트가 실행 중 Stream이나 Schema Baseline을 자동 변경하지 않아야 하며, Rollback이 이미 전송한 이벤트나 Checkpoint까지 되돌리지는 않습니다.
패키지 신뢰도/버전 확인 → 설치 상태 확인 → 별도 Credential 생성 → Stream 실제 샘플 확인 → Route 전달/독립 수신 증명까지 완료해야 합니다. 설치 성공만으로 완료가 아닙니다.해당 Vendor의 패키지를 찾을 수 없다면 HTTP API Polling으로 범용 Connector를 구성합니다. Connectors & Marketplace, 제한 사항도 참고하세요.
마지막 수정일 2026년 10월 18일
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"DataRelay Control","description":"Data delivery, route processing, protection, and operational control for enterprise data flows.","colors":{"primary":"#C2410C","light":"#FB923C","dark":"#C75A00"},"logo":{"light":"https://mintcdn.com/datarelay-control/tSouZfeXx238dWIU/logo/light.svg?fit=max\u0026auto=format\u0026n=tSouZfeXx238dWIU\u0026q=85\u0026s=dbaae21bf2f930ba9c91c5c6f56131d1","dark":"https://mintcdn.com/datarelay-control/tSouZfeXx238dWIU/logo/dark.svg?fit=max\u0026auto=format\u0026n=tSouZfeXx238dWIU\u0026q=85\u0026s=e2996dc158fb10355bb1f62a7c5ea1a7","href":"https://control.datarelay.run"},"favicon":"https://mintcdn.com/datarelay-control/tSouZfeXx238dWIU/favicon.svg?fit=max\u0026auto=format\u0026n=tSouZfeXx238dWIU\u0026q=85\u0026s=712ef0b5b0545ce5dea415ca5ef77cf9","appearance":{"default":"system","strict":false},"navbar":{"links":[{"href":"https://datarelay.run/","label":"DataRelay"},{"href":"https://link.datarelay.run/","label":"Link"},{"href":"https://control.datarelay.run/","label":"Control"},{"href":"https://grant.datarelay.run/","label":"Grant"},{"href":"https://engineering.datarelay.run/","label":"Engineering"},{"href":"https://github.com/datarelay-labs/datarelay-control","type":"github"}]},"search":{"prompt":"Search DataRelay Control docs..."},"seo":{"metatags":{"canonical":"https://control.datarelay.run"},"indexing":"navigable"},"metadata":{"timestamp":true},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","href":""},{"language":"ko","href":"ko"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"datarelay-control","hasAudioNarration":false,"actualSubdomain":"datarelay-control","customDomains":["control.datarelay.run"],"gitSource":{"type":"github","owner":"datarelay-labs","repo":"datarelay-control-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ad4f6dd6410502f2e4657ca","collectionId":"3cd9860b-3224-48a0-9710-00991a4cf6c9","liveDeploymentHistoryId":"6ad4f6dd6410502f2e4657ca","schemaVersion":"v3"},"entitlements":{},"buildId":"6ad4f6dd6410502f2e4657ca","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"en","tag":"Step-by-step Use Cases","count":17},{"language":"ko","tag":"활용 사례별 따라하기","count":17},{"language":"en","tag":"Reference","count":8},{"language":"ko","tag":"참고","count":8},{"language":"en","tag":"Getting Started","count":7},{"language":"ko","tag":"시작하기","count":7},{"language":"en","tag":"Operations","count":4},{"language":"ko","tag":"운영","count":4},{"language":"en","tag":"Administration","count":3},{"language":"ko","tag":"관리","count":3},{"language":"en","tag":"Deployment","count":2},{"language":"en","tag":"Processing \u0026 Governance","count":2},{"language":"en","tag":"Security","count":2},{"language":"ko","tag":"배포","count":2},{"language":"ko","tag":"처리 \u0026 Governance","count":2},{"language":"ko","tag":"보안","count":2},{"language":"en","tag":"Roadmap","count":1},{"language":"ko","tag":"로드맵","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root{--dr-brand:#C2410C;--dr-brand-hover:#9A3412;--dr-brand-soft:#FFF7ED;--dr-product-accent:#047857;--dr-bg:#FFFFFF;--dr-surface:#FFFFFF;--dr-surface-subtle:#FAFAF9;--dr-ink:#1C1917;--dr-muted:#57534E;--dr-border:#E7E5E4;--dr-border-strong:#D6D3D1;--dr-shadow-sm:0 1px 2px rgb(28 25 23 / 0.05);--dr-shadow-md:0 14px 34px rgb(28 25 23 / 0.09);--dr-radius-sm:10px;--dr-radius-md:16px;--dr-radius-lg:24px}.dark{--dr-brand:#FB923C;--dr-brand-hover:#FDBA74;--dr-brand-soft:#2A160D;--dr-product-accent:#34D399;--dr-bg:#0C0A09;--dr-surface:#141210;--dr-surface-subtle:#1C1917;--dr-ink:#FAFAF9;--dr-muted:#C7C2BC;--dr-border:#292524;--dr-border-strong:#44403C;--dr-shadow-sm:0 1px 2px rgb(0 0 0 / 0.25);--dr-shadow-md:0 18px 42px rgb(0 0 0 / 0.32)}html{scroll-behavior:smooth}body{text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased}#navbar-transition{background:rgb(255 255 255/.9)!important;border-color:rgb(120 113 108/.16)!important;backdrop-filter:blur(16px) saturate(150%);-webkit-backdrop-filter:blur(16px) saturate(150%)}.dark #navbar-transition{background:rgb(12 10 9/.88)!important;border-color:rgb(231 229 228/.1)!important}.nav-logo{height:2rem!important}body,main h1,main h2{color:var(--dr-ink)}main h1{letter-spacing:-.038em;font-weight:760;line-height:1.08}main h2{letter-spacing:-.025em;font-weight:700}main h3{letter-spacing:-.015em}main li,main p{line-height:1.72}main blockquote{border-left:3px solid var(--dr-product-accent)!important;background:var(--dr-surface-subtle);border-radius:0 var(--dr-radius-sm) var(--dr-radius-sm) 0;padding:.8rem 1rem}main pre{border:1px solid var(--dr-border)!important;border-radius:var(--dr-radius-md)!important;box-shadow:var(--dr-shadow-sm)}main table{border-color:var(--dr-border)!important;border-radius:var(--dr-radius-sm)}.dr-hero-kicker{display:inline-flex;align-items:center;gap:.5rem;margin:0 0 1rem;padding:.42rem .7rem;border:1px solid #fed7aa;border-radius:999px;background:#fff7ed;color:#9a3412;font-size:.72rem;font-weight:760;letter-spacing:.12em;text-transform:uppercase}.dark .dr-hero-kicker{border-color:#7c2d12;background:#2a160d;color:#fdba74}.dr-hero-kicker+h1{max-width:950px;margin-top:0!important;font-size:clamp(2.7rem,6vw,4.85rem)!important;line-height:.98!important;letter-spacing:-.055em!important}.dr-hero-actions{display:flex;flex-wrap:wrap;gap:.7rem;margin:1.55rem 0 1.35rem}.dr-button{display:inline-flex;min-height:2.75rem;align-items:center;justify-content:center;border-radius:.72rem;padding:.68rem 1rem;border:1px solid transparent;font-size:.9rem;font-weight:680;line-height:1;text-decoration:none!important;transition:transform 150ms ease,border-color 150ms ease,background-color 150ms ease,box-shadow 150ms ease}.dr-button:hover{transform:translateY(-1px)}.dr-button-primary{background:var(--dr-brand);color:#fff!important;box-shadow:0 6px 18px rgb(194 65 12/.2)}.dr-button-primary:hover{background:var(--dr-brand-hover)}.dark .dr-button-primary{color:#1c1917!important}.dr-button-secondary{background:var(--dr-surface);color:var(--dr-ink)!important;border-color:var(--dr-border-strong);box-shadow:var(--dr-shadow-sm)}.dr-button-secondary:hover{border-color:var(--dr-product-accent)}.dr-family-strip{display:flex;align-items:center;gap:.35rem;margin:0 0 2rem;padding:.4rem;width:fit-content;max-width:100%;overflow-x:auto;border:1px solid var(--dr-border);border-radius:.85rem;background:var(--dr-surface-subtle);scrollbar-width:none}.dr-family-strip::-webkit-scrollbar{display:none}.dr-family-strip .dr-family-current,.dr-family-strip a{display:inline-flex;align-items:center;min-height:2rem;padding:.42rem .68rem;border-radius:.56rem;white-space:nowrap;color:var(--dr-muted)!important;font-size:.78rem;font-weight:650;text-decoration:none!important}.dr-family-strip a:hover{color:var(--dr-ink)!important;background:var(--dr-surface)}.dr-family-strip .dr-family-current{color:#fff!important;background:var(--dr-product-accent);box-shadow:var(--dr-shadow-sm)}.dark .dr-family-strip .dr-family-current{color:#0c0a09!important}.card{border-color:var(--dr-border)!important;border-radius:var(--dr-radius-md)!important;background:var(--dr-surface)!important;box-shadow:var(--dr-shadow-sm);transition:transform 160ms ease,box-shadow 160ms ease,border-color 160ms ease!important}.card:hover{transform:translateY(-2px);border-color:var(--dr-product-accent)!important;box-shadow:var(--dr-shadow-md)}[data-component-part=card-title]{letter-spacing:-.012em}[data-component-part=card-icon]{color:var(--dr-product-accent)!important}.callout{border-radius:var(--dr-radius-md)!important}footer{border-top-color:var(--dr-border)!important}:where(a, button, input, select, textarea):focus-visible{outline:3px solid var(--dr-product-accent)!important;outline-offset:3px!important}@media (max-width:768px){.dr-hero-kicker+h1{font-size:clamp(2.35rem,13vw,3.55rem)!important}.dr-hero-actions{display:grid;grid-template-columns:1fr}.dr-button,.dr-family-strip{width:100%}}@media (prefers-reduced-motion:reduce){html{scroll-behavior:auto}.card,.dr-button{transition:none!important}.card:hover,.dr-button:hover{transform:none}}"}],"page":{"pagePath":"ko/use-cases/marketplace-install","slug":"/ko/use-cases/marketplace-install","pageMetadata":{"title":"Marketplace 패키지에서 Stream 배포까지","description":"신뢰도·버전·라이선스를 검토하고 설치 후 Credential과 Stream을 별도로 설정합니다.","href":"/ko/use-cases/marketplace-install"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"신뢰도·버전·라이선스를 검토하고 설치 후 Credential과 Stream을 별도로 설정합니다.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Heading,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`marketplace를-이용해-connector-구성하기`,children:`Marketplace를 이용해 Connector 구성하기`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`목표:`}),` 지원되는 패키지를 활용하여 통합 기능을 준비하고 실제 Stream을 배포합니다. 패키지 설치와 데이터 수집 실행은 서로 다른 작업입니다.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Marketplace Lifecycle, Signing, Registry, AI Builder는 현재 `,_jsx(_components.strong,{children:`개발 브랜치`}),`에 존재하는 기능입니다. 고정된 GA 릴리스에서 모두 검증된 것으로 간주하지 않습니다. UI 메뉴나 Install 버튼이 없으면 해당 버전에서는 제공되지 않는 것이므로 기존 Built-in Connector를 사용하세요.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`적용-순서`,children:`적용 순서`}),`\n`,_jsxs(_components.p,{children:[`이 사례는 이미 구성된 Connector·Destination·Stream을 전제로 합니다. 아직 생성하지 않았다면 `,_jsx(_components.a,{href:`/ko/use-cases/index`,children:`커넥터별 수집 가이드`}),`에서 먼저 수집 Source를 설정하세요. 이후 이 페이지의 구체적인 단계를 수행하고 `,_jsx(_components.strong,{children:`실제 Logs와 Destination/격리 기록`}),`을 검증합니다. 화면 캡처는 기존 테스트 증빙으로, 실제 결과를 대신하지 않습니다.`]}),`\n`,_jsx(Heading,{level:`2`,id:`1-통합-패키지-선택`,children:`1. 통합 패키지 선택`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Connectors`}),` (`,_jsx(_components.code,{children:`/connectors`}),`)에서 배포된 버전이 제공하는 `,_jsx(_components.strong,{children:`Marketplace / Browse Integrations`}),` 메뉴를 찾습니다. 패키지 관리 화면은 `,_jsx(_components.strong,{children:`Administration → Connector Catalog`}),` (`,_jsx(_components.code,{children:`/admin/connector-catalog`}),`)에 나타날 수도 있습니다.`]}),`\n`,_jsx(_components.li,{children:`사용하려는 Vendor/Product를 검색합니다.`}),`\n`,_jsxs(_components.li,{children:[`세부 화면에서 `,_jsx(_components.strong,{children:`패키지 Origin, Package Version, Vendor API Version, 제공 Streams, 인증 방식, 호환성, License/Provenance, Trust/Support Tier`}),`를 확인합니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`Imported`}),` 또는 `,_jsx(_components.code,{children:`Community`}),` 상태를 실제 Vendor API까지 검증한 `,_jsx(_components.code,{children:`Verified`}),`와 동일하게 취급하지 않습니다.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`2-검증하고-설치`,children:`2. 검증하고 설치`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Built-in 또는 조직이 승인한 패키지를 선택합니다.`}),`\n`,_jsx(_components.li,{children:`Validation 경고와 플랫폼 호환성을 확인하고 차단 오류가 있으면 해결합니다.`}),`\n`,_jsxs(_components.li,{children:[`가능한 경우 `,_jsx(_components.strong,{children:`Install`}),`을 선택합니다. 오프라인 설치는 현재 버전과 관리자 정책이 지원하는 Upload/Signed Bundle 경로만 사용합니다.`]}),`\n`,_jsx(_components.li,{children:`Registry에 Installed Version이 표시되는지 확인합니다.`}),`\n`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Install만으로 Credential 생성, Stream Enable, Polling 시작, 실행 중 Stream 수정, Checkpoint 갱신이 발생해서는 안 됩니다.`})}),`\n`,_jsx(_components.p,{children:`패키지 YAML/JSON에는 Secret이나 임의 실행형 Python/JavaScript/Shell 코드를 넣지 않습니다.`}),`\n`,_jsx(Heading,{level:`2`,id:`3-실제-수집-stream-만들기`,children:`3. 실제 수집 Stream 만들기`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Connectors`}),`로 돌아가 패키지에서 제공하는 Connector/Preset을 선택합니다.`]}),`\n`,_jsxs(_components.li,{children:[`별도의 `,_jsx(_components.strong,{children:`Credential`}),`을 지원되는 인증 방식으로 구성합니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`/streams/new`}),`의 `,_jsx(_components.strong,{children:`Connect`}),`에서 해당 Connector를 지정합니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Run Test`}),`로 자신의 Vendor 계정에 실제 호출하고 응답을 확인합니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Record Selection`}),`에서 현재 이벤트 구조와 Event Root를 확정합니다. Package Sample/Schema는 초기 자료일 뿐 `,_jsx(_components.strong,{children:`실제 API 응답이 우선`}),`입니다.`]}),`\n`,_jsx(_components.li,{children:`테스트 Destination을 선택하고 Route Processing, Effective Preview를 확인합니다.`}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Deploy`}),` 후 필요한 경우 Stream을 Enable/Start합니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Logs`}),`의 Route 전송 기록과 실제 Destination 수신을 함께 확인합니다.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`4-업그레이드와-롤백-시-주의`,children:`4. 업그레이드와 롤백 시 주의`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Upgrade / Rollback / Uninstall`}),` 전에는 의존 중인 Stream, Mapping, API Version 호환성과 변경 영향을 확인합니다. 패키지 업데이트가 실행 중 Stream이나 Schema Baseline을 자동 변경하지 않아야 하며, Rollback이 이미 전송한 이벤트나 Checkpoint까지 되돌리지는 않습니다.`]}),`\n`,_jsx(Heading,{level:`2`,id:`완료-조건`,children:`완료 조건`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`패키지 신뢰도/버전 확인 → 설치 상태 확인 → 별도 Credential 생성 → Stream 실제 샘플 확인 → Route 전달/독립 수신 증명`}),`까지 완료해야 합니다. 설치 성공만으로 완료가 아닙니다.`]}),`\n`,_jsxs(_components.p,{children:[`해당 Vendor의 패키지를 찾을 수 없다면 `,_jsx(_components.a,{href:`/ko/use-cases/http-api`,children:`HTTP API Polling`}),`으로 범용 Connector를 구성합니다. `,_jsx(_components.a,{href:`/ko/administration/connectors-marketplace`,children:`Connectors \u0026 Marketplace`}),`, `,_jsx(_components.a,{href:`/ko/reference/limitations`,children:`제한 사항`}),`도 참고하세요.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Marketplace 패키지에서 Stream 배포까지","description":"신뢰도·버전·라이선스를 검토하고 설치 후 Credential과 Stream을 별도로 설정합니다.","href":"/ko/use-cases/marketplace-install"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Marketplace를 이용해 Connector 구성하기","slug":"marketplace를-이용해-connector-구성하기","depth":1,"children":[]},{"title":"적용 순서","slug":"적용-순서","depth":2,"children":[]},{"title":"1. 통합 패키지 선택","slug":"1-통합-패키지-선택","depth":2,"children":[]},{"title":"2. 검증하고 설치","slug":"2-검증하고-설치","depth":2,"children":[]},{"title":"3. 실제 수집 Stream 만들기","slug":"3-실제-수집-stream-만들기","depth":2,"children":[]},{"title":"4. 업그레이드와 롤백 시 주의","slug":"4-업그레이드와-롤백-시-주의","depth":2,"children":[]},{"title":"완료 조건","slug":"완료-조건","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"datarelay-control","siteName":"DataRelay Control","title":"Marketplace 패키지에서 Stream 배포까지 - DataRelay Control","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/use-cases/marketplace-install","matchLevel":1},"ko":{"href":"/ko/use-cases/marketplace-install","matchLevel":0}}},"lastModified":"2026-10-18T16:09:25.743Z","gitLastModified":"2026-10-18T16:09:18.000Z","originalFileLocation":"ko/use-cases/marketplace-install.mdx","locale":"ko"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"신뢰도·버전·라이선스를 검토하고 설치 후 Credential과 Stream을 별도로 설정합니다.\">\u003cmeta data-mint-head name=\"application-name\" content=\"DataRelay Control\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/datarelay-control/Jay7lA66uQT7y97k/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/datarelay-control/Jay7lA66uQT7y97k/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/datarelay-control/Jay7lA66uQT7y97k/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/datarelay-control/Jay7lA66uQT7y97k/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/datarelay-control/Jay7lA66uQT7y97k/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/datarelay-control/Jay7lA66uQT7y97k/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/datarelay-control/Jay7lA66uQT7y97k/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/datarelay-control/Jay7lA66uQT7y97k/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/datarelay-control/Jay7lA66uQT7y97k/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Marketplace 패키지에서 Stream 배포까지 - DataRelay Control\">\u003cmeta data-mint-head property=\"og:description\" content=\"신뢰도·버전·라이선스를 검토하고 설치 후 Credential과 Stream을 별도로 설정합니다.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"DataRelay Control\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://control.datarelay.run/ko/use-cases/marketplace-install\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://datarelay-control.mintlify.app/_mintlify/api/og/v2?division=%ED%99%9C%EC%9A%A9+%EC%82%AC%EB%A1%80%EB%B3%84+%EB%94%B0%EB%9D%BC%ED%95%98%EA%B8%B0\u0026amp;title=Marketplace+%ED%8C%A8%ED%82%A4%EC%A7%80%EC%97%90%EC%84%9C+Stream+%EB%B0%B0%ED%8F%AC%EA%B9%8C%EC%A7%80\u0026amp;description=%EC%8B%A0%EB%A2%B0%EB%8F%84%C2%B7%EB%B2%84%EC%A0%84%C2%B7%EB%9D%BC%EC%9D%B4%EC%84%A0%EC%8A%A4%EB%A5%BC+%EA%B2%80%ED%86%A0%ED%95%98%EA%B3%A0+%EC%84%A4%EC%B9%98+%ED%9B%84+Credential%EA%B3%BC+Stream%EC%9D%84+%EB%B3%84%EB%8F%84%EB%A1%9C+%EC%84%A4%EC%A0%95%ED%95%A9%EB%8B%88%EB%8B%A4.\u0026amp;theme=49091afdb5ce7328bec07c83\u0026amp;signature=243fc69041230d9d71b1016dd6ae44e7c3719570a40f177345b9e3890491c1d8\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Marketplace 패키지에서 Stream 배포까지 - DataRelay Control\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"신뢰도·버전·라이선스를 검토하고 설치 후 Credential과 Stream을 별도로 설정합니다.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://datarelay-control.mintlify.app/_mintlify/api/og/v2?division=%ED%99%9C%EC%9A%A9+%EC%82%AC%EB%A1%80%EB%B3%84+%EB%94%B0%EB%9D%BC%ED%95%98%EA%B8%B0\u0026amp;title=Marketplace+%ED%8C%A8%ED%82%A4%EC%A7%80%EC%97%90%EC%84%9C+Stream+%EB%B0%B0%ED%8F%AC%EA%B9%8C%EC%A7%80\u0026amp;description=%EC%8B%A0%EB%A2%B0%EB%8F%84%C2%B7%EB%B2%84%EC%A0%84%C2%B7%EB%9D%BC%EC%9D%B4%EC%84%A0%EC%8A%A4%EB%A5%BC+%EA%B2%80%ED%86%A0%ED%95%98%EA%B3%A0+%EC%84%A4%EC%B9%98+%ED%9B%84+Credential%EA%B3%BC+Stream%EC%9D%84+%EB%B3%84%EB%8F%84%EB%A1%9C+%EC%84%A4%EC%A0%95%ED%95%A9%EB%8B%88%EB%8B%A4.\u0026amp;theme=49091afdb5ce7328bec07c83\u0026amp;signature=243fc69041230d9d71b1016dd6ae44e7c3719570a40f177345b9e3890491c1d8\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/datarelay-control/Jay7lA66uQT7y97k/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"DataRelay Control\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#C2410C\">\u003clink data-mint-head rel=\"canonical\" href=\"https://control.datarelay.run/ko/use-cases/marketplace-install\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ko/use-cases/marketplace-install.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://control.datarelay.run/ko/use-cases/marketplace-install\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://control.datarelay.run/use-cases/marketplace-install\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://control.datarelay.run/use-cases/marketplace-install\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://control.datarelay.run/#organization\",\"name\":\"DataRelay Control\",\"url\":\"https://control.datarelay.run\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/datarelay-control/tSouZfeXx238dWIU/logo/light.svg?fit=max\u0026auto=format\u0026n=tSouZfeXx238dWIU\u0026q=85\u0026s=dbaae21bf2f930ba9c91c5c6f56131d1\"}},{\"@type\":\"WebSite\",\"@id\":\"https://control.datarelay.run#website\",\"name\":\"DataRelay Control\",\"url\":\"https://control.datarelay.run\",\"publisher\":{\"@id\":\"https://control.datarelay.run/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://control.datarelay.run/ko/use-cases/marketplace-install#webpage\",\"url\":\"https://control.datarelay.run/ko/use-cases/marketplace-install\",\"name\":\"Marketplace 패키지에서 Stream 배포까지\",\"description\":\"신뢰도·버전·라이선스를 검토하고 설치 후 Credential과 Stream을 별도로 설정합니다.\",\"dateModified\":\"2026-10-18T16:09:18.000Z\",\"isPartOf\":{\"@id\":\"https://control.datarelay.run#website\"},\"breadcrumb\":{\"@id\":\"https://control.datarelay.run/ko/use-cases/marketplace-install#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://control.datarelay.run/ko/use-cases/marketplace-install#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"활용 사례별 따라하기\",\"item\":\"https://control.datarelay.run/ko/use-cases/index\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Marketplace 패키지에서 Stream 배포까지\",\"item\":\"https://control.datarelay.run/ko/use-cases/marketplace-install\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://control.datarelay.run/ko/use-cases/marketplace-install#article\",\"headline\":\"Marketplace 패키지에서 Stream 배포까지\",\"name\":\"Marketplace 패키지에서 Stream 배포까지\",\"description\":\"신뢰도·버전·라이선스를 검토하고 설치 후 Credential과 Stream을 별도로 설정합니다.\",\"url\":\"https://control.datarelay.run/ko/use-cases/marketplace-install\",\"mainEntityOfPage\":{\"@id\":\"https://control.datarelay.run/ko/use-cases/marketplace-install#webpage\"},\"dateModified\":\"2026-10-18T16:09:18.000Z\",\"publisher\":{\"@id\":\"https://control.datarelay.run/#organization\"},\"isPartOf\":{\"@id\":\"https://control.datarelay.run#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"DataRelay Control\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"DataRelay Control","nav":{"global":null,"languages":[{"language":"en","pages":[{"title":"en","href":"/use-cases/marketplace-install"}]},{"language":"ko","groups":[{"group":"시작하기","icon":"rocket","pages":[{"title":"DataRelay Control","href":"/ko"},{"title":"개요","href":"/ko/getting-started/overview"},{"title":"아키텍처","href":"/ko/getting-started/architecture"},{"title":"빠른 시작","href":"/ko/getting-started/quickstart"},{"title":"첫 로그인","href":"/ko/getting-started/first-login"},{"title":"첫 Stream 만들기","href":"/ko/getting-started/first-stream"},{"title":"DataRelay Link 관계","href":"/ko/getting-started/data-relay-link"}]},{"group":"활용 사례별 따라하기","icon":"book","pages":[{"title":"활용 사례별 실습","href":"/ko/use-cases/index"},{"title":"스크린샷으로 따라 하는 Stream Wizard","href":"/ko/use-cases/screen-walkthrough"},{"title":"실습 환경 준비","href":"/ko/use-cases/lab-setup"},{"title":"Webhook 첫 이벤트 전송","href":"/ko/use-cases/webhook-first-flow"},{"title":"HTTP API 데이터 수집","href":"/ko/use-cases/http-api"},{"title":"PostgreSQL DB에서 이벤트 수집","href":"/ko/use-cases/postgresql-collection"},{"title":"S3·MinIO 버킷 로그 수집","href":"/ko/use-cases/s3-object-collection"},{"title":"SFTP 원격 파일에서 로그 수집","href":"/ko/use-cases/sftp-file-collection"},{"title":"하나의 Stream에서 2개 목적지 전송","href":"/ko/use-cases/multi-destination"},{"title":"외부 Route에서만 개인정보 마스킹","href":"/ko/use-cases/protect-pii"},{"title":"Schema 변경 확인 및 대응","href":"/ko/use-cases/schema-change"},{"title":"Quarantine·Release·Replay","href":"/ko/use-cases/quarantine-replay"},{"title":"전송 장애 진단과 복구","href":"/ko/use-cases/delivery-incident"},{"title":"Logs 필터링·Saved View·Export","description":"실패 이벤트를 식별하고 브라우저 저장 필터 및 CSV/JSON 증빙 파일을 만드는 방법입니다.","href":"/ko/use-cases/logs-audit"},{"title":"Marketplace 패키지에서 Stream 배포까지","href":"/ko/use-cases/marketplace-install"},{"title":"Syslog 수신기로 이벤트 전송","description":"SYSLOG_UDP Destination을 생성하고 실제 UDP 수신 데이터와 Route 로그를 비교합니다.","href":"/ko/use-cases/syslog-delivery"},{"title":"운영자 일일 점검","href":"/ko/use-cases/daily-operations"}]},{"group":"관리","icon":"gear","pages":[{"title":"관리 개요","href":"/ko/administration/overview"},{"title":"사용자 \u0026 역할","href":"/ko/administration/users-roles"},{"title":"Connectors \u0026 Marketplace","href":"/ko/administration/connectors-marketplace"}]},{"group":"처리 \u0026 Governance","icon":"route","pages":[{"title":"Route Processing","href":"/ko/processing/route-processing"},{"title":"Governance","href":"/ko/governance/overview"}]},{"group":"운영","icon":"screwdriver-wrench","pages":[{"title":"운영 개요","href":"/ko/operations/overview"},{"title":"백업 \u0026 복구","href":"/ko/operations/backup-restore"},{"title":"업그레이드","href":"/ko/operations/upgrades"},{"title":"문제 해결","href":"/ko/operations/troubleshooting"}]},{"group":"배포","icon":"server","pages":[{"title":"배포 요구사항","href":"/ko/deployment/requirements"},{"title":"네트워크 \u0026 TLS","href":"/ko/deployment/network-tls"}]},{"group":"보안","icon":"shield-halved","pages":[{"title":"보안 개요","href":"/ko/security/overview"},{"title":"인증 \u0026 권한","href":"/ko/security/authentication-authorization"}]},{"group":"참고","icon":"book","pages":[{"title":"환경 설정","href":"/ko/reference/configuration"},{"title":"API 참고","href":"/ko/reference/api"},{"title":"CLI \u0026 운영 도구","href":"/ko/reference/cli-tools"},{"title":"데이터 모델","href":"/ko/reference/data-model"},{"title":"릴리스 상태","href":"/ko/reference/release-status"},{"title":"알려진 제약사항","href":"/ko/reference/limitations"},{"title":"라이선스","href":"/ko/reference/license"},{"title":"용어집","href":"/ko/reference/glossary"}]},{"group":"로드맵","icon":"map","pages":[{"title":"현재 상태 \u0026 로드맵","href":"/ko/roadmap/current-status"}]}]}]},"basePath":"","title":"Marketplace 패키지에서 Stream 배포까지 - DataRelay Control","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":[],"chunks":[]}
