728x90 반응형 전체 글254 프로젝트 폴더 이동 후 Python venv 복구하기: 새 환경 생성부터 실행 경로 확인까지 프로젝트 폴더를 옮긴 뒤 venv나 설치된 명령이 실행되지 않는다면 새 위치에서 가상환경을 만들고 → requirements.txt의 패키지를 설치한 뒤 → 실행 중인 환경 경로를 확인하세요. Python 공식 문서는 가상환경이 들어 있는 상위 폴더를 옮긴 경우에도 새 위치에서 환경을 재생성하도록 안내합니다. 1왜 폴더 이동 후 재생성이 필요할까요?가상환경에 설치된 스크립트의 shebang에는 Python 인터프리터의 절대 경로가 들어갑니다. 프로젝트 폴더를 옮겨 경로가 달라지면 이 참조가 맞지 않을 수 있습니다. 따라서 가상환경은 일반적으로 폴더째 이동해서 계속 사용하는 구조가 아닙니다. 1시작 조건: 기존 프로젝트와 기반 Python이 글은 이동 전 사용하던 기존 프로젝트의 환경을 복구하는 절차입니다.. 2026. 11. 2. uv 프로젝트에서 로컬 패키지 수정이 반영되지 않을 때: uv add --editable로 해결하기 로컬 패키지의 Python 소스를 수정했는데 이전 코드가 실행된다면, 경로 의존성이 editable로 설정되어 있는지 확인하세요. 일반 경로 의존성은 기본적으로 editable이 아닙니다. 패키지를 사용하는 uv 프로젝트에서 uv add --editable ../projects/bar/를 실행하면 원본 소스를 참조하는 설치 방식을 요청할 수 있습니다. 경로는 실제 수정 대상 패키지 디렉터리로 바꾸세요. 1왜 원본을 수정해도 이전 코드가 실행될까요?일반 설치는 로컬 패키지로 wheel을 빌드한 뒤 소스 파일을 가상환경에 복사합니다. 따라서 원본 파일만 수정하면 가상환경에는 이전 코드가 남을 수 있습니다. 로컬 경로를 지정했다는 사실과 원본 수정이 반영되는 설치 방식인지는 별개입니다. 1editable 설치.. 2026. 11. 1. uv lock이 Python 버전이 충분한데도 실패할 때: requires-python 점검과 해결 순서 Python 버전이 충분한데도 uv lock이 실패한다면, 먼저 pyproject.toml의 project.requires-python 하한을 확인하세요. uv의 범용 의존성 해결은 실행 중인 Python뿐 아니라 프로젝트가 선언한 지원 범위 전체를 고려합니다. 프로젝트가 >=3.8을 선언했는데 어떤 의존성의 모든 버전이 Python 3.9 이상을 요구한다면, 실행 Python이 그보다 높아도 Python 3.8을 지원할 조합이 없어 실패합니다. 1시작 전: 기존 프로젝트의 설정을 기준으로 확인합니다이 글은 uv와 Python이 설치되어 있고, 저장소 루트의 pyproject.toml에 프로젝트와 의존성이 정의된 기존 프로젝트를 대상으로 합니다. 아래 작업 위치는 해당 프로젝트 루트로 통일합니다. 프로젝.. 2026. 10. 31. Docker Compose .env 변수 전달 문제 해결: environment 연결·설정 확인·적용 .env에 적은 DEBUG=1을 컨테이너에 전달하려면 대상 서비스의 environment에 - DEBUG=${DEBUG}를 연결하세요. 그런 다음 docker compose config로 서비스에 전달될 값을 확인하고 docker compose up -d로 적용합니다. 셸에도 DEBUG가 있으면 파일보다 셸 값이 우선하므로, 기대값이 나오지 않을 때는 치환 입력부터 확인해야 합니다. 1 2준비 조건과 적용 범위이 글은 Docker와 Compose CLI가 설치되어 있고, 기존 이미지 또는 빌드 설정으로 실행 가능한 Compose 프로젝트가 있다는 전제의 수정 절차입니다. YAML은 기존 서비스에 추가할 발췌본이며, webapp은 실제 대상 서비스명으로 바꾸세요. 미리 작성된 테스트는 사용하지 않고 Com.. 2026. 10. 30. uv 프로젝트에서 pip용 requirements.txt 파일 내보내기 기존 uv 프로젝트에서 pip용 requirements.txt를 파일로 저장하려면 uv export --format requirements.txt --output-file requirements.txt를 실행하세요. 생성한 파일은 pip에서 사용할 수 있습니다. 아래는 기존 프로젝트의 잠금 파일을 준비하고 파일로 내보내는 절차입니다. 1준비: 기존 프로젝트와 실행 위치이 글은 uv가 설치되어 실행 가능하고, 기존 uv 프로젝트가 준비된 환경을 전제로 합니다. 새 프로젝트 생성이나 도구 설치는 다루지 않습니다. 명령은 프로젝트 루트의 pyproject.toml이 있는 디렉터리에서 실행하는 구성입니다. uv는 이 파일로 프로젝트 루트를 식별합니다. 미리 작성한 테스트나 애플리케이션 실행 검증은 이 절차의 전.. 2026. 10. 29. Docker Compose에서 PostgreSQL 준비 후 앱 시작하기: 기존 프로젝트에 healthcheck 적용 PostgreSQL이 연결을 받을 준비가 된 뒤 앱을 시작하려면 DB 서비스에 healthcheck를 추가하고, 앱의 depends_on에 condition: service_healthy를 지정하세요. Compose의 기본 시작 동작은 컨테이너 실행까지만 기다리므로, DB가 연결을 처리할 준비가 끝났다는 뜻은 아닙니다. 1 2준비: 기존 프로젝트에 적용하는 설정입니다이 글은 Docker와 Compose가 설치되어 있고, 앱 실행 설정·PostgreSQL 초기화 및 인증 설정·앱의 DB 연결 설정이 이미 준비된 프로젝트를 대상으로 합니다. 시작 순서 문제를 제외한 기본 구성이 갖춰졌다는 전제이며, 신규 앱이나 DB를 구축하는 절차는 아닙니다. 여기서 추가할 것은 DB 검사와 앱 시작 조건입니다. 1 2예제.. 2026. 10. 28. Docker Agent를 기존 자체 호스팅 NVIDIA NIM 서버에 연결하는 설정과 확인 절차 기존 자체 호스팅 NVIDIA NIM 서버에 연결하려면 provider: nvidia를 사용하고 base_url을 자신의 NIM 엔드포인트로 바꾸세요. models.local_nim에 모델을 정의한 다음 agents.root.model에서 local_nim을 참조하면 됩니다. 아래에서는 이 설정을 작성하고, 사전 검사와 실제 실행을 나누어 확인합니다. 1준비: 이미 운영 중인 NIM 서버가 필요합니다이 글은 NIM 서버가 이미 배포되어 있고, 클라이언트에서 docker agent를 사용할 수 있다는 전제의 연결 안내입니다. Docker Desktop 4.63 이상에는 Docker Agent가 포함되어 있으며, 4.49~4.62에서는 cagent라는 이름이었습니다. NIM 설치, GPU·드라이버 구성, 서.. 2026. 10. 27. Docker Agent의 기존 agent.yaml에서 dev·reviewer에 서로 다른 모델 지정하기 기존 agent.yaml에 dev와 reviewer가 정의되어 있다면, docker agent run agent.yaml --model "dev=openai/gpt-4o,reviewer=anthropic/claude-sonnet-4-5"로 두 에이전트에 서로 다른 모델을 지정할 수 있습니다. agent=provider/model이 에이전트별 지정 문법이며, 여러 지정은 쉼표로 구분합니다. 1준비: 기존 팀 설정과 실행 환경이 글은 Docker Agent가 설치되어 있고, 기존 팀 설정에 dev와 reviewer가 있는 상황을 다룹니다. 새 프로젝트나 팀을 만드는 절차가 아닙니다. 예제에서는 기존 agent.yaml이 있는 디렉터리에서 파일 경로를 명시해 실행하며, 저장소 루트에 별도 설정이 있거나 미리 .. 2026. 10. 26. Docker Agent에서 Nebius 모델 ID의 슬래시를 유지해 agent.yaml에 지정하기 agent.yaml의 agents.root.model에 nebius/deepseek-ai/DeepSeek-V3를 지정하세요. 인라인 참조는 provider/model 형식이며, 여기서 공급자는 nebius, 모델 ID는 deepseek-ai/DeepSeek-V3입니다. 모델 ID 내부의 슬래시와 DeepSeek-V3의 대소문자를 그대로 유지하세요.12준비: 기존 Docker Agent 설정을 수정합니다이 글은 Docker Agent가 설치되어 실행 가능하고, 기존 프로젝트의 agent.yaml에 agents.root가 있는 환경을 대상으로 합니다. 설치부터 시작하는 절차가 아닙니다. 아래 명령은 agent.yaml이 있는 디렉터리에서 실행하는 것으로 설명하며, 저장소 루트의 별도 설정이나 미리 작성한 테.. 2026. 10. 25. 이전 1 2 3 4 ··· 29 다음 728x90 반응형