시스템관리: 두 판 사이의 차이
172.27.0.1 (토론) 편집 요약 없음 |
172.27.0.1 (토론) |
||
| 224번째 줄: | 224번째 줄: | ||
mysql dolibarr -h mariadb -P 3306 -u doliuser -p*** < backup.sql | mysql dolibarr -h mariadb -P 3306 -u doliuser -p*** < backup.sql | ||
mariadb 여기서 다름 | * mariadb 여기서 다름 | ||
* doliuser 인지 확인 필요 | |||
2025년 4월 9일 (수) 07:14 판
dolibarr 유지보수 관련 내용입니다.
설치
설치 환경과 구축
주요 요약
- Docker Desktop을 Windows에 설치하려면 공식 웹사이트에서 다운로드하고, 설치 마법사를 따라 진행하면 됩니다. WSL 2 또는 Hyper-V를 선택할 수 있습니다. - Dolibarr ERP를 Docker로 사용하려면 Docker Compose를 설정하고, MariaDB와 함께 컨테이너를 실행한 후 웹 인터페이스로 접근하면 됩니다. 데이터는 호스트 디렉토리에 영구 저장됩니다.
---
Docker Desktop 설치
Docker Desktop은 Windows에서 컨테이너를 쉽게 관리할 수 있는 도구입니다. 아래 단계를 따라 설치하세요:
- 공식 웹사이트 [Docker Desktop](https://www.docker.com/products/docker-desktop/)에서 설치 프로그램을 다운로드합니다.
- 실행 파일을 더블 클릭하고, 마법사를 따라 진행하며 필요한 권한을 허용합니다.
- 설치 후 컴퓨터를 재부팅할 수 있습니다. WSL 2를 사용하려면 미리 활성화해야 합니다.
Dolibarr ERP Docker 사용
Dolibarr ERP를 Docker로 설정하려면 다음 단계를 따르세요: - 호스트에 `/home/dolibarr_mariadb`, `/home/dolibarr_documents`, `/home/dolibarr_custom` 디렉토리를 생성합니다. - `docker-compose.yml` 파일을 만들고, 아래와 같은 설정을 추가합니다:
```yaml
services:
mariadb:
image: mariadb:latest
environment:
MYSQL_ROOT_PASSWORD: root
MYSQL_DATABASE: dolidb
MYSQL_USER: dolidbuser
MYSQL_PASSWORD: dolidbpass
volumes:
- /home/dolibarr_mariadb:/var/lib/mysql
web:
image: dolibarr/dolibarr:latest
environment:
DOLI_DB_HOST: mariadb
DOLI_DB_NAME: dolidb
DOLI_DB_USER: dolidbuser
DOLI_DB_PASSWORD: dolidbpass
DOLI_URL_ROOT: "http://0.0.0.0"
DOLI_ADMIN_LOGIN: admin
DOLI_ADMIN_PASSWORD: admin
ports:
- "80:80"
links:
- mariadb
volumes:
- /home/dolibarr_documents:/var/www/documents
- /home/dolibarr_custom:/var/www/html/custom
```
- 터미널에서 `docker-compose up -d` 명령어를 실행하여 컨테이너를 시작합니다. - 브라우저에서 `http://0.0.0.0`에 접속하여 Dolibarr에 로그인합니다 (기본 계정: admin/admin).
---
---
보고서: Docker Desktop과 Dolibarr ERP 사용 상세 가이드
이 보고서는 Windows OS에서 Docker Desktop을 설치하고, Dolibarr ERP를 Docker를 통해 사용하는 방법을 상세히 설명합니다. 아래 내용은 공식 문서와 관련 자료를 기반으로 작성되었으며, 사용자가 쉽게 따라 할 수 있도록 단계별로 정리되었습니다.
Docker Desktop 설치 상세 과정
Docker Desktop은 컨테이너화된 애플리케이션을 개발하고 테스트하기 위한 강력한 도구입니다. Windows OS에서 설치하려면 다음 시스템 요구사항을 확인하세요:
- **시스템 요구사항**:
- Windows 10 64-bit: Home 또는 Pro 버전 22H2 (빌드 19045) 이상, 또는 Enterprise/Education 버전 22H2 (빌드 19045) 이상. - Windows 11 64-bit: Home/Pro 22H2 이상, 또는 Enterprise/Education 22H2 이상. - WSL 2를 사용하려면 WSL 2 기능이 활성화되어 있어야 하며, Hyper-V를 사용하려면 Hyper-V 및 컨테이너 Windows 기능이 필요합니다. - Windows Home/Education 에디션은 Linux 컨테이너만 지원하며, Windows 컨테이너를 사용하려면 Professional/Enterprise 에디션이 필요합니다.
- **설치 단계**:
1. 공식 웹사이트 [Docker Desktop](https://www.docker.com/products/docker-desktop/)에서 최신 설치 프로그램을 다운로드합니다. 2. 다운로드된 `Docker Desktop Installer.exe`를 실행합니다. 기본 설치 경로는 `C:\Program Files\Docker\Docker`입니다. 3. 설치 마법사를 따라 진행하며, "Use WSL 2 instead of Hyper-V" 옵션을 선택하거나 시스템 설정에 따라 적절한 백엔드를 선택합니다. 4. 설치가 완료되면 "Close"를 클릭합니다. 필요 시 컴퓨터를 재부팅합니다. 5. 관리자 계정과 일반 사용자 계정이 다를 경우, 일반 사용자를 "docker-users" 그룹에 추가해야 합니다: - "컴퓨터 관리"를 관리자 권한으로 실행합니다. - "로컬 사용자 및 그룹" > "그룹" > "docker-users"로 이동합니다. - 사용자를 추가한 후 로그아웃하고 다시 로그인합니다.
- **Docker Desktop 시작**:
- 시작 메뉴에서 "Docker"를 검색하고 "Docker Desktop"을 선택합니다. - Docker 구독 서비스 약관에 동의해야 합니다. 개인 사용 또는 소규모 기업(250명 미만, 연 매출 1천만 달러 미만)의 경우 무료입니다. 상업적 사용 시 유료 구독이 필요할 수 있습니다. - 약관에 동의하지 않으면 Docker Desktop이 실행되지 않으므로, 반드시 동의해야 합니다. 자세한 내용은 [Docker Desktop Subscription Service Agreement](https://www.docker.com/legal/docker-subscription-service-agreement/) 및 [FAQs](https://www.docker.com/pricing/faq)를 참조하세요.
- **추가 정보**:
- Docker Desktop은 WSL 2와 Hyper-V를 모두 지원하며, 선택에 따라 성능 차이가 있을 수 있습니다. WSL 2는 리소스 효율성이 높고, Hyper-V는 Windows 컨테이너에 유리합니다. - 설치 후 컨테이너와 이미지는 동일 VM을 사용하는 모든 사용자 계정에서 공유됩니다.
Dolibarr ERP Docker 사용 상세 과정
Dolibarr ERP는 오픈 소스 ERP 및 CRM 솔루션으로, Docker를 통해 쉽게 배포하고 관리할 수 있습니다. 아래는 Docker를 사용한 설정 및 사용 방법입니다:
- **사전 준비**:
- Docker Desktop이 이미 설치되어 있어야 합니다. - 호스트 머신에 영구 저장을 위한 디렉토리를 생성합니다: - `/home/dolibarr_mariadb`: MariaDB 데이터베이스 데이터 저장. - `/home/dolibarr_documents`: Dolibarr 문서 파일 저장. - `/home/dolibarr_custom`: Dolibarr 커스텀 모듈 저장.
- **Docker Compose 설정**:
- `docker-compose.yml` 파일을 생성하고, 아래와 같은 내용을 추가합니다. 이 예시는 MariaDB를 데이터베이스로 사용하는 설정입니다 (MySQL도 가능): ```yaml
services:
mariadb:
image: mariadb:latest
environment:
MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD:-root}
MYSQL_DATABASE: ${MYSQL_DATABASE:-dolidb}
MYSQL_USER: ${MYSQL_USER:-dolidbuser}
MYSQL_PASSWORD: ${MYSQL_PASSWORD:-dolidbpass}
volumes:
- /home/dolibarr_mariadb:/var/lib/mysql
web:
image: dolibarr/dolibarr:latest
environment:
WWW_USER_ID: ${WWW_USER_ID:-1000}
WWW_GROUP_ID: ${WWW_GROUP_ID:-1000}
DOLI_DB_HOST: ${DOLI_DB_HOST:-mariadb}
DOLI_DB_NAME: ${DOLI_DB_NAME:-dolidb}
DOLI_DB_USER: ${DOLI_DB_USER:-dolidbuser}
DOLI_DB_PASSWORD: ${DOLI_DB_PASSWORD:-dolidbpass}
DOLI_URL_ROOT: "${DOLI_URL_ROOT:-http://0.0.0.0}"
DOLI_ADMIN_LOGIN: "${DOLI_ADMIN_LOGIN:-admin}"
DOLI_ADMIN_PASSWORD: "${DOLI_ADMIN_PASSWORD:-admin}"
DOLI_CRON: ${DOLI_CRON:-0}
DOLI_CRON_KEY: ${DOLI_CRON_KEY:-mycronsecurekey}
DOLI_INIT_DEMO: ${DOLI_INIT_DEMO:-0}
DOLI_COMPANY_NAME: ${DOLI_COMPANY_NAME:-MyBigCompany}
ports:
- "80:80"
links:
- mariadb
volumes:
- /home/dolibarr_documents:/var/www/documents
- /home/dolibarr_custom:/var/www/html/custom
```
- 환경 변수는 필요에 따라 수정할 수 있습니다. 예를 들어, `DOLI_ADMIN_LOGIN`과 `DOLI_ADMIN_PASSWORD`를 변경하여 기본 관리자 계정을 안전하게 설정하세요.
- **컨테이너 실행**:
- 생성된 디렉토리에서 다음 명령어를 실행합니다:
```bash
docker-compose up -d
```
- 또는 "docker-compose" 명령어가 사용 불가능하다면:
```bash
docker compose up -d
```
- 컨테이너 상태와 로그를 확인하려면:
```bash
docker-compose ps
docker-compose logs
```
- **Dolibarr 접근 및 초기 설정**:
- 브라우저에서 `http://0.0.0.0`에 접속합니다. 포트 80이 이미 사용 중이라면, `http://0.0.0.0:xx` (xx는 사용 가능한 포트 번호)로 접속하세요. - 초기 로그인 정보는 기본적으로 `admin/admin`입니다. 환경 변수에서 변경한 경우 해당 정보를 사용하세요. - 첫 실행 시 자동 설치가 진행되며, `DOLI_INIT_DEMO=1`로 설정하면 데모 데이터가 로드됩니다.
- **환경 변수 상세**:
아래 표는 주요 환경 변수와 설명입니다:
| **변수** | **기본값** | **설명** | |------------------------|----------------------|----------------------------------------------| | `DOLI_DB_HOST` | `mariadb` | MariaDB/MySQL 서버 호스트 이름 | | `DOLI_DB_NAME` | `dolidb` | 데이터베이스 이름 | | `DOLI_DB_USER` | `dolidbuser` | 데이터베이스 사용자 | | `DOLI_DB_PASSWORD` | `dolidbpass` | 데이터베이스 사용자 비밀번호 | | `DOLI_URL_ROOT` | `http://localhost` | Dolibarr 설치 URL 루트 | | `DOLI_ADMIN_LOGIN` | `admin` | 초기 관리자 로그인 | | `DOLI_ADMIN_PASSWORD` | `admin` | 초기 관리자 비밀번호 | | `DOLI_INSTALL_AUTO` | `1` | 1: Docker 첫 부팅 시 자동 설치 | | `DOLI_INIT_DEMO` | `0` | 1: Docker 첫 부팅 시 데모 데이터 로드 |
- **업그레이드 및 유지보수**:
- Dolibarr 버전을 업그레이드하려면 `install.lock` 파일을 제거해야 합니다: ```bash docker exec <web-container-name> bash -c "rm -f /var/www/documents/install.lock" ``` 또는 호스트 디렉토리에서: ```bash rm -f /home/dolibarr_documents/install.lock ``` - 업데이트 후 다음 명령어를 실행합니다: ```bash docker-compose pull docker-compose up -d docker-compose logs ``` - `DOLI_INSTALL_AUTO=1`로 설정하면 데이터베이스 마이그레이션이 자동으로 진행됩니다. 그렇지 않으면 웹 인터페이스 `/install`에서 수동으로 진행하세요.
- **추가 정보**:
- 지원 아키텍처: Linux x86-64 (`amd64`), ARMv8 64-bit (`arm64v8`). - Dolibarr Docker 이미지는 공식 PHP 저장소와 Dolibarr 저장소를 기반으로 하며, 사용 가능한 버전은 [Dolibarr Docker Hub](https://hub.docker.com/r/dolibarr/dolibarr/tags)에서 확인할 수 있습니다. - 데이터는 지정된 호스트 디렉토리에 영구 저장되므로, 컨테이너 재시작이나 업그레이드 후에도 유지됩니다.
결론
Windows OS에서 Docker Desktop을 설치하고 Dolibarr ERP를 Docker로 사용하는 과정은 비교적 간단하며, 위 단계를 따라하면 효율적으로 설정할 수 있습니다. 데이터 영구 저장을 위한 디렉토리 설정과 환경 변수 커스터마이징은 특히 중요하며, 필요에 따라 MariaDB 대신 MySQL을 사용할 수도 있습니다. 추가적인 문제 해결이나 세부 사항은 공식 문서를 참조하세요.
---
- 주요 인용
- Windows에 Docker Desktop 설치 방법
윈도우 버전 차이
DB 패키지 설정 다름
DB설정에서 차이가 있다.
윈도우 버전의 DB설정에서는 default 설치를 하므로, root db가 다르다. 설치에서 암호를 docker yml과 비교하여 결정 및 설치 할 것
복원 문제
백업파일 기준으로 복원의 경우, 설치 암호 차이와 db 타입 문제가 있음
mysql dolibarr -h mariadb -P 3306 -u doliuser -p*** < backup.sql * mariadb 여기서 다름 * doliuser 인지 확인 필요