TECHNICAL RESOURCE

시놀로지 컨테이너 이미지 관리

이미지 다운로드와 업데이트, 이미지 파일과 컨테이너 파일 가져오기 및 데이터 보존을 구분합니다.

01

이미지와 실행 상태를 따로 관리

이미지는 컨테이너를 만들 때 사용하는 기본 자료이며 실행 중인 컨테이너의 설정과 저장 데이터 전체를 뜻하지 않습니다. 사용할 이미지의 제공자와 태그, NAS의 CPU 구조에 맞는 지원을 확인합니다. 다운로드가 끝났다는 사실만으로 앱이 현재 모델과 설정에서 정상 동작한다고 판단하지 않습니다.

다운로드가 실패하면 NAS의 시간과 DNS, 설치 볼륨 여유 공간과 레지스트리 접근 상태 및 요청 제한을 나눠 확인합니다. 공식 문서의 공용 DNS 변경과 IPv6 중지 등은 원인 분리를 위한 진단 항목입니다. 업무망의 DNS와 네트워크 설정을 조건 없이 영구 변경하는 공통 절차로 쓰지 않습니다.

02

이미지 업데이트와 패키지 업데이트 구분

Image에서 대상을 선택해 Action > Update 또는 Tag 열의 업데이트 항목을 확인합니다. 문자 그대로 latest라는 태그의 업데이트 감지는 Container Manager 릴리스에 설명돼 있지만, 알림 확인과 이미지 변경 및 실행 컨테이너의 앱 동작 확인은 각각 따로 수행할 항목입니다. 태그 이름만 보고 필요한 설정과 데이터가 자동 보존된다고 가정하지 않습니다.

NAS 패키지인 Container Manager 업데이트도 별도입니다. 24.0.2-1606은 DSM 7.3 이상 조건과 업데이트 후 컨테이너 재시작 안내를 포함합니다. 앱 이미지의 변경과 관리 패키지의 변경을 한꺼번에 진행하기보다 적용할 대상과 중단 영향을 확인하고 필요한 설정과 자료를 보존합니다.

03

이미지 파일을 가져오는 올바른 위치

이미지 파일은 Container Manager의 Image 화면에서 파일 가져오기를 사용합니다. 공식 오류 안내는 Image에서 내보낸 파일을 Container 화면의 Import로 가져오면 설정된 컨테이너 파일로 처리되어 No command specified 오류가 생길 수 있다고 설명합니다. 파일 확장자만 보고 가져올 메뉴를 고르지 않습니다.

일반 도움말은 Action > Import의 파일 선택, 오류 해결 문서는 Action > Add From File이라는 이름으로 설명합니다. 설치 버전의 Image 화면에서 해당 기능을 확인합니다. Container의 설정 가져오기와 Image의 이미지 가져오기를 같은 작업으로 취급하지 않고, 가져온 뒤 새 컨테이너 설정을 검토합니다.

04

내보내기와 저장 데이터의 보존 범위

Image의 Export는 이미지를 저장하고 Container의 Export는 컨테이너 또는 컨테이너와 설정을 내보내는 메뉴로 설명됩니다. 별도로 마운트한 NAS 폴더와 앱의 데이터베이스, 외부 저장소는 보존 위치를 따로 확인해야 합니다. 내보내기 파일이 만들어졌다는 사실만으로 전체 서비스 복원이 준비됐다고 기록하지 않습니다.

Docker 표준 container export 문서는 연결된 볼륨의 내용을 포함하지 않는다고 명시합니다. 이 CLI 문서를 Synology GUI 내보내기 파일의 정확한 구성으로 단정하지는 않습니다. 이미지와 설정 및 실제 저장 자료를 나눠 보존하고, 필요한 경우 분리된 환경에서 복원 대상과 읽기 가능 여부를 확인합니다.

05

정리 전에 참조와 로그 확인

Remove Unused Images는 실행 중이거나 중지된 컨테이너가 사용하지 않는 이미지를 정리하는 기능입니다. 중지한 컨테이너가 참조하는 이미지까지 불필요하다고 가정하지 않습니다. 사용 중인 이미지는 삭제할 수 없다는 도움말 조건을 확인하고, 문제가 생긴 구성과 관련된 자료를 먼저 남깁니다.

Container의 로그와 Container Manager의 Log 화면을 구분해 오류를 확인하고 필요한 기록을 내보냅니다. Log의 Clear는 기록 삭제이며 되돌릴 수 없다고 안내되어 있습니다. 로그를 지우거나 이미지를 다시 받는 행위 자체를 장애 원인 해결로 기록하지 않고, 앱 실행과 필요한 데이터 접근을 확인한 결과를 남깁니다.

06

공식 자료와 적용 범위

관련 용어와 글

TECHNICAL RESOURCES CONTACT

확인하려는 기술 내용과 사용 환경을 알려주세요

장비와 운영 환경, 확인한 오류나 자료 내용을 알려주시면 필요한 안내와 상담 범위를 확인합니다.