wan의 개발일기

들어가며 Jira와 GitHub를 연동하면 커밋, PR, 브랜치 정보를 Jira 이슈에서 바로 확인할 수 있다. 코드 변경과 이슈를 연결해서 추적하기 훨씬 편해진다. 연동 방법과 활용법을 정리해둔다. 연동으로 할 수 있는 것 - Jira 이슈에서 연결된 GitHub PR, 커밋, 브랜치 확인- GitHub PR에서 연결된 Jira 이슈 확인- 커밋 메시지에 이슈 키 입력으로 자동 연결- PR merge 시 Jira 이슈 상태 자동 변경 연동 방법 Jira에서 GitHub 앱 설치 Jira 설정 → 앱 → 앱 찾기 → "GitHub for Jira" 검색 → 설치 또는 GitHub Marketplace에서 설치한다. https://github.com/marketplac..

들어가며 보안 관련 설정은 프로젝트 초반에 제대로 잡아두지 않으면 나중에 문제가 생긴다. GitHub에서 제공하는 Secrets 관리와 Dependabot을 정리해둔다. GitHub Secrets Secrets란? API 키, 데이터베이스 비밀번호, 토큰 등 민감한 정보를 저장소 코드에 포함시키지 않고 안전하게 관리하는 기능이다. 절대 하면 안 되는 것:- .env 파일을 저장소에 커밋- 소스코드에 API 키 하드코딩- 커밋 메시지에 비밀번호 포함 Secrets 종류 종류 범위 설정 위치 Repository secrets 특정 저장소..

들어가며 여러 저장소를 관리하는 방식에 대해 제대로 정리한 적이 없었다. Submodule과 Monorepo는 서로 다른 문제를 해결하는 접근법이다. 개념과 사용 시점을 정리해둔다. Git Submodule Submodule이란? 하나의 Git 저장소 안에 다른 Git 저장소를 포함시키는 기능이다. 외부 라이브러리나 공통 모듈을 별도 저장소로 관리하면서 메인 프로젝트에서 참조할 때 유용하다. main-project/├── src/├── .gitmodules└── libs/ └── common-utils/ ← 별도 Git 저장소 Submodule 추가 # 저장소에 submodule 추가git submodule add https://git..

들어가며 Git Hooks는 알고는 있었는데 직접 설정해본 적이 없었다. commit, push 같은 Git 이벤트 전후에 스크립트를 자동으로 실행할 수 있어서 코드 품질 관리에 유용하다. 핵심 훅과 실전 활용법을 정리해둔다. Git Hooks란? Git 이벤트가 발생할 때 자동으로 실행되는 스크립트다. .git/hooks/ 디렉토리에 저장된다. ls .git/hooks/# applypatch-msg.sample# commit-msg.sample# pre-commit.sample# pre-push.sample# prepare-commit-msg.sample# ... .sample 확장자를 제거하면 활성화된다. 주요 훅 종류 ..

들어가며 오픈소스 기여는 어렵게 느껴지는데, 실제로 흐름을 알고 나면 그리 복잡하지 않다. 코드 기여뿐 아니라 문서 수정, 번역, 버그 리포트도 모두 기여다. 전체 흐름을 정리해둔다. 오픈소스 기여 방식 기여 방식은 코드 작성 외에도 다양하다. 방식 예시 버그 리포트 재현 가능한 버그 Issue 등록 문서 수정 오탈자, 오역, 설명 보완 번역 문서 한국어 번역 코드 기여 버그 수정, 기능 추가 코..

들어가며 GitHub Pages는 별도 서버 없이 GitHub 저장소에서 바로 정적 사이트를 호스팅할 수 있는 서비스다. 포트폴리오, 문서 사이트, 블로그 등을 무료로 배포할 수 있다. 배포 방식을 제대로 정리해둔다. GitHub Pages란? GitHub 저장소의 특정 브랜치나 디렉토리를 기준으로 정적 파일을 호스팅하는 서비스다. https://.github.io # 개인 페이지https://.github.io/ # 프로젝트 페이지 무료 플랜에서 공개 저장소는 무제한, 비공개 저장소는 GitHub Pro 이상에서 사용 가능하다. 배포 방식 두 가지 방식 1: 브랜치 직접 배포 특정 브랜치의 루트 또는 /docs 폴더를 그..

들어가며 Issues와 Projects를 단순히 할 일 목록 정도로만 써왔는데, 제대로 활용하면 팀 전체의 작업 흐름을 한눈에 파악할 수 있다. 기능을 제대로 정리해둔다. GitHub Issues Issue란? 버그 리포트, 기능 요청, 작업 단위를 기록하는 공간이다. PR과 연결해서 코드 변경과 작업을 추적할 수 있다. Issue 작성 제목: [bug] 로그인 페이지에서 새로고침 시 토큰 초기화 됨 [feat] 소셜 로그인 구현 [docs] README 업데이트 본문 구성 예시: ## 문제 상황로그인 후 페이지 새로고침 시 토큰이 초기화되어 로그아웃 됨## 재현 방법1. 로그인2. F5 새로고침3. 로그아웃 상태 확인##..

들어가며 GitHub Actions를 이전에 몇 번 써봤는데 yml 파일 구조를 정확히 이해하지 못하고 복붙해서 쓰는 수준이었다. 핵심 개념과 구조를 제대로 정리해둔다. GitHub Actions란? GitHub 저장소에서 특정 이벤트가 발생했을 때 자동으로 워크플로우를 실행하는 CI/CD 플랫폼이다. 별도 서버 없이 GitHub 안에서 빌드, 테스트, 배포를 자동화할 수 있다. 핵심 개념 개념 설명 Workflow 자동화된 프로세스 전체. .github/workflows/*.yml에 정의 Event ..