실행
새 기능 #13770
패키지 버전 관리와 registry 게시, 오프라인 설치 문서 추가
발견 버전:
반영 버전:
난이도:
보통
중요도:
하
조력자:
회사:
연락처:
점수:
3.25
설명
개요¶
드라이버를 현장에 설치할 수 있게 배포 경로를 정리한다. 지금까지 빌드 결과물은 일주일 뒤 사라지는 CI artifact로만 남았고 버전은 모든 빌드가 1.0.0으로 같았으며 설치 문서는 저장소 checkout에서 pip install .을 하는 방법뿐이었다. 오프라인 현장과 kolla 컨테이너 환경에 들고 갈 wheel을 어디서 받고 어떻게 설치하는지를 한 문서로 넘길 수 있게 한다.
버전은 git tag에서 정한다. 작업을 시작할 때 버전을 먼저 올리지 않으므로 파일에 적힌 버전은 늘 실제와 어긋난다. tag를 찍은 커밋은 그 릴리스 버전(v1.0.0 → 1.0.0)으로, 그 뒤 커밋은 커밋 hash가 붙은 dev 버전(1.0.1.dev3+g1a2b3c4)으로 빌드된다.
작업 내용¶
- 오프라인 설치 문서: wheel과 GMS 인증서만 들고 가면 되는 이유, 패키지 설치형 manila에
pip install --no-index --no-deps로 넣는 방법, kolla 환경에서 현장 manila-share 이미지 위에 층을 쌓는 Dockerfile, 백엔드 사전 조건과 manila.conf 설정을 영어·한국어로 적는다. 설치 문서는 따로 전달할 수 있게 다른 문서를 참조하지 않는다. README에서 이 문서로 링크한다 - 버전 관리: 고정 버전을 setuptools-scm으로 바꾼다. setuptools-scm은 추적 중인 파일을 모두 sdist에 넣으므로 개발 문서는 MANIFEST.in에서 제외한다. CI의 package 잡은 tag까지 보이도록 전체 이력을 clone한다
- package registry 게시: 기존 artifact 일주일 보관은 그대로 두고 publish 잡을 추가한다. main의 최신 빌드는 브랜치 이름(
main)을 버전 칸으로 삼아 올리고 이전 빌드 파일은 지운다. 받는 주소가 바뀌지 않는다.v로 시작하는 tag는 빌드된 버전으로 올리고 지우지 않는다 - CI 주석: GITLAB_TOKEN이 어디서 오는지 바로잡는다. dev3 그룹이 소속 프로젝트에 제공하고 dev3 밖의 fork만 직접 설정한다
실행
