Coze가 온프레미스에 Docker 버전 요구사항이 있나요? 공공 이슈를 보면, 답은 기본적으로 "네, 그리고 옛 버전은 밟기 쉽다"입니다. 가장 일반적인 현상은 'make web'을 실행할 때 'unknown shorthand flag'(-f' 안에 'f')가 직접 보고되는 경우인데, 이는 보통 Coze 프로그램 자체가 고장 나서가 아니라, Docker/Compose 버전이 너무 오래되어 현재 저장소에서 사용 중인 명령 폼을 인식하지 못하기 때문입니다.
공식 저장소에서 'Makefile'의 'web' 타겟은 직접 'docker compose -f docker/docker-compose.yml --env-file...을 사용합니다. 'up -d'가 적혀 있습니다. 즉, 이 시작 과정은 기본적으로 'docker compose' 명령어에 의존하며, 기존 'docker-compose' v1 습관이 아닙니다.
왜 옛 버전들은 쉽게 뒤집힐까
18.x 시대의 도커 게임 플레이가 현재 Compose와 매우 다르기 때문입니다. 여전히 예전 바이너리나 예전 플러그인을 사용하고 있을 수 있지만, 저장소의 시작 스크립트는 이미 새 명령어로 정리되어 있습니다. 따라서 '-f', '--프로필', 'up -d'와 같은 매개변수는 이전 환경에서 직접 오류를 보고하는데, 이는 "Coze가 호환되지 않는다"는 것처럼 보이지만, 실제로는 시작 도구 간의 불일치입니다.
비교적 안정적인 판단 방법
- 먼저 'docker compose version'을 실행해서 환경이 새 명령어를 인식하는지 확인해 보세요.
- 'docker-compose version'만 사용할 수 있다면, 보통 환경이 너무 오래되었음을 의미합니다.
- 'make web' 명령 매개변수가 잘못되었다고 보고되면, 먼저 Docker Engine과 Compose 플러그인을 업그레이드하세요.
공식 README는 이미 이 프로젝트를 Docker Compose가 시작한 로컬 배포 솔루션으로 규정하고 있으므로, 가장 번거로움 없는 방법은 '저장소 스크립트를 우회'하는 것이 아니라, 호스트 환경을 이 명령어 집합을 직접 실행할 수 있는 상태로 업그레이드하는 것입니다. 이렇게 하면 이후 문제 해결이 훨씬 줄어듭니다.
한 문장 결론
Coze 온프레미스 배포는 단순히 실행할 수 있는 Docker가 아니라, 적어도 일반적으로 'docker compose'를 사용할 수 있어야 합니다. 아직 18.x + compose v1을 사용 중이라면, 먼저 환경을 업그레이드하고 그 다음에 Coze에 대해 이야기하세요.
