artifactory-module-architecture

Artifactory 制品库模块架构指南，涵盖制品上传下载、存储后端适配、制品元数据、清理策略、权限控制。当用户开发制品库功能、处理制品存储、配置清理策略或实现制品管理时使用。

1. Zapoznaj się ze strukturą modułu Artifactory w BK-CI — moduł dzieli się na cztery główne warstwy: api-artifactory (definicje interfejsów API), biz-artifactory (logika biznesowa), model-artifactory (modele danych JOOQ) oraz boot-artifactory (konfiguracja Spring Boot). Zrozumienie tego podziału jest kluczowe do pracy z magazynem artefaktów.

2. Wybierz odpowiedni backend przechowywania dla Twojego przypadku użycia — system obsługuje BkRepo (zalecaną蓝鲸制品库) poprzez klasę BkRepoArchiveFileServiceImpl lub przechowywanie na dysku lokalnym poprzez DiskArchiveFileServiceImpl. Decyzja wpłynie na sposób implementacji operacji na plikach.

3. Zdefiniuj typ artefaktu odpowiedni dla Twojego scenariusza — dostępne typy to PIPELINE (produkty z potoków budowy), CUSTOM_DIR (katalogi niestandardowe) i REPORT (pliki raportów). Każdy typ ma dedykowaną obsługę w warstwie biznesowej.

4. Pracuj z warstwą API — interfejsy w api-artifactory obejmują operacje budowy (builds), komunikację między usługami (service) i interfejsy dla użytkowników (user). Skorzystaj z odpowiednich endpointów do przesyłania, pobierania i zarządzania artefaktami.

5. Implementuj logikę biznesową w warstwie biz-artifactory — wykorzystaj klasy DAO do dostępu do danych, serwisy do obsługi biznesowej (w tym usługi sklepu deweloperskiego) oraz narzędzia do operacji pomocniczych. Pamiętaj o obsłudze zdarzeń z kolejki wiadomości (MQ) dla asynchronicznych operacji.

6. Skonfiguruj polityki czyszczenia i kontrolę dostępu — moduł wspiera zarządzanie metadanymi artefaktów, definiowanie strategii czyszczenia starych produktów oraz implementację kontroli uprawnień dostępu do magazynu.