Docker Compose 배포

이 가이드에서는 Docker Compose를 사용하여 HagiCode를 배포하는 방법을 다룹니다. 대부분의 사용자에게 이는 개발, 테스트 및 프로덕션 환경 전반의 기본 배포 경로입니다.

비디오 튜토리얼

전체 흐름을 먼저 보려면 비디오 튜토리얼부터 시작하십시오.

동영상 콘텐츠에는 다음이 포함됩니다:

Docker Compose 배포 프로세스의 전체 데모
구성 파일 생성 및 수정 지침
서비스 시작 및 확인 단계
일반적인 문제 및 해결 방법

영상 길이: 약 15분

:::참고[Docker Compose 빌더] Docker Compose Builder는 이제 다음 위치에서 독립 실행형 도구로 제공됩니다. https://builder.hagicode.com/. 동일한 클래스의 구성 파일을 생성하기 위한 기본 소스로 해당 사이트를 사용하십시오. :::

전제조건

시작하기 전에 시스템에 Docker 및 Docker Compose가 설치되어 있는지 확인하세요.

도커 설치

윈도우

다운로드 및 설치 Windows용 도커 데스크탑

설치 후 Docker Desktop이 실행 중인지 확인하세요.

macOS

다운로드 및 설치 Mac용 Docker 데스크탑

설치 후 Docker Desktop이 실행 중인지 확인하세요.

리눅스

패키지 관리자를 사용하여 Docker를 설치합니다.

sudo apt-get update
sudo apt-get install docker.io docker-compose-plugin

설치 후 Docker 서비스를 시작합니다.

sudo systemctl start docker
sudo systemctl enable docker

설치 확인

설치 후 다음 명령을 실행하여 Docker 및 Docker Compose가 올바르게 설치되었는지 확인하세요.

docker --version
docker compose version

빠른 시작

1. Docker Compose 구성 파일 생성

열기 Docker Compose Builder(독립형 사이트)
필요에 따라 구성을 입력합니다.
- API 제공업체 선택(Zhipu AI, Anthropic Official 또는 Custom API)
- 포트, 데이터베이스, 작업 디렉터리 및 기타 옵션 구성
- 이미지 소스 선택: 네트워크 환경에 따라 적절한 이미지 소스를 선택하세요.
생성 버튼을 클릭하여 가져옵니다. docker-compose.yml 구성
생성된 구성을 다음과 같이 저장합니다. docker-compose.yml 파일
필요한 경우 .env 민감한 정보를 구성하는 파일

이미지 소스 선택

생성기는 세 가지 이미지 소스 옵션을 지원합니다.

도커 허브

이미지 주소: newbe36524/hagicode:{tag}
적용 가능한 시나리오: Docker Hub 미러 가속을 사용하는 사용자에게 적합
장점: 공식 이미지 소스, 적시 업데이트, 안정적인 액세스
참고: 일부 지역에서는 미러 가속을 구성해야 할 수도 있습니다.

ACR(Azure 컨테이너 레지스트리)

이미지 주소: hagicode.azurecr.io/hagicode:{tag}
적용 가능한 시나리오: Docker Hub에 로컬로 액세스할 수 없는 사용자에게 적합
장점: 대체 이미지 소스 제공, 네트워크 액세스 문제 해결
참고: 이미지는 Docker Hub와 동기화 상태를 유지하지만 잠시 지연될 수 있습니다.

Alibaba 클라우드 컨테이너 레지스트리(ACR)

이미지 주소: registry.cn-hangzhou.aliyuncs.com/hagicode/hagicode:{tag}
적용 가능한 시나리오: 국내 사용자에게 적합하며 안정적이고 빠른 네트워크 액세스
장점: Alibaba Cloud 국내 노드, 빠른 액세스 속도, 높은 안정성
참고: Alibaba ACR 이미지는 일반적으로 30분 이내에 Docker Hub와 동기화된 상태로 유지됩니다.

국내 사용자는 알리바바 클라우드 ACR을 추천합니다: 국내 사용자라면 빠르고 안정적인 접속을 위해 알리바바 클라우드 ACR 이미지 소스를 우선적으로 사용하는 것을 권장합니다
대체 Docker Hub: 네트워크 환경에서 Docker Hub에 액세스할 수 있는 경우 Docker Hub를 이미지 소스로 선택할 수도 있습니다.
대체 Azure ACR: 다른 이미지 소스에 액세스하는 데 어려움이 있는 경우에만 Azure ACR 이미지 소스를 선택하세요.
이미지 동기화: Alibaba Cloud ACR 이미지는 일반적으로 30분 이내에 Docker Hub와 동기화 상태를 유지합니다.
버전 일관성: 이미지 태그는 세 가지 이미지 소스 모두에서 일관되므로 버전 문제를 걱정할 필요가 없습니다.

2. 서비스 시작

해당 디렉터리에서 다음 명령을 실행합니다. docker-compose.yml 위치:

docker compose up -d

이 명령은 다음을 수행합니다.

생성된 템플릿으로 정의된 HagiCode 컨테이너를 다운로드하고 시작하세요.
네트워크 생성 및 구성
기본 데이터 디렉터리 및 런타임 종속성을 초기화합니다.

3. 서비스 상태 확인

컨테이너가 실행 중인지 확인합니다.

docker compose ps

생성된 템플릿에 정의된 서비스가 “실행 중” 상태로 표시되어야 합니다.

서비스 로그 보기

모든 서비스 로그를 보려면:

# View all service logs
docker compose logs

# View HagiCode service logs
docker compose logs hagicode

# Real-time log following
docker compose logs -f hagicode

구성 지침

구성을 수정해야 하는 경우(예: 포트 변경, API 공급자 전환 등) 다음을 수행할 수 있습니다.

다음을 사용하여 새 구성을 재생성합니다. Docker Compose Builder(독립형 사이트)
수동으로 편집 docker-compose.yml 그리고 .env 파일
구성을 적용하려면 서비스를 다시 시작하세요.

docker compose restart

접속 신청

웹 인터페이스

서비스가 성공적으로 시작된 후 브라우저를 통해 액세스하십시오.

http://localhost:45000

데이터 지속성

지원되는 Docker Compose 경로는 기본적으로 영구 볼륨이 있는 SQLite 데이터 파일을 사용합니다. 마운트 지점을 검사하거나 백업을 계획해야 하는 경우 생성된 파일에서 볼륨 및 데이터 디렉터리 매핑을 검토하세요. docker-compose.yml.

다음 단계

이제 HagiCode를 성공적으로 배포했습니다. 다음으로 웹 인터페이스에서 실제 프로젝트를 연결한 후 계속 진행하세요. 마법사 설정 또는 제안 세션 생성.

데스크톱 애플리케이션 배포 방법을 선호하는 경우 다음을 참조하세요. 데스크탑 설치 가이드.