콘텐츠 대표 이미지 - 드루팔 Features 모듈: 설정 관리의 마에스트로

드루팔 Features 모듈: 설정 관리의 마에스트로

개발과 배포의 늪에서 허우적대는 당신을 위한 필살기, 설정과 기능을 우아하게 패키징하는 법!

안녕, 나의 개발자 동지! 👋

오늘도 로컬 환경에서는 완벽하게 돌아가던 내 웹사이트가
스테이징 서버에만 올리면 귀신같이 에러를 뿜어내는 마법 같은 경험, 다들 한 번쯤은 해봤을 거야.
분명 똑같이 세팅한 것 같은데, 왜 너만... 왜 너만 안 되는 건데...?! 😭

이런 '환경 불일치' 문제는 웹 개발, 특히 여러 명이 함께하는 프로젝트에서 정말이지 고질적인 스트레스 요인이지.
A 개발자가 만든 기능, B 개발자가 만든 기능, 그리고 내가 만든 기능이 합쳐지는 순간!
서로의 설정값이 꼬이고 엉키면서 대환장 파티가 열리는 거지.

이럴 때 우리에게 필요한 게 바로 '설정 관리(Configuration Management)'라는 개념이야.
웹사이트의 수많은 설정들(콘텐츠 타입, 필드, 뷰, 권한 등등)을 그냥 데이터베이스에만 저장해두는 게 아니라,
마치 코드처럼 체계적으로 관리하고, 버전 관리 시스템(Git 같은 거!)으로 추적하고, 다른 환경에 똑같이 복제할 수 있게 만드는 기술이지.

그리고 여기, 드루팔 세계관에서 이 설정 관리의 역사를 논할 때 빼놓을 수 없는 전설적인 모듈이 있어.
바로 오늘 우리가 깊게 파고들 주제, Features 모듈이야!

Features 모듈은 웹사이트의 특정 기능과 관련된 설정들을 하나의 묶음, 즉 '피처(Feature)'로 만들어서 코드처럼 다룰 수 있게 해주는 마법 같은 도구야.
마치 요리 레시피처럼, '블로그 기능'에 필요한 모든 재료(설정)들을 하나의 레시피 북(피처)에 담아두고,
어떤 주방(서버 환경)에서든 똑같은 맛의 요리(기능)를 만들어낼 수 있게 해주는 거지.

물론 최신 드루팔(8/9/10)에는 코어에 'Configuration Management Initiative(CMI)'라는 강력한 설정 관리 시스템이 내장되어 있어.
하지만 그렇다고 Features 모듈이 퇴물이 되었냐고? 천만의 말씀!
CMI가 사이트 전체 설정을 통째로 관리하는 '거시적' 접근법이라면,
Features는 특정 기능 단위로 설정을 묶고 재사용하는 '미시적' 접근법에서 여전히 막강한 힘을 발휘해.
오히려 CMI와 함께 사용할 때 그 시너지는 폭발하지.

자, 그럼 이제부터 나와 함께 드루팔 Features 모듈의 세계로 떠나보자.
개발과 배포의 스트레스를 확 줄여주고, 너의 개발 워크플로우를 한 단계 업그레이드시켜 줄 치트키를 손에 넣을 시간이야!
Let's get it! 🚀

Chapter 1. Features 모듈, 너 정체가 뭐니?

좋아, 본격적으로 시작하기 전에 Features 모듈이 정확히 어떤 녀석인지 그 본질부터 파헤쳐 보자.
이름만 들으면 '오, 웹사이트에 새로운 기능을 추가해주는 건가?' 싶지만, 그건 반만 맞는 말이야.
Features 모듈의 진짜 정체는 '설정 패키징 및 배포 도구'라고 할 수 있어.

레고 블록 vs. 레고 시티: Features의 핵심 컨셉

드루팔에서 웹사이트를 만든다는 건, 수많은 설정 '블록'들을 조립하는 과정과 같아.
콘텐츠 타입, 필드, 뷰, 메뉴, 권한... 이 모든 게 다 개별적인 설정 블록들이지.

여기서 드루팔 코어의 설정 관리 시스템(CMI)은 이 모든 블록들을 담고 있는 거대한 '블록 통' 전체를 관리하는 방식이야.
개발 환경의 블록 통을 그대로 복사해서 운영 환경에 덮어쓰는 거지.
사이트 전체를 동기화할 때는 아주 강력하고 정확해.

반면에 Features 모듈은 다른 접근법을 취해.
그냥 블록 통을 통째로 옮기는 게 아니라, 특정 모델을 만드는 데 필요한 블록들만 골라내서
설명서와 함께 하나의 '레고 시티 제품(예: 경찰서, 소방서)'으로 포장하는 거야.

  • '블로그 기능'이라는 Feature를 만든다고 상상해봐.
  • 필요한 블록들: '블로그 포스트' 콘텐츠 타입, '본문' 필드, '이미지' 필드, '태그' 필드, '블로그 목록' 뷰, '블로그 작성' 권한...

Features 모듈은 이 모든 설정 블록들을 쏙쏙 골라내서 `my_blog`라는 이름의 '피처 모듈'로 만들어줘.
이 피처 모듈은 이제 독립적인 하나의 코드가 되는 거야.
Git으로 버전을 관리할 수 있고, 다른 프로젝트에 가져가서 "자, 여기 블로그 기능 세트야!" 하고 간단하게 설치할 수도 있게 되지.

이게 바로 Features 모듈의 핵심이야.
단순히 설정을 내보내는(export) 것을 넘어, 관련 있는 설정들을 논리적인 기능 단위로 '패키징(packaging)'하고, 이를 재사용 가능한 모듈로 만들어준다는 것!

💡 Features vs. CMI: 언제 무엇을 써야 할까?

이 둘은 경쟁 관계가 아니라 상호 보완적인 관계야. 상황에 맞게 쓰는 게 국룰이지.

CMI (Configuration Management Initiative)가 빛을 발할 때:

  • 환경 동기화: 개발(Dev) → 스테이징(Staging) → 운영(Production) 환경 간의 모든 설정을 완벽하게 일치시키고 싶을 때. 사이트 전체의 '스냅샷'을 옮기는 것과 같아.
  • 단일 프로젝트 관리: 하나의 거대한 드루팔 사이트를 여러 개발자가 함께 개발하고, 설정 변경 사항을 체계적으로 추적하고 병합해야 할 때.

