Alpine Linux 빌드 의존성을 .build-deps로 정리하기

컴파일 도구가 최종 이미지에 남거나 삭제 시 런타임 패키지까지 사라진다는 상황에서 Alpine Linux 특유의 원인을 확인하고 안전하게 해결하는 순서입니다.

GeneralAlpine Linux

짧은 요약

컴파일 도구가 최종 이미지에 남거나 삭제 시 런타임 패키지까지 사라진다면 가상 패키지 그룹으로 빌드 의존성만 묶고 런타임 의존성은 별도 설치한다. 무작정 전체 설정을 초기화하기보다 해당 기술이 실제로 선택한 실행 경로와 로그를 먼저 확인합니다.

컴파일 도구가 최종 이미지에 남거나 삭제 시 런타임 패키지까지 사라진다. 오류 원문, 버전, 실행 계정과 직전 변경을 함께 기록하면 비슷한 범용 문제와 구분할 수 있습니다.

빌드와 런타임 패키지를 같은 apk add 집합으로 관리했다. 이 동작은 Alpine Linux의 실행 모델이나 기본 정책에 따른 것이므로 다른 환경의 해결법을 그대로 적용하면 부작용이 생길 수 있습니다.

영향이 제한된 테스트 디렉터리에서 아래 진단을 실행해 정상 입력과 실패 입력의 첫 차이를 확인합니다. 운영 비밀값은 마스킹하고, 변경 전에 현재 설정과 결과를 복사해 둡니다.

1. 오류 전문과 Alpine Linux 버전, 실행 계정, 대상 경로를 확인합니다.

2. 읽기 전용 진단 명령으로 “빌드와 런타임 패키지를 같은 apk add 집합으로 관리했다” 가설을 검증합니다.

3. 가상 패키지 그룹으로 빌드 의존성만 묶고 런타임 의존성은 별도 설치한다.

4. 같은 입력으로 수정 전후를 비교하고 깨끗한 세션에서도 다시 확인합니다.

apk add --no-cache --virtual .build-deps build-base python3-dev
# build
apk del .build-deps
apk info -vv

꺾쇠로 표시한 값은 실제 대상에 맞게 바꿉니다. 삭제·보안 정책 변경은 예문의 진단 결과를 확인한 뒤 진행합니다.

오류를 일으킨 최소 입력을 다시 실행해 종료 코드와 로그를 확인합니다. 관련 테스트를 두 번 연속 통과하고 새 세션 또는 동일한 자동화 환경에서도 결과가 같아야 해결된 것으로 봅니다.

보안 검증을 끄거나 관리자 권한으로 상시 실행하는 우회는 사용하지 않습니다. 공유 설정을 바꿀 때는 diff와 복원 방법을 확보하고, 실제 버전의 공식 문서에서 옵션 지원 여부를 확인합니다.