Docker Manager
Docker Manager는 그래픽 인터페이스를 갖춘 Docker 관리 도구로, 우수한 사용자 경험을 제공합니다. Docker Manager는 이미지 레지스트리를 통합하고, 그래픽 인터페이스를 통해 이미지 검색, 다운로드, 컨테이너 설치 및 구성 등 다양한 기능을 구현합니다. Docker Hub의 수백만 개의 이미지가 비즈니스 요구를 충족하기 위해 TNAS에 다양한 가능성을 제공합니다.
Docker Manager 애플리케이션을 사용하려면 먼저 Docker Engine을 설치하세요.
개요
개요 페이지에서는 프로젝트와 컨테이너의 실시간 상태를 빠르게 파악하여 안정적인 서비스 운영을 보장할 수 있습니다. 또한 실행 중인 프로젝트와 컨테이너의 리소스 사용 현황을 한눈에 직관적으로 확인할 수 있습니다.
개요 페이지에는 다음과 같은 핵심 정보가 포함되어 있습니다:
- Docker Engine 상태: Docker Engine이 설치되어 활성화되었는지 표시합니다. 설치되지 않았거나 활성화되지 않은 경우 페이지에 "Docker Engine이 설치되지 않았거나 활성화되지 않았습니다"라는 메시지가 표시됩니다;
- CPU 사용량: Docker 전체 CPU 사용량 및 백분율을 표시합니다;
- RAM 사용량: Docker 전체 메모리 사용량 및 사용률을 표시합니다;
- 리소스 통계 차트: CPU 및 메모리 사용 추이를 그래픽으로 표시합니다;
- 컨테이너 실행 개요: 실행 중/중지된 컨테이너 수를 표시합니다. 컨테이너 실행 이상 시 눈에 띄는 표시를 제공합니다;
- 이미지 통계: 로컬 이미지 총 수를 표시합니다.
프로젝트
프로젝트를 통해 단일 구성 파일(Docker-compose.yml)로 다중 컨테이너 애플리케이션을 쉽게 정의할 수 있으며, 하나의 명령으로 YML 파일 구성에서 모든 서비스를 생성하고 시작할 수 있습니다.
프로젝트 관리
프로젝트 페이지에서 프로젝트에 대해 다음 작업을 수행할 수 있습니다:
- 프로젝트 추가: 새 프로젝트를 추가합니다;
- 시작/중지: 선택한 프로젝트를 시작/중지합니다;
- 재시작: 선택한 프로젝트를 재시작합니다;
- 편집: 선택한 프로젝트를 편집합니다;
- 삭제: 선택한 프로젝트를 삭제합니다;
- 강제 중지: 선택한 프로젝트를 강제로 중지합니다;
- 정리: 모든 서비스의 컨테이너, 네트워크, 이미지, 볼륨을 중지하고 삭제합니다;
- 빌드: 프로젝트의 YAML 구성 파일을 통해 프로젝트를 다시 빌드합니다;
프로젝트 만들기
프로젝트 기능에서 프로젝트를 만들려면:
- Docker Manager 애플리케이션 인터페이스에서 왼쪽 탐색 모음의 "프로젝트"를 클릭합니다;
- 오른쪽 상단의 "추가" 아이콘 또는 페이지의 "지금 추가" 버튼을 클릭하여 프로젝트 만들기 대화상자를 엽니다;
- 프로젝트 이름, 프로젝트 경로, 구성 파일(Docker-compose.yml)을 순서대로 설정합니다 구성 파일을 설정하는 세 가지 방법이 있습니다: • 로컬 TNAS — TNAS 로컬 파일을 선택하여 설정합니다. • 내 컴퓨터 — 컴퓨터에서 구성 파일을 업로드합니다. • YAML 파일 만들기 — 편집기를 열어 docker-compose.yml을 만듭니다.
- YAML 유효성 검사를 실행합니다.
- 유효성 검사를 통과하면 적용 버튼을 클릭합니다.
- YAML 유효성 검사는 편집기 내의 docker-compose.yml 내용과 형식을 확인합니다. 내용이 비어 있거나 형식이 잘못된 경우 "적용" 버튼을 클릭할 수 없습니다. 안내에 따라 docker-compose.yml 파일을 수정하세요.
- Compose 구성 파일이 삭제된 경우 페이지에 알림이 표시됩니다.
프로젝트 생성 실패 원인을 빠르게 확인하는 방법?
프로젝트 생성 과정에서 프로젝트 생성 실패가 관찰되면, "생성 실패" 프로젝트 상태를 클릭하여 오류 로그를 확인할 수 있습니다.
컨테이너
컨테이너는 Docker 이미지의 실행 인스턴스이자 이미지의 동적 표현입니다. 시작, 일시 중지, 중지, 삭제할 수 있습니다. 컨테이너를 만들려면 이미지가 필요합니다. 이미지가 없는 경우 레지스트리 페이지로 이동하여 오픈 소스 개발자가 업로드한 이미지를 다운로드할 수 있습니다.
컨테이너 관리
컨테이너 페이지에서 컨테이너에 대해 다음 작업을 수행할 수 있습니다:
- 추가: 이미지를 선택하여 컨테이너를 만듭니다;
- 시작/중지: 컨테이너를 시작/중지합니다;
- 재시작: 실행 중인 컨테이너를 재시작합니다;
- 편집: 컨테이너 구성을 편집합니다;
- 삭제: 선택한 컨테이너를 삭제합니다;
- 강제 중지: 실행 중인 컨테이너를 강제로 중지합니다;
- 컨테이너 복제: 컨테이너 구성을 복제하여 새 컨테이너를 구성합니다 (구성만 복제되며 이미지와 데이터는 복제되지 않습니다. 포트는 자동으로 다시 매핑됩니다);
- 내보내기: 선택한 컨테이너를 .tar 파일로 내보냅니다. "컨테이너 내보내기"와 "컨테이너 설정만 내보내기" 두 가지 모드를 지원합니다;
- 가져오기: 가져올 수 있는 파일을 선택하고 파일을 기반으로 컨테이너를 구성합니다;
- 프로세스: 컨테이너 내에서 실행된 명령의 실행 상태;
- 로그: 컨테이너 작동으로 생성된 로그;
- 터미널: 컨테이너 터미널 인터페이스 (bash).
- 바탕화면으로 보내기: TOS 바탕화면에 컨테이너 바로가기를 만듭니다. 사용자 지정 아이콘 업로드를 지원합니다 (.jpg/.png, 크기 ≤ 8MB).
- 액세스 URL: 컨테이너의 액세스 URL을 확인합니다.
컨테이너 만들기
Docker Manager 애플리케이션에서 컨테이너를 만들려면:
- Docker Manager 애플리케이션 인터페이스에서 왼쪽 탐색 모음의 "이미지"를 클릭합니다;
- 오른쪽 상단의 "시작" 아이콘을 클릭하여 컨테이너 만들기 대화상자를 엽니다;
1단계: 기본 정보
- 이미지 선택: 로컬 이미지에서 선택합니다;
- 리포지토리 주소: 선택적 사용자 지정 리포지토리 주소 (사용자 이름/비밀번호 인증 포함);
- 컨테이너 이름: 소문자, 숫자, 하이픈
-및 밑줄_을 지원합니다.-또는_로 시작할 수 없습니다.
2단계: 네트워크 및 포트
- 네트워크 모드: 호스트 모드 (호스트 IP 및 포트 사용) 또는 브리지 모드 (가상 브리지, 172.17.x.x와 같은 독립 IP 세그먼트);
- 포트 추가: 로컬 포트 + 컨테이너 포트 + 프로토콜 구성; 추가/편집/삭제를 지원합니다. 포트가 사용 중일 때 오류 메시지가 표시됩니다.
3단계: 데이터 볼륨 (Volumes)
- 컨테이너 데이터 저장 경로 설정 (호스트 디렉토리 → 컨테이너 디렉토리). 컨테이너의 데이터를 호스트에 백업합니다;
- 읽기/쓰기 권한: 기본값은 읽기/쓰기, 읽기 전용으로 전환 가능 (컨테이너는 읽기만 가능);
- 팁: "컨테이너가 삭제되어도 데이터는 삭제되지 않습니다."
4단계: 환경 변수
- 컨테이너의 환경 변수 설정 (변수명 + 변수값); 추가/편집/삭제를 지원합니다.
5단계: 컨테이너 연결 (Links)
- 다른 컨테이너와의 연결을 만들어 여러 컨테이너 간의 안전한 통신을 가능하게 합니다; 별칭 설정을 지원합니다.
6단계: 실행 구성
- 권한 실행: 활성화하면 컨테이너가 ROOT 권한으로 실행됩니다 (권한 있는 컨테이너);
- CPU 우선순위: 낮음/중간/높음 3단계 선택;
- 메모리 제한: 컨테이너의 최대 메모리 사용량을 설정합니다;
- 부팅 시 자동 시작: NAS 재부팅 또는 Docker Engine 재시작 후 컨테이너를 자동으로 시작합니다;
- 대역폭 제한: 활성화하면 컨테이너의 네트워크 대역폭을 제한합니다;
- 사용자 지정 Capabilities: Linux Capabilities 추가/제거;
- 진입점 (Entrypoint): 컨테이너 진입 명령을 사용자 지정합니다;
- 실행 명령 (CMD): 컨테이너 시작 명령을 사용자 지정합니다.
- 설정을 확인하고 "확인"을 클릭하여 설정을 완료합니다.
- 설정이 올바른지 확인했음에도 Docker Hub 이미지를 사용하여 컨테이너를 만들 수 없는 경우 다른 이미지를 시도해 보세요. Docker Hub에는 다양한 개발자가 업로드한 사용자 지정 이미지가 포함되어 있어 이미지 품질이 항상 보장되지는 않습니다.
- 컨테이너 포트를 구성할 때 다른 서비스가 사용하는 포트 번호와 다른 번호를 선택하여 포트 충돌로 인한 서비스 오류를 방지하세요.
- 대부분의 컨테이너의 기본 시간대는 UTC입니다. 환경 변수 "TZ"를 설정하여 컨테이너의 시간대를 변경할 수 있습니다. 시간대 데이터베이스의 시간대 목록은 여기를 방문하여 확인하세요.
이미지
Docker 이미지는 특수한 파일 시스템으로, 컨테이너 런타임에 필요한 프로그램, 라이브러리, 리소스, 구성 파일 등을 제공하는 것 외에도 런타임을 위해 준비된 일부 구성 매개변수도 포함하고 있습니다. Docker 컨테이너를 생성하고 실행하는 기반입니다.
로컬 이미지
TNAS에 로컬로 다운로드된 이미지를 나열합니다. 이미지 기능을 통해 다운로드된 모든 이미지를 관리하고 이미지를 사용하여 컨테이너를 만들 수 있습니다.
로컬 이미지 관리
로컬 이미지 페이지에서 로컬 이미지에 대해 다음 작업을 수행할 수 있습니다:
- 시작: 선택한 이미지를 시작하고 해당 컨테이너를 구성합니다;
- 가져오기: 컴퓨터 또는 NAS에 저장된 이미지를 가져옵니다;
- 내보내기: 선택한 이미지를 NAS 폴더로 내보냅니다;
- 삭제: 선택한 이미지를 삭제합니다.
레지스트리
Docker Hub의 수백만 개의 이미지 리포지토리를 동기화합니다. 레지스트리에서 다음을 수행할 수 있습니다:
- 레지스트리 추가: 새 이미지 리포지토리 소스를 추가합니다. 리포지토리 주소, 사용자 이름 및 비밀번호 인증 설정을 지원합니다;
- 레지스트리 편집: 등록된 리포지토리 정보를 수정합니다;
- 레지스트리 삭제: 사용자 지정 리포지토리를 제거합니다 (시스템 기본 Docker Hub는 삭제할 수 없습니다);
- 레지스트리 활성화/비활성화: 레지스트리의 사용 상태를 전환합니다;
- SSL 인증서 신뢰: 자체 서명된 SSL 인증서가 있는 리포지토리를 신뢰합니다.
가속기 구성
이미지 가속기는 Docker Hub 이미지의 다운로드 속도를 높이는 데 사용됩니다:
- 레지스트리 미러 활성화: Docker Hub 이미지 가속기를 활성화합니다;
- 가속기 URL: 이미지 가속 주소를 구성합니다 (예: Alibaba Cloud 이미지 가속, USTC 미러 소스 등);
- 수정 알림: 가속기 구성을 수정하면 Docker Engine이 재시작되어 실행 중인 작업(컨테이너 또는 프로젝트 생성, 이미지 다운로드 등)이 중단됩니다.
네트워크
네트워크 모듈은 Docker 컨테이너 네트워크를 관리하는 데 사용되며, 사용자 지정 네트워크 생성 및 구성을 지원합니다.
네트워크 관리
네트워크 페이지에서 네트워크에 대해 다음 작업을 수행할 수 있습니다:
- 네트워크 추가: 사용자 지정 새 Docker 네트워크를 만듭니다;
- 삭제: 선택한 사용자 지정 네트워크를 삭제합니다;
- 설정/세부정보: 네트워크 세부정보를 보고 선택한 네트워크에 연결된 컨테이너를 관리합니다.
네트워크 만들기
네트워크를 만들 때 다음 항목을 구성할 수 있습니다:
| 구성 항목 | 설명 |
|---|---|
| 네트워크 이름 | 문자, 숫자, 하이픈 - _ 지원 |
| 드라이버 | 기본 bridge (사용자 지정 드라이버 지원) |
| IP 구성 모드 | 자동 (DHCP) / 수동 |
| IPv4 서브넷 | CIDR 형식, 예: 172.20.0.0/16 |
| IPv4 게이트웨이 | 예: 172.20.0.1 |
| IPv4 IP 범위 | CIDR 형식, 예: 172.20.10.128/25 |
| IPv6 서브넷 | CIDR 형식, 예: fd80:ac8::/48 |
| IPv6 게이트웨이 | 예: fd80:ac8::1 |
| IPv6 범위 | CIDR 형식, 예: fd80:ac8::/64 |
| IP 위장 비활성화 | IP Masquerading 비활성화 |
| 컨테이너 할당 | 기존 컨테이너를 즉시 이 네트워크에 추가 |
로그
Docker Manager 애플리케이션에서 실행된 모든 작업 기록을 나열합니다. 로그를 내보내고 관리할 수 있습니다.
로그 관리
로그 페이지에서 모든 작업의 로그를 보고, 특정 작업을 선택하여 로그를 확인하며, 로그에 대해 다음 설정을 구성할 수 있습니다:
- 검색: 이벤트를 검색합니다;
- 새로고침: 로그를 새로고침합니다;
- 내보내기: 로그를 내보냅니다;
- 삭제: 로그를 삭제합니다 — 모든 로그 또는 지정된 로그를 삭제할 수 있습니다;
- 설정: 로그 보존 정책을 설정합니다. 정책에 부합하지 않는 로그는 자동으로 삭제됩니다.