Features 모듈이 치트키가 될 때:

  • 기능 배포: 특정 기능(예: 뉴스 섹션, 포토 갤러리, 이벤트 캘린더)을 만들어서 여러 다른 사이트에 동일하게 적용하고 싶을 때.
  • 멀티사이트 관리: 비슷한 구조를 가진 여러 사이트를 운영하면서, 공통 기능을 한 번에 개발하고 각 사이트에 쉽게 배포/업데이트하고 싶을 때.
  • 설치 프로필 제작: 특정 목적(예: 쇼핑몰, 커뮤니티 사이트)에 최적화된 드루팔 '스타터 킷'을 만들 때. Features로 핵심 기능들을 미리 패키징해서 배포할 수 있어.
  • 기능의 논리적 분리: 하나의 큰 사이트 안에서도 기능들을 논리적으로 분리해서 관리하고 싶을 때. "이 코드는 블로그 기능에만 관련 있어"라고 명확히 구분할 수 있게 되지.

결론적으로, CMI는 '사이트 전체의 상태'를 관리하고, Features는 '재사용 가능한 기능 묶음'을 관리하는 데 특화되어 있다고 생각하면 쉬워.

드루팔: CMI vs. Features 모듈 설정 관리 방식 비교 CMI (코어 설정 관리) 사이트 전체 설정 (config/sync) system.site.yml node.type.article.yml views.view.frontpage.yml user.role.anonymous.yml 사이트의 모든 설정을 하나의 거대한 보따리로 관리합니다. Features 모듈 Drupal Site Feature: Blog node.type.blog.yml views.view.blog.yml Feature: Photo Gallery node.type.gallery.yml image.style.large.yml 관련 설정들을 기능 단위로 묶어 재사용 가능한 모듈로 만듭니다.

CMI는 사이트 전체를, Features는 기능별 패키지를 관리하는 개념적 차이

Features 모듈의 역사: Drupal 7의 구원자에서 Drupal 10의 조력자로

이 친구, 사실 꽤나 역사가 깊어. CMI가 없었던 Drupal 7 시절, 설정 관리는 그야말로 대혼돈이었어.
모든 설정이 데이터베이스에 뒤죽박죽 섞여 있었고, 개발 환경에서 만든 기능을 운영 환경으로 옮기려면...
말 그대로 '손으로' 하나하나 똑같이 클릭해서 만들어주거나, `Strongarm` 같은 보조 모듈들을 덕지덕지 붙여 써야 했지.

이때 혜성처럼 등장한 것이 바로 Features 모듈이야.
설정을 코드로 내보내고 관리할 수 있다는 개념을 제시하며 Drupal 7 개발자들에게 한 줄기 빛과 소금이 되어주었지.
가히 '혁명'이라고 불릴 만했어.

시간이 흘러 Drupal 8이 등장하며 코어에 CMI가 탑재되었어.
많은 사람들이 "이제 Features의 시대는 끝났다"고 생각했지만, 웬걸?
위에서 설명했듯이, Features는 CMI와는 다른 자신만의 명확한 영역을 구축하며 살아남았고, 오히려 더 발전했어.
이제는 CMI라는 든든한 기반 위에서, 특정 기능 묶음을 더 세련되고 안정적으로 관리하는 '전문가' 역할을 하고 있지.

그래서 오늘날 우리는 Drupal 10에서도 여전히 Features 모듈을 유용하게 사용하고 있는 거야.
과거의 유물이 아니라, 현대적인 드루팔 개발 워크플로우를 완성하는 핵심 조각 중 하나로 말이지!

Chapter 2. 실전! Features 모듈 설치 및 기본 세팅

백문이 불여일견! 이제 직접 Features 모듈을 설치하고 우리 눈으로 확인해 볼 시간이야.
겁먹지 마, 전혀 어렵지 않으니까 차근차근 따라와 봐.

준비물: 드루팔 사이트와 Composer

당연히 드루팔 사이트가 하나 필요하겠지? 로컬 개발 환경에 설치된 따끈따끈한 드루팔 사이트면 충분해.
그리고 현대적인 드루팔 개발의 필수품, Composer가 설치되어 있어야 해.
요즘은 Composer 없이 드루팔 모듈을 관리하는 건 상상하기 힘드니까, 혹시 아직이라면 꼭 설치하고 오자!

1단계: Composer로 모듈 설치하기

자, 터미널을 열고 너의 드루팔 프로젝트 루트 디렉토리로 이동해.
그리고 마법의 주문을 외쳐보자.

Terminal
composer require drupal/features

이 한 줄이면 Composer가 알아서 Features 모듈과 그에 필요한 다른 의존성 모듈들까지 다운로드해서 `modules/contrib` 폴더에 촤라락 설치해 줄 거야.
정말 편하지 않아? 이래서 다들 Composer, Composer 하는 거라구.

💡 잠깐, CMI (Configuration Manager)도 필요해요!

Features 모듈은 드루팔 코어의 설정 관리 시스템(CMI)을 기반으로 동작해.
그래서 Features를 제대로 활용하려면 `Configuration Manager` 모듈이 활성화되어 있어야 해.
보통은 드루팔을 설치할 때 기본 'Standard' 프로필로 설치했다면 이미 활성화되어 있을 거야.
혹시 모르니 확인해보는 센스!

2단계: 관리자 화면에서 모듈 활성화하기

코드를 다운받았으니, 이제 드루팔에게 "이 모듈을 실제로 사용할게!"라고 알려줘야 해.
드루팔 관리자 화면으로 로그인해서 '확장 (Extend)' 메뉴로 이동하자. (URL: `/admin/modules`)

검색창에 'Features'라고 입력하면 관련 모듈들이 필터링될 거야.
여기서 우리는 두 가지를 체크해야 해.

  1. Features: 이 녀석이 바로 핵심 엔진이야. 모든 기능의 기반이 되지.
  2. Features UI: 이름 그대로, 우리가 관리자 화면에서 Features를 편리하게 사용할 수 있도록 유저 인터페이스를 제공해주는 모듈이야.

이 두 개를 체크하고 페이지 하단의 '설치 (Install)' 버튼을 클릭!
잠시 기다리면 모듈이 성공적으로 활성화되었다는 메시지를 볼 수 있을 거야.

3단계: Features UI 첫 만남

