技術ノート on Clarence｜Backend・AI・DevOps・Infrastructure

AWS CDK Tips

Mon, 01 Jan 0001 00:00:00 +0000

日常コマンド

cdk init app --language typescript
cdk synth
cdk diff
cdk deploy
cdk deploy --all
cdk destroy

deployment 前には cdk diff を確認し、環境ごとの値は construct code に直接書かない。

Environment と tags

const env = {
  account: process.env.CDK_DEFAULT_ACCOUNT,
  region: process.env.CDK_DEFAULT_REGION,
};

Tags.of(this).add("Project", "example");
Tags.of(this).add("Environment", "production");

tags は ownership、cost review、incident tracing に使う。

AWS CLI クイックリファレンス

Mon, 01 Jan 0001 00:00:00 +0000

Install と configure

brew install awscli
aws --version
aws configure
aws configure --profile production
aws configure list --profile production
aws sts get-caller-identity --profile production

production や customer account では named profile を使う。長期 credential を shell history や共有メモに残さない。

S3 operations

aws s3 ls
aws s3 ls s3://example-bucket --recursive --human-readable --summarize
aws s3 cp ./dist s3://example-bucket/dist --recursive
aws s3 sync ./public s3://example-bucket --delete
aws s3api head-object --bucket example-bucket --key path/file.txt

sync --delete は、その bucket path が deployment target 専用だと確認してから使う。

macOS 管理コマンド

Mon, 01 Jan 0001 00:00:00 +0000

Launchpad と Dock

defaults write com.apple.dock ResetLaunchPad -bool true
killall Dock

defaults write com.apple.dock autohide -bool true
defaults write com.apple.dock tilesize -int 50
killall Dock

Dock の変更は、多くの場合 killall Dock 後に反映される。

Finder と screenshots

defaults write com.apple.finder AppleShowAllFiles -bool true
defaults write NSGlobalDomain AppleShowAllExtensions -bool true
killall Finder

defaults write com.apple.screencapture location ~/Desktop/Screenshots
defaults write com.apple.screencapture type -string "png"
killall SystemUIServer

screenshot location を変更する前に target folder を作成する。

System と network checks

sw_vers
system_profiler SPHardwareDataType
sysctl -n machdep.cpu.brand_string
df -h
networksetup -listallhardwareports
networksetup -getinfo "Wi-Fi"

troubleshooting や migration 前の Mac 記録に使える。

Ollama 設定と使い方

Mon, 01 Jan 0001 00:00:00 +0000

Install と実行

curl -fsSL https://ollama.com/install.sh | sh
ollama serve
ollama pull gemma2:9b
ollama pull llama3.1:8b
ollama list

prompt testing では小さめの model から始め、workflow が安定してから大きな model に移る。

Model commands

ollama run gemma2:9b
ollama show gemma2:9b
ollama rm gemma2:9b

script では model name を明示する。default model の変更で結果が変わるのを避けるため。

Local API

curl http://localhost:11434/api/generate \
  -d '{"model":"gemma2:9b","prompt":"Summarize this text.","stream":false}'

local API は private experiment に便利だが、production では timeout、retry、logging boundary が必要。

パッケージ管理コマンド

Mon, 01 Jan 0001 00:00:00 +0000

Homebrew

brew update
brew install git node hugo
brew install --cask visual-studio-code
brew list
brew outdated
brew upgrade
brew cleanup

active development 用の machine では、広範囲 upgrade 前に brew outdated を確認する。

APT

sudo apt update
sudo apt upgrade
sudo apt install git curl wget vim
apt list --installed
apt list --upgradable
sudo apt autoremove

production host では kernel や runtime updates の範囲を確認してから適用する。

DNF と YUM

sudo dnf check-update
sudo dnf install git nginx
sudo dnf upgrade

sudo yum check-update
sudo yum install git nginx
sudo yum update

distribution native の package manager を使い、service scripts と dependencies の一貫性を保つ。

システム管理コマンド

Mon, 01 Jan 0001 00:00:00 +0000

System inspection

uname -a
cat /etc/os-release
lscpu
free -h
df -h
lsblk
ip addr show
ip route show

server incident を記録するときは、この基本情報から取得する。

Files と logs

ls -la
find /path -name "*.log"
du -sh /path/*
tail -f /var/log/syslog
grep "error" /var/log/syslog
tar -czf archive.tar.gz folder/

live logs には tail -f、過去ログの絞り込みには grep を使う。

systemd と networking

sudo systemctl status nginx
sudo systemctl restart nginx
sudo journalctl -u nginx -f

ping -c 4 8.8.8.8
ss -tuln
lsof -i :80
curl -I https://example.com

service state、listening ports、external HTTP path の順で確認する。

Docker コマンド

Mon, 01 Jan 0001 00:00:00 +0000

Images と containers

docker pull nginx:latest
docker images
docker ps
docker ps -a
docker run -d --name web -p 8080:80 nginx
docker exec -it web sh
docker logs -f web
docker stop web
docker rm web

長く動かす container には名前を付ける。logs や operational commands が読みやすくなる。

Compose workflow

docker compose up -d
docker compose up --build
docker compose ps
docker compose logs -f service_name
docker compose exec service_name sh
docker compose down
docker compose down -v

down -v は volume data を削除してよい場合だけ使う。