Go on Joonlog

Hugo Stack 계층형 카테고리 리팩토링

Mon, 27 Apr 2026 09:00:00 +0900

계층형 카테고리 커스텀 이후 발견한 버그 및 불필요한 코드 정리

이전 포스트에서 구현한 계층형 카테고리 시스템에서 3가지 문제를 발견

포스트 categories frontmatter의 오타로 인해 카테고리가 잘못 생성되고 있었음
generate-categories.go에서 Go의 slugify()와 Hugo의 urlize 동작 불일치로 인한 잠재적 404 위험
테마 사이드바 위젯 오버라이드 파일이 테마 기본값과 완전히 동일한데도 계속 유지되어, 테마 자동 업데이트 내용이 반영 안 되는 문제

1. 포스트 카테고리 오타 수정

frontmatter의 categories 배열에 오타가 있으면 카테고리 페이지가 잘못된 이름으로 생성됨
발견된 오타 5건 수정

파일	변경
`2025-11-04-AnsiblePlaybookDockerInstall`	`"Ansilbe"` → `"Ansible"`
`2025-11-05-AnsiblePlaybookcmdlogrotateopenfilesar`	`"Ansilbe"` → `"Ansible"`
`2026-02-04-MiniPCPromoxInstall`	`"Promox"` → `"Proxmox"`
`2026-02-23-PromoxNetworkVMSettings`	`"Promox"` → `"Proxmox"`
`2025-09-16-troubleshootinghaproxyrestartfault`	`"LoadBalancer"` → `"Load Balancer"`

2. `generate-categories.go` 개선

2.1 ioutil 제거

io/ioutil 패키지는 Go 1.16부터 deprecated
os.ReadFile / os.WriteFile으로 직접 대체

1
2
3
4
5
6
7
8


// 변경 전
import "io/ioutil"
content, err := ioutil.ReadFile(path)
ioutil.WriteFile(path, data, 0644)

// 변경 후
content, err := os.ReadFile(path)
os.WriteFile(path, data, 0644)

2.2 url 필드 추가

문제: Go의 slugify() 결과와 Hugo의 urlize 함수 결과가 불일치하는 경우 발생 가능
- 예: "Load Balancer" → slugify() → "load-balancer" vs Hugo urlize → "load-balancer" (일치하는 경우도 있지만, 특수문자·한글 혼용 시 불일치 가능)
- 레이아웃 템플릿에서 urlize로 생성한 링크와 실제 생성된 페이지 URL이 달라지면 404
해결: 생성되는 _index.md와 .md 파일에 url: 필드를 명시적으로 추가
- Hugo가 url: 필드를 최우선으로 사용하므로 slugify 결과와 완전히 동일해짐

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


// Primary _index.md
primarySlug := slugify(primary)
primaryContent := fmt.Sprintf(`---
title: "%s"
description: "%s 카테고리의 모든 포스트"
primary_category: "%s"
layout: "category-primary"
url: "/categories/%s/"
---
`, primary, primary, primary, primarySlug)

// Secondary .md
secondarySlug := slugify(secondary)
secondaryContent := fmt.Sprintf(`---
title: "%s"
description: "%s > %s 카테고리의 포스트"
primary_category: "%s"
secondary_category: "%s"
layout: "category-secondary"
url: "/categories/%s/%s/"
---
`, secondary, primary, secondary, primary, secondary, primarySlug, secondarySlug)

생성 결과 예시

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


content/categories/linux/_index.md
---
title: "Linux"
url: "/categories/linux/"
...
---

content/categories/linux/load-balancer.md
---
title: "Load Balancer"
url: "/categories/linux/load-balancer/"
...
---

3. 사이드바 위젯 오버라이드 삭제

layouts/partials/widget/categories.html
테마 Stack v3의 기본 위젯 파일을 오버라이드하고 있었음
내용 비교 결과 테마 기본값과 완전히 동일
- 유지할 이유가 없는 상태
매일 실행되는 테마 자동 업데이트 워크플로우가 있는데, 이 파일이 존재하면 테마에서 해당 위젯이 변경되어도 반영이 안 됨
- 불필요한 오버라이드 파일은 삭제하는 것이 테마 독립성 유지에 적합
해당 파일 삭제

Hugo Stack 테마에서 계층형 카테고리 커스텀하기

Wed, 12 Nov 2025 09:00:00 +0900

기존 Hugo Stack 테마에 계층적 카테고리 시스템을 커스텀

개요

기존 카테고리

기존 카테고리는 정확하게 태그와 동일한 역할을 했었음
- Hugo Taxonomy가 자동으로 /categories/linux, /categories/middleware 페이지 생성
  - 각 카테고리를 독립적인 태그처럼 평면적으로면 취급함
  - 각 포스트들에 [”Linux”, “Milldeware”]로 설정이 되어있더라도 Linux, Milldeware 두개의 카테고리가 포스팅에 부여되는 식으로만 동작
이전 사용하던 Jekyll Chirpy 테마처럼 계층적 카테고리를 구현하고 싶었음

커스텀 카테고리

메인 카테고리와 서브 카테고리의 2단계 계층 구조
자동 카테고리 페이지 생성 코드로 /categories/, /categories/메인/, /categories/메인/서브/ 3가지 페이지 생성
- /categories
  - 전체 카테고리 트리 페이지
    - 모든 포스트 스캔 → 메인/서브 카테고리 추출 → 트리 구조로 표시
  - layouts/categories/list.html
- /categories/메인/
  - 메인 카테고리 아래의 서브 카테고리 목록 페이지
    - categories[0] == "메인"인 서브 카테고리들만 표시
  - category-primary.html
- /categories/메인/서브/
  - 메인+서브 카테고리 조건을 만족하는 포스트 목록 페이지
    - categories[0] == "메인" AND categories[1] == "서브”인 포스트만 표시
  - category-secondary.html

1. 카테고리 페이지 자동 생성 스크립트

scripts/generate-categories.go
Hugo 빌드 전에 실행되어야 하는 전처리 스크립트
GitHub Actions에서 go run scripts/generate-categories.go 명령으로 실행

코드 구조 및 역할

1.1 기본 구조체 정의

각 포스트에서 추출한 카테고리 정보를 저장할 구조체

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


package main

import (
 "fmt"
 "os"
 "path/filepath"
 "regexp"
 "strings"
)

type CategoryInfo struct {
 Primary string
 Secondary string
}

1.2 main 함수 - 디렉토리 초기화

content/categories 디렉토리를 매번 새로 생성
- 기존 것 삭제 후 재생성
  - 포스트가 삭제되면 해당 카테고리 페이지도 자동으로 삭제되어야 하기 때문
1 2 3 4 5 6