모듈을 활성화했으니 이제 구경하러 가봐야지?
'설정(Configuration)' > '개발(Development)' 메뉴로 가보면, 우리가 기다리던 'Features'라는 새로운 메뉴가 생겨났을 거야.
(URL: `/admin/config/development/features`)

클릭해서 들어가 보면, 처음에는 아마 텅 비어 있거나 몇 가지 기본 정보만 보일 거야.
괜찮아, 아직 우리가 아무런 피처도 만들지 않았으니까.
상단을 보면 몇 개의 탭이 보일 텐데, 이게 바로 Features UI의 핵심 구성 요소야.

  • Features: 현재 사이트에 설치된 모든 피처들의 목록과 상태를 보여주는 메인 대시보드야. 피처를 만들고 나면 이곳이 우리의 주 무대가 될 거야.
  • Export: 새로운 피처를 만들거나 기존 피처를 업데이트하는 곳. 바로 여기서 설정들을 골라 담아 패키징 작업을 하게 돼.
  • Diff: '차이점'이라는 뜻이지? 특정 피처의 코드(YML 파일)와 현재 사이트의 실제 설정(데이터베이스)이 어떻게 다른지 비교해서 보여주는 아주 중요한 기능이야.
  • Advanced: 고급 설정. 피처를 묶어서 번들로 관리하거나, 특정 설정을 무시하는 등의 세부적인 제어를 할 수 있어. 처음에는 거의 쓸 일이 없으니 가볍게 패스!
🚨 주의! 아직은 아무것도 누르지 마세요!

특히 Export 탭에 들어가면 수많은 설정 목록들이 쫙 펼쳐져서 "이게 다 뭐야?!" 하고 당황할 수 있어.
괜찮아, 정상이야. 그게 바로 네 사이트를 구성하는 모든 설정 조각들이거든.
다음 챕터에서 저 목록들을 어떻게 다루는지, 어떻게 필요한 것만 쏙쏙 골라내는지 아주 친절하게 알려줄 테니 걱정 말고 따라와!

자, 여기까지 왔다면 Features 모듈을 사용할 모든 준비가 끝난 거야.
설치는 생각보다 간단하지? 이제 진짜 재미있는 부분, 나만의 첫 번째 피처를 만들어 볼 시간이야.
다음 챕터에서 우리는 간단한 '블로그 기능'을 직접 만들고, 패키징하고, 코드로 변환하는 전 과정을 함께 해볼 거야.
가슴이 웅장해지지 않아? 😉

Chapter 3. 내 첫 Feature 만들기: 블로그 기능 패키징

이론은 충분해! 이제 직접 손으로 만들어보며 Features의 진가를 느껴볼 시간이야.
이번 챕터에서는 드루팔 사이트의 가장 기본적인 기능 중 하나인 '블로그'를 만들어 볼 거야.
그리고 우리가 만든 블로그에 관련된 모든 설정을 하나의 '피처'로 깔끔하게 포장해 볼 거야.
이 과정만 마스터하면, 다른 어떤 기능이든 자신있게 패키징할 수 있게 될 거야. 자, 집중하고 따라와!

시나리오: 우리가 만들 '심플 블로그' 기능 명세

피처를 만들기 전에, 우리가 뭘 만들 건지부터 명확히 해야겠지? 우리가 만들 블로그는 아래와 같은 구성요소를 가질 거야.

  1. 콘텐츠 타입 (Content Type): '블로그 포스트'라는 이름의 새로운 글 유형.
  2. 필드 (Fields):
    • 기본적인 '제목'과 '본문' 외에,
    • 대표 이미지를 올릴 수 있는 '이미지' 필드
    • 글을 분류할 '태그' 필드
  3. 분류 (Taxonomy): '태그' 필드에서 사용할 '블로그 태그'라는 이름의 태그 모음.
  4. 뷰 (View): 작성된 모든 블로그 포스트를 목록 형태로 보여주는 '블로그' 페이지.
  5. 권한 (Permissions): 로그인한 사용자는 누구나 블로그 포스트를 작성하고 수정할 수 있는 권한.

꽤 그럴듯하지? 이 정도면 블로그의 기본은 다 갖춘 셈이야.

1단계: UI에서 블로그 기능 직접 만들기 (피처링 이전)

Features는 이미 만들어진 설정을 '포장'하는 도구야. 그러니 일단은 드루팔 관리자 화면에서 직접 이 기능들을 만들어야 해.

1. '블로그 포스트' 콘텐츠 타입 생성

  • '구조(Structure)' > '콘텐츠 타입(Content types)'으로 이동 (`/admin/structure/types`).
  • '콘텐츠 타입 추가(+ Add content type)' 버튼 클릭.
  • 이름(Name)에 `블로그 포스트`, 기계 이름(Machine name)에 `blog_post` 입력.
  • 다른 설정은 일단 기본값으로 두고 '저장 및 필드 관리(Save and manage fields)' 클릭.

2. 필드 추가하기

방금 만든 '블로그 포스트' 콘텐츠 타입의 필드 관리 화면일 거야.

  • 이미지 필드:
    • '+ 필드 추가(+ Add field)' 버튼 클릭.
    • '새 필드 추가(Add a new field)' 드롭다운에서 'Image' 선택.
    • 레이블(Label)에 `대표 이미지`, 기계 이름에 `field_blog_image` 입력 후 '저장하고 계속하기(Save and continue)'.
    • 다음 화면은 그냥 기본값으로 두고 '필드 설정 저장(Save field settings)'.
    • 마지막 화면에서는 '필수 필드(Required field)'를 체크 해제하고 '설정 저장(Save settings)'. 이제 이미지 필드가 추가됐어!
  • 태그 필드 (분류 용어 참조):
    • 다시 '+ 필드 추가' 버튼 클릭.
    • '재사용할 기존 필드(Re-use an existing field)'가 아닌 '새 필드 추가'에서 'Taxonomy term' 선택.
    • 레이블에 `태그`, 기계 이름에 `field_blog_tags` 입력 후 '저장하고 계속하기'.
    • 다음 화면에서 '참조할 어휘(Vocabulary)'를 선택해야 하는데, 아직 우리가 태그 어휘를 안 만들었지? 괜찮아. 일단 기본값으로 두고 '필드 설정 저장'.
    • 마지막 화면에서 '참조 유형(Reference type)' 섹션의 '어휘(Vocabulary)' 드롭다운에서 '새 어휘 생성(Create a new vocabulary)'을 선택하고, 이름에 `블로그 태그`를 입력해줘. 그리고 '허용할 값의 개수(Allowed number of values)'를 '제한 없음(Unlimited)'으로 변경하고 '설정 저장'.

