diff --git a/docker-compose.nas.yml b/docker-compose.nas.yml index eafdae7..a662ab2 100644 --- a/docker-compose.nas.yml +++ b/docker-compose.nas.yml @@ -1,6 +1,7 @@ services: sori-studio: image: ${SORI_STUDIO_IMAGE:-sori-studio:latest} + pull_policy: never container_name: sori-studio env_file: - ${ENV_FILE:-.env.production} diff --git a/docs/deploy.md b/docs/deploy.md index 2da37ff..b3d2f8c 100644 --- a/docs/deploy.md +++ b/docs/deploy.md @@ -246,6 +246,14 @@ docker save sori-studio:latest -o sori-studio-latest.tar NAS Docker 앱에서 `sori-studio-latest.tar` 이미지를 가져온 뒤, Compose 생성 화면에는 `docker-compose.nas.yml` 내용을 사용한다. 이 파일은 앱 서비스를 `image: ${SORI_STUDIO_IMAGE:-sori-studio:latest}`로 실행하므로 NAS에서 Buildx 빌드를 시도하지 않는다. +이미지를 가져온 뒤 NAS Docker 앱의 이미지 목록에서 이름과 태그가 `sori-studio:latest`인지 확인한다. 다른 이름으로 표시되면 `.env.production`에 아래처럼 실제 이미지 이름을 맞춘다. + +```bash +SORI_STUDIO_IMAGE=가져온이미지이름:태그 +``` + +`docker-compose.nas.yml`은 `pull_policy: never`를 사용해 앱 이미지가 없을 때 Docker Hub에서 `sori-studio`를 찾으러 가지 않는다. 이 오류가 계속 뜨면 이미지 가져오기가 누락됐거나, 가져온 이미지 태그와 `SORI_STUDIO_IMAGE` 값이 서로 다른 상태다. + SSH를 쓸 수 있는 NAS에서는 같은 파일로 아래처럼 실행할 수 있다. ```bash diff --git a/docs/history.md b/docs/history.md index 77f3f0d..a453ead 100644 --- a/docs/history.md +++ b/docs/history.md @@ -1,3 +1,7 @@ +## 2026-08-13 v1.12.14 — NAS 앱 이미지는 pull이 아니라 가져온 태그로 맞춘다 + +NAS Docker 앱에서 `docker-compose.nas.yml`을 먼저 실행하면 로컬에 `sori-studio:latest` 이미지가 없어서 Docker Hub에서 같은 이름을 pull하려고 시도할 수 있다. 이 이름은 공개 레지스트리 이미지가 아니라 로컬에서 만들어 NAS에 가져오는 앱 이미지이므로, NAS용 Compose에는 `pull_policy: never`를 추가해 원격 pull 시도를 막는다. 운영자는 이미지 가져오기 후 NAS 이미지 목록의 실제 이름과 태그를 확인하고, 기본값과 다르면 `.env.production`의 `SORI_STUDIO_IMAGE`로 실행 이미지명을 맞춘다. + ## 2026-08-13 v1.12.13 — UGREEN Docker 앱은 빌드 대신 이미지 실행 경로를 둔다 UGREEN NAS Docker 앱에서 Compose 프로젝트를 만들 때 Buildx 플러그인 없이 `build:` 서비스를 처리하지 못하는 환경이 확인됐다. 기본 `docker-compose.yml`은 Docker CLI나 Buildx가 있는 환경에서 기존처럼 Dockerfile 빌드를 수행하도록 유지하되, NAS GUI 배포에는 `build:`를 제거한 `docker-compose.nas.yml`을 별도로 둔다. 이 경로에서는 로컬에서 `sori-studio:latest` 이미지를 만든 뒤 NAS Docker 앱에 가져오고, NAS는 이미지를 실행만 하므로 Buildx 설치 여부에 막히지 않는다. diff --git a/docs/update.md b/docs/update.md index cf137b0..0501fa1 100644 --- a/docs/update.md +++ b/docs/update.md @@ -1,5 +1,10 @@ # 업데이트 이력 +## v1.12.14 + +- NAS 이미지 실행용 Compose가 로컬 앱 이미지 누락 시 Docker Hub pull을 시도하지 않도록 `pull_policy: never` 추가. +- NAS Docker 앱에서 가져온 이미지 태그와 `SORI_STUDIO_IMAGE`를 맞추는 절차 문서화. + ## v1.12.13 - UGREEN NAS Docker 앱에서 Buildx 없이 가져온 앱 이미지를 실행할 수 있도록 `docker-compose.nas.yml` 추가. diff --git a/package-lock.json b/package-lock.json index ee9be29..8dbbb08 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "sori.studio", - "version": "1.12.13", + "version": "1.12.14", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "sori.studio", - "version": "1.12.13", + "version": "1.12.14", "hasInstallScript": true, "dependencies": { "@nuxtjs/tailwindcss": "^6.14.0", diff --git a/package.json b/package.json index 2cdd258..f5a041f 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "sori.studio", - "version": "1.12.13", + "version": "1.12.14", "private": true, "type": "module", "imports": {