Разработка на Go с микросервисной архитектурой — это постоянный баланс между скоростью и надёжностью. Одна ошибка в контракте gRPC, необработанный сбой в Kafka или утечка в кэше могут превратить ночь в бесконечный дебаг. Но что, если часть рутины можно переложить на языковые модели? Правильно сформулированный промт помогает сгенерировать рабочий код, найти узкие места и даже спроектировать отказоустойчивую систему — без выгорания. В этой подборке — 12 промтов, которые я собрал из практики сопровождения Go-сервисов. Каждый — с конкретной задачей, примером использования и фрагментом кода. Они не заменят инженера, но снимут рутину и дадут время на архитектуру.
1. Генерация gRPC-сервиса с валидацией и обработкой ошибок
Задача: быстро создать каркас gRPC-сервиса на Go с интерсепторами для логирования и валидации запросов.
Промт:
Ты — senior Go-разработчик. Сгенерируй proto-файл для сервиса управления заказами (OrderService) с методами CreateOrder, GetOrder, ListOrders. Добавь поля: id (string), user_id (string), items (repeated OrderItem), total (double), status (enum). Напиши Go-сервер с использованием google.golang.org/grpc, подключи интерсепторы: logging (zap), recovery, валидацию через protoc-gen-validate. Обработай ошибки с кодами gRPC (InvalidArgument, NotFound, Internal). Приведи пример клиента и команды для генерации кода.
Пример использования:
После генерации вы получаете готовый order.proto, server.go, client.go. Достаточно выполнить:
protoc --go_out=. --go-grpc_out=. --validate_out="lang=go:." order.proto
Интерсепторы автоматически логируют запросы и восстанавливаются после паник. Это экономит часы на старте нового сервиса.
2. Проектирование топиков Kafka и идемпотентного консьюмера
Задача: избежать дублей при обработке сообщений и правильно настроить партиционирование.
Промт:
Спроектируй схему топиков Kafka для сервиса уведомлений: события user.created, order.paid, order.cancelled. Ключ — user_id. Напиши консьюмер на Go с использованием segmentio/kafka-go, который гарантирует идемпотентность через таблицу processed_events в PostgreSQL. Добавь обработку ребалансировки и graceful shutdown. Покажи, как настроить retry с экспоненциальной задержкой и DLQ.
Пример:
Промт сгенерирует код с проверкой event_id перед обработкой и записью в БД в одной транзакции. Это исключает повторную отправку уведомлений. Для DLQ используется отдельный топик order.paid.dlq.
3. Кэширование с Redis: стратегии инвалидации
Задача: кэшировать ответы gRPC-метода, но не отдавать устаревшие данные.
Промт:
Напиши на Go обёртку для Redis (go-redis/v9), которая кэширует результат вызова GetOrder по ключу order:{id} с TTL 5 минут. При обновлении заказа (UpdateOrder) инвалидируй кэш. Используй паттерн Cache-Aside. Добавь защиту от cache stampede через singleflight. Приведи пример кода с контекстом и таймаутами.
Пример:
func (s *Service) GetOrder(ctx context.Context, id string) (*Order, error) {
key := "order:" + id
val, err := s.redis.Get(ctx, key).Result()
if err == nil { return decode(val), nil }
// singleflight для предотвращения дублирующих запросов
v, err, _ := s.group.Do(key, func() (interface{}, error) {
order, err := s.repo.GetOrder(ctx, id)
if err != nil { return nil, err }
s.redis.Set(ctx, key, encode(order), 5*time.Minute)
return order, nil
})
return v.(*Order), err
}
4. Observability: трейсинг, метрики, логи
Задача: настроить сквозной трейсинг между сервисами и вывести метрики в Prometheus.
Промт:
Покажи, как интегрировать OpenTelemetry в Go-микросервис: экспорт трейсов в Jaeger, метрик в Prometheus. Настрой gRPC-интерсепторы для трейсинга и сбора метрик (количество запросов, длительность, ошибки). Добавь корреляцию логов через trace_id. Приведи пример конфигурации otel-collector.
Пример:
Промт сгенерирует код с otelgrpc.UnaryServerInterceptor(), который автоматически создаёт спаны. В логах появится поле trace_id, что упрощает поиск проблемы в распределённой системе.
5. Graceful shutdown и health checks
Задача: корректно завершать сервис без потери сообщений.
Промт:
Напиши на Go main-функцию для gRPC-сервера с graceful shutdown по SIGTERM/SIGINT. Добавь health-check endpoint (grpc-health-probe) и readiness/liveness пробы. Учти завершение активных Kafka-консьюмеров и закрытие соединений с БД. Приведи пример с errgroup и context.
Пример:
Код будет ждать завершения текущих запросов до 30 секунд, затем закрывать соединения. Это предотвращает потерю данных при деплое.
6. Тестирование gRPC с помощью bufconn
Задача: писать интеграционные тесты без поднятия реального порта.
Промт:
Сгенерируй пример теста для gRPC-сервиса на Go с использованием bufconn. Покажи, как создать in-memory соединение, запустить сервер и клиент, проверить метод CreateOrder. Добавь моки для репозитория. Используй testify.
Пример:
Тест занимает миллисекунды, не требует сети и легко запускается в CI.
7. Обработка ошибок и retry в клиентах
Задача: сделать вызовы к внешним сервисам устойчивыми к сбоям.
Промт:
Напиши Go-клиент для gRPC с retry-политикой: 3 попытки с экспоненциальной задержкой (100ms, 200ms, 400ms) и джиттером. Обрабатывай коды Unavailable, DeadlineExceeded. Добавь circuit breaker (sony/gobreaker). Приведи пример с context.WithTimeout.
Пример:
Клиент автоматически повторяет запросы при временных сбоях, не заваливая сервис.
8. Миграции БД и версионирование схемы
Задача: безопасно менять схему без даунтайма.
Промт:
Предложи стратегию миграций для PostgreSQL в микросервисах на Go с использованием golang-migrate. Напиши пример миграции для добавления поля в таблицу orders без блокировки. Покажи, как откатить изменения. Добавь проверку совместимости в CI.
Пример:
Используется ALTER TABLE ... ADD COLUMN ... DEFAULT ... NOT NULL с предварительным заполнением, чтобы избежать долгих блокировок.
9. Конфигурация и секреты
Задача: управлять настройками без пересборки.
Промт:
Покажи, как загружать конфигурацию Go-сервиса из переменных окружения и Vault. Используй viper. Настрой горячую перезагрузку при изменении. Добавь валидацию обязательных полей. Приведи пример структуры Config.
Пример:
Сервис читает секреты из Vault при старте и обновляет их по сигналу SIGHUP.
10. Бенчмарки и профилирование
Задача: найти узкие места в производительности.
Промт:
Напиши бенчмарк для функции обработки заказа на Go. Используй testing.B, добавь профилирование CPU и памяти. Покажи, как анализировать pprof. Приведи пример оптимизации с sync.Pool.
Пример:
Бенчмарк выявит аллокации, а go tool pprof покажет горячие точки.
11. Деплой в Kubernetes с Helm
Задача: упаковать сервис в чарт с best practices.
Промт:
Создай Helm-чарт для Go-микросервиса: Deployment, Service, ConfigMap, HPA, PodDisruptionBudget. Учти liveness/readiness пробы, resource limits. Добавь values.yaml с настройками для dev/prod. Приведи пример CI/CD пайплайна.
Пример:
Чарт можно установить одной командой helm install my-service ./chart.
12. Логирование с zap и структурированный вывод
Задача: логи должны быть парсируемыми и содержать контекст.
Промт:
Настрой zap-logger в Go-сервисе: JSON-формат, уровни, добавление trace_id и user_id в каждую запись. Покажи, как передавать logger через context. Приведи пример middleware для gRPC.
Пример:
В Kibana логи легко фильтруются по trace_id, что ускоряет диагностику.
Все эти промты — не догма. Адаптируйте их под свой стек, комбинируйте и уточняйте. Главное — помнить: LLM генерирует код на основе паттернов, поэтому проверяйте его в тестах и код-ревью. Если хотите глубже разобраться в микросервисах на Go, изучите официальную документацию gRPC, Kafka и OpenTelemetry. А если нужен структурированный путь — обратите внимание на курсы по Go и распределённым системам. Делитесь своими промтами в комментариях — вместе мы сделаем ночные дежурства редкостью.
Комментарии