좋아! 이제 '블로그 포스트' 콘텐츠 타입은 대표 이미지와 태그를 가질 수 있게 됐어.

3. '블로그' 목록 뷰 생성

  • '구조(Structure)' > '뷰(Views)'로 이동 (`/admin/structure/views`).
  • '+ 뷰 추가(+ Add view)' 버튼 클릭.
  • 뷰 이름(View name)에 `블로그` 입력.
  • '뷰 설정(View settings)'에서 'Show' 드롭다운을 'Content' of type '블로그 포스트'로 변경.
  • '페이지 생성(Create a page)' 체크.
    • 페이지 제목(Page title): `블로그`
    • 경로(Path): `blog`
  • '저장 및 편집(Save and edit)' 클릭.
  • 뷰 편집 화면이 나오면, 일단은 이대로도 충분해. 오른쪽 위의 '저장(Save)' 버튼을 눌러 뷰를 최종 저장하자.

이제 `http://내사이트주소/blog` 로 접속하면 블로그 글 목록이 보이는 페이지가 만들어졌을 거야. (물론 아직 글이 없어서 텅 비어 있겠지만!)

4. 권한 설정하기

  • '사용자(People)' > '권한(Permissions)'으로 이동 (`/admin/people/permissions`).
  • 'Node' 섹션을 찾아서, 'Authenticated user' (로그인한 사용자) 역할에 해당하는 행을 봐.
  • `블로그 포스트: Create new content`, `블로그 포스트: Edit own content`, `블로그 포스트: Delete own content` 권한을 체크해주자. (자신이 쓴 글을 생성, 수정, 삭제할 수 있는 권한)
  • 페이지 맨 아래로 내려가 '권한 저장(Save permissions)' 클릭.

휴, 길었다! 하지만 이제 우리는 완벽하게 작동하는 '블로그 기능'을 갖게 됐어.
하지만 이건 어디까지나 이 사이트, 이 데이터베이스 안에만 존재하는 설정이야.
이제 마법을 부릴 시간이야. 이 모든 설정을 '코드'로 바꿔보자!

2단계: Features로 블로그 기능 패키징하기

드디어 주인공이 등판할 차례. '설정' > '개발' > 'Features' 메뉴로 다시 돌아가자. (`/admin/config/development/features`)

1. 새 피처 생성 시작

  • 'Export' 탭을 클릭해. (`/admin/config/development/features/export`)
  • 'Feature name'에 우리가 만들 피처의 이름을 적어주자.
    • Feature name: `My Blog` (사람이 읽기 좋은 이름)
    • Machine name: `my_blog` (코드에서 사용할 이름, 자동으로 생성될 거야)
    • Description: `Provides a simple blog functionality.` (이 피처에 대한 간단한 설명)

2. 설정 컴포넌트 선택하기 (가장 중요!)

이제 아래에 있는 거대한 설정 목록에서 우리가 방금 만든 것들을 하나씩 골라 담을 거야.
왼쪽의 'Configuration type'으로 필터링하면서 찾으면 훨씬 쉬워.

  • Content Type (node.type):
    • 왼쪽에서 'Content Type'을 클릭.
    • 오른쪽 목록에 `블로그 포스트 (blog_post)`가 보일 거야. 체크!
  • Field Storage (field.storage):
    • 왼쪽에서 'Field Storage' 클릭.
    • 우리가 만든 필드 2개를 찾아서 체크: `field.storage.node.field_blog_image`, `field.storage.node.field_blog_tags`
  • Field Instance (field.instance):
    • 왼쪽에서 'Field Instance' 클릭.
    • 이것도 2개 체크: `field.instance.node.blog_post.field_blog_image`, `field.instance.node.blog_post.field_blog_tags`
  • Taxonomy Vocabulary (taxonomy.vocabulary):
    • 왼쪽에서 'Taxonomy Vocabulary' 클릭.
    • `블로그 태그 (blog_tags)` 체크.
  • View (views.view):
    • 왼쪽에서 'View' 클릭.
    • `블로그 (blog)` 체크.
  • User Permissions (user.permissions):
    • 왼쪽에서 'User Permissions' 클릭.
    • 우리가 설정한 권한들을 찾아야 해. `create blog_post content`, `edit own blog_post content`, `delete own blog_post content` 등 `blog_post`와 관련된 권한들을 모두 체크!
💡 Field Storage vs. Field Instance, 그 차이는?

이거 헷갈리는 친구들 많을 거야. 간단히 설명해줄게.

  • Field Storage (`field.storage`): 필드의 '설계도'야. "이 필드는 텍스트를 저장하고, 최대 255자까지 가능하다" 와 같은 필드의 근본적인 정의를 담고 있어. 이 설계도는 여러 콘텐츠 타입에서 재사용될 수 있어.
  • Field Instance (`field.instance`): 그 설계도를 특정 콘텐츠 타입에 '부착'한 거야. "블로그 포스트 콘텐츠 타입에 '본문'이라는 이름으로 이 텍스트 필드를 사용하겠다" 와 같이, 특정 위치에 필드를 배치하고 세부 설정을 하는 거지.

그래서 보통 새로운 필드를 만들면 Storage와 Instance가 한 쌍으로 만들어지고, 둘 다 피처에 포함시켜야 해.

3. 의존성 확인 및 피처 생성

필요한 설정을 다 체크하고 나면, 페이지 오른쪽을 봐.
'Dependencies'라는 섹션이 보일 거야. Features가 똑똑하게도 우리가 선택한 설정들이 어떤 다른 모듈을 필요로 하는지 자동으로 감지해준 거야.
예를 들어, 이미지 필드를 썼으니 'Image' 모듈이, 태그 필드를 썼으니 'Taxonomy' 모듈이, 뷰를 썼으니 'Views UI' 모듈이 필요하다고 알려주지.

