Drupal에서 코드베이스를 설정하는 것은 매우 쉽습니다! 약간의 인내심만 있으면 됩니다. 이제 자세히 살펴보겠습니다.

이전 단계에서 프로젝트를 설정했습니다. 이제 Git 저장소(repo)를 초기화하고 몇 가지 변경 사항을 추가할 것입니다. 만약 이미 프로젝트를 생성했다면, 버전 관리(Version Control) 섹션으로 넘어가셔도 됩니다. 여기에는 우리가 다음에 무엇을 해야 하는지에 대한 지침이 포함되어 있습니다.

제가 사용한 링크는 다음과 같습니다: Version Control

버전 관리 (Version Control)

mkdir ai_recipe_generator

cd ai_recipe_generator
...

이것들은 우리가 수행할 작업에 대한 명시적인 지침입니다.

이해 없이 복사하는 것은 무의미합니다. 각 단계를 하나씩 차근차근 살펴보겠습니다.

명령어	기능	수행 이유
mkdir ai_recipe_generator	ai_recipe_generator라는 이름의 새 디렉터리를 생성합니다.	프로젝트 파일을 위한 전용 로컬 공간을 할당합니다.
...

이후에 우리는 모듈 개발에 똑같이 중요한 자체 파일 3개를 더 커밋(commit)했습니다.

1 ai_recipe_generator.module.info

2 composer.json

3 .gitignore

참고 자료 (Resources)

1. 모듈 생성 및 .info.yml 문서화 커스텀 모듈 생성 (Main Hub): 이 페이지는 라우팅(routing)부터 커스텀 블록(custom blocks) 생성에 이르기까지 모든 것을 다루는 현대적인 Drupal의 모든 모듈 개발 튜토리얼을 위한 중앙 랜딩 페이지입니다.

.info.yml 파일 정의하기: 이 페이지는 모듈의 메타데이터를 위한 정확한 사양, 필수 속성 및 핵심 버전 요구 사항 구문을 제공합니다.

1. 모듈을 위한 Composer 문서 모듈에 composer.json 파일 추가하기: 이 문서는 Drupal 패키지 유형에 맞게 특별히 조정된 composer init 단계를 포함하여, 커스텀(custom) 또는 기여(contributed) 모듈에 composer.json 파일을 왜, 그리고 어떻게 추가해야 하는지 정확히 설명합니다.

name: AI Recipe Generator
description: Creates recipes using AI.
package: AI
...

{
    "name": "drupal/ai_recipe_generator",
    "description": "Creates recipes using AI.",
...

제가 고군분투하며 실수했던 부분

영상을 보셨다면 제가 git 저장소(repo)를 초기화할 때 실수를 했다는 것을 알 수 있을 것입니다 😅. 포크(fork)와 배포(deployment)를 생성하는 데 매우 중요한 1.0.x 버전을 설정하기 전에 메인 브랜치(main branch)에 커밋을 해버렸습니다. 정말 엉망이었지만, 아주 좋은 학습 기회가 되었습니다.

Git에서 Remote 개념 이해하기

Git Remote

Git의 **Remote (원격 저장소)**를 클라우드 백업 또는 공유 사무실이라고 생각해보세요.

당신이 집의 개인 책상(Local Repository (로컬 저장소))에서 책을 쓰고 있다고 상상해 보세요. 당신은 원하는 대로 페이지를 쓰고, 삭제하고, 정리할 수 있습니다.

하지만 출판사와 공동 저자들은 다른 건물에 있습니다. 그들에게 당신의 작업물을 보여주기 위해서는, 그들의 사무실에 있는 **공유 초안 작성 테이블 (Remote Repository (원격 저장소))**이 필요합니다.

1. "Remote": 이것은 단순히 당신의 컴퓨터 주소록에 있는 북마크 또는 "저장된 연락처"와 같으며, 인터넷상의 해당 공유 테이블이 정확히 어디에 위치해 있는지 Git에게 알려줍니다.

2. Origin: 이것은 해당 공유 테이블에 대한 기본 별명일 뿐입니다. (하지만 backup, publish 등 무엇이든 원하는 이름으로 부를 수 있습니다.)

Remote 관리: 명령어

때때로 코드가 가는 위치를 변경해야 할 때가 있습니다 (예: 다른 포크(fork)나 저장소(repository)에 커밋하는 경우).

1. 현재 remote 확인하기

무엇인가를 변경하기 전에, 현재 프로젝트가 어디와 "통신"하고 있는지 확인하세요.

-v는 "verbose(상세 정보)"를 의미합니다. 이는 fetch (다운로드) 및 push (업로드)를 위한 URL을 보여줍니다.

git remote -v

2. remote의 URL 변경하기

서버 위치가 변경되었지만 동일한 별칭(origin)을 유지하고 싶다면, 다음 명령어를 사용하세요:

git remote set-url origin https://git.drupalcode.org/issue/ai_recipe_generator-3592994.git

사용 시점: 설정 중에 실수로 잘못된 URL을 입력했거나, 프로젝트가 새로운 서버로 이동한 경우에 사용하세요.

3. 두 번째 remote 추가하기

두 개 이상 가질 수도 있습니다! 하나는 개인 백업용으로, 다른 하나는 공개 Drupal 프로젝트용으로 사용할 수 있습니다.

git remote add backup https://git.drupalcode.org/issue/ai_recipe_generator-000001.git

4. remote 이름 변경하기

origin이라는 이름이 마음에 들지 않아 다른 이름으로 부르고 싶다면: (여기서는 drupal_server)

git remote rename origin drupal_server

5. remote 제거하기

특정 서버와의 연결을 끊고 싶다면:

git remote remove backup

전문가 팁 (Pro-Tip): 만약 "Remote origin already exists"라는 에러가 발생한다면, 이는 프로젝트가 이미 서버에 연결되어 있음을 의미합니다. 이 경우 add 대신 set-url을 사용하여 업데이트하세요.

마침내....

잠시 우회한 끝에, 드디어 우리의 초기 코드를 gitlab에 push했습니다! 🎉🎉

최종 코드 Push

팔로우하기: https://www.linkedin.com/in/hrishikeshdalal/

포트폴리오: https://hrishikeshdalal.tech/