Nextcloud Docker Compose (개발자를 위한 사용 방법)

Nextcloud의 기능

Nextcloud Docker는 주요 핵심 기능을 아래에 나열된 채 배포 및 관리 기능의 용이성을 제공합니다:

• 간소화된 설치: Docker의 단일 컨테이너 내에서 PHP 및 웹 서버 같은 모든 종속성을 포함할 수 있는 기능 덕분에 쉬운 설치가 가능하며, 번거로움 없이 설치 및 구성을 할 수 있습니다.
• 휴대성: Docker 컨테이너는 다양한 환경 및 노드에서 휴대 가능하며, 서버 또는 클라우드 환경 간에 Nextcloud 인스턴스를 이동할 때 호환성 문제를 방지합니다.
• 격리: 컨테이너는 호스트 시스템과 다른 컨테이너로부터 절연되어 있어 종속성 및 설정이 동일한 기계에 있는 다른 서비스와 충돌하지 않도록 합니다.
• 확장성: Docker Compose를 사용하여 데이터베이스, 캐싱 또는 부하 분산 서비스를 위한 추가 컨테이너를 배포하여 대규모 환경에서 우수한 성능을 위해 Nextcloud를 쉽게 확장할 수 있습니다.
• 영구 저장소: 스토리지를 컨테이너 외부에 마운트하면, 컨테이너가 다시 시작되거나 업그레이드된 후에도 데이터가 유지됩니다.
• 쉬운 업그레이드: 새로운 이미지 버전을 가져와 컨테이너를 다시 시작하여 Docker를 통해 Nextcloud 또는 그 종속성을 원활하게 업그레이드합니다; 혼란스러운 마이그레이션이 필요하지 않습니다.
• 보안: Docker의 내재된 격리는 Nextcloud의 환경을 호스트 및 다른 애플리케이션과 분리하여 공격 표면을 최소화합니다.

이 모든 기능은 Nextcloud Docker를 당신의 개인 클라우드 인프라를 호스팅하는 효율적인 솔루션으로 만듭니다.

필수 조건

• WSL 2 지원이 있는 Windows 10/11 (Pro, Enterprise, 또는 Education).
• Docker Desktop이 Windows에 설치되어 실행 중입니다.
• 명령 프롬프트 또는 터미널 사용에 대한 기본적인 친숙도.

Nextcloud Docker 이미지 가져오기

터미널에서 다음 명령을 실행하여 Docker Hub에서 공식 Nextcloud Docker 이미지를 가져오세요:

docker pull nextcloud

docker pull nextcloud

또는 Docker 애플리케이션을 열고 검색 상자에서 "nextcloud"를 검색하세요.

명령 프롬프트에서 아래 명령을 사용하여 Nextcloud 설치를 실행하십시오:

docker run -d -p 8080:80 nextcloud

docker run -d -p 8080:80 nextcloud

이 명령은 Nextcloud 이미지를 다운로드하고 새 컨테이너를 생성하여 포트 8080에 노출시킬 것입니다.

데이터베이스용 MariaDB 설정

Nextcloud는 데이터를 저장하기 위해 데이터베이스를 필요로 합니다. MySQL의 대체제로 MariaDB를 사용할 수 있습니다.

먼저 MariaDB 이미지를 가져오십시오:

docker pull mariadb

docker pull mariadb

이 명령을 사용하여 MariaDB 컨테이너를 생성하십시오:

docker run -d \
  --name nextcloud-db \
  -e MYSQL_ROOT_PASSWORD=your_root_password \
  -e MYSQL_DATABASE=nextcloud \
  -e MYSQL_USER=nextcloud_user \
  -e MYSQL_PASSWORD=your_password \
  mariadb

docker run -d \
  --name nextcloud-db \
  -e MYSQL_ROOT_PASSWORD=your_root_password \
  -e MYSQL_DATABASE=nextcloud \
  -e MYSQL_USER=nextcloud_user \
  -e MYSQL_PASSWORD=your_password \
  mariadb

강력한 비밀번호를 선택하여 your_root_password 및 your_password을 대체하십시오. 이 명령은 nextcloud-db이라는 이름의 MariaDB 컨테이너를 설정하며 nextcloud라는 데이터베이스와 nextcloud_user이라는 사용자를 만듭니다.

Nextcloud 웹 인터페이스

웹 브라우저를 열고 Nextcloud가 호스팅된 서버의 IP 주소 또는 도메인 이름을 입력하여 Nextcloud 설치에 접근하세요. 로컬 설치의 경우, 사용하세요:

http://localhost:8080/

관리자 계정 설정

설정 페이지에 접근하면 관리자 사용자를 생성하세요. 필요한 경우 구성 및 설정 관리를 위한 Nextcloud CLI도 사용 가능합니다.

필수 정보를 입력한 후 데이터베이스 연결을 구성하십시오:

1. 데이터베이스 호스트: 로컬 데이터베이스에는 localhost을 사용하거나 Docker를 사용하는 경우 데이터베이스 컨테이너 이름(예: nextcloud-db)을 사용하십시오.
2. MariaDB 설정 시 제공된 데이터베이스 사용자 이름과 비밀번호을 입력하세요.
3. 데이터베이스 이름: 이 예에서는 nextcloud입니다.

필요한 세부 사항을 모두 입력하고 "설정 완료"를 클릭하여 설치를 완료하세요.

IronSecureDoc 설치 및 실행

다음 명령을 사용하여 IronSecureDoc Docker 이미지를 가져오십시오:

docker pull ironsoftwareofficial/ironsecuredoc

docker pull ironsoftwareofficial/ironsecuredoc

IronSecureDoc 컨테이너를 실행하려면 다음을 사용하세요:

docker container run --rm -p 8080:8080 \
  -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> \
  -e ENVIRONMENT=Development \
  -e HTTP_PORTS=8080 \
  ironsoftwareofficial/ironsecuredoc:latest

docker container run --rm -p 8080:8080 \
  -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> \
  -e ENVIRONMENT=Development \
  -e HTTP_PORTS=8080 \
  ironsoftwareofficial/ironsecuredoc:latest

실제 라이선스 키로 <IRONSECUREDOC_LICENSE_KEY>을 대체하십시오. 이 명령은 IronSecureDoc 컨테이너를 시작하여 포트 8080에 노출시킵니다.

Docker 컨테이너에서 IronSecureDoc 사용

IronSecureDoc는 설치 후 REST API를 통해 접근할 수 있습니다. 문서 및 API 엔드포인트는 http://localhost:8080/swagger/index.html에서 찾을 수 있습니다.

암호화할 문서를 제출하려면 curl를 통해 POST 요청을 사용하십시오:

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/encrypt?user_password=demo' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/encrypt?user_password=demo' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

이 문서는 IronSecureDoc으로 전달되어 적절한 암호화를 적용합니다.