이제 모든 준비가 끝났어. 페이지 하단에 있는 두 개의 버튼 중 하나를 선택할 시간이야.

  • Download archive: 피처 모듈을 `.tar.gz` 압축 파일로 다운로드해줘. 이걸 받아서 네 사이트의 `modules/custom` 같은 폴더에 압축을 풀면 돼.
  • Generate feature: (추천!) 이 버튼을 누르면 드루팔이 알아서 `modules/custom/my_blog` 와 같은 경로에 피처 모듈을 직접 생성해줘. 훨씬 편하지! (단, 파일 시스템 쓰기 권한이 필요해)

'Generate feature' 버튼을 클릭하자!

3단계: 생성된 코드 확인하기

성공적으로 피처가 생성되었다는 메시지가 떴을 거야.
이제 너의 드루팔 프로젝트 폴더를 직접 탐색해보자.
보통 `modules/custom/my_blog` 경로에 새로운 폴더가 생겼을 거야. 그 안을 들여다보면... 와우!

/modules/custom/my_blog/
my_blog/
├── config/
│   └── install/
│       ├── core.entity_form_display.node.blog_post.default.yml
│       ├── core.entity_view_display.node.blog_post.default.yml
│       ├── field.field.node.blog_post.field_blog_image.yml
│       ├── field.field.node.blog_post.field_blog_tags.yml
│       ├── field.storage.node.field_blog_image.yml
│       ├── field.storage.node.field_blog_tags.yml
│       ├── node.type.blog_post.yml
│       ├── taxonomy.vocabulary.blog_tags.yml
│       └── views.view.blog.yml
├── my_blog.info.yml
└── my_blog.features.yml

이게 뭐야? 우리가 UI에서 클릭 몇 번으로 만들었던 모든 설정들이 이렇게 깔끔한 `YML` 파일 형태의 '코드'로 변환되었어!
이게 바로 Features의 마법이야. 데이터베이스 안에만 존재하던 추상적인 설정들이 이제는 파일로 존재하고, Git으로 관리하고, 다른 개발자와 공유할 수 있는 실체가 된 거지.

  • `my_blog.info.yml`: 이 피처가 드루팔 모듈임을 정의하는 파일. 안을 열어보면 우리가 아까 감지했던 의존성(dependencies)들이 적혀있을 거야.
  • `config/install/`: 이 폴더 안에 우리가 선택했던 모든 설정 파일들이 들어있어. 이 모듈을 처음 설치할 때 이 설정들이 사이트에 적용되는 거야.
  • - `my_blog.features.yml`: 이 피처가 어떤 설정들을 포함하고 있는지 정의하는 Features 모듈만의 설정 파일이야.

이제 이 `my_blog` 폴더 전체를 Git에 커밋하면 돼.
그리고 다른 개발자는 `git pull`을 받고, 이 모듈을 활성화하기만 하면, 내가 만들었던 것과 100% 동일한 블로그 기능을 자신의 로컬 환경에 구성할 수 있게 되는 거야.
더 이상 "어, 나는 태그 필드가 안 보이는데?" 같은 말은 들을 필요가 없게 되지!

어때? 직접 해보니 감이 확 오지? 이게 바로 Features 모듈의 가장 기본적이고 핵심적인 워크플로우야.
다음 챕터에서는 이렇게 만들어진 피처를 어떻게 관리하고, 변경사항을 어떻게 추적하고 업데이트하는지 더 깊게 파고들어 볼 거야.

Chapter 4. Features의 꽃, 상태 관리와 업데이트

좋아, 우리는 성공적으로 'My Blog'라는 피처를 만들어서 코드화했어.
하지만 개발은 여기서 끝나지 않지. "아, 블로그에 요약 필드도 추가해야겠다!", "운영 서버에 배포했는데 누가 관리자 화면에서 설정을 마음대로 바꿔버렸네?" 같은 일은 비일비재해.

바로 이럴 때 Features 모듈의 진정한 힘이 드러나. 바로 '상태 관리'와 '업데이트' 기능이야.
이건 Features를 단순한 '설정 내보내기' 도구가 아닌, 지속적인 '설정 관리' 솔루션으로 만들어주는 핵심 기능이지.

피처의 3가지 상태: Default, Overridden, Needs Review

다시 '설정' > '개발' > 'Features'의 메인 화면으로 가보자. (`/admin/config/development/features`)
이제 목록에 우리가 만든 'My Blog' 피처가 보일 거야. 그리고 그 옆에 'State(상태)'라는 컬럼이 있어.
이 상태는 피처의 현재 건강 상태를 알려주는 신호등 같은 거야.

  • Default (기본)

    가장 이상적인 상태. 평화 그 자체. 🕊️
    이건 피처의 코드(`config/install` 폴더의 YML 파일들)와 현재 사이트의 활성 설정(데이터베이스)이 100% 일치한다는 뜻이야.
    코드가 정의한 그대로 사이트가 구성되어 있다는 의미지. 우리의 목표는 항상 이 상태를 유지하는 거야.

  • Overridden (덮어쓰임)

    가장 흔하게 보게 될 상태. 경고등이 켜진 거야. ⚠️
    이건 피처의 코드는 그대로인데, 누군가(혹은 내가) 관리자 UI를 통해 사이트의 설정을 변경했다는 뜻이야.
    예를 들어, '블로그 포스트' 콘텐츠 타입의 설명을 UI에서 살짝 바꿨다고 해보자. 그러면 코드가 정의한 내용과 실제 설정 사이에 차이가 발생하겠지? 그 순간 Features는 이걸 감지하고 상태를 'Overridden'으로 바꿔서 "어이, 코드랑 실제 설정이 달라졌어! 확인해봐!"라고 알려주는 거야.

  • Needs Review (검토 필요)

    이건 'Overridden'의 반대 상황이야.
    사이트의 실제 설정은 그대로인데, 피처의 코드(YML 파일)가 변경되었을 때 나타나.
    주로 다른 개발자가 피처를 업데이트하고 Git에 푸시한 코드를 내가 `git pull`로 받았을 때 이런 상태가 되지.
    코드는 업데이트되었지만, 아직 그 변경사항이 내 로컬 사이트에는 적용되지 않았다는 신호야. "새로운 버전의 코드가 있으니 검토하고 사이트에 적용해!"라는 의미지.

Diff: 무엇이 달라졌는지 한눈에 보기

자, 그럼 'Overridden' 상태가 되었다고 치자. 도대체 뭐가 바뀐 걸까?
이걸 알아내려고 모든 설정을 뒤져볼 순 없잖아. 이때 사용하는 게 바로 'Diff' 기능이야.

