mcpField
K
k8s-deployment

k8s-deployment

github.com/brojonatクラウド・DevOps146 回インストール2 週間前に更新
リポジトリ

k8s-deployment について

サービス向けのDockerマルチステージビルド、kustomizeオーバーレイ、Makefileによる自動化を扱うKubernetesデプロイ用スキルです。GoとPythonのコンテナ構成例を含み、フロントエンドにVercelを使う場合はバックエンドのみをKubernetesへ配置します。

主な機能

  1. 01Dockerマルチステージビルドのパターン
  2. 02環境別のkustomizeオーバーレイ
  3. 03Makefileによるデプロイ自動化
  4. 04Gitハッシュによるイメージタグ
  5. 05GoとPythonのDocker例

活用シーン

  1. 01Goサービスのコンテナ準備
  2. 02Pythonサービスのコンテナ準備
  3. 03バックエンドサービスのKubernetes配置
  4. 04Vercelでのフロントエンド別配置

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/brojonat/llmsrules --skill k8s-deployment

インストール後、Claude Code で/k8s-deploymentを入力して読み込まれたか確認します。

詳細

Kubernetes のデプロイ

Docker のマルチステージビルド、kustomize のオーバーレイ、Makefile による自動化を使用してサービスをデプロイします。

ディレクトリ構成

.
├── Dockerfile
├── Makefile
├── server/
│   └── k8s/
│       └── prod/
│           ├── server.yaml
│           ├── ingress.yaml
│           └── kustomization.yaml
└── worker/
    └── k8s/
        └── prod/
            ├── worker.yaml
            └── kustomization.yaml

Makefile

SHELL := /bin/bash

define setup_env
        $(eval ENV_FILE := $(1))
        $(eval include $(1))
        $(eval export)
endef

build-push-cli: ## Build and push Docker image with git hash tag
	$(call setup_env, .env.server.prod)
	$(eval GIT_HASH := $(shell git rev-parse --short HEAD))
	$(eval DYNAMIC_TAG := your-registry/your-app:$(GIT_HASH))
	docker build -f Dockerfile -t $(DYNAMIC_TAG) .
	docker push $(DYNAMIC_TAG)

deploy-server: ## Deploy server to Kubernetes (prod)
	$(call setup_env, .env.server.prod)
	@$(MAKE) build-push-cli
	$(eval GIT_HASH := $(shell git rev-parse --short HEAD))
	kustomize build --load-restrictor=LoadRestrictionsNone server/k8s/prod | \
	sed -e "s;{{DOCKER_REPO}};your-registry/your-app;g" \
		-e "s;{{GIT_COMMIT_SHA}};$(GIT_HASH);g" | \
		kubectl apply -f -

deploy-worker: ## Deploy worker to Kubernetes (prod)
	$(call setup_env, .env.worker.prod)
	@$(MAKE) build-push-cli
	$(eval GIT_HASH := $(shell git rev-parse --short HEAD))
	kustomize build --load-restrictor=LoadRestrictionsNone worker/k8s/prod | \
	sed -e "s;{{DOCKER_REPO}};your-registry/your-app;g" \
		-e "s;{{GIT_COMMIT_SHA}};$(GIT_HASH);g" | \
		kubectl apply -f -

Dockerfile（Go）

# ---- Builder Stage ----
FROM golang:1.24-alpine AS builder

RUN apk update && apk add --no-cache git build-base ca-certificates
RUN update-ca-certificates

WORKDIR /app

COPY go.mod go.sum ./
RUN go mod download

COPY cmd/ ./cmd/
COPY server/ ./server/
COPY worker/ ./worker/

RUN CGO_ENABLED=0 GOOS=linux go build -ldflags="-w -s" -o /bin/app cmd/app/*.go

# ---- Final Stage ----
FROM alpine:latest

COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/
WORKDIR /app
COPY --from=builder /bin/app /app

EXPOSE 8080
CMD ["/app", "run", "http-server"]

Dockerfile（Python）

FROM python:3.13-slim AS base

RUN pip install uv
WORKDIR /app

COPY pyproject.toml uv.lock ./
RUN uv sync --frozen --no-dev

COPY src/ ./src/
COPY server/ ./server/

EXPOSE 8000
CMD ["uv", "run", "uvicorn", "server.main:app", "--host", "0.0.0.0", "--port", "8000"]

主なパターン

  • Git ハッシュタグ: git rev-parse --short HEAD でイメージにタグを付け、追跡可能にします
  • kustomize のオーバーレイ: kustomize build と sed による置換を使用して、環境ごとにデプロイします
  • マルチステージビルド: イメージを最小限にするため、ビルダーとランタイムのステージを分けます
  • レイヤーキャッシュ: 依存関係ファイルを先にコピーし、その後にソースコードをコピーします
  • Vercel でフロントエンドをホスト: フロントエンドは Vercel 経由でデプロイし、k8s にはバックエンドのみを配置します

コメント

Markdown 対応