Technical on Yungen's blog

My MacBook Setup

Sat, 12 Jul 2025 00:00:00 +0000

My philosophy for my setup is to keep things minimal. I never install an app just because “everyone uses it.” Instead of one big bloated app that does a lot of things averagely, I prefer multiple small apps that each do one thing well. I wrote this to keep track of what I’ve installed and to help me re-examine which apps I really need.

Productivity

Obsidian: Notes, writings
Notion
Typora
Antinote
ChatGPT
Claude

Development

Orbstack
Postman
1Password
Ghostty: I previously used Warp, but Warp kept pushing its AI features. I prefer a more minimal terminal app.
VirtualBox
Cursor
VSCode
DBngin

Work

Microsoft Word, PowerPoint, Excel : I might not need these in the future
Zoom
Slack

Utils

AdGuard: I bought the lifetime subscription during Black Friday sales. uBlock might be an alternative.
AppCleaner
Karabiner-Elements
Keka
October: A tool to sync Kobo eReader highlights to Readwise
CleanShot X
Tailscale
Maccy

Personal

Anki
Calibre: I personally own a Kobo eReader; an essential app for sideloading books
IINA
Reader
Spotify

CLI tools

atiun
docker
docker-compose
fd
fnm
fzf
go
hugo
jq
k9s
lazygit
neovim
pnpm
ripgrep
tree
uv
wget
topgrade
Home | mise-en-place

Terraform short note

Sun, 26 Feb 2023 00:00:00 +0000

Introduction

在使用雲端服務時我們通常會使用雲端平台提供 GUI 介面去設定並使用雲端服務，但這樣有個缺點就是使用 GUI 設定很難被紀錄、重現，假設今天我架設一台 VM 更動了 20 幾個設定，日後我想要再設定另一台一模一樣的 VM 就會很麻煩，又或著我使用多個不同的雲端服務建立一個環境我希望其他人也能建立一個跟我一樣的環境。這時候我們就可以使用 Terraform 這個工具來達到 Infrastructure as Code。我們可以使用 Code 來建置、更改並版本紀錄我們的 Infrastructure。

HCL(Hashicorp Configuration Language)

Terraform 主要使用 HCL 來設定雲端服務，HCL 主要用來描述你想要設定的 resource ，例如以下

1resource "gpc_vpc" "main" {
2 cidr_block = var.base_cidr_block
3}
4
5<BLOCK TYPE> "<BLOCK LABEL>" "<BLOCK LABEL>" {
6 # Block body
7 <IDENTIFIER> = <EXPRESSION> # Argument
8}

如果你使用 vscode 可以用這個 extension

Install

請參考官方連結

kubernetes local dev

Tue, 29 Nov 2022 00:00:00 +0000

Introduction

在開發 kubernetes 相關的程式時為了確保程式能正確運行，需要一個 kubernetes 環境方便我們測試。我們不太可能每次測試都要另外開一個 gke ，太麻煩且浪費錢了，所以我們需要一些工具幫助我們在本地端架設 kubernetes cluster 來測試。

在本地端架設 kubernetes 有許多種方法下面列舉出一些較多人使用的工具

接下來會介紹如何安裝以及使用 minikube 以及 rancherdesktop

minikube

Prerequisite

安裝 docker 或 nerdctl
安裝 kubectl

安裝 minikube

mac

1brew install minikube

linux(WSL)

1curl -LO <https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64>
2sudo install minikube-linux-amd64 /usr/local/bin/minikube

更多安裝方法請參考 https://minikube.sigs.k8s.io/docs/start/

啟動

1minikube start

結束

1minikube stop

檢查 kubectl context

1kubectl config get-contexts

設定 kubectl context

1kubectl config use-context <context-name>

rancher desktop

Prerequisite

安裝 rancher desktop

直接下載

1brew install --cask rancher

檢查 kubectl context

1kubectl config get-contexts

設定 kubectl context

1kubectl config use-context <context-name>

build and deploy

minikube

1eval $(minikube docker-env)

確定 docker context

1docker context list

deploy

kubernetes.yaml

MQTT short note

Fri, 18 Mar 2022 00:00:00 +0000

What is mqtt

mqtt 是個基於 Pub/Sub 模式的 protocol ，主要會由一個 message broker 與多個 client 組成。

What is Pub/Sub