Features 목록에서 'My Blog' 피처의 'State' 컬럼에 있는 'Overridden' 링크를 클릭하거나, 상단의 'Diff' 탭으로 가서 'My Blog' 피처를 선택해봐.
그러면 마치 Git diff를 보는 것처럼 익숙한 화면이 나타날 거야.

  • 왼쪽 (Feature): 코드에 정의된 설정 (`.yml` 파일의 내용)
  • 오른쪽 (Active): 현재 사이트의 활성 설정 (데이터베이스의 내용)

빨간색으로 표시된 부분은 삭제/변경된 내용, 초록색으로 표시된 부분은 추가/변경된 내용이야.
이 화면을 통해 우리는 정확히 어떤 설정이, 어떻게 변경되었는지 명확하게 파악할 수 있어.
더 이상 "누가 뭘 건드렸어!"라며 범인 찾기를 할 필요가 없는 거지. Diff가 모든 걸 말해주니까.

Revert: 코드로 사이트를 바로잡기

Diff를 통해 변경 내용을 확인했어. UI에서 실수로 바꾼 설정이라 원래대로 되돌리고 싶어.
이때 사용하는 액션이 바로 'Revert(되돌리기)'야.

Features 메인 목록 화면에서 'My Blog' 피처를 체크하고, 상단의 'Actions' 드롭다운에서 'Revert features'를 선택한 후 'Apply' 버튼을 눌러봐.
그러면 Features는 코드(`yml` 파일)에 정의된 설정을 읽어서, 현재 사이트의 활성 설정(데이터베이스)에 강제로 덮어쓰게 돼.

이건 매우 강력한 작업이야. UI에서 변경했던 모든 내용이 사라지고 코드가 정의한 '원래 상태'로 돌아가는 거지.
이 'Revert' 액션을 통해 우리는 언제나 '코드가 진실의 원천(Source of Truth)'이라는 원칙을 지킬 수 있게 돼.
운영 서버의 설정이 뭔가 꼬였다? 그냥 `Revert` 한 방이면 코드가 정의한 깨끗한 상태로 돌아가는 거야.

만약 상태가 'Needs Review'였다면? 이때도 Revert(최신 버전에서는 Import라고 불리기도 함)를 실행하면 돼.
새로 업데이트된 코드를 현재 사이트에 적용해서, 코드와 사이트 설정을 다시 일치시키는 거지.

드루팔 Features 모듈: 설정 관리 워크플로우 개발자 (로컬 환경) Git 저장소 운영 서버 1. UI에서 설정 변경 (예: 블로그에 요약 필드 추가) 상태: Overridden 2. Features Export (변경된 설정을 피처에 반영) YML 파일 생성/수정 YML 파일 업데이트 (my_blog 피처 코드 변경) 저장소에 커밋됨 서버에 코드 반영 YML 파일은 바뀌었지만 DB는 아직 그대로 상태: Needs Review 5. Feature Import (drush features-import) 상태: Default 배포 완료! 코드와 DB 설정 일치 Export 실행 3. git commit & push 4. git pull (배포) Import 실행 ✓ 새로운 기능 개발 반복 핵심 포인트 • Features 모듈은 설정 변경사항을 코드로 관리하여 버전 관리 및 협업을 용이하게 합니다. • 'Export → Commit → Deploy → Import' 워크플로우로 개발과 운영 환경의 일관성을 보장합니다.

Features 모듈을 활용한 일반적인 개발-배포 사이클. 상태 변화가 핵심이다.

피처 업데이트: 기능 추가 및 변경사항 반영하기

자, 이제 실전 시나리오로 돌아가 보자. '블로그 포스트'에 글의 내용을 요약하는 '요약(Summary)' 필드를 추가하고 싶어졌어.
이 변경사항을 'My Blog' 피처에 어떻게 반영할까?

1. UI에서 기능 추가/변경

먼저 하던 대로 하면 돼. 관리자 UI에서 직접 필드를 추가하자.

  • '구조' > '콘텐츠 타입' > '블로그 포스트'의 '필드 관리'로 이동.
  • '+ 필드 추가'를 눌러 'Text (formatted, long, with summary)' 타입의 필드를 '요약'이라는 이름(`field_blog_summary`)으로 추가해.

이 순간, Features 대시보드로 가보면 'My Blog' 피처의 상태는 즉시 'Overridden'으로 바뀔 거야.
당연하지? 코드에는 없는 '요약' 필드가 사이트에 생겼으니까.

2. Export 화면에서 피처 업데이트

이제 이 변경사항을 코드에 알려줄 차례야.

  • '설정' > '개발' > 'Features'의 'Export' 탭으로 이동.
  • 화면 상단에 'Edit a feature'라는 섹션이 있어. 드롭다운에서 우리가 업데이트할 'My Blog'를 선택해.
  • 그러면 화면이 리로드되면서, 현재 'My Blog' 피처에 포함된 설정들이 체크된 상태로 나타날 거야.
  • 그리고 중요한 것! 'Unpackaged(패키징 안 됨)'이라는 새로운 섹션이 보일 거야. 여기에는 현재 어떤 피처에도 속하지 않은 새로운 설정들이 표시돼.
  • 바로 여기에 우리가 방금 추가한 '요약' 필드 관련 설정(`field.storage.node.field_blog_summary` 등)이 보일 거야. 이걸 체크!
  • 페이지 하단의 'Generate feature' 버튼을 다시 클릭.

이 과정을 거치면, Features는 `my_blog` 모듈의 `config/install` 폴더에 새로운 요약 필드 관련 `.yml` 파일들을 추가하고, `my_blog.features.yml` 파일도 업데이트해줘.

3. 변경사항 커밋 및 배포

이제 업데이트된 `my_blog` 모듈 폴더 전체를 Git에 커밋하고 푸시하면 돼.
다른 개발자나 운영 서버에서는 이 코드를 `pull` 받은 다음, `Revert`(or `Import`)를 실행하면 새로 추가된 '요약' 필드가 사이트에 안전하게 적용되는 거지.

이 워크플로우만 잘 이해하고 있다면, 아무리 복잡한 기능을 추가하거나 변경하더라도
체계적으로, 그리고 실수 없이 팀원들과 협업하고 서버에 배포할 수 있게 돼.
더 이상 설정이 꼬일까 봐 두려워할 필요가 없는 거야!

