Деплой Go на Kubernetes: базовое руководство на практике

Введение: Почему Go и Kubernetes — идеальная пара

Современная разработка всё чаще опирается на микросервисную архитектуру и контейнеризацию. Язык Go (Golang) благодаря своей производительности, простоте и нативной поддержке конкурентности стал одним из лидеров для написания backend-сервисов. В то же время Kubernetes (K8s) является стандартом де-факто для оркестрации контейнеров.

Деплой Go-приложения на Kubernetes — процесс, который может показаться сложным новичкам. Однако, следуя пошаговому руководству, вы сможете настроить CI/CD-пайплайн и запустить свой сервис за несколько минут. В этой статье мы разберём создание Docker-образа, написание манифестов для Kubernetes, настройку сервисов и Ingress, а также дадим практические советы по оптимизации.

1. Подготовка Go-приложения и Dockerfile

Прежде чем деплоить приложение в кластер, необходимо упаковать его в контейнер. В Go это особенно удобно благодаря статической компиляции.

1.1. Пример простого HTTP-сервера на Go

Создадим минимальный сервер, который будет отвечать на запросы. Это типичный микросервис для демонстрации.

// main.go
package main

import (
    "fmt"
    "net/http"
    "os"
)

func main() {
    port := os.Getenv("PORT")
    if port == "" {
        port = "8080"
    }

    http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprintf(w, "Hello from Go on Kubernetes!")
    })

    http.HandleFunc("/health", func(w http.ResponseWriter, r *http.Request) {
        w.WriteHeader(http.StatusOK)
        w.Write([]byte("OK"))
    })

    fmt.Printf("Server is running on port %s\n", port)
    http.ListenAndServe(":"+port, nil)
}

1.2. Многоступенчатая сборка Dockerfile

Используем многоступенчатую сборку (multi-stage build) для минимизации размера итогового образа. Это критически важно для быстрой загрузки в кластер.

# ---- Первый этап: сборка бинарника ----
FROM golang:1.21-alpine AS builder

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

COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build -o /app/server .

# ---- Второй этап: минимальный образ ----
FROM alpine:latest

RUN apk --no-cache add ca-certificates

WORKDIR /root/
COPY --from=builder /app/server .

EXPOSE 8080

CMD ["./server"]

Важно: флаг CGO_ENABLED=0 отключает CGO, что позволяет собрать полностью статический бинарник, который не требует внешних библиотек.

2. Создание манифестов Kubernetes

Теперь, когда у нас есть образ, нужно описать, как Kubernetes будет управлять нашим приложением. Основные объекты: Deployment (для управления репликами) и Service (для сетевого доступа).

2.1. Deployment

Deployment гарантирует, что нужное количество подов (Pod) с нашим приложением всегда запущено. Важно настроить liveness и readiness probes для автоматического восстановления.

// deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: go-app
  labels:
    app: go-app
spec:
  replicas: 2
  selector:
    matchLabels:
      app: go-app
  template:
    metadata:
      labels:
        app: go-app
    spec:
      containers:
      - name: go-app
        image: your-dockerhub-username/go-app:latest
        ports:
        - containerPort: 8080
        env:
        - name: PORT
          value: "8080"
        livenessProbe:
          httpGet:
            path: /health
            port: 8080
          initialDelaySeconds: 5
          periodSeconds: 10
        readinessProbe:
          httpGet:
            path: /health
            port: 8080
          initialDelaySeconds: 3
          periodSeconds: 5
        resources:
          requests:
            memory: "64Mi"
            cpu: "100m"
          limits:
            memory: "128Mi"
            cpu: "200m"

2.2. Service

Service обеспечивает стабильный сетевой доступ к подам. Для внутреннего взаимодействия используем ClusterIP, для внешнего — NodePort или LoadBalancer.

// service.yaml
apiVersion: v1
kind: Service
metadata:
  name: go-app-service
spec:
  selector:
    app: go-app
  ports:
    - protocol: TCP
      port: 80
      targetPort: 8080
  type: ClusterIP

3. Запуск и управление в кластере

После того как манифесты готовы, можно применять их к кластеру. Рассмотрим базовые команды и типичные проблемы.

3.1. Применение манифестов

Убедитесь, что у вас установлен kubectl и настроен доступ к кластеру (например, Minikube, Docker Desktop или облачный K8s).

# Применяем все манифесты в папке
kubectl apply -f deployment.yaml
kubectl apply -f service.yaml

# Проверяем статус подов
kubectl get pods

# Проверяем сервисы
kubectl get svc

# Просматриваем логи пода
kubectl logs -l app=go-app

3.2. Проброс портов для тестирования

Если вы используете Minikube или локальный кластер, можно временно получить доступ к сервису через port-forward:

kubectl port-forward service/go-app-service 8080:80

Теперь откройте браузер по адресу http://localhost:8080 — вы увидите приветствие от Go-приложения.

4. Настройка Ingress и переменных окружения

Для продакшена одного Service недостаточно. Нужно настроить Ingress Controller (например, Nginx Ingress), чтобы маршрутизировать внешний трафик по доменному имени.

4.1. Пример Ingress

// ingress.yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: go-app-ingress
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /
spec:
  rules:
  - host: go-app.example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: go-app-service
            port:
              number: 80

4.2. Управление кон