플랫폼에 이미지 올리기
docker save tar 를 화면에서 반입하거나, 컨테이너 토큰으로 docker push 하기
필요 권한: 개발DEVELOPER · OPERATOR · ADMIN
이미지를 플랫폼 내장 레지스트리에 넣는 길은 둘입니다.
| 길 | 이럴 때 | 필요한 것 |
|---|---|---|
| tar 반입 (화면) | 협력사가 파일로 넘겼다. 받는 사람 PC 에 Docker 가 없어도 된다 | 브라우저, 개발DEVELOPER · OPERATOR · ADMIN |
| docker push | 이미지를 만든 PC 가 플랫폼 레지스트리에 직접 닿는다 | Docker, 컨테이너 토큰 |
어느 쪽이든 결과는 같습니다. 이미지는 <레지스트리 호스트>/<테넌트>/<리포지토리>:<태그> 로 등록되고, 학습 파드가 이 주소에서 이미지를 받습니다.
아키텍처와 크기
linux/amd64여야 합니다. 다른 아키텍처만 담긴 이미지는 반입할 때 거절됩니다. ARM CPU 컴퓨터에서 빌드한다면docker build --platform linux/amd64 …로 빌드합니다.- CUDA 휠을 넣으면 6~8 GB 가 흔합니다. 반입 상한은 기본 32 GiB 입니다.
tar 로 넘기기 (협력사 쪽)
docker build -t example/mnist-trainer:v1 .
docker save example/mnist-trainer:v1 | gzip > mnist-trainer-v1.tar.gz # 태그를 꼭 넣는다
sha256sum mnist-trainer-v1.tar.gz > mnist-trainer-v1.tar.gz.sha256| 항목 | 내용 |
|---|---|
| 형식 | docker save 산출물. Docker 버전에 따라 docker-archive 또는 OCI layout 으로 나오는데 둘 다 받습니다 |
| 압축 | .tar · .tar.gz · .tgz 모두 됩니다. gzip 을 권합니다 |
| 이미지 개수 | 아카이브 하나에 이미지 하나. docker save a b 처럼 여러 개를 담으면 거절됩니다 |
| 이름 | 아카이브에 적힌 이름을 그대로 씁니다. 태그 없이 이미지 ID 로 저장하면 이름이 비어 반입하는 쪽이 직접 정해야 합니다 |
| 체크섬 | .sha256 을 함께 주면 전송 중 손상을 구분할 수 있습니다 |
예제 MNIST 이미지(CPU 전용 torch)는 압축해서 약 520 MB 였습니다.
tar 반입하기 (플랫폼 쪽)
- 왼쪽 메뉴 컨테이너 레지스트리 를 열고 오른쪽 위 이미지 반입 을 누릅니다.
- ① 받은
.tar.gz를 고릅니다. ② 리포지토리·태그는 이름을 바꿀 때만 채웁니다. 비워 두면 아카이브의 이름(example/mnist-trainer:v1)을 씁니다. 테넌트 접두사(demo/)는 서버가 붙이므로 적지 않습니다. ③ 반입 을 누릅니다.이미지 반입: ① docker save 로 만든 .tar/.tar.gz ② 이름을 바꿀 때만 채운다 ③ 반입 - 파일이 청크로 나뉘어 올라갑니다. 전송이 끝나면 서버가 조립 → 검사 → 레이어 등록을 이어서 합니다. 전송 중에 창을 닫으면 업로드가 끊기지만, 전송이 끝난 뒤에는 창을 닫아도 서버 쪽 작업은 계속됩니다. 끝나면 이미지 반입 카드에 완료와 최종 주소가 보입니다.
반입 이력: 조립·검사·레이어 등록을 거쳐 '완료'가 되면 레지스트리 주소가 표시된다
반입이 실패하면 카드에 사유가 그대로 나옵니다(아키텍처 불일치, docker save 산출물이 아님 등). 위 화면의 경고(skipped an attestation manifest …)는 최신 Docker 가 함께 저장하는 서명 증명 매니페스트를 건너뛰었다는 뜻이고, 이미지 사용에는 영향이 없습니다.
docker push 로 올리기
- 계정 설정 → 컨테이너 토큰 에서 토큰을 발급합니다. 토큰은 발급 직후 한 번만 보이고, 호스트와 사용자명이 채워진
docker login명령이 함께 나옵니다. push 는 DEVELOPER 이상만 됩니다.컨테이너 토큰 발급 직후: ① 토큰은 이때 한 번만 보인다 ② 호스트가 채워진 docker login 명령 - 로그인하고, 태그를 붙여 push 합니다.
echo "<발급한 토큰>" | docker login mlops.example.com -u demo --password-stdin
docker tag example/mnist-trainer:v1 mlops.example.com/demo/example/mnist-trainer:v1
docker push mlops.example.com/demo/example/mnist-trainer:v1- 사용자명은 무엇이든 됩니다. 토큰이 비밀번호이고, 테넌트는 토큰에 고정돼 있습니다.
- 경로의 첫 칸에 테넌트 코드(소문자) 를 두세요. 화면에서 반입한 이미지와 같은 모양이 되어 목록과 변형 선택기에서 한눈에 보입니다.
- 레지스트리가 HTTP 로만 열려 있으면 Docker 데몬에 insecure 설정이 필요합니다. 컨테이너 레지스트리 직접 쓰기 를 보세요.
다음: 마법사에서 고르게 하기