스킬: Kit 빌드 및 게시
목적
Bottlerocket kit(core-kit 또는 kernel-kit)을 빌드하고 개발 테스트 및 검증을 위해 로컬 OCI 레지스트리에 게시합니다. 이를 통해 kit 변경 사항을 프로덕션 레지스트리에 게시하지 않고 변형 빌드에서 테스트할 수 있습니다.
사용 시점
- kit 패키지를 변경하고 변형에서 테스트할 때
- kit에 대한 반복 개발 작업 중
- kit 변경 사항에 의존하는 변형 이미지를 빌드하기 전
사전 요구 사항
- Docker 설치 및 실행 중
- grove 디렉토리 내에서 작업 중
- kit 저장소가
kits/디렉토리에 클론되어 있음
절차
1. 로컬 레지스트리 실행 확인
brdev registry start
2. 로컬 레지스트리용 설정
cd kits/<kit-name>
brdev twoliter use-local-publish
이 명령은 게시를 위해 로컬 레지스트리를 가리키는 Infra.toml을 생성합니다.
3. Kit 빌드
make build
특정 아키텍처의 경우:
make build ARCH=x86_64
# 또는
make build ARCH=aarch64
4. 로컬 레지스트리에 게시
make publish VENDOR=local
이 명령은 localhost:5000에 local 공급업체 접두사로 kit를 게시합니다.
5. 게시 확인
brdev registry list
명령 출력에 kit가 저장소 목록에 표시되어야 합니다.
검증
kit를 사용할 수 있는지 확인합니다:
brdev registry list
게시된 버전 태그가 반환되어야 합니다.
일반적인 문제
레지스트리가 실행 중이 아님:
오류: 연결 거부됨
해결 방법: brdev registry start를 실행하세요.
Infra.toml이 설정되지 않음:
오류: 공급업체 'local'을 찾을 수 없음
해결 방법: 설정을 생성하려면 brdev twoliter use-local-publish를 실행하세요.
Docker 권한 거부: 해결 방법: 사용자가 docker 그룹에 속해 있고 Docker 데몬이 실행 중인지 확인하세요.
다음 단계
kit를 게시한 후:
- 변형의
Twoliter.toml을 업데이트하여 새 kit 버전을 참조하세요. - 변형 저장소에서
make update를 실행하세요. cargo make로 변형을 빌드하세요.