DevGateway는 개발 중에 로컬 워크로드 인스턴스를 패브릭에 등록하기 위해 실행하는 작은 도우미입니다. 프런트 엔드가 호스트되는 위치(localhost의 DevServer)와 매니페스트에 따라 사용할 수 있는 항목을 Fabric 서비스에 알려줍니다. DevGateway가 실행되면 패브릭은 패키지를 테넌트에 게시하지 않고 iFrame에서 UI를 로드하고 로컬 DevServer를 호출하여 제품 및 항목 메타데이터를 읽을 수 있습니다.
DevGateway의 기능
- 현재 로그인한 개발자를 위해 특정 작업 영역에 로컬 워크로드 인스턴스를 등록합니다.
- 매니페스트를 사용하여 워크로드 ID 및 진입점에 대해 Fabric에 알릴 수 있습니다.
- 플랫폼이 프론트엔드를 로드하고 반복할 때 항목을 검색할 수 있도록 Fabric 호스트 호출을 로컬 환경으로 라우팅합니다.
- 실제로 프런트 엔드를 호스트하고 매니페스트 엔드포인트를 노출하는 DevServer와 함께 작동합니다.
비고
DevGateway는 웹앱 또는 매니페스트 자체를 제공하지 않습니다. 대신 로컬 인스턴스를 등록하고 Fabric이 DevServer와 매니페스트를 가리키도록 설정합니다.
개발에서 매니페스트를 사용하는 방법
워크로드는 개발 및 프로덕션 모두에서 매니페스트 기반입니다. 개발 중:
- DevGateway는 로컬 구성을 사용하여 워크로드의 ID와 진입점(워크로드 매니페스트에 정의됨)을 발표합니다.
- 그런 다음 패브릭은 DevServer를 호출하여 로컬 엔드포인트(예: 템플릿의 경로)를 통해 제품 매니페스트 및
/manifests를 가져오므로 서비스에서 탐색, 타일 및 만들기 환경을 렌더링할 수 있습니다.
이는 게시 시간에 발생하는 작업을 반영하지만 빠른 반복을 위해 모든 것이 로컬로 유지됩니다.
일반적인 개발 흐름
- localhost에서 프런트 엔드를 호스트하도록 DevServer를 시작합니다.
- DevGateway를 시작하고 대상 작업 영역의 관리자인 사용자로 로그인합니다.
- Fabric 작업 영역을 열고 워크로드 진입점을 사용합니다. 패브릭은 iFrame에서 UI를 로드하고 매니페스트를 통해 항목을 검색합니다.
- UI 및 매니페스트 파일을 편집하고 새로 고쳐 변경 내용을 즉시 확인합니다.
단계별 설정 및 시작 지침 은 시작 자습서 를 참조하세요.
구성 입력
템플릿에 따라 DevGateway는 다음을 포함하는 로컬 구성을 읽습니다.
- 등록 대상 작업 영역
- 로컬 프런트엔드 엔드포인트(DevServer URL)
- 개발 중에 사용되는 매니페스트 파일/자산에 대한 경로 또는 참조
리포지토리의 설치/빌드 스크립트는 DevGateway 및 DevServer가 동기화 상태를 유지할 수 있도록 이 구성을 자동으로 생성하거나 업데이트합니다.
문제 해결 팁
- 패브릭에서 UI가 열리지 않는 경우 DevGateway와 DevServer를 모두 시작했고 필요한 권한이 있는 작업 영역에 로그인했는지 확인합니다.
- Fabric에서 항목을 검색할 수 없는 경우 DevServer의 매니페스트 엔드포인트가 유효한 JSON을 반환하고 DevGateway가 서비스를 올바른 localhost URL로 가리키고 있는지 확인합니다.
- 아이콘 또는 문자열이 누락된 경우 매니페스트의 자산 경로와 DevServer가 해당 경로를 제공하는지 확인합니다.