시스템관리 편집하기

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
<nowiki>
  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

</nowiki>  ```
- 터미널에서 `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
<pre>
    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
</pre>    ```

- **Dolibarr 접근 및 초기 설정**:
  - 브라우저에서 `http://0.0.0.0`에 접속합니다. 포트 80이 이미 사용 중이라면, `http://0.0.0.0:xx` (xx는 사용 가능한 포트 번호)로 접속하세요.
  - 초기 로그인 정보는 기본적으로 `admin/admin`입니다. 환경 변수에서 변경한 경우 해당 정보를 사용하세요.
  - 첫 실행 시 자동 설치가 진행되며, `DOLI_INIT_DEMO=1`로 설정하면 데모 데이터가 로드됩니다.

- **환경 변수 상세**:
  아래 표는 주요 환경 변수와 설명입니다:
<pre>
  | **변수**               | **기본값**           | **설명**                                      |
  |------------------------|----------------------|----------------------------------------------|
  | `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 첫 부팅 시 데모 데이터 로드        |

</pre>

- **업그레이드 및 유지보수**:
  - 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을 사용할 수도 있습니다. 추가적인 문제 해결이나 세부 사항은 공식 문서를 참조하세요.

---

: '''주요 인용'''
- [https://docs.docker.com/desktop/setup/install/windows-install/ Windows에 Docker Desktop 설치 방법]
- [https://github.com/Dolibarr/dolibarr-docker Dolibarr ERP Docker 사용 가이드]