在 Pub/Sub 的傳輸模式下訊息的傳輸不會以一對一的方式傳送訊息，而是將訊息發布到一個 Topic 中，而所有有訂閱該 Topic 的用戶都會收到訊息。可以想像為 slack 的頻道，我可以在 d1 中發訊息（發布訊息到 d1 這個 topic），而只會有在 d1 這個頻道的使用者收到訊息（有訂閱 d1 topic 的使用者）。不過在 Pub/Sub 模式下收到訊息不會知道是誰發佈的。（除非在訊息中有寫）

MQTT 傳輸模式

QOS

QoS 0: 最多一次傳送：client 傳送訊息後不在乎訊息是否真的有其他 client 端收到。
QoS 1: 至少一次傳送：client 傳送訊息後會等待接收方回應，如果沒有回應則會重新再傳一次。（此方法可以確保訊息會送達，但不會確保訊息不會重複）
QoS 2: 正好一次傳送：與 QoS 2 相似但會確保訊息不會重複。

How

目前打算使用 emqx 作為 message broker ，讓所有使用者作為 client 端，同時 chat services 也會作為 client 發布訊息給所有 client 端。

kubernetes basics

Wed, 09 Mar 2022 00:00:00 +0000

Wow Docker 好方便！那他跟 kubernetes 差在哪裡？

首先，docker 是無法跟 kubernetes 比較的，docker 是運行 container 的一種方式，許多人會認為 docker == container == image ，但實際上 docker ≠ container ≠ image。

在了解 kubernetes 前我們要先理解 container 到底是怎麼運作的。

container 、 container engine 、 container runtime ???

docker 的基本概念可以參考下圖

當使用者輸入 docker ... 其實是在告訴 docker engine(container engine) 使用者要跑一些 image 這時候 docker engine 就會告訴 containerd (container runtime) 該做什麼事（比如說要 pull image 、建立 container 之類的）containerd 就會根據 docker engine 的指令做事。（備註：圖中的 runc 其實也是 container runtime 因為 container runtime 有分 high level 與 low level …）

gRPC short note

Fri, 04 Mar 2022 00:00:00 +0000

What is gRPC

在了解什麼是 gRPC 之前需要先解釋一下什麼是 RPC(Remote Procedure Call)。RPC 是一種程式之間溝通的方式，A 程式可以呼叫 B 程式去執行一些 function ，也可以把他想像為在一個程式中呼叫另一個程式的 function 。gRPC 為 google 推出的一個 framework 能實現上述提到的功能。

Why

未來如果要將 backend microservices 化，會遇到一個問題就是 services 之間要如何溝通，當然我們能夠沿用 HTTP 作為溝通的方式，但 HTTP 有幾個缺點：

與 gRPC 相比、傳輸同一筆資料需要消耗更多頻寬。舉例：

json: {”id”:2} (9 bytes)

xml: <id>42</id> (11 bytes)

protobuf: 0x08 0x2a (2 bytes) → gRPC 的傳輸方式
傳輸方式只有一種（client 發送 request, server 給予 response）
…

總而言之 gRPC 的方式更適合 microservice 架構

更詳細的比較可以參考這篇：

比較 gRPC 服務與 HTTP API

traefik & let’s encrypt

Fri, 04 Feb 2022 00:00:00 +0000

前言

在上一篇文章中介紹如何設置 reverse proxy ，這篇將會介紹如何使用 let’s encrypt 讓 traefik 支援 HTTPS 連線。

簡單介紹 let’s encrypt

let’s encrypt 是個憑證頒發機構，與其他憑證頒發機構不同的是 let’s encrypt 提供免費的憑證，只要客戶端達成某些條件，向 let’s encrypt 證明其擁有某個網域名時，let’s encrypt 就會免費提供數位憑證給客戶端。

traefik & let’s encrypt

traefik 本身支援使用最常見的 TLS 憑證，也支援透過 ACME 的方式向支援 ACME 頒發憑證的機構自動獲取數位憑證（此範例使用 let’s encrypt）。此外，let’s encrypt 所頒發的數位憑證有有效期限，traefik 會在到期時自動更新數位憑證。

let’s encrypt 運作機制

在申請憑證時，最重要的步驟就是向 let’s encrypt 證明你擁有此網域。let’s encrypt 有提供三種方式：

