Go on Joonlog

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