Chapter 5. 고급 테크닉과 꿀팁 (feat. Drush)

기본기를 탄탄히 다졌으니, 이제 당신을 'Features 마스터'로 만들어 줄 고급 기술과 프로들의 꿀팁을 대방출할 시간이야.
특히 개발자들의 영원한 친구, Drush와 함께라면 Features의 활용도는 날개를 달게 될 거야.
이 챕터를 마치고 나면, 당신의 개발 속도와 효율성은 지금과는 비교도 안 되게 향상될 걸?

Drush: 터미널에서 날아다니기

Drush(The DRUpal SHell)는 드루팔을 위한 커맨드 라인 인터페이스(CLI) 도구야.
관리자 화면에서 마우스로 클릭하던 수많은 작업을 터미널에서 명령어 한 줄로 처리할 수 있게 해주지.
Features 모듈은 Drush와 환상의 궁합을 자랑해. 사실, 숙련된 개발자들은 대부분의 Features 작업을 Drush로 처리한다구.

터미널에서 너의 드루팔 프로젝트 루트로 이동한 다음, 아래 명령어들을 따라 쳐봐.

피처 목록 및 상태 확인: `features:list` (축약: `fl`)

Terminal
drush features:list
# 또는 짧게
drush fl

이 명령어는 `/admin/config/development/features` 페이지에서 보던 피처 목록과 상태를 터미널에 그대로 출력해줘.
굳이 브라우저를 켤 필요 없이 현재 피처들의 건강 상태를 빠르게 확인할 수 있지.

피처 되돌리기 (코드 -> 사이트): `features:import` (축약: `fim`)

Terminal
# 특정 피처만 되돌리기
drush features:import my_blog

# 모든 피처를 한 번에 되돌리기
drush features:import --all
# 또는 짧게
drush fim -y

이게 바로 우리가 UI에서 'Revert' 버튼을 누르던 것과 똑같은 작업이야.
오히려 훨씬 강력하지. `--all` 옵션을 사용하면 상태가 'Overridden'이나 'Needs Review'인 모든 피처를 한 방에 'Default' 상태로 되돌릴 수 있어.
배포 스크립트에 이 명령어 한 줄만 넣어두면, 코드 배포 후 자동으로 모든 설정을 동기화할 수 있겠지? 이게 바로 자동화의 시작이야!

(참고: 예전 버전의 Features에서는 `features-revert` 또는 `fr` 이라는 명령어를 썼어. 최신 버전에서는 `features-import` 또는 `fim`으로 이름이 바뀌었으니 참고해!)

피처 업데이트 (사이트 -> 코드): `features:export` (축약: `fex`)

Terminal
drush features:export my_blog

이 명령어는 UI의 Export 화면에서 하던 피처 업데이트 작업을 터미널에서 실행해줘.
UI에서 변경된 사항을 감지해서 `my_blog` 피처의 코드(`.yml` 파일)에 반영해주는 거지.
UI에서 컴포넌트를 하나하나 체크할 필요 없이, 명령어 한 줄로 끝나니 정말 편리해.

🚀 프로 개발자의 배포 시나리오 (with Drush)

Drush를 사용하면 배포 과정이 이렇게나 심플하고 강력해져.

  1. (로컬) UI에서 기능을 변경하고, `drush fex my_feature`로 피처 코드를 업데이트한다.
  2. (로컬) `git add .`, `git commit -m "블로그 기능 업데이트"`, `git push`로 변경된 코드를 저장소에 올린다.
  3. (서버) `git pull`로 최신 코드를 내려받는다.
  4. (서버) `drush updatedb`로 데이터베이스 업데이트를 실행한다. (혹시 모를 모듈 업데이트)
  5. (서버) `drush fim --all -y`로 모든 피처 설정을 코드 기준으로 동기화한다.
  6. (서버) `drush cache:rebuild` (축약: `cr`)로 캐시를 싹 비워준다.

이 과정을 쉘 스크립트로 만들어두면, `deploy.sh` 파일 실행 한 번으로 모든 배포 과정이 순식간에 끝나게 돼.
실수할 확률은 0에 가까워지고, 시간은 엄청나게 절약되지. 이게 바로 전문가의 워크플로우야.

피처 번들: 피처들을 그룹으로 묶어 관리하기

프로젝트가 커지면 피처의 개수도 수십 개로 늘어날 수 있어.
'블로그 콘텐츠 타입', '블로그 뷰', '블로그 권한'처럼 기능을 아주 잘게 쪼갰다면 더더욱 그렇지.
이럴 때 관련된 피처들을 하나의 그룹, 즉 '번들(Bundle)'로 묶어서 관리하면 편리해.

예를 들어, '블로그 시스템'이라는 번들을 만들고 그 안에 아래 피처들을 포함시키는 거야.

  • `blog_content_type`
  • `blog_views`
  • `blog_permissions`
  • `blog_taxonomy`

이렇게 하면 Features UI에서 번들 단위로 피처들을 필터링해서 보거나, 번들 전체를 한 번에 Revert 하는 등의 그룹 작업이 가능해져.
번들 설정은 Features UI의 'Advanced' 탭에서 할 수 있어. `my_blog.features.yml` 파일에 `bundle: blog_system` 같은 라인을 추가해서 코드로 직접 관리할 수도 있지.

특히 드루팔 '설치 프로필(Installation Profile)'을 만들 때 이 번들 기능이 아주 유용하게 쓰여.
사이트의 핵심 기능들을 번들로 묶어두면 관리가 훨씬 수월해지거든.

설정 무시하기: 환경별로 다른 값을 가져가야 할 때

가끔은 특정 설정을 Features의 관리 대상에서 제외하고 싶을 때가 있어.
가장 대표적인 예가 바로 '사이트 이름'(`system.site.yml`의 `name` 값)이야.

로컬 개발 환경에서는 "로컬 개발용 사이트"라고 해두고 싶고,
운영 환경에서는 "재능넷 공식 블로그"라고 해두고 싶잖아.
그런데 이 설정을 피처에 포함시켜 버리면, 배포할 때마다 운영 서버의 사이트 이름이 "로컬 개발용 사이트"로 바뀌어버리는 대참사가 발생하겠지?

이럴 때 사용하는 것이 바로 '설정 무시(Configuration Ignore)' 기능이야.
드루팔 코어의 `settings.php` 파일에 특정 설정을 무시하도록 지정할 수 있어.

