Github on Joonlog

GitHub 내의 민감한 정보 제거

Mon, 16 Mar 2026 09:00:00 +0900

공개된 GitHub에 민감한 정보가 올라갔을 경우 히스토리에서 민감 정보 제거하는 방법

git-filter-repo 설치

1
2


curl https://raw.githubusercontent.com/newren/git-filter-repo/main/git-filter-repo -o /usr/local/bin/git-filter-repo
chmod +x /usr/local/bin/git-filter-repo

교체할 문자열 파일 작성

1

echo "삭제할문자열==>대체할문자열" > /tmp/passwords.txt

mirror 리포에서 작업

1
2


git clone --mirror <repo url>
cd <repo>.git

히스토리 재작성

1

git filter-repo --replace-text /tmp/passwords.txt --force

origin 재등록
- git filter-repo는 기본적으로 origin을 제거하기 때문에 재등록
1

git remote add origin <GITHUB URL>
Force 푸시
1

git push --force --mirror origin

주의사항

히스토리를 건드렸기 때문에 모든 커밋 해시가 변경됨
팀 작업 중이면 모든 팀원이 git fetch –all 후 로컬 브랜치 재설정 필요
GitHub에 캐시되었을 때나 PR, Fork에 남아 있을 경우 하기 url을 통해 수정 필요
- https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/removing-sensitive-data-from-a-repository

GitHub SSH 설정

Thu, 22 May 2025 09:00:00 +0900

1. SSH 키 생성

GitHub에서 사용할 SSH 키를 생성
최신 보안 권장사항에 따라 ed25519 알고리즘 사용

1

ssh-keygen -t ed25519 -C "your_email@example.com"

이메일은 GitHub 계정에 등록된 이메일로 입력
생성 시 파일명을 github_ssh.txt와 같이 지정 가능
키는 기본적으로 ~/.ssh 디렉토리에 생성

예시 출력:

1

Enter file in which to save the key (/home/user/.ssh/id_ed25519): github_ssh.txt

2. 공개키 GitHub에 등록

생성된 공개키 확인:
1

cat ~/.ssh/github_ssh.txt.pub
GitHub 접속 → Settings → SSH and GPG keys → New SSH key 클릭
위 명령어로 확인한 공개키 내용을 붙여넣기

3. SSH config 설정

~/.ssh/config 파일을 열어 GitHub 접속 시 사용할 키를 지정

1
2
3
4


echo "Host github.com
 HostName github.com
 User git
 IdentityFile ~/.ssh/github_ssh.txt" >> ~/.ssh/config

여러 Git 계정을 사용할 경우 Host github.com-<계정명> 등으로 이름을 다르게 지정하면 병행 사용도 가능

4. SSH 연결 테스트

1

ssh -T git@github.com

성공 시 아래와 같은 메시지를 출력

1

Hi <GitHub 사용자명>! You've successfully authenticated, but GitHub does not provide shell access.

5. 저장소 클론

SSH를 통해 저장소를 클론 가능

1

git clone git@github.com:joonlog/<내-리포지토리>.git

GitHub Blog(Jekyll Chirpy) SEO 설정

Fri, 25 Apr 2025 09:00:00 +0900

SEO

SEO는 Search Engine Optimization, 즉 검색 엔진 최적화로 구글이나 네이버 같은 검색 엔진에서 내 블로그가 더 잘 노출되도록 하는 작업이다.

블로그를 운영하더라도, 검색에 노출되지 않으면 방문자가 내 블로그 도메인을 직접 입력해야만 접근 가능하다. 사실상 필수 설정.

GitHub Pages + Jekyll 환경 SEO 설정

jekyll-seo-tag 플러그인 설치
- 블로그에 필요한 SEO 메타 태그들을 자동으로 생성해주는 공식 플러그인
- Gemfile에 추가
1

gem 'jekyll-seo-tag'
- _config.yml에 추가
1 2

plugins: - jekyll-seo-tag
jekyll-sitemap 플러그인 설치
- 블로그 글 전체를 포함한 sitemap.xml 파일을 자동을 생성해주는 플러그인
- 구글, 네이버 같은 검색엔진에 내 사이트 구조를 전달하는 목적의 파일
1

gem 'jekyll-sitemap'
1 2