func main() { contentDir := "content/post" categoriesDir := "content/categories" os.RemoveAll(categoriesDir) os.MkdirAll(categoriesDir, 0755)

1.3 포스트 스캔 및 카테고리 수집

content/post 디렉토리의 모든 마크다운 파일 스캔
각 파일에서 categories: ["메인", "서브"] 형태로 정의된 카테고리 추출

categoryMap 구조: map[메인]map[서브]bool

예: {"Linux": {"Middleware": true, "Shell": true}}

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


 categoryMap := make(map[string]map[string]bool)

 filepath.Walk(contentDir, func(path string, info os.FileInfo, err error) error {
 if err != nil || info.IsDir() || !strings.HasSuffix(path, ".md") {
 return nil
 }

 content, err := os.ReadFile(path)
 if err != nil {
 return nil
 }

 cats := extractCategories(string(content))
 if len(cats) >= 2 {
 primary := cats[0]
 secondary := cats[1]

 if categoryMap[primary] == nil {
 categoryMap[primary] = make(map[string]bool)
 }
 categoryMap[primary][secondary] = true
 }
 return nil
 })

extractCategories 함수

정규식으로 front matter에서 categories: [...] 부분 찾기
쌍따옴표 제거하고 쉼표로 분리

예: ["Linux", "Middleware"] → []string{"Linux", "Middleware"}

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


func extractCategories(content string) []string {
 re := regexp.MustCompile(`categories:\\s*\\[([^\\]]+)\\]`)
 matches := re.FindStringSubmatch(content)
 if len(matches) < 2 {
 return nil
 }

 categoriesStr := matches[1]
 categoriesStr = strings.ReplaceAll(categoriesStr, `"`, "")
 parts := strings.Split(categoriesStr, ",")

 var result []string
 for _, part := range parts {
 trimmed := strings.TrimSpace(part)
 if trimmed != "" {
 result = append(result, trimmed)
 }
 }
 return result
}

1.4 메인 카테고리 페이지 생성

메인 카테고리마다 content/page/categories/메인/_index.md 생성
layout: "category-primary" → Hugo가 layouts/_default/category-primary.html 템플릿 사용하도록 설정

primary_category 파라미터로 필터링에 사용할 카테고리 이름 전달

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


 for primary, secondaries := range categoryMap {
 primaryDir := filepath.Join(categoriesDir, strings.ToLower(primary))
 os.MkdirAll(primaryDir, 0755)

 primaryIndexPath := filepath.Join(primaryDir, "_index.md")
 primaryContent := fmt.Sprintf(`---
title: "%s"
layout: "category-primary"
primary_category: "%s"
---
`, primary, primary)
 os.WriteFile(primaryIndexPath, []byte(primaryContent), 0644)

1.5 서브 카테고리 페이지 생성

서브 카테고리마다 content/page/categories/메인/서브.md 생성
layout: "category-secondary" → layouts/_default/category-secondary.html 사용하도록 설정

두 개의 파라미터로 AND 조건 필터링 가능

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


 for secondary := range secondaries {
 secondaryPath := filepath.Join(primaryDir, strings.ToLower(secondary)+".md")
 secondaryContent := fmt.Sprintf(`---
title: "%s"
layout: "category-secondary"
primary_category: "%s"
secondary_category: "%s"
---
`, secondary, primary, secondary)
 os.WriteFile(secondaryPath, []byte(secondaryContent), 0644)
 }
 }

생성 결과 예시

1
2
3
4
5
6
7
8


content/page/categories/
├── linux/
│ ├── _index.md (primary_category: "Linux")
│ ├── middleware.md (primary: "Linux", secondary: "Middleware")
│ └── shell.md (primary: "Linux", secondary: "Shell")
└── scm/
 ├── _index.md (primary_category: "SCM")
 └── kubernetes.md (primary: "SCM", secondary: "Kubernetes")

2. Categories 페이지 템플릿

layouts/categories/list.html
Hugo의 템플릿 우선순위: layouts/categories/list.html > themes/.../layouts/categories/list.html
/categories/ URL은 Hugo가 자동으로 categories taxonomy 페이지로 인식
이 위치에 파일을 두면 테마의 기본 템플릿을 override

템플릿 구조 및 역할

2.1 계층 구조 빌드

테마의 baseof.html에서 {{ block "main" . }}를 이 내용으로 대체
모든 포스트를 순회하며 계층 구조 빌드
$hierarchy 구조: {"Linux": ["Middleware", "Shell"], "SCM": ["Kubernetes"]}
.Site.RegularPages: Hugo의 모든 일반 페이지
.Params.categories: 각 포스트의 front matter에서 categories 배열
index $cats 0: 배열의 첫 번째 요소 (메인 카테고리)

merge: Go template의 딕셔너리 병합 함수

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


{{ define "main" }}

{{ $hierarchy := dict }}

{{ range .Site.RegularPages }}
 {{ $cats := .Params.categories }}
 {{ if and $cats (ge (len $cats) 2) }}
 {{ $main := index $cats 0 }}
 {{ $sub := index $cats 1 }}

 {{ if not (index $hierarchy $main) }}
 {{ $hierarchy = merge $hierarchy (dict $main (slice)) }}
 {{ end }}

 {{ $subs := index $hierarchy $main }}
 {{ $subs = $subs | append $sub }}
 {{ $hierarchy = merge $hierarchy (dict $main $subs) }}
 {{ end }}
{{ end }}

2.2 메인 카테고리별 포스트 수 계산

uniq: 중복 제거
- 같은 서브 카테고리가 여러 포스트에 있을 수 있음

$totalPosts: 해당 메인 카테고리에 속한 전체 포스트 수 계산

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


{{ range $mainCat, $subCats := $hierarchy }}
 {{ $subCats = uniq $subCats | sort }}

 {{ $totalPosts := 0 }}
 {{ range $.Site.RegularPages }}
 {{ $cats := .Params.categories }}
 {{ if and $cats (ge (len $cats) 1) }}
 {{ if eq (index $cats 0) $mainCat }}
 {{ $totalPosts = add $totalPosts 1 }}
 {{ end }}
 {{ end }}
 {{ end }}

2.3 토글 UI

<details>: 토글
open 속성: 기본적으로 펼쳐진 상태
urlize: URL 안전 문자열로 변환
- “Linux Kernel” → “linux-kernel”

/categories/linux/ → scripts/generate-categories.go가 생성한 _index.md 페이지로 이동

1
2
3
4
5
6
7
8


 <details class="category-group" open>
 <summary class="main-cat">
 <span class="main-cat-title">
 <span class="icon">📁</span>
 <a href="{{ printf "/categories/%s/" ($mainCat | urlize) }}">{{ $mainCat }}</a>
 </span>
 <span class="post-count-badge">{{ $totalPosts }}</span>
 </summary>

2.4 서브 카테고리 목록

각 서브 카테고리의 포스트 개수 계산
AND 조건: categories[0] == mainCat AND categories[1] == subCat

/categories/linux/middleware/ → generate-categories.go가 생성한 middleware.md 페이지로 이동

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


 <div class="sub-cats">
 {{ range $subCat := $subCats }}
 {{ $count := 0 }}
 {{ range $.Site.RegularPages }}
 {{ $cats := .Params.categories }}
 {{ if and $cats (ge (len $cats) 2) }}
 {{ if and (eq (index $cats 0) $mainCat) (eq (index $cats 1) $subCat) }}
 {{ $count = add $count 1 }}
 {{ end }}
 {{ end }}
 {{ end }}

 <a href="{{ printf "/categories/%s/%s/" ($mainCat | urlize) ($subCat | urlize) }}" class="sub-cat-link">
 <span class="sub-cat-name">{{ $subCat }}</span>
 <span class="count">({{ $count }})</span>
 </a>
 {{ end }}
 </div>
 </details>
{{ end }}

2.5 스타일링

인라인 CSS: 이 페이지에만 적용되는 스타일

var(--accent-color): 테마에서 정의한 CSS 변수 사용 (다크 모드 대응)

1
2
3
4
5
6
7
8
9


<style>
.page-header {
 margin-bottom: 2rem;
 padding-bottom: 1rem;
 border-bottom: 2px solid var(--accent-color);
}
/* ... 나머지 CSS ... */
</style>
{{ end }}

3. 메인 카테고리 페이지 템플릿

파일 위치: layouts/_default/category-primary.html
generate-categories.go가 생성한 _index.md에서 layout: "category-primary" 지정
Hugo는 layouts/_default/ 디렉토리에서 커스텀 레이아웃을 찾음
파일명이 category-primary.html이므로 layout: "category-primary"와 매칭

템플릿 구조 및 역할

3.1 포스트 필터링

.Params.primary_category: generate-categories.go가 front matter에 추가한 파라미터
필터링 조건: categories[0] == $primaryCat

$posts: 필터링된 포스트 목록 (slice)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


{{ $primaryCat := .Params.primary_category }}

{{ $posts := slice }}
{{ range .Site.RegularPages }}
 {{ $cats := .Params.categories }}
 {{ if and $cats (ge (len $cats) 1) }}
 {{ if eq (index $cats 0) $primaryCat }}
 {{ $posts = $posts | append . }}
 {{ end }}
 {{ end }}
{{ end }}

3.2 서브 카테고리 추출

필터링된 포스트들에서 서브 카테고리 목록 추출
in: Go template의 배열 포함 여부 확인 함수

알파벳 순으로 정렬

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


{{ $subCategories := slice }}
{{ range $posts }}
 {{ $cats := .Params.categories }}
 {{ if ge (len $cats) 2 }}
 {{ $sub := index $cats 1 }}
 {{ if not (in $subCategories $sub) }}
 {{ $subCategories = $subCategories | append $sub }}
 {{ end }}
 {{ end }}
{{ end }}
{{ $subCategories = $subCategories | uniq | sort }}

3.3 서브 카테고리별 그룹핑

서브 카테고리별로 그룹핑하여 표시

각 그룹의 포스트 개수 배지로 표시

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


{{ range $subCat := $subCategories }}
 {{ $postCount := 0 }}
 {{ range $posts }}
 {{ $cats := .Params.categories }}
 {{ if and (ge (len $cats) 2) (eq (index $cats 1) $subCat) }}
 {{ $postCount = add $postCount 1 }}
 {{ end }}
 {{ end }}

 <details class="sub-category-group" open>
 <summary class="sub-category-title">
 <span class="title-text">{{ $subCat }}</span>
 <span class="post-count-badge">{{ $postCount }}</span>
 </summary>

3.4 포스트 목록 렌더링

각 서브 카테고리 내의 포스트 목록 표시
.RelPermalink: 포스트의 상대 URL
first 3: 태그가 많을 경우 처음 3개만 표시

{{ with }}: 값이 존재할 때만 실행

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


 <div class="post-list">
 {{ range $posts }}
 {{ $cats := .Params.categories }}
 {{ if and (ge (len $cats) 2) (eq (index $cats 1) $subCat) }}
 <article class="post-item">
 <a href="{{ .RelPermalink }}" class="post-link">
 <h3 class="post-title">{{ .Title }}</h3>
 <div class="post-meta">
 <time>{{ .Date.Format "2006-01-02" }}</time>
 {{ with .Params.tags }}
 <span class="tags">
 {{ range first 3 . }}
 <span class="tag">{{ . }}</span>
 {{ end }}
 </span>
 {{ end }}
 </div>
 </a>
 </article>
 {{ end }}
 {{ end }}
 </div>
 </details>
{{ end }}

4. 서브 카테고리 페이지 템플릿

layouts/_default/category-secondary.html
generate-categories.go가 생성한 middleware.md에서 layout: "category-secondary" 지정
layouts/_default/category-secondary.html과 매칭

템플릿 구조 및 역할

Breadcrumb 네비게이션: Linux › Middleware

메인 카테고리 클릭 시 메인 카테고리 페이지로 이동

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


<header class="page-header">
 <div class="breadcrumb">
 <a href="{{ printf "/categories/%s/" (.Params.primary_category | urlize) }}">
 {{ .Params.primary_category }}
 </a>
 <span class="separator">›</span>
 <span class="current">{{ .Title }}</span>
 </div>
 <h1>{{ .Title }}</h1>
</header>

4.2 AND 조건 필터링

AND 조건 필터링: categories[0] == primary AND categories[1] == secondary

두 파라미터 모두 generate-categories.go가 front matter에 추가

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


{{ $primaryCat := .Params.primary_category }}
{{ $secondaryCat := .Params.secondary_category }}

{{ $posts := slice }}
{{ range .Site.RegularPages }}
 {{ $cats := .Params.categories }}
 {{ if and $cats (ge (len $cats) 2) }}
 {{ if and (eq (index $cats 0) $primaryCat) (eq (index $cats 1) $secondaryCat) }}
 {{ $posts = $posts | append . }}
 {{ end }}
 {{ end }}
{{ end }}

4.3 포스트 목록

필터링된 포스트 목록만 표시

서브 카테고리 그룹핑 없이 플랫한 리스트

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


<div class="post-count">
 총 {{ len $posts }}개의 포스트
</div>

<section class="category-posts">
 <div class="post-list">
 {{ range $posts }}
 <article class="post-item">
 <a href="{{ .RelPermalink }}" class="post-link">
 <h3 class="post-title">{{ .Title }}</h3>
 <div class="post-meta">
 <time>{{ .Date.Format "2006-01-02" }}</time>
 {{ with .Params.tags }}
 <span class="tags">
 {{ range first 3 . }}
 <span class="tag">{{ . }}</span>
 {{ end }}
 </span>
 {{ end }}
 </div>
 </a>
 </article>
 {{ end }}
 </div>
</section>

5. GitHub Actions 워크플로우 수정

.github/workflows/deploy.yml
추가한 부분
1. generate-categories.go 실행 → content/page/categories/ 디렉토리 생성
2. Hugo 빌드 → 생성된 카테고리 페이지들을 포함하여 정적 사이트 생성
1 2 3 4 5

- name: Generate category pages run: go run scripts/generate-categories.go - name: Build run: hugo --minify --gc

6. 메뉴 설정

config/_default/menu.toml
- identifier: Hugo가 이 메뉴 항목을 식별하는 고유 ID
- name: 사용자에게 표시될 메뉴 이름
- url: 클릭 시 이동할 경로
- weight: 메뉴 정렬 순서 (낮을수록 위에 표시)
- icon: 테마의 assets/icons/categories.svg 아이콘 사용
1 2 3 4 5 6 7

[[main]] identifier = "categories" name = "Categories" url = "/categories/" weight = 2 [main.params] icon = "categories"

Archives weight 조정

content/page/archives/index.md

1
2
3


menu:
 main:
 weight: 3 # 기존 2에서 3으로 변경

구현 화면

메뉴
/categories 페이지
/categories/메인 페이지
/categories/메인/서브 페이지

Jekyll Chirpy 테마에서 Hugo Stack 테마로 블로그 이관하기

Tue, 11 Nov 2025 09:00:00 +0900

Jekyll Chirpy 테마로 포스팅했던 글들을 Hugo Stack으로 이관

자세한 Hugo Stack 구축 과정은 이 글 참고

Jekyll Chirpy에서 Hugo Stack으로 이관한 이유

Jekyll은 Liquid를 사용해서, 포스팅에 {%, {{ 같은 글자가 있으면 Liquid 템플릿 엔진이 이걸 Liquid 글로 인식을 해서 저 문자 자체로 사용하려면 {% raw %} 태그로 감싸야 했음
Jekyll은 Ruby 언어를 베이스로 짜여져 있고, 계층적 카테고리 구성과 같이 블로그를 커스터마이징할 일이 종종 있는데, 코드를 수정하기에는 Ruby에 대해 아는 바가 없음
최근에 Go를 배우기 시작한 상황에서 Go를 베이스로 한 Hugo로 블로그를 구성하면 좋겠다 싶었음
현재 Jekyll보다 Hugo가 더 점유율이 높고, 업데이트가 자주 있음
직접 구성해보니 구조 자체도 Hugo가 훨씬 간단
빌드부터 배포까지 Hugo가 더 빠름
기존 Chirpy 테마와 비슷하면서 사용자가 많은 테마인 Stack을 선택

블로그 이관 과정

기존 Jekyll 소스코드 별도 브랜치로 백업
- Jekyll 브랜치 생성 후 백업
Hugo Stack Starter로 뼈대만 있는 블로그 배포
기존 블로그 글 이관
- 107개의 블로그 글 이관
- 전체 이관 전에 글 1개로 테스트

이관 시 포스팅 글 변경점

Front Matter

날짜 형식

첫 공백을 T로 변경하고, timezone 앞 공백 제거

1
2
3
4
5


# Jekyll
date: 2024-12-09 18:08:00 +09:00

# Hugo
date: 2024-12-09T18:08:00+09:00

Categories/Tags 배열 따옴표 추가

1
2
3
4
5
6
7


# Jekyll
categories: [Linux, Middleware]
tags: [rocky8, apache, tomcat]

# Hugo
categories: ["Linux", "Middleware"]
tags: ["rocky8", "apache", "tomcat"]

폴더 구조

각 포스팅마다 <포스팅 이름>.md가 아닌, <포스팅 이름> 폴더를 만들고 그 아래 index.md가 있는 구조

1
2
3
4
5
6
7
8


# Jekyll
_posts/2024-12-09-Rocky8ApacheTomcat.md

# Hugo
content/post/2024-12-09-rocky8apachetomcat/
 ├── index.md
 ├── Rocky8ApacheTomcat1.png
 └── Rocky8ApacheTomcat2.png

이미지 경로 변경
- Jekyll에서는 assests/img 경로에 모든 사진을 넣었지만, Hugo에서는 각 포스팅 폴더 안에 각각의 이미지를 넣음
1 2 3 4 5

# Jekyll /img/linux/Rocky8ApacheTomcat1.png # Hugo Rocky8ApacheTomcat1.png

이후 예정 작업

Hugo Theme에는 계층적 카테고리를 지원하는 테마가 없다
이 기능을 사용하기 위해선 별도 커스텀 필요

Hugo 템플릿 Stack 테마로 GitHub Blog 배포하기

Tue, 04 Nov 2025 09:00:00 +0900

GitHub Pages로 Hugo 템플릿의 Stack Theme를 사용해서 깃허브 블로그를 구축

별도의 컨텐츠 설정 없이 배포까지 정상적인지 확인

Hugo Stack 구조

config
- Hugo Stack 설정 폴더
  - 사이트 url, 언어, 페이지네이션, footer/sidebar 파라미터, 메뉴, 모듈 등을 설정
content
- 포스팅 글, 아카이브, 검색, 링크, 카테고리 등의 페이지가 존재
static
- 정적 파일들이 있는 폴더
assets
- 빌드에 포함할 커스텀 css, 이미지를 넣는 폴더
.github
- GitHub Action 배포에 사용할 deploy.yml이 있는 폴더
go.mod
- go 모듈

Hugo Stack 구축

깃허브 소스 클론

1

git clone https://github.com/CaiJimmy/hugo-theme-stack-starter.git

config 수정

config/_default/config.toml

1
2
3
4
5


baseurl = "https://joonlog.github.io"
languageCode = "ko-kr"
title = "Joonlog"
defaultContentLanguage = "ko"
hasCJKLanguage = true

footer, sidebar 수정

config/_default/params.toml

1
2
3


since = 2024
emoji = "🐕"
subtitle = "인프라/개발 기술 블로그"

배포 설정

배포 설정 수정
- master 브랜치에 푸시될때 자동 배포하는 설정을 main 브랜치로 수정
- .github/workflows/deploy.yml
  1 2 3 4 5
  
  on: push: branches: [main] pull_request: branches: [main]
배포 방식 변경
- starter 리포에 있는 기존 deploy.yml은 gh-pages 방식
- 배포 과정:
  1. main 브랜치로 코드 푸시
  2. 빌드
  3. 빌드한 결과물을 gh-pages 브랜치에 푸시
  4. GitHub Pages가 gh-pages 브랜치에서 블로그 서빙
    - 2개의 브랜치에 거렻서 배포되기 때문에 느림
- GitHub Actions Artifact 방식으로 변경
- 배포 과정
  1. main 브랜치로 코드 푸시
  2. 빌드
  3. 빌드한 결과물을 artifact에 업로드
  4. GitHub Pages가 artifact에서 직접 서빙
    - GitHub Pages를 사용할 때의 최신 배포 방식
    - gh-pages 브랜치 관리 불필요
    - 빠름
- .github/workflows/deploy.yml
  - gh-pages 브랜치에 푸시할 필요가 없어져서 contentes 권한을 write로 유지할 필요가 없어짐
  - GitHub Pages에 직접 배포하기 위한 pages:write 권한
  - OIDC 보안을 위한 id-token:write
    1 2 3 4
    
    permissions: contents: read pages: write id-token: write
  - 기존 코드는 gh-pages 브랜치에 푸시하는 코드
  - 대신 artifact에 푸시 + 푸시한 artifact를 GitHub Pages로 배포
    1 2 3 4 5 6 7 8
    
    - name: Upload artifact uses: actions/upload-pages-artifact@v3 with: path: ./public - name: Deploy to GitHub Pages id: deployment uses: actions/deploy-pages@v4

GitHub Pages 설정

Repository 생성
- GitHub에서 <username>.github.io Repository 생성
  - 깃허브 블로그로 사용하기 위해선 반드시 위 이름으로 Repository 생성 필요
GitHub Pages 활성화
- Settings - Pages - Build and deployment
  - GitHub Actions 선택

배포 확인

소스 푸시

1
2
3


git add .
git commit -m "First Push"
git push

배포 성공!

참고

Hugo Stack GitHub: https://github.com/CaiJimmy/hugo-theme-stack
Hugo Stack Starter GitHub: https://github.com/CaiJimmy/hugo-theme-stack-starter
Hugo Theme: https://themes.gohugo.io/

Teleport 18 이미지 빌드 및 배포

Thu, 09 Oct 2025 09:00:00 +0900

Teleport 18 이미지 빌드

도커 이미지 빌드

Dockerfile
- 빌드한 바이너리 파일의 teleport/tctl/tsh/tbot을 복사해서 이미지 빌드

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


FROM ubuntu:20.04

RUN apt-get update && apt-get install -y \
 ca-certificates dumb-init libfido2-1 && \
 apt-get clean && rm -rf /var/lib/apt/lists/*

COPY build/teleport /usr/local/bin/teleport
COPY build/tctl /usr/local/bin/tctl
COPY build/tsh /usr/local/bin/tsh
COPY build/tbot /usr/local/bin/tbot

ENTRYPOINT ["/usr/bin/dumb-init", "teleport", "start", "-c", "/etc/teleport/teleport.yaml"]

이미지 빌드 및 도커허브 푸시

1
2
3
4


docker build -t teleport18-custom .
docker login -u <username>
docker tag teleport18-custom <username>/teleport18:v1.0.0
docker push <username>/teleport18:v1.0.0

Teleport 18 배포

Auth+Proxy 분리 구축

디렉토리 구조

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# tree
.
├── auth
│ ├── config
│ │ └── teleport.yaml
│ └── data
├── docker-compose.yaml
└── proxy
 ├── config
 │ └── teleport.yaml
 └── data

1. docker-compose.yaml

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50


version: '3.8'

services:
 auth:
 image: <username>/teleport18:v1.0.0
 container_name: teleport-auth
 hostname: teleport-auth
 restart: unless-stopped
 volumes:
 - ./auth/config:/etc/teleport
 - ./auth/data:/var/lib/teleport
 entrypoint: ["/usr/local/bin/teleport"]
 command: ["start", "--config=/etc/teleport/teleport.yaml"]
 expose:
 - "3025"
 networks:
 - teleport-net

 proxy:
 image: <username>/teleport18:v1.0.0
 container_name: teleport-proxy
 hostname: teleport-proxy
 restart: unless-stopped
 ports:
 - "3080:3080" # Web UI & public HTTPS
 - "3023:3023" # Proxy SSH
 - "3024:3024" # Reverse tunnel
 - "3026:3026" # Kube reverse tunnel
 volumes:
 - ./proxy/config:/etc/teleport
 - ./proxy/data:/var/lib/teleport
 - /etc/letsencrypt:/etc/letsencrypt:ro
 environment:
 - TELEPORT_CDN_BASE_URL=https://cdn.cloud.gravitational.io
 entrypoint: ["/usr/local/bin/teleport"]
 command: [
 "start",
 "--config=/etc/teleport/teleport.yaml",
 "--roles=proxy",
 "--token=teleportclustertoken",
 "--auth-server=teleport-auth:3025"
 ]
 networks:
 - teleport-net
 depends_on:
 - auth

networks:
 teleport-net:
 driver: bridge

2. auth/teleport.yaml

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


teleport:
 nodename: teleport-auth
 data_dir: /var/lib/teleport
 log:
 output: stderr
 severity: INFO

auth_service:
 enabled: yes
 cluster_name: cluster
 listen_addr: 0.0.0.0:3025
 tokens:
 - "proxy:teleportclustertoken"

proxy_service:
 enabled: no

ssh_service:
 enabled: no

3. proxy/teleport.yaml

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


teleport:
 nodename: teleport-proxy
 data_dir: /var/lib/teleport
 log:
 output: stderr
 severity: INFO

 auth_servers:
 - teleport-auth:3025

auth_service:
 enabled: no

proxy_service:
 enabled: yes
 web_listen_addr: 0.0.0.0:3080
 tunnel_listen_addr: 0.0.0.0:3024
 kube_listen_addr: 0.0.0.0:3026
 public_addr: <도메인>:3080
 https_keypairs:
 - cert_file: /etc/letsencrypt/live/<도메인>/fullchain.pem
 key_file: /etc/letsencrypt/live/<도메인>/privkey.pem

ssh_service:
 enabled: no

Teleport 18버전 도커 환경에서의 소스 빌드 오류 TroubleShooting

Wed, 08 Oct 2025 09:00:00 +0900

Teleport 18을 도커 환경에서 빌드하는 과정에서 발생한 오류 정리

1. `UID 0 is not unique` 오류

1
2
3
4
5
6
7


wget https://github.com/gravitational/teleport/archive/refs/tags/v18.0.0.tar.gz
mkdir teleport && tar -xzf v18.0.0.tar.gz -C teleport --strip-components=1
cd teleport
rm -rf .github/dependabot.yml
rm -rf e

make -C build.assets build-binaries

에러

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


 => CANCELED [git2 1/2] RUN yum-builddep -y git 3.8s
 => ERROR [buildbox 1/27] RUN (groupadd ci --gid=0 -o && useradd ci --uid=0 --gi 3.7s
------
 > [buildbox 1/27] RUN (groupadd ci --gid=0 -o && useradd ci --uid=0 --gid=0 --create-home --shell=/bin/sh && mkdir -p -m0700 /var/lib/teleport && chown -R ci /var/lib/teleport):
3.000 useradd: UID 0 is not unique
------
Dockerfile-centos7:218
--------------------
 217 | ARG GID
 218 | >>> RUN (groupadd ci --gid=$GID -o && useradd ci --uid=$UID --gid=$GID --create-home --shell=/bin/sh && \
 219 | >>> mkdir -p -m0700 /var/lib/teleport && chown -R ci /var/lib/teleport)
 220 |
--------------------
ERROR: failed to solve: process "/bin/sh -c (groupadd ci --gid=$GID -o && useradd ci --uid=$UID --gid=$GID --create-home --shell=/bin/sh && mkdir -p -m0700 /var/lib/teleport && chown -R ci /var/lib/teleport)" did not complete successfully: exit code: 4
exit status 1
make: *** [Makefile:213: buildbox-centos7] Error 1
make: Leaving directory '/data/teleport/build.assets'

root사용자로 작업하던 상황에서 Dockerfile 내 ARG UID 코드로 인해 uid, gid가 0으로 설정됨
- 소스 코드 디렉토리 권한 부여 + UID, GID 지정해서 다시실행
1 2

chown -R 1000:1000 ./* nohup make -C build.assets build-binaries UID=1000 GID=1000 > build.log 2>&1 &

2. CentOS7 환경 빌드 실패

make -C build.assets build-binaries 실행 시 centos7에서 실행 ⇒ 버전이 낮아서 빌드 실패

nohup make -C build.assets release-ng > build.log 2>&1
release-ng를 사용한 make가 권장되지면 teleport-buildbox-thirtparty가 18버전 이미지가 없어서 에러 발생
- https://github.com/gravitational/teleport/pkgs/container/teleport-buildbox-thirdparty
1

failed to pull teleport-buildbox-thirdparty:teleport18

로컬에서 thirdparty 이미지 빌드 필요

이미지 빌드에 1시간 이상 걸리니 주의

1
2
3
4


docker buildx build --platform=linux/amd64 --load --tag test-thirdparty:manual -f build.assets/buildbox/Dockerfile-thirdparty build.assets/buildbox

docker tag test-thirdparty:manual <username>/teleport-buildbox-thirdparty:teleport18
docker push <username>/teleport-buildbox-thirdparty:teleport18

thirdparty 이미지 빌드 후에는 아래 명령어로 바이너리 빌드

1

nohup make -C build.assets release-ng UID=1000 GID=1000 BUILDBOX_THIRDPARTY=<username>/teleport-buildbox-thirdparty:teleport18 > build.log 2>&1 &

3. `error obtaining VCS status: exit status 128` 에러

컨테이너 내부에 .git 디렉토리가 있을 경우 go build가 VCS 정보를 가져오다 실패

https://www.linkedin.com/pulse/addressing-error-obtaining-vcs-status-issue-leo-liu-rhuye/

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


error obtaining VCS status: exit status 128
 Use -buildvcs=false to disable VCS stamping.
make[2]: *** [Makefile:388: build/teleport] Error 1
make[2]: Leaving directory '/home/teleport'
make[1]: *** [Makefile:354: all] Error 2
make[1]: Leaving directory '/home/teleport'
make: *** [Makefile:507: full] Error 2
exit status 2
make[1]: *** [Makefile:624: release-ng] Error 2
make[1]: Leaving directory '/data/teleport/build.assets'

루트 Makefile 상단에 GOFLAGS ?= -buildvcs=false 를 통해 비활성화

4. 정상 동작

1

nohup make -C build.assets release-ng UID=1000 GID=1000 BUILDBOX_THIRDPARTY=<username>/teleport-buildbox-thirdparty:teleport18 > build.log 2>&1 &

빌드 완료

Teleport 18버전 로컬 소스 빌드 오류 TroubleShooting

Tue, 07 Oct 2025 09:00:00 +0900

Teleport 18버전을 소스 빌드하면서 겪은 의존성 관련 문제를 정리 Node, Rust, Corepack 등의 버전이 중요

1. `Corepack is not installed` 오류

소스 코드 다운로드 후 make

1
2
3
4
5
6
7


wget https://github.com/gravitational/teleport/archive/refs/tags/v18.0.0.tar.gz
mkdir teleport && tar -xzf v18.0.0.tar.gz -C teleport --strip-components=1
cd teleport
rm -rf .github/dependabot.yml
rm -rf e

make full

make full 시 오류 발생

1
2
3
4
5
6


Error: Corepack is not installed, cannot enable pnpm. See the installation guide https://pnpm.io/installation#using-corepack
make[2]: *** [Makefile:1779: ensure-js-package-manager] Error 1
make[2]: Leaving directory '/root/teleport'
make[1]: *** [Makefile:1803: ensure-js-deps] Error 2
make[1]: Leaving directory '/root/teleport'
make: *** [Makefile:1762: ensure-webassets] Error 2

Teleport 웹 UI는 React 기반
- pnpm 패키지 매니저를 Corepack으로 관리

build.assets/versions.mk에 로컬 설치 시 필요 버전 명시되어 있음

1
2
3
4


GOLANG_VERSION ?= go1.24.4
NODE_VERSION ?= 22.14.0
RUST_VERSION ?= 1.81.0
WASM_PACK_VERSION ?= 0.12.1

nodejs 22에선 아래 명령어로 해결

1
2


corepack enable
corepack prepare pnpm@10.12.4 --activate

2. Rust + wasm-pack 버전 에러

Rust 1.72 미만 또는 wasm-pack 설치 누락 시 오류 발생

1
2
3
4
5
6
7


 ERR_PNPM_RECURSIVE_RUN_FIRST_FAIL  @gravitational/shared@1.0.0 build-wasm: `node ../../scripts/clean-up-ironrdp-artifacts.mjs && RUST_MIN_STACK=16777216 wasm-pack build ./libs/ironrdp --target web`
Exit status 1
 ELIFECYCLE  Command failed with exit code 1.
/root/teleport/web/packages/teleport:
 ERR_PNPM_RECURSIVE_RUN_FIRST_FAIL  @gravitational/teleport@1.0.0 build: `pnpm build-wasm && vite build`
Exit status 1
 ELIFECYCLE  Command failed with exit code 1.

wasm-pack 설치 후에도 wasm-opt 버전이 낮으면 빌드 실패

wasm-opt 123 버전 필요

1
2
3


curl -LO https://github.com/WebAssembly/binaryen/releases/download/version_123/binaryen-version_123-x86_64-linux.tar.gz
tar -xzf binaryen-version_123-x86_64-linux.tar.gz
mv binaryen-version_123/bin/* /usr/local/bin/

이후 캐시된 wasm-pack 바이너리 덮어쓰기

1
2
3
4


mv ~/.cache/.wasm-pack/wasm-opt-*/bin/wasm-opt \
 ~/.cache/.wasm-pack/wasm-opt-*/bin/wasm-opt.bak
mv /usr/local/bin/wasm-opt ~/.cache/.wasm-pack/wasm-opt-*/bin/wasm-opt
chmod +x ~/.cache/.wasm-pack/wasm-opt-*/bin/wasm-opt

3. libfido2 관련 경고

libfido2-devel 패키지 미설치 오류

Teleport의 MFA 기능을 포함하려면 설치 필요

1
2
3
4
5


Warning: Building tctl without libfido2. Install libfido2 to have access to MFA.
GOOS=linux GOARCH=amd64 CGO_ENABLED=1 go build -tags " kustomize_disable_go_plugin_support" -o build/tctl -ldflags '-w -s -X k8s.io/component-base/version.gitVersion=v1.33.2' -trimpath -buildmode=pie ./tool/tctl
Warning: Building tsh without libfido2. Install libfido2 to have access to MFA.
GOOS=linux GOARCH=amd64 CGO_ENABLED=1 go build -tags " kustomize_disable_go_plugin_support" -o build/tsh -ldflags '-w -s -X k8s.io/component-base/version.gitVersion=v1.33.2' -trimpath -buildmode=pie ./tool/tsh
GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -tags " kustomize_disable_go_plugin_support" -o build/tbot -ldflags '-w -s -X k8s.io/component-base/version.gitVersion=v1.33.2' -trimpath ./tool/tbot

libfido2-devel 패키지 설치

1

yum install libfido2-devel -y

4. 디렉토리 여유 공간 확보

Teleport 빌드 시 go cache, cargo, rustup, node_modules 등의 캐시 파일들이 쌓이며 최소 10GB 이상의 여유 공간 필요

Teleport 18 소스 빌드 환경 설정

Mon, 06 Oct 2025 09:00:00 +0900

로컬 소스 빌드

Teleport 18 소스 코드를 로컬에서 빌드하기 위한 환경 세팅

https://github.com/gravitational/teleport

1. 기본 패키지 설치

1

dnf groupinstall -y "Development Tools"

2. Node.js 22.14.0

1
2
3
4


curl -fsSL https://rpm.nodesource.com/setup_22.x | bash -
dnf install -y nodejs

node -v

3. Corepack ≥ 0.31 및 pnpm ≥ 10.11.0

1
2
3
4


corepack enable
corepack prepare pnpm@10.12.4 --activate

corepack -v

4. Python 3.8

1
2
3
4
5


dnf install -y python38
ln -s /usr/bin/python3.8 /usr/bin/python
export PYTHON=$(which python3.8)

python --version

5. Rust ≥ 1.72 및 wasm-pack 0.12.1

1
2
3
4
5


curl https://sh.rustup.rs -sSf | sh -s -- -y
source $HOME/.cargo/env
cargo install wasm-pack --locked --version 0.12.1

rustc --version

6. (선택) wasm-opt 123 (Binaryen)

wasm-opt로 인한 빌드 오류 발생 시 최신 버전으로 교체
- 111 버전은 오류 발생

1
2
3
4
5
6
7


cd /usr/local/bin
curl -LO https://github.com/WebAssembly/binaryen/releases/download/version_123/binaryen-version_123-x86_64-linux.tar.gz
tar -xzf binaryen-version_123-x86_64-linux.tar.gz
mv binaryen-version_123/bin/* /usr/local/bin/
rm -rf binaryen-version_123*

wasm-opt --version

7. libfido2-devel

1

dnf install -y libfido2-devel

8. Teleport 소스코드 다운로드 및 빌드

1
2
3
4
5
6


wget https://github.com/gravitational/teleport/archive/refs/tags/v18.0.0.tar.gz
mkdir teleport && tar -xzf v18.0.0.tar.gz -C teleport --strip-components=1
cd teleport

make clean
make full

도커 소스 빌드

Teleport 18 소스 빌드를 도커 환경에서 하기 위한 방법

1. 소스코드 Pull

1
2
3
4
5
6


wget https://github.com/gravitational/teleport/archive/refs/tags/v18.0.0.tar.gz
mkdir teleport && tar -xzf v18.0.0.tar.gz -C teleport --strip-components=1
cd teleport
rm -rf .github/dependabot.yml
rm -rf e
chown -R pjt:pjt ./*

2. go VCS 오류 해결

./Makefile 최상단에 하기 설정 추가 필요

1

GOFLAGS ?= -buildvcs=false

3. 도커 make

teleport-buildbox-thirdparty:teleport18 이미지 제작

https://github.com/gravitational/teleport/pkgs/container/teleport-buildbox-thirdparty 경로에 18버전 이미지가 없어서 에러
로컬에서 이미지 빌드 필요
- 이미지 빌드에 1시간 이상 걸리니 주의

1
2
3
4


docker buildx build --platform=linux/amd64 --load --tag test-thirdparty:manual -f build.assets/buildbox/Dockerfile-thirdparty build.assets/buildbox

docker tag test-thirdparty:manual ksi05298/teleport-buildbox-thirdparty:teleport18
docker push ksi05298/teleport-buildbox-thirdparty:teleport18

ksi05298/teleport-buildbox-thirdparty:teleport18

1

nohup make -C build.assets release-ng BUILDBOX_THIRDPARTY=ksi05298/teleport-buildbox-thirdparty:teleport18 GOFLAGS="-buildvcs=false" > build.log 2>&1 &

Go 언어에서의 Protocal Buffers

Sun, 20 Jul 2025 09:00:00 +0900

언어 중립적, 플랫폼 중립적, 확장 가능한 데이터 직렬화(serialization) 포맷
- gRPC의 기본 포맷
구조화된 데이터를 효율적으로 저장하고 전송하기 위한 방식
데이터 타입이 명확히 정의되어 있음 (int32, string 등)
.proto 파일에서 데이터 구조를 정의하고, protoc 컴파일러로 각 언어로 변환해 사용
- protoc --go_out=. person.proto

JSON vs protobuf

json보다 훨씬 적은 용량으로 전송 가능(binary 포맷)

1

{ "name": "Alice", "age": 30 }

1
2
3
4
5


message Person {
 string name = 1;
 int32 age = 2;
 string email = 3;
}

필드 번호 기반으로 동작해서, 일부 필드가 빠져도 괜찮음 (optional처럼 동작)
- 위에처럼 protobuf가 정의되어 있을 때 1, 2, 3이 각 필드의 번호
- 아래처럼 데이터를 보낼 때, 필드 3이 없어도 동작
  - 이런 동작 방식 덕분에 새 필드를 추가해도 이전 클라이언트는 무시하고 정상 작동
1 2 3 4 5

Person { name: "Alice" age: 30 // email은 없음 }

Go에서의 protobuf

protobuf를 Go 코드로 변환할 때의 추가 설정 옵션

1

string InitScript = 16 [(gogoproto.jsontag) = "init_script,omitempty"];

gogoproto: gogo/protobuf라는 성능 최적화된 Protobuf 구현체에서 제공하는 옵션
jsontag: 필드가 Go 구조체로 변환될 때, JSON 직렬화 시 사용될 struct tag를 직접 지정하는 설정입니다.

Go 코딩 규칙(Idiomatic Go)

Tue, 17 Jun 2025 09:00:00 +0900

변수 및 함수 이름

camelCase 사용
축약어는 중간이나 끝에 (예: userID, httpServer)
간결하고 의미 있는 이름 권장 (err, ok, i, r 등)

1
2


var userID int
func getUserInfo() {}

타입 및 인터페이스

타입 이름은 PascalCase
인터페이스는 동작 기반 이름 사용 (Reader, Closer 등)

1
2
3
4
5
6
7


type FileReader interface {
 Read(p []byte) (n int, err error)
}

type User struct {
 Name string
}

에러 처리

if err != nil 패턴이 기본
에러 발생 즉시 처리하고 빠르게 반환
에러 메시지는 소문자로 시작하고 마침표는 생략

1
2
3
4


f, err := os.Open("file.txt")
if err != nil {
 return err
}

패키지 이름 규칙

항상 소문자
단수형
의미는 명확하되 짧게 (strings, math, http 등)
밑줄(_), 복수형, 접두사 등은 지양

주석 스타일

공개 함수나 타입에는 주석 필수
함수명으로 시작하는 문장형 주석 사용

1
2
3
4
5
6
7


// Add는 두 숫자의 합 반환
/*
Add는 두 숫자의 합 반환
*/
func Add(a, b int) int {
 return a + b
}

Go 기본 명령어

Mon, 16 Jun 2025 09:00:00 +0900

컴파일 명령어

go build
- main 패키지면 현재 디렉터리에 실행 파일 생성
  - main 패키지 없다면 실행 파일 생성 안 됨 (컴파일만 됨)

go install

main 패키지면 실행 파일이 $GOBIN 또는 $GOPATH/bin 에 생성됨
- main 패키지 없다면 실행 파일 없음, 캐시에만 저장
아래 코드처럼 실행 가능한 go로 작성된 cli 툴들 가져오기 가능(GOBIN에 등록됐을 시)
1

go install github.com/user/tool@latest
환경 변수 설정

1
2
3
4
5
6
7
8


# GOBIN 기본 경로 확인
go env GOBIN
# 없으면 GOPATH/bin이 기본
go env GOPATH

# 실행 파일 전역 사용을 위해 PATH 설정
echo 'export PATH=$PATH:$(go env GOPATH)/bin' >> ~/.bashrc
source ~/.bashrc

모듈 라이브러리 명령어

go get
- main 패키지가 없는 모듈 라이브러리(go.mod)에 추가하는 명령어
1

go get github.com/user/package
go mod tidy
- go.mod에 필요 없는 모듈 제거
- 누락된 의존성 자동 추가

코드 스타일 정리

들여쓰기, 공백, import 정렬 등을 표준화

1
2
3


go fmt # 현재 디렉토리 전체 포맷
go fmt file.go # 특정 파일만 포맷
go fmt ./... # 하위 디렉토리까지 전체 포맷. bash 문법이 아닌 go 문법.

Go Public / Private 식별자

Sat, 31 May 2025 09:00:00 +0900

Go 언어는 public, private 키워드 없이 이름의 첫 글자 대소문자만으로 식별자의 공개 여부를 결정 함수, 변수, 인터페이스 등 모든 식별자에 적용되는 규칙

공개(Public) 식별자와 비공개(Private) 식별자

대문자로 시작하는 이름 → 해당 패키지 외부에서도 접근 가능 (공개)

소문자로 시작하는 이름 → 해당 패키지 내부에서만 사용 가능 (비공개)

1
2
3
4
5
6
7
8
9


// 공개 함수
func Reverse(s string) string {
 return reverseTwo(s)
}

// 비공개 함수
func reverseTwo(s string) string {
 // 문자열 뒤집기
}

Public 함수 접근 예시

패키지 구조

1
2
3
4
5
6


GolangTraining/
 ├── 02_library/
 │ └── stringutil/
 │ └── reverse.go
 └── 01_helloWorld/
 └── hello.go

reverse.go (패키지 내부 함수 정의)

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


package stringutil

func Reverse(s string) string {
 return reverseTwo(s)
}

func reverseTwo(s string) string {
 r := []rune(s)
 for i, j := 0, len(r)-1; i < len(r)/2; i, j = i+1, j-1 {
 r[i], r[j] = r[j], r[i]
 }
 return string(r)
}

hello.go (외부 패키지에서 import)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


package main

import (
 "fmt"
 "github.com/goestoeleven/GolangTraining/02_library/stringutil"
)

func main() {
 fmt.Println(stringutil.Reverse("Hello, Go!"))
}

실행 결과
1

!oG ,olleH

Private 함수에 접근하려 할 경우

reverseTwo는 stringutil 내부에서만 사용 가능하므로, 아래와 같이 사용하면 컴파일 에러 발생
1

fmt.Println(stringutil.reverseTwo("Hello"))
컴파일 에러
1

undefined: stringutil.reverseTwo

Go Blank Identifier

Fri, 30 May 2025 09:00:00 +0900

Go에서 _는 사용하지 않는 값 또는 결과를 버리는 용도로 사용
읽기 전용이며, 어떤 값도 저장하거나 참조 불가
실제 메모리에 변수로 존재하지 않음

주요 사용 예

다중 리턴값 중 일부 무시할 때

1

val, _ := someFunc() // 두 번째 리턴값 무시

반복문에서 인덱스나 값을 무시할 때

1
2
3


for _, v := range list {
 fmt.Println(v) // 인덱스는 필요 없을 때
}

인터페이스 구현 시, 사용하지 않는 메서드 인자 무시

1
2
3


func handler(_ int) {
 // 인자를 사용하지 않음
}

import된 패키지를 코드에서 직접 사용하지 않을 때

1

import _ "net/http/pprof" // side-effect용 import

변수 선언 후 사용하지 않아 에러가 날 때 회피용

1
2


msg := "hello"
_ = msg

Go iota

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

Go 특유의 상수용 자동 증가 매크로 키워드

const 블록에서만 사용 가능
첫 번째 상수는 0부터 시작
아래로 한 줄씩 내려갈 때마다 1씩 자동 증가

기본 예제

1
2
3
4
5


const (
 A = iota // 0
 B // 1
 C // 2
)

iota는 행 기준으로 증가 → 위 예제에서 A=0, B=1, C=2

중간에 값을 지정해도 다음 iota는 계속 증가

1
2
3
4
5


const (
 A = iota // 0
 B = 100 // 고정값
 C = iota // 2
)

비트 연산자와 조합 (플래그)

1
2
3
4
5


const (
 Read = 1 << iota // 1 << 0 → 1
 Write // 1 << 1 → 2
 Exec // 1 << 2 → 4
)

→ Read=1, Write=2, Exec=4 → 비트 플래그 용도로 자주 사용

여러 개 동시에 선언할 때도 동작

1
2
3
4


const (
 x, y = iota, iota // x=0, y=0
 a, b = iota, iota // a=1, b=1
)

Go의 기본 자료형과 단축 선언

Wed, 28 May 2025 09:00:00 +0900

정수형
- int, int8, int16, int32, int64
- uint 계열은 양수 전용
- 보통은 그냥 int 사용
실수형
- float32, float64 (기본은 float64)
- 소수점 숫자 저장용
문자형
- rune: 유니코드 문자 하나 (int32)
- 'A', '한' , 이모티콘을 포함한 문자 저장 가능
문자열
- string: UTF-8 인코딩 문자열
- 불변(immutable)
- 슬라이싱, 인덱싱 가능
Boolean
- bool: true / false
- 조건문 등에 사용
Byte
- byte는 uint8의 alias
- 문자열 인코딩 관련 작업에서 자주 사용

1
2
3
4
5
6


var i int = 10
var f float64 = 3.14
var ch rune = '가'
var s string = "hello"
var b bool = true
var b byte = 'A' // byte는 uint8

기본값

Go에서는 변수 선언 시 초기값을 주지 않으면 자료형에 맞는 기본값(zero value)으로 초기화됨

1
2
3
4


var i int // 0
var s string // ""
var b bool // false
var f float64 // 0.0

출력 포맷 (`fmt.Printf`)

포맷	설명	예시
`%d`	정수	`fmt.Printf("%d", 10)`
`%f`	실수	`fmt.Printf("%.2f", 3.14)`
`%s`	문자열	`fmt.Printf("%s", "go")`
`%c`	문자	`fmt.Printf("%c", 'A')`
`%v`	기본 포맷	`fmt.Printf("%v", 변수)`
`%T`	타입	`fmt.Printf("%T", 변수)`

형 변환

Go는 자동 형 변환 없음 → 반드시 명시적 변환 필요
정수 ↔ 실수, 정수 ↔ uint 변환 시 주의

1
2
3


var a int = 42
var b float64 = float64(a)
var c uint = uint(b)

rune <===> string 인덱싱 시 주의
- string[index]는 byte 리턴 → 유니코드 문자는 rune으로 변환해야 제대로 출력 가능
1 2 3

s := "가나다" fmt.Printf("%c\n", s[0]) // 깨짐 fmt.Printf("%c\n", []rune(s)[0]) // 가

단축 선언 (`:=`)

타입 추론과 동시에 변수 선언
주로 함수 내부에서 사용

1
2
3
4


name := "Go" // string
score := 95 // int
rate := 4.5 // float64
valid := true // bool

Go 설치와 실행

Mon, 26 May 2025 09:00:00 +0900

공식 문서: https://go.dev/doc/install

설치

1
2
3


wget https://go.dev/dl/go1.24.3.linux-amd64.tar.gz
tar -xvzf go1.24.3.linux-amd64.tar.gz
sudo mv go /usr/local/

.bashrc에 영구 적용

1
2
3
4
5
6
7


go env GOROOT

# 위 명령어에서 나온 값 변수로 저장
# 기본값: /usr/local/go
echo 'export GOROOT=$(go env GOROOT)' >> ~/.bashrc
echo 'export PATH=$PATH:$GOROOT/bin' >> ~/.bashrc
source ~/.bashrc

설치 확인
1

go version

go 모듈 초기화
- Go 프로젝트 시작 시 go.mod 파일을 만들고 의존성 관리 가능하게 함
- 보통 하나의 프로젝트(리포지토리)당 한 번만 실행
- 모듈 이름은 GitHub 경로처럼 짓는 것이 관례이며, 실제로 GitHub에 올릴 경우 import 경로로 사용됨
1 2

mkdir go-basic && cd go-basic go mod init github.com/joonlog/go-basic
- 이 명령은 현재 디렉토리를 github.com/joonlog/go-basic이라는 이름의 모듈로 선언함
  
  → GitHub에 올리지 않아도 작동하지만, 나중에 배포하려면 실제 리포지토리 경로와 맞춰야 함
- go.mod 파일 생성됨
1 2 3 4

go-workspace/ └── myproject/ ← 모듈 디렉터리 ├── go.mod ← 모듈 정보 └── main.go

main.go 작성

package main의 목적: go run / go build로 실행 가능한 바이너리 생성 반드시 func main 존재 필요
1 2 3 4 5 6 7

package main import "fmt" func main() { fmt.Println("Hello, Go!") }

실행
1

go run main.go

Go on Joonlog

Hugo Stack 계층형 카테고리 리팩토링

1. 포스트 카테고리 오타 수정

2. generate-categories.go 개선

2.1 ioutil 제거

2.2 url 필드 추가

생성 결과 예시

3. 사이드바 위젯 오버라이드 삭제

Hugo Stack 테마에서 계층형 카테고리 커스텀하기

개요

기존 카테고리

커스텀 카테고리

1. 카테고리 페이지 자동 생성 스크립트

코드 구조 및 역할

1.1 기본 구조체 정의

1.2 main 함수 - 디렉토리 초기화

1.3 포스트 스캔 및 카테고리 수집

1.4 메인 카테고리 페이지 생성

1.5 서브 카테고리 페이지 생성

생성 결과 예시

2. Categories 페이지 템플릿

템플릿 구조 및 역할

2.1 계층 구조 빌드

2.2 메인 카테고리별 포스트 수 계산

2.3 토글 UI

2.4 서브 카테고리 목록

2.5 스타일링

3. 메인 카테고리 페이지 템플릿

템플릿 구조 및 역할

3.1 포스트 필터링

3.2 서브 카테고리 추출

3.3 서브 카테고리별 그룹핑

3.4 포스트 목록 렌더링

4. 서브 카테고리 페이지 템플릿

템플릿 구조 및 역할

4.1 Breadcrumb 네비게이션

4.2 AND 조건 필터링

4.3 포스트 목록

5. GitHub Actions 워크플로우 수정

6. 메뉴 설정

구현 화면

Jekyll Chirpy 테마에서 Hugo Stack 테마로 블로그 이관하기

Jekyll Chirpy에서 Hugo Stack으로 이관한 이유

블로그 이관 과정

이관 시 포스팅 글 변경점

이후 예정 작업

Hugo 템플릿 Stack 테마로 GitHub Blog 배포하기

Hugo Stack 구조

Hugo Stack 구축

배포 설정

GitHub Pages 설정

배포 확인

참고

Teleport 18 이미지 빌드 및 배포

Teleport 18 이미지 빌드

도커 이미지 빌드

Teleport 18 배포

디렉토리 구조

1. docker-compose.yaml

2. auth/teleport.yaml

3. proxy/teleport.yaml

Teleport 18버전 도커 환경에서의 소스 빌드 오류 TroubleShooting

1. UID 0 is not unique 오류

2. CentOS7 환경 빌드 실패

3. error obtaining VCS status: exit status 128 에러

4. 정상 동작

Teleport 18버전 로컬 소스 빌드 오류 TroubleShooting

1. Corepack is not installed 오류

2. Rust + wasm-pack 버전 에러

3. libfido2 관련 경고

4. 디렉토리 여유 공간 확보

Teleport 18 소스 빌드 환경 설정

로컬 소스 빌드

1. 기본 패키지 설치

2. Node.js 22.14.0

3. Corepack ≥ 0.31 및 pnpm ≥ 10.11.0

4. Python 3.8

5. Rust ≥ 1.72 및 wasm-pack 0.12.1

6. (선택) wasm-opt 123 (Binaryen)

7. libfido2-devel

2. `generate-categories.go` 개선

1. `UID 0 is not unique` 오류

3. `error obtaining VCS status: exit status 128` 에러

1. `Corepack is not installed` 오류

출력 포맷 (`fmt.Printf`)

단축 선언 (`:=`)