settings.php
// 특정 설정 전체를 무시
$config['config_ignore.settings']['ignored_config_entities'] = [
  'system.site',
];

// 특정 설정의 일부 값만 무시 (더 복잡한 방법)
// ... 이 방법은 config_split 모듈 등을 사용하는 것이 더 일반적입니다.

이렇게 `system.site` 설정을 무시하도록 설정해두면, Features는 이 설정을 더 이상 추적하지 않아.
Revert를 해도 사이트 이름은 변경되지 않고, Export를 해도 피처에 포함되지 않지.
API 키, 이메일 주소 등 환경마다 달라야 하는 민감한 정보들은 이런 식으로 관리하는 게 정석이야.

더 나아가, `Config Split`이라는 모듈을 Features와 함께 사용하면
'개발용 설정', '운영용 설정' 등을 별도의 파일로 분리해서 훨씬 더 체계적으로 관리할 수 있어.
이건 정말 고급 주제이니, 일단은 "환경별로 설정을 다르게 가져갈 방법이 있다"는 것만 알아두자!

프로들의 Best Practices (이것만은 지키자!)

마지막으로, Features를 정말 '잘' 쓰기 위한 몇 가지 실전 원칙들을 정리해줄게.
이 원칙들은 수많은 개발자들이 피, 땀, 눈물을 흘리며 얻어낸 교훈들이니 꼭 기억해둬.

  1. 작고 명확하게 (Small and Specific):
    모든 설정을 하나의 거대한 '괴물 피처'에 때려 넣지 마. "하나의 피처는 하나의 기능만 책임진다"는 원칙을 지키는 게 좋아. 예를 들어, '블로그'라는 큰 기능도 '콘텐츠 타입', '뷰', '권한' 등으로 피처를 분리하면 나중에 특정 부분만 수정하거나 재사용하기가 훨씬 쉬워져.
  2. 명명 규칙 (Naming Convention):
    피처의 기계 이름은 프로젝트의 다른 모듈과 겹치지 않도록 `프로젝트명_기능명` (예: `myproject_blog`) 같은 일관된 규칙으로 만드는 게 좋아. 나중에 피처가 수십 개가 되어도 한눈에 알아볼 수 있지.
  3. Git은 생명이다 (Version Control is Everything):
    Features는 '설정을 코드로' 관리하는 도구야. 그 말은 곧, 모든 변경사항이 Git을 통해 추적되어야 한다는 뜻이야. UI에서 설정을 바꾸고 `fex`로 코드를 업데이트했다면, 반드시 의미 있는 커밋 메시지와 함께 Git에 커밋하는 습관을 들여야 해. "누가, 언제, 왜" 이 설정을 바꿨는지 기록으로 남기는 건 협업의 기본이야.
  4. 소통, 또 소통 (Communication is Key):
    팀 프로젝트에서는 "나 지금 블로그 피처 건드리고 있어!"라고 동료들에게 알려주는 게 중요해. 동시에 두 명이 같은 피처를 수정하다가 충돌(conflict)이 나면 해결하기가 아주 골치 아프거든. 어떤 기능을 개발할지, 어떤 피처를 만들거나 수정할지 미리 계획하고 공유하는 문화가 필수적이야.
  5. 이런 고급 기술과 좋은 습관들이 몸에 배면, 당신은 더 이상 설정 문제로 골머리를 앓지 않게 될 거야.
    오히려 설정을 자유자재로 다루며, 안정적이고 효율적인 개발 프로세스를 이끄는 리더가 될 수 있지.
    혹시 이런 복잡한 드루팔 아키텍처 설계나 개발 워크플로우 구축에 전문가의 도움이 필요하다면, **재능넷** 같은 플랫폼에서 숙련된 드루팔 개발자의 조언을 구해보는 것도 좋은 방법이 될 수 있어. 때로는 전문가의 짧은 컨설팅이 몇 날 며칠의 삽질을 막아주기도 하니까 말이야.

마치며: 설정의 지배자가 되어라

자, 지금까지 정말 긴 여정을 함께 달려왔어.
단순히 '설정을 내보내는' 도구로만 알았던 Features 모듈이, 사실은 얼마나 깊이 있고 강력한 철학을 담고 있는 녀석인지 이제는 확실히 느꼈을 거야.

Features 모듈은 단순한 기술이 아니야. 이건 '방법론(Methodology)'에 가까워.
웹사이트의 기능을 논리적인 단위로 나누고, 코드 기반으로 관리하며, 버전 관리를 통해 추적하고, 어떤 환경에서든 동일한 결과를 보장하는 체계적인 개발 문화를 만들어주는 도구지.

우리는 오늘 함께:

  • CMI와 Features의 역할 차이를 이해했고,
  • 직접 블로그 기능을 만들어 피처로 패키징했으며,
  • 'Overridden' 같은 상태 변화를 추적하고 'Revert'로 바로잡는 법을 배웠고,
  • Drush를 이용해 전문가처럼 워크플로우를 자동화하는 방법까지 엿봤어.

물론, 현대 드루팔의 설정 관리에는 CMI, Config Split, Config Ignore 등 더 다양한 도구들이 존재해.
Features는 그 거대한 생태계의 한 축을 담당하며, 특히 '기능의 재사용'과 '논리적 패키징'이라는 측면에서 여전히 대체 불가능한 가치를 제공하고 있어.

이제 당신은 더 이상 로컬과 서버의 설정이 달라서 밤새워 삽질하던 과거의 내가 아닐 거야.
변경사항을 자신 있게 커밋하고, 배포 버튼을 두려움 없이 누를 수 있는 '설정의 지배자'로 거듭난 거지.

오늘 배운 내용을 바탕으로, 지금 당장 당신의 작은 사이드 프로젝트부터 Features를 적용해보는 건 어떨까?
작은 성공의 경험이 쌓이면, 거대한 팀 프로젝트에서도 자신감 있게 설정 관리를 주도할 수 있게 될 거야.

Go forth and package!
이제 당신의 손으로 직접, 우아하고 견고한 드루팔 애플리케이션을 만들어나갈 시간이야. 🚀

댓글 작성

이 글에 대한 여러분의 생각을 들려주세요

댓글 0
댓글을 불러오는 중입니다.

아직 댓글이 없습니다.