plugins: - jekyll-sitemap
- 배포 후 https://<블로그주소>/sitemap.xml 로 접근 가능하면 성공
Google Search Console 등록
1. Google Search Console 접속
2. URL 접두어 방식 선택 → https://<블로그주소> 입력
1. 생성된 verifications 값 _config.yml에 입력
1 2

webmaster_verifications: google: "<값 입력>"
1. 배포 후 Google Search Console 내 소유권 확인
1. 2번에서 생성된 사이트맵 Google Search Console에 등록
- 등록 후에 즉시 활성화가 되는 것은 아님
  - 하루 정도 대기 필요

참고

SEO: https://standing-o.github.io/posts/jekyll-seo/

GitHub 블로그(Jekyll Chirpy) 오류 TroubleShooting

Sun, 29 Dec 2024 09:00:00 +0900

Jekyll - Chirpy 테마

로컬 테스트 오류

Unable to monitor directories for changes because iNotify max watches exceeded.
Linux의 inotify 파일 시스템 감시자의 최대 수 제한을 초과했기 때문에 발생

1코어 1기가로 실행 중이기 때문에 제한인 것으로 추정
inotify 값 변경해서 해결
1
2
3
cat /proc/sys/fs/inotify/max_user_watches

sudo sysctl fs.inotify.max_user_watches=524288

GitHub Action 의존성 오류

git push 후에 github action에서 발생한 오류

의존성 누락으로 인해 _sass/main.bundle.scss에서 @use ‘vendors/bootstrap’ 참조 불가

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


Error: Can't find stylesheet to import.
 ╷
1 │ @use 'vendors/bootstrap';
 │ ^^^^^^^^^^^^^^^^^^^^^^^^
 ╵
 main.bundle.scss 1:1 @use
 /home/runner/work/joonlog.github.io/joonlog.github.io/assets/css/jekyll-theme-chirpy.scss 1:1 root stylesheet
 Conversion error: Jekyll::Converters::Scss encountered an error while converting 'assets/css/jekyll-theme-chirpy.scss':
 Can't find stylesheet to import.
 ------------------------------------------------
 Jekyll 4.3.4 Please append `--trace` to the `build` command
 for any additional information or backtrace.
 ------------------------------------------------

참고: https://github.com/cotes2020/jekyll-theme-chirpy/discussions/1809

ci 파일에 npm 의존성 주입 추가로 해결 가능
아래 코드를 jekyll.yml의 Build with Jekyll Step 위에 작성

1
2


name: npm build
run: npm install && npm run build

GitHub Action 의존성 오류2

git push 후에 github action에서 발생한 오류

7시간 전까지 정상 동작 했는데 GitHub Action 중 오류

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23


...
npm warn EBADENGINE Unsupported engine {
npm warn EBADENGINE package: '@semantic-release/npm@12.0.1',
npm warn EBADENGINE required: { node: '>=20.8.1' },
npm warn EBADENGINE current: { node: 'v18.20.5', npm: '10.8.2' }
npm warn EBADENGINE }
npm warn EBADENGINE Unsupported engine {
npm warn EBADENGINE package: '@semantic-release/release-notes-generator@14.0.1',
npm warn EBADENGINE required: { node: '>=20.8.1' },
npm warn EBADENGINE current: { node: 'v18.20.5', npm: '10.8.2' }
npm warn EBADENGINE }
...
[js] [!] Error: Cannot find module '/home/runner/work/joonlog.github.io/joonlog.github.io/node_modules/@jridgewell/gen-mapping/dist/gen-mapping.umd.js'
[js] at createEsmNotFoundErr (node:internal/modules/cjs/loader:1177:15)
[js] at finalizeEsmResolution (node:internal/modules/cjs/loader:1165:15)
[js] at resolveExports (node:internal/modules/cjs/loader:590:14)
[js] at Function.Module._findPath (node:internal/modules/cjs/loader:664:31)
[js] at Function.Module._resolveFilename (node:internal/modules/cjs/loader:1126:27)
[js] at Function.Module._load (node:internal/modules/cjs/loader:981:27)
[js] at Module.require (node:internal/modules/cjs/loader:1231:19)
[js] at require (node:internal/modules/helpers:177:18)
[js] at Object.<anonymous> (/home/runner/work/joonlog.github.io/joonlog.github.io/node_modules/@jridgewell/source-map/dist/source-map.cjs:6:18)
[js] at Module._compile (node:internal/modules/cjs/loader:1364:14)