HTTP-01 考驗：let’s encrypt 會給客戶端一個 token ，客戶端要將此 token 放在網頁伺服器 http://<YOUR_DOMAIN>/.well-known/acme-challenge/<TOKEN> 中，let’s encrypt 之後就會向該網址發送請求，若 let’s encrypt 成功拿到 token 後就會認定此網域的確為客戶所擁有，並頒發數位憑證。
DNS-01 考驗：let’s encrypt 會給客戶端一組字串，客戶端將此字串以 TXT 紀錄放在 DNS 中，接著 let’s encrypt 就會去查詢相對應的 DNS TXT 紀錄。若有成功查詢到 TXT 紀錄，就會認定此網域的確為客戶所擁有，並頒發數位憑證。
TLS-ALPN-01 考驗：此方法較為少見，詳細可參考官網。

traefik 支援以上三種驗證方式，且會在快到期時自動更新憑證。接下來的範例中會使用 HTTPS-01 以及 DNS-01 考驗。

traefik tutorial

Tue, 01 Feb 2022 00:00:00 +0000

前言

當我們在架設後端 service 的時候很常會遇到要將 service A 和 service B 放在同一個伺服器中運行，這時候會遇到一個問題：要如何設置 Endpoint 讓使用者能分別使用 service A 與 service B 呢？

方法ㄧ：將 service A 暴露（expose?）在 port A （例如：9000），將 service B 暴露在與 port A 不同的 port B （例如：3000），這樣使用者就能分別從 <伺服器 IP>:<portA> 、<伺服器 IP>:<portB> （例如：140.116.241.66:9000,140.116.241.66:3000）存取 service A 與 B
方法二：使用 reverse proxy ，設置 reverse proxy 監聽 port C （例如：80），使用者只要向 <伺服器 IP>:<portC> 發送 request ， reverse proxy 會根據使用者請求分別將 request 轉送到不同的 service （例如：140.116.241.66:80/A → service A、140.116.241.66:80/B → service B）。以下文章會介紹如何使用 traefik 作為 reverse proxy

簡單介紹 traefik

在 traefik 的官網中是如此介紹 traefik 的

Code-Prettifyer project

Mon, 11 Jan 2021 00:00:00 +0000

前言

本篇內容主要是說明我如何用 Docker、traefik、nginx 軟體，以及 JavaScript、PHP、C⋯⋯等等程式語言，做出一個可以讓使用者透過網頁輸入自己的程式碼後，對其進行分析、檢查以及排版的網頁應用程式。

概念發想

因著我是大一才開始真正接觸程式，從編輯器開始接觸了 vim。因著 vim 的特性，可以自定義很多快捷鍵、以及安裝許多由其他人寫的 plugin。其中就有 plugin 可透過其他人寫的 linter 直接對程式碼進行分析，找出程式碼中可能存在的錯誤。這個 plugin 帶給我許多方便，可惜的是絕大部分的 linter 在 windows 環境安裝起來有點麻煩，為了能推廣 linter 給使用 windows 環境的朋友，我便有一個想法。就是做一個網頁使使用者只要複製貼上自己的程式碼，按一個鍵，就能輸出分析結果甚至格式化程式碼。

過程

伺服器

要能架設網頁首先就是要有自己的伺服器，因著我手邊剛好有一台 raspberry pi 我就直接在上面安裝 ubuntu 20.4LTS。

安裝完基本設定都搞定後，抱著好玩與嘗試的心態我沒有照原本的計畫直接在 raspberry 上安裝 web server 而是想要嘗試看看用 docker 來運行 web server，基本上我就照著官方給的資料安裝就成功了。接著我照著其他人給的建議安裝了 portainer 讓我可以透過網頁 UI 來管理 docker。

到目前為止，我只能透過內網連到我的伺服器，如果要從外面的網路連到伺服器的話就需要有一個固定 ip。因著我家裡是安裝中華電信的網路，所以我可以直接到他們的網站申請一組固定 ip。申請完後直接設定 raspberry pi 讓它能透夠 PPPoE 的方式上網。

這時候我已經可以直接在外網 ssh 到伺服器，或是直接在瀏覽器輸入 ip 位址打開 portianer 頁面了。但如果其他要連到我的網頁的話就要輸入一串很難記的數字。為了讓我的網頁更好記得，我就在 name.com 上申請了自己網域名。

申請完後在設定裡添加一個 A record 指向自己 server 的位址