Docker 및 ddev를 사용하여 로컬에서 Drupal 사이트 시작

Mac의 기존 Drupal 사이트에 대해 로컬 nginx 웹 서버를 설정하는 데 너무 많은 시간을 소비한 후 저는 그냥 포기해야 했습니다. 웹상의 모든 튜토리얼에 따르면 간단한 몇 단계 프로세스로 되어 있었지만 실제로 필요한 모든 부분을 함께 작동하도록 구성하는 것은 불가능해 보였습니다.

범인이 내가 올바르게 설정하지 않았을 수 있는 nginx의 r/w/x 권한인지, 아니면 내가 올바르게 설정하지 않았을 수 있는 nginx conf 파일의 일부인지, 또는 아마도 Drupal이 데이터베이스에 연결하지 않았거나 전체 설정에서 중요한 역할을 하는 것은 php-fpm이었지만 다시 올바르게 구성해야 했습니다.

요점은 개발자가 구성할 항목이 너무 많다는 것입니다. 특히 콘솔 npm install 및 npm run start 에 입력하는 데 익숙한 저와 같은 프론트 엔드 개발자에게는 특히 그렇습니다.

운 좋게도 ddev가 도와줍니다.

설치

Drupal의 로컬 개발 환경을 단순화하도록 설계된 다양한 도구가 있습니다. 사실 Drupal docs 에 많은 것들이 나열되어 있습니다. 더 나은 성능을 위해 M1 Mac을 지원하기 때문에 ddev을 사용했습니다.

Note: Apple Silicon M1 (ARM64) is supported in v1.17-alpha1+ (edge versions).

Homebrew를 사용하여 ddev를 설치하려면 안정적인 버전의 명령 brew install drud/ddev-edge/ddev 또는 brew install drud/ddev/ddev를 사용하십시오.

물론 시스템에도 Docker를 설치해야 합니다. ddev docs for docker installation 을 참조하십시오.

설정

따라서 모든 사이트 파일과 함께 Drupal 프로젝트가 포함된 리포지토리가 제공된다고 가정해 보겠습니다. 당연히 가장 먼저 할 일은 git clone https://github.com/example/example-site 를 사용하여 프로젝트를 복제하고 프로젝트에 cd cd example-site 하는 것입니다.

다음으로 ddev가 재생됩니다. ddev 명령을 실행하려면 먼저 ddev config 를 실행해야 합니다.

Note: All ddev commands need to be launched from the project root folder!

프로젝트 이름 및 프로젝트 유형과 같은 몇 가지 기본 구성 단계를 안내하지만 ddev가 적절한 값을 추측하는 데 꽤 능숙해 보이기 때문에 아무 것도 입력할 필요가 없었습니다.

The docs 모든 종류의 설정에 대한 빠른 시작 가이드가 포함되어 있습니다. 나는 Drupal 9 섹션에 관심이 있었고 놀랍게도 (그리고 안도의) 실행할 명령은 ddev composer install 및 ddev launch 2개뿐입니다.

Note: If you haven't run the mkcert -install command before, now is the time.

모든 것이 원활하게 실행되면 ddev는 Project can be reached at https://yourprojectname.ddev.site https://127.0.0.1:64124 라는 메시지를 출력합니다. 그러나 사이트에 액세스하기 전에 데이터베이스를 추가해야 합니다. 제 경우에는 ddev import-db --src=/path/to/file/db.sql 를 사용하여 프로젝트에 쉽게 추가할 수 있는 .sql 파일 형식의 원시 SQL 덤프가 제공되었습니다. 주목해야 할 또 다른 사항 - 내가 복제한 프로젝트가 이전에 수동으로 구성되었기 때문에 ddev가 sites/default/settings.php 에서 자체 데이터베이스 구성을 생성한 이후 제거해야 하는 데이터베이스 구성이 settings.ddev.php에 남아 있었습니다.

그리고 그게 다야.

또한 자동으로 phpmyadmin을 설정합니다. ddev describe 명령을 실행하여 (다른 유용한 것들 중에서) 포트 번호를 확인할 수 있습니다.

요약하자면

1단계 - 도커 설치

brew install homebrew/cask/docker
// or visit
https://docs.docker.com/docker-for-mac/install/

2단계 - ddev 설치

brew install drud/ddev-edge/ddev
// or
brew install drud/ddev/ddev 

3단계 - 프로젝트 가져오기

git clone https://github.com/example/example-site && cd example-site

4단계 - 프로젝트에 대한 구성 ddev

ddev config

5단계 - 프로젝트 종속성 설치

ddev composer install

6단계 - 데이터베이스 가져오기

ddev import-db --src=/path/to/file/db.sql

ddev launch 완료되었습니다!