정상 동작 하던 커밋으로 롤백했는데도 같은 에러 발생 ⇒ GitHub 쪽 버전 문제?

warn 발생하는 node 문제인가 싶어 jekyll.yml에 아래 코드 추가해서 node 22이상으로 사용 후 해결됨 - npm 설치 후 빌드 시 node 20 이상이 필요하게 변경된 것으로 추정 ⇒ 버전 지정 안하면 깃허브는 node를 18버전으로 사용

1
2
3
4


 - name: Setup Node.js
 uses: actions/setup-node@v3
 with:
 node-version: '22.x' # Node 22 이상 사용

GitHub 잔디 누락 TroubleShooting

Fri, 27 Dec 2024 09:00:00 +0900

커밋을 해도 깃허브에 잔디가 보이지 않아서 찾아보니 잔디가 심어지는 것에 조건이 있었다.

github 이메일 계정과 로컬의 이메일 정보가 같아야 한다
branch는 main 혹은 gh-pages 둘 중 하나에서 커밋해야 한다
forked repo가 아니어야 한다

내 경우에는 git config에 이메일이 등록되어 있지 않아서 잔디가 심어지지 않았다.

1
2


git config --global --list
git config --global user.email “<email>”

이메일 추가 후 해결

참고

공식문서: https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/why-are-my-contributions-not-showing-up-on-my-profile

GitHub 명령어 정리

Thu, 26 Dec 2024 09:00:00 +0900

깃허브 리포지토리 clone

1

git clone <repo-url>

깃허브 Pull / Push

1
2
3
4


git pull origin main
git add .
git commit -am "commit message"
git push origin main

깃허브 rebase

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# git pull 할 때 rebase 방식을 사용하도록 설정
# 로컬 브랜치의 변경 사항을 원격 브랜치의 끝에 위치
# 기본 설정은 merge
git config pull.rebase true

# 다른 브랜치의 커밋을 main 브랜치로 이동
# 커밋 히스토리를 정리하거나 브랜치를 재구성하는 데 사용
git rebase main

# rebase 작성 취소
git rebase --abort

깃허브 리포지토리 관리

1
2


git remote add origin <repo-url>
git remote set-url origin <repo-url>

깃허브 브랜치 변경

1
2
3


git show-ref
# default branch가 master로 되어있을 경우
git branch -m main

커밋 히스토리

1

git log --online

최근 커밋 취소

1
2
3
4
5


# 코드까지 돌아감
git reset --hard HEAD~2

# 코드는 그대로 두고 커밋만 삭제
git reset --soft HEAD~1

GitHub 블로그 구축 - Jekyll Chirpy

Wed, 25 Dec 2024 09:00:00 +0900

Jekyll Chirpy 테마

https://github.com/cotes2020/jekyll-theme-chirpy

Jekyll Chirpy 사용 이유

기술 블로그용으로 가장 적합
- 다른 Jekyll 테마들은 스타트업 블로그 스타일이나 쇼핑몰에서 사용할 것 같은 많은데, 개인용 기술블로그 테마로는 가장 깔끔하다고 느꼈다
- 카테고리, 타임라인 별로 작성한 글을 볼 수 있고, 블로그 내 검색 기능이 빨라서 좋았다
- 게시글 내에 있는 항목 별 바로가기 기능과, 게시글마다 읽는데 얼마나 걸리는지 나와있는 것도 맘에 들었다

많은 사용자
- 커스터마이징 할 때 오류가 발생해도 사용자가 많으면 고치기가 수월하다
- 특히 한국인 사용자가 많은 테마로 더 편한 면이 있다

Jekyll Chirpy 구조

_config.yml

Jekyll 블로그의 기본 설정 파일
사이트 제목, 설명, URL, 언어, 플러그인 등 전반적인 설정을 정의

_data

언어 설정, 사이드바 구성, 카테고리 또는 태그와 같은 반복적인 데이터 관리에 사용

_includes

재사용이 가능한 header, footer, banner와 같은 HTML을 저장

_layouts

페이지 레이아웃 템플릿을 저장
default.html, post.html 등의 파일이 포함되어 각 페이지의 구조를 정의

_posts

블로그 글을 작성하는 공간
각 파일은 YYYY-MM-DD-title.md 형식으로 저장
Markdown 형식으로 작성하며, YAML front matter로 메타데이터(제목, 날짜, 태그, 카테고리)를 지정

_site

Jekyll 빌드 결과물이 저장되는 디렉터리
사용자가 직접 수정하지 않으며, GitHub Actions 또는 로컬 빌드 시 생성

_tabs

블로그의 탭 네비게이션을 구성
about.md, archive.md와 같은 파일을 포함
탭 메뉴에 표시되는 페이지의 내용과 경로를 정의

assets

정적 파일(css, 이미지, JS 파일 등)을 저장
css/, img/, js/ 등의 하위 디렉터리가 포함

_sass

Sass 파일을 저장
Chirpy 테마의 CSS를 수정하려면 이 디렉터리를 편집

.github

GitHub Actions 설정이 위치
workflows/ 디렉터리에는 Chirpy의 CI/CD 파이프라인 설정이 저장됨

깃허브 블로그 구축 과정

블로그 Repo 생성

저장소 생성
- 깃허브에서 username.github.io Repo 생성
GitHub Pages 활성화
- 저장소 설정 > Pages 섹션에서 브랜치 선택 후 활성화
블로그 업로드
- 작성 후 저장소에 Push → GitHub Pages가 자동으로 GitHub Actions 사용해 배포

Jekyll - Chirpy 테마 적용

Chirpy 복사
- chirpy를 단순 fork하면 이후에 깃허브 잔디 심기가 곤란하니까 clone 후 copy

1
2
3
4


git clone git@github.com:joonlog/joonlog.github.io.git
git clone https://github.com/cotes2020/jekyll-theme-chirpy.git chirpy
cp -r chirpy/* joonlog
cp -r chirpy/.* joonlog

Git 설정

1
2
3
4


cd joonlog

git remote set-url origin git@github.com:joonlog/joonlog.github.io.git
git pull origin main

로컬 테스트(선택)

의존성 설치

1
2
3
4
5
6
7
8
9


sudo dnf install ruby ruby-devel gcc make -y
sudo dnf groupinstall "Development Tools"
sudo gem install bundler

bundle install
npm install

bundle exec jekyll serve
 http://localhost:4000

깃허브 블로그 배포

Git Push

1
2
3


git add .
git commit -am "test"
git push origin main

Repo - 저장소 설정 - 페이지 섹션 - 배포 형식을 GitHub Actions로 변경
- GitHub Actions 말고 기존 껄로 배포하면 index.html만 나타남

- Configure 후 npm 의존성을 “Build with Jekyll” 단계 전에 추가 후에 Commit
```bash
name: npm build
run: npm install && npm run build
```
- ./github/workflows/starter/pages-deploy.yml 삭제
- 삭제 안하면 pages-deploy.yml도 같이 실행되어서 오류 발생

여기까지 하고 브라우저에서 username.github.io로 접속하면 블로그에 테마가 적용된 게 보일 것이다.

글 포스팅

구분	새 페이지 추가	새 게시물 추가
목적	고정 콘텐츠(정적 페이지) 작성	블로그 글(동적 콘텐츠) 작성
위치	프로젝트 루트 또는 서브 디렉토리	`_posts/` 디렉토리
파일명 규칙	자유로운 이름 (`about.md`)	`YYYY-MM-DD-title.md` 형식
URL	`/about`, `/contact` 등	`/year/month/day/title` 형식
목록 표시	목록에 포함되지 않음	블로그 목록에 자동 포함

형식 : yyyy-mm-dd-제목.md
확장자는 .md 또는 .markdown
중간에 공백을 넣지 않음
작성한 파일은 _posts 디렉토리에 위치

Front Matter

사이트의 게시물에 대해 제목 및 레이아웃과 같은 변수와 메타데이터를 설정하기 위해 Markdown 또는 HTML 파일의 맨 위에 YAML 전문을 추가

파일명: YYYY-MM-DD-title.md

1
2
3
4
5
6


---
title : Rocky8 MySQL Replication & HAproxy 연동
date : 2024-12-10 09:00:00 +09:00
categories : [Linux, DB]
tags : [rocky8, mysql, haproxy, replication] #소문자만 가능
---

블로그에 포스팅이 되었는지 확인

참고

공식문서: https://docs.github.com/ko/pages

jekyll chirpy 테마: https://github.com/cotes2020/jekyll-theme-chirpy