2 Commits

Author SHA1 Message Date
6d9a869a6f 3-ый релиз образа для билда
All checks were successful
Release Build / create-builder-docker-image (push) Successful in 2m17s
2025-07-28 07:57:50 +06:00
a3867ba3de 2-ый релиз образа для билда
Some checks failed
Release Build / create-builder-docker-image (push) Failing after 20s
2025-07-28 07:55:58 +06:00
15 changed files with 379 additions and 1157 deletions

View File

@@ -1,3 +0,0 @@
create-release: 0
create-docker-image: 1
update-to-release-branch: 0

View File

@@ -1,125 +1,18 @@
name: Conditional Release Build name: Release Build
on: on:
push: push:
tags: tags:
- v* - v*
jobs: jobs:
debug-conditions:
runs-on: ubuntu-latest
steps:
- name: Show build conditions
run: |
echo "Build conditions:"
echo " BUILD_CREATE_RELEASE: ${{ vars.BUILD_CREATE_RELEASE == 'true' }}"
echo " BUILD_CREATE_DOCKER_IMAGE: ${{ vars.BUILD_CREATE_DOCKER_IMAGE == 'true' }}"
echo " BUILD_UPDATE_RELEASE_BRANCH: ${{ vars.BUILD_UPDATE_RELEASE_BRANCH == 'true' }}"
create-release:
runs-on: ubuntu-latest
if: ${{ vars.BUILD_CREATE_RELEASE == 'true' }}
container:
image: ${{ secrets.DOCKERHUB_USERNAME }}/my-build-golang-runner:latest
steps:
- name: Checkout repository
run: |
git clone https://oauth2:${{ secrets.GITEATOKEN }}@direct-dev.ru/gitea/GiteaAdmin/hello_gitea.git hello_gitea
cd hello_gitea
git checkout ${{ github.ref }}
- name: Setup Go
run: |
git --version
go version
jq --version
- name: Build all binaries
run: |
cd hello_gitea
# Проверяем, изменились ли зависимости
if [ ! -f go.sum ] || ! go mod verify >/dev/null 2>&1; then
echo "Dependencies changed, downloading..."
go mod download
fi
mkdir -p bin
echo "Building for all platforms..."
# Build for all platforms using direct go build commands
echo "Building for linux amd64..."
GOOS=linux GOARCH=amd64 go build -o bin/hello-api-linux-amd64 main.go
echo "Building for linux arm64..."
GOOS=linux GOARCH=arm64 go build -o bin/hello-api-linux-arm64 main.go
echo "Building for windows amd64..."
GOOS=windows GOARCH=amd64 go build -o bin/hello-api-windows-amd64.exe main.go
echo "Building for darwin amd64..."
GOOS=darwin GOARCH=amd64 go build -o bin/hello-api-darwin-amd64 main.go
echo "Building for darwin arm64..."
GOOS=darwin GOARCH=arm64 go build -o bin/hello-api-darwin-arm64 main.go
# Create archives
echo "Creating archives..."
cd bin
# Create archives with correct file names
tar -czf hello-api-linux-amd64.tar.gz hello-api-linux-amd64
tar -czf hello-api-linux-arm64.tar.gz hello-api-linux-arm64
tar -czf hello-api-windows-amd64.tar.gz hello-api-windows-amd64.exe
tar -czf hello-api-darwin-amd64.tar.gz hello-api-darwin-amd64
tar -czf hello-api-darwin-arm64.tar.gz hello-api-darwin-arm64
echo "Listing bin directory..."
ls -la
- name: Create Release
run: |
cd hello_gitea
# Create release using Gitea API
echo "Creating release..."
curl -X POST \
-H "Authorization: token ${{ secrets.GITEATOKEN }}" \
-H "Content-Type: application/json" \
-d '{
"tag_name": "${{ github.ref_name }}",
"name": "Release ${{ github.ref_name }}",
"body": "Automated release with multi-platform binaries and Docker image",
"draft": false,
"prerelease": false
}' \
"https://direct-dev.ru/gitea/api/v1/repos/GiteaAdmin/hello_gitea/releases"
echo "Getting release id..."
RELEASE_ID=$(curl -s -H "Authorization: token ${{ secrets.GITEATOKEN }}" \
"https://direct-dev.ru/gitea/api/v1/repos/GiteaAdmin/hello_gitea/releases/tags/${{ github.ref_name }}" | \
jq -r '.id')
# Upload all binaries
echo "Uploading assets..."
for file in bin/*.tar.gz; do
echo "Uploading $file..."
curl -X POST \
-H "Authorization: token ${{ secrets.GITEATOKEN }}" \
-H "Content-Type: application/octet-stream" \
--data-binary @$file \
"https://direct-dev.ru/gitea/api/v1/repos/GiteaAdmin/hello_gitea/releases/$RELEASE_ID/assets?name=$(basename $file)"
done
echo "Release created successfully"
create-docker-image: create-docker-image:
runs-on: ubuntu-latest runs-on: ubuntu-latest
# needs: create-release
if: ${{ vars.BUILD_CREATE_DOCKER_IMAGE == 'true' }}
container: container:
image: docker:28.3.2-dind image: docker:28.3.2-dind
steps: steps:
- name: Checkout repository - name: Checkout repository
run: | run: |
# Install git
apk add --no-cache git apk add --no-cache git
echo "=== GitHub Variables ===" echo "=== GitHub Variables ==="
@@ -136,9 +29,9 @@ jobs:
run: | run: |
# Docker is already installed in docker:dind image # Docker is already installed in docker:dind image
docker --version docker --version
echo "Setting up Docker Buildx for multi-platform builds..."
# Setup Docker Buildx for multi-platform builds # Setup Docker Buildx for multi-platform builds
docker buildx create --name go-buildx --use docker buildx create --use
docker buildx inspect --bootstrap docker buildx inspect --bootstrap
- name: Login to Docker Hub - name: Login to Docker Hub
@@ -148,7 +41,6 @@ jobs:
- name: Build multi-platform Docker images - name: Build multi-platform Docker images
run: | run: |
cd hello_gitea cd hello_gitea
echo "Building multi-platform images using buildx..."
# Build multi-platform images using buildx # Build multi-platform images using buildx
docker buildx build \ docker buildx build \
--platform linux/amd64,linux/arm64 \ --platform linux/amd64,linux/arm64 \
@@ -156,35 +48,77 @@ jobs:
--tag ${{ secrets.DOCKERHUB_USERNAME }}/hello-api:latest \ --tag ${{ secrets.DOCKERHUB_USERNAME }}/hello-api:latest \
--push \ --push \
. .
echo "Multi-platform images built successfully"
- name: Remove buildx create-release:
run: |
echo "Removing buildx..."
docker buildx rm go-buildx
update-to-release-branch:
runs-on: ubuntu-latest runs-on: ubuntu-latest
# needs: create-docker-image
if: ${{ vars.BUILD_UPDATE_RELEASE_BRANCH == 'true' }}
container: container:
image: docker:28.3.2-dind # image: golang:1.21
image: ${DOCKERHUB_USERNAME}/my-build-golang-runner:latest
needs: create-docker-image
steps: steps:
- name: Create Release Branch - name: Checkout repository
run: | run: |
apk add --no-cache git
git clone https://oauth2:${{ secrets.GITEATOKEN }}@direct-dev.ru/gitea/GiteaAdmin/hello_gitea.git hello_gitea git clone https://oauth2:${{ secrets.GITEATOKEN }}@direct-dev.ru/gitea/GiteaAdmin/hello_gitea.git hello_gitea
cd hello_gitea cd hello_gitea
git checkout ${{ github.ref }}
git config user.email "info@direct-dev.ru"
git config user.name "Direct-Dev-Robot" - name: Setup Go
run: |
if git ls-remote --heads origin release | grep -q release; then # Install jq for JSON parsing
git checkout release apt-get update && apt-get install -y jq
git pull origin release git --version
else go version
git checkout -b release jq --version
fi
- name: Build all binaries
git reset --hard ${{ github.ref_name }} run: |
git push origin release --force cd hello_gitea
mkdir -p bin
# Build for all platforms
GOOS=linux GOARCH=amd64 go build -o bin/hello-api-linux-amd64 main.go
GOOS=linux GOARCH=arm64 go build -o bin/hello-api-linux-arm64 main.go
GOOS=windows GOARCH=amd64 go build -o bin/hello-api-windows-amd64.exe main.go
GOOS=darwin GOARCH=amd64 go build -o bin/hello-api-darwin-amd64 main.go
GOOS=darwin GOARCH=arm64 go build -o bin/hello-api-darwin-arm64 main.go
# Create archives
cd bin
tar -czf hello-api-linux-amd64.tar.gz hello-api-linux-amd64
tar -czf hello-api-linux-arm64.tar.gz hello-api-linux-arm64
tar -czf hello-api-windows-amd64.tar.gz hello-api-windows-amd64.exe
tar -czf hello-api-darwin-amd64.tar.gz hello-api-darwin-amd64
tar -czf hello-api-darwin-arm64.tar.gz hello-api-darwin-arm64
ls -la
- name: Create Release
run: |
cd hello_gitea
# Create release using Gitea API
curl -X POST \
-H "Authorization: token ${{ secrets.GITEATOKEN }}" \
-H "Content-Type: application/json" \
-d '{
"tag_name": "${{ github.ref_name }}",
"name": "Release ${{ github.ref_name }}",
"body": "Automated release with multi-platform binaries and Docker image",
"draft": false,
"prerelease": false
}' \
"https://direct-dev.ru/gitea/api/v1/repos/GiteaAdmin/hello_gitea/releases"
# Upload assets
RELEASE_ID=$(curl -s -H "Authorization: token ${{ secrets.GITEATOKEN }}" \
"https://direct-dev.ru/gitea/api/v1/repos/GiteaAdmin/hello_gitea/releases/tags/${{ github.ref_name }}" | \
jq -r '.id')
# Upload all binaries
for file in bin/*.tar.gz; do
echo "Uploading $file..."
curl -X POST \
-H "Authorization: token ${{ secrets.GITEATOKEN }}" \
-H "Content-Type: application/octet-stream" \
--data-binary @$file \
"https://direct-dev.ru/gitea/api/v1/repos/GiteaAdmin/hello_gitea/releases/$RELEASE_ID/assets?name=$(basename $file)"
done

View File

@@ -1,4 +1,4 @@
name: Build Builder Docker Image name: Release Build
on: on:
push: push:
tags: tags:
@@ -21,31 +21,26 @@ jobs:
echo "github.sha = ${{ github.sha }}" echo "github.sha = ${{ github.sha }}"
echo "github.repository = ${{ github.repository }}" echo "github.repository = ${{ github.repository }}"
echo "========================" echo "========================"
echo "Cloning..."
git clone https://oauth2:${{ secrets.GITEATOKEN }}@direct-dev.ru/gitea/GiteaAdmin/hello_gitea.git hello_gitea git clone https://oauth2:${{ secrets.GITEATOKEN }}@direct-dev.ru/gitea/GiteaAdmin/hello_gitea.git hello_gitea
cd hello_gitea cd hello_gitea
echo "Checkout to ${{ github.ref }} ..."
git checkout ${{ github.ref }} git checkout ${{ github.ref }}
- name: Setup Docker Buildx - name: Setup Docker Buildx
run: | run: |
# Docker is already installed in docker:dind image # Docker is already installed in docker:dind image
echo "look at docker version"
docker --version docker --version
# Setup Docker Buildx for multi-platform builds # Setup Docker Buildx for multi-platform builds
echo "setup buildx" docker buildx create --use
docker buildx create --name builder-builx --use
docker buildx inspect --bootstrap docker buildx inspect --bootstrap
- name: Login to Docker Hub - name: Login to Docker Hub
run: | run: |
echo "login to docker hub ..."
echo ${{ secrets.DOCKERHUB_TOKEN }} | docker login -u ${{ secrets.DOCKERHUB_USERNAME }} --password-stdin echo ${{ secrets.DOCKERHUB_TOKEN }} | docker login -u ${{ secrets.DOCKERHUB_USERNAME }} --password-stdin
- name: Build multi-platform Docker images - name: Build multi-platform Docker images
run: | run: |
cd hello_gitea cd hello_gitea
echo "Build multi-platform images using buildx ..." # Build multi-platform images using buildx
docker buildx build \ docker buildx build \
--platform linux/amd64,linux/arm64 \ --platform linux/amd64,linux/arm64 \
--tag ${{ secrets.DOCKERHUB_USERNAME }}/my-build-golang-runner:${{ github.ref_name }} \ --tag ${{ secrets.DOCKERHUB_USERNAME }}/my-build-golang-runner:${{ github.ref_name }} \
@@ -54,6 +49,3 @@ jobs:
-f Dockerfile.builder \ -f Dockerfile.builder \
. .
- name: Remove buildx
run: |
docker buildx rm builder-builx

View File

@@ -1,5 +1,5 @@
# Build stage # Build stage
FROM --platform=$BUILDPLATFORM golang:1.24-alpine AS builder FROM --platform=$BUILDPLATFORM golang:1.21-alpine AS builder
# Install git and ca-certificates # Install git and ca-certificates
RUN apk --no-cache add git ca-certificates RUN apk --no-cache add git ca-certificates

View File

@@ -9,18 +9,5 @@ RUN apt-get update && \
jq && \ jq && \
rm -rf /var/lib/apt/lists/* rm -rf /var/lib/apt/lists/*
# Создаем рабочую директорию
WORKDIR /app
# Копируем файлы зависимостей
COPY go.mod go.sum ./
# Предварительно загружаем все зависимости
RUN go mod download && go mod verify
# Устанавливаем переменные окружения
ENV GOPATH=/go
ENV PATH=$PATH:/go/bin:/usr/local/bin
# (Опционально) Можно добавить команду по умолчанию # (Опционально) Можно добавить команду по умолчанию
CMD ["bash"] CMD ["bash"]

250
README.md
View File

@@ -1,15 +1,12 @@
# Hello Gitea API # Hello Gitea API
Современный REST API сервер, построенный на Go с использованием Gin framework и структурированного логирования. Простой REST API сервер, построенный на Go с использованием Gin framework.
## 🚀 Возможности ## 🚀 Возможности
- ✅ REST API с JSON ответами - ✅ REST API с JSON ответами
- ✅ Health check endpoint - ✅ Health check endpoint
- ✅ CORS поддержка - ✅ CORS поддержка
-**Современное структурированное логирование** (Go 1.24+)
-**Настраиваемые уровни и форматы логирования**
-**Системная информация и мониторинг**
- ✅ Мультиплатформенная сборка - ✅ Мультиплатформенная сборка
- ✅ Docker образы для Linux AMD64/ARM64 - ✅ Docker образы для Linux AMD64/ARM64
- ✅ Автоматические релизы через Gitea Actions - ✅ Автоматические релизы через Gitea Actions
@@ -40,8 +37,6 @@ go run main.go
## 🔧 Конфигурация ## 🔧 Конфигурация
### Основные настройки
Сервер запускается на порту 8080 по умолчанию. Можно изменить через переменную окружения: Сервер запускается на порту 8080 по умолчанию. Можно изменить через переменную окружения:
```bash ```bash
@@ -49,98 +44,46 @@ export PORT=3000
./hello-api ./hello-api
``` ```
### Настройка логирования
Приложение поддерживает гибкую настройку логирования через переменные окружения:
#### Уровни логирования (`LOG_LEVEL`)
```bash
# Доступные уровни (по возрастанию важности):
export LOG_LEVEL=DEBUG # Все сообщения
export LOG_LEVEL=INFO # Информационные и выше
export LOG_LEVEL=WARN # Предупреждения и выше
export LOG_LEVEL=ERROR # Только ошибки
```
#### Форматы логирования (`LOG_FORMAT`)
```bash
# JSON формат (по умолчанию) - для production
export LOG_FORMAT=json
# Текстовый формат - для разработки
export LOG_FORMAT=text
```
#### Примеры конфигурации
**Для разработки:**
```bash
export LOG_LEVEL=DEBUG
export LOG_FORMAT=text
export PORT=8080
go run main.go
```
**Для production:**
```bash
export LOG_LEVEL=INFO
export LOG_FORMAT=json
export PORT=8080
./hello-api
```
## 📡 API Endpoints ## 📡 API Endpoints
### GET / ### GET /
Основной endpoint Основной endpoint
**Ответ:** **Ответ:**
```json ```json
{ {
"message": "Hello, World!", "message": "Hello, World!",
"version": "1.0.33" "version": "1.0.0"
} }
``` ```
### GET /healthz ### GET /health
Health check endpoint Health check endpoint
**Ответ:** **Ответ:**
```json ```json
{ {
"status": "ok", "status": "ok",
"version": "1.0.33" "version": "1.0.0"
} }
``` ```
### GET /api/v1/info ### GET /api/v1/info
Информация о сервисе Информация о сервисе
**Ответ:** **Ответ:**
```json ```json
{ {
"service": "hello-api", "service": "hello-api",
"status": "running", "status": "running",
"version": "1.0.33" "version": "1.0.0"
} }
``` ```
### POST /api/v1/echo ### POST /api/v1/echo
Echo endpoint - возвращает отправленное сообщение Echo endpoint - возвращает отправленное сообщение
**Запрос:** **Запрос:**
```json ```json
{ {
"message": "Hello from client!" "message": "Hello from client!"
@@ -148,149 +91,18 @@ Echo endpoint - возвращает отправленное сообщение
``` ```
**Ответ:** **Ответ:**
```json ```json
{ {
"echo": "Hello from client!", "echo": "Hello from client!",
"version": "1.0.33" "version": "1.0.0"
} }
``` ```
### GET /api/v1/config ## 🛠 Разработка
**Новый endpoint** - системная информация и конфигурация
**Ответ:**
```json
{
"version": "1.0.33",
"system_info": {
"go_version": "go1.24.0",
"os": "linux",
"architecture": "amd64",
"num_cpu": 8,
"start_time": "2024-01-15T10:30:45Z"
},
"environment": {
"PATH": "/usr/local/bin:/usr/bin:/bin",
"PORT": "8080",
"LOG_LEVEL": "INFO"
},
"uptime": "2h30m15s"
}
```
### POST /api/v1/log-test
**Новый endpoint** - тестирование уровней логирования
**Запрос:**
```json
{
"level": "debug",
"message": "Test log message"
}
```
**Ответ:**
```json
{
"status": "logged",
"level": "debug",
"message": "Test log message"
}
```
## 📊 Логирование
### Структурированное логирование
Приложение использует современную систему логирования Go 1.24+ (`log/slog`) с поддержкой:
- **Структурированных логов** в JSON и текстовом формате
- **Уровней логирования** (DEBUG, INFO, WARN, ERROR)
- **Контекстной информации** (IP клиента, User-Agent, время запроса)
- **Автоматического форматирования** времени
- **Фильтрации чувствительных данных**
### Примеры логов
#### JSON формат (production)
```json
{
"time": "2024-01-15T10:30:45.123Z",
"level": "INFO",
"msg": "HTTP Request",
"method": "GET",
"path": "/api/v1/config",
"status": 200,
"latency": "1.234ms",
"client_ip": "192.168.1.100",
"user_agent": "curl/7.68.0",
"timestamp": "2024-01-15T10:30:45.123Z"
}
```
#### Текстовый формат (development)
``` text
2024-01-15T10:30:45.123Z INFO HTTP Request method=GET path=/api/v1/config status=200 latency=1.234ms client_ip=192.168.1.100 user_agent="curl/7.68.0"
```
## Основные изменения в README
### 🆕 **Новые разделы:**
1. **Конфигурация логирования** - подробное описание переменных окружения
2. **Форматы логирования** - примеры JSON и текстового формата
3. **Новые API endpoints** - `/api/v1/config` и `/api/v1/log-test`
4. **Безопасность логирования** - фильтрация чувствительных данных
### 📊 **Детальное описание логирования:**
- **Уровни логирования** (DEBUG, INFO, WARN, ERROR)
- **Форматы** (JSON для production, text для разработки)
- **Примеры логов** с реальными данными
- **Контекстная информация** в логах
### 🔧 **Практические примеры:**
- Настройка для разработки и production
- Команды для тестирования
- Отладочные приемы
### 📦 **Улучшенная структура:**
- Четкое разделение возможностей
- Пошаговые инструкции
- Примеры конфигурации
- Команды для тестирования
Теперь README полностью отражает современные возможности приложения с детальным описанием системы логирования! 🎉
### Логируемые события
- **HTTP запросы** с детальной информацией
- **Ошибки приложения** с контекстом
- **Системные события** (запуск, остановка)
- **API вызовы** с параметрами
- **Конфигурационные изменения**
### Безопасность
- **Автоматическая фильтрация** чувствительных переменных окружения
- **Безопасное логирование** без утечки секретов
- **Контролируемые уровни** для разных сред
## Разработка
### Зависимости ### Зависимости
- Go 1.24+ - Go 1.21+
- Gin framework - Gin framework
### Сборка ### Сборка
@@ -316,65 +128,27 @@ GOOS=darwin GOARCH=arm64 go build -o hello-api-darwin-arm64 main.go
### Тестирование ### Тестирование
```bash ```bash
# Запуск сервера с отладочным логированием # Запуск сервера
export LOG_LEVEL=DEBUG
export LOG_FORMAT=text
go run main.go go run main.go
# Тестирование API # Тестирование API
curl http://localhost:8080/ curl http://localhost:8080/
curl http://localhost:8080/healthz curl http://localhost:8080/health
curl http://localhost:8080/api/v1/info curl http://localhost:8080/api/v1/info
curl http://localhost:8080/api/v1/config
# Тестирование echo
curl -X POST http://localhost:8080/api/v1/echo \ curl -X POST http://localhost:8080/api/v1/echo \
-H "Content-Type: application/json" \ -H "Content-Type: application/json" \
-d '{"message":"Hello!"}' -d '{"message":"Hello!"}'
# Тестирование логирования
curl -X POST http://localhost:8080/api/v1/log-test \
-H "Content-Type: application/json" \
-d '{"level": "debug", "message": "Test log message"}'
```
### Отладка
Для детального анализа работы приложения:
```bash
# Включить отладочное логирование
export LOG_LEVEL=DEBUG
export LOG_FORMAT=text
# Запустить приложение
go run main.go
# В другом терминале - мониторинг логов
tail -f /var/log/application.log # если логи в файл
``` ```
## 🚀 CI/CD ## 🚀 CI/CD
При создании тега (например, `v1.1.20`) автоматически: При создании тега (например, `v1.1.0`) автоматически:
1. Собираются бинарники для всех платформ 1. Собираются бинарники для всех платформ
2. Создается Docker образ для Linux AMD64/ARM64 2. Создается Docker образ для Linux AMD64/ARM64
3. Образ публикуется в Docker Hub 3. Образ публикуется в Docker Hub
4. Создается релиз в Gitea с бинарниками 4. Создается релиз в Gitea с бинарниками
Дополнительно `.gitea/workflows/build_build.yaml` предназначен для автоматизации процесса сборки и публикации Docker-образов билдера - то есть образа который будет использоваться в основном процессе сборки и релиза. Этот workflow запускается (триггерится) автоматически при пуше тега, начинающегося с `builder-` (например, `builder-v1.2.3`), в репозиторий на сервере Gitea.
Когда такой тег появляется, workflow выполняет следующие задачи:
- Клонирует репозиторий и переключается на соответствующую версию кода.
- Настраивает окружение для сборки Docker-образов с поддержкой мультиплатформенности (amd64 и arm64).
- Выполняет аутентификацию в Docker Hub.
- Собирает и публикует Docker-образы для разных архитектур (tag DOCKERHUB_USERNAME/my-build-golang-runnerr:builder-v1.2.3 и tag DOCKERHUB_USERNAME/my-build-golang-runner:latest.
- Для сборки используется специальный Dockerfile (`Dockerfile.builder`) для создания образа билдера.
Таким образом, данный файл обеспечивает автоматическую сборку и публикацию артефактов проекта при выпуске новых версий, что упрощает процесс релиза и гарантирует наличие актуальных образов и бинарников для пользователей.
## 📄 Лицензия ## 📄 Лицензия
MIT Licens MIT License

BIN
bin/hello-api-1.0.0 Executable file

Binary file not shown.

View File

@@ -2,7 +2,7 @@
docker buildx build \ docker buildx build \
--platform linux/amd64,linux/arm64 \ --platform linux/amd64,linux/arm64 \
--tag "${DOCKERHUB_USERNAME:-kuznetcovay}"/my-build-golang-runner:latest \ --tag ${DOCKERHUB_USERNAME}/my-build-golang-runner:latest \
--push \ --push \
-f Dockerfile_for_runner_image \ -f Dockerfile_for_runner_image \
. .

File diff suppressed because it is too large Load Diff

2
go.mod
View File

@@ -1,6 +1,6 @@
module direct-dev-ru/hello_gitea module direct-dev-ru/hello_gitea
go 1.24 go 1.21
require github.com/gin-gonic/gin v1.10.1 require github.com/gin-gonic/gin v1.10.1

243
main.go
View File

@@ -1,127 +1,20 @@
package main package main
import ( import (
"context"
"log/slog"
"net/http" "net/http"
"os" "os"
"runtime"
"time"
"github.com/gin-gonic/gin" "github.com/gin-gonic/gin"
) )
const version = "1.0.50" const version = "1.0.0"
// SystemInfo holds system information
type SystemInfo struct {
GoVersion string `json:"go_version"`
OS string `json:"os"`
Architecture string `json:"architecture"`
NumCPU int `json:"num_cpu"`
StartTime string `json:"start_time"`
}
var (
startTime = time.Now()
logger *slog.Logger
)
// setupLogger configures structured logging with different levels for dev/prod
func setupLogger() {
var logLevel slog.Level
var logFormat string
// Determine log level from environment
switch os.Getenv("LOG_LEVEL") {
case "DEBUG":
logLevel = slog.LevelDebug
case "INFO":
logLevel = slog.LevelInfo
case "WARN":
logLevel = slog.LevelWarn
case "ERROR":
logLevel = slog.LevelError
default:
logLevel = slog.LevelInfo
}
// Determine log format from environment
logFormat = os.Getenv("LOG_FORMAT")
if logFormat == "" {
logFormat = "json" // Default to JSON for production
}
// Configure logger based on format
var handler slog.Handler
opts := &slog.HandlerOptions{
Level: logLevel,
AddSource: true,
ReplaceAttr: func(groups []string, a slog.Attr) slog.Attr {
// Customize timestamp format
if a.Key == slog.TimeKey {
return slog.Attr{
Key: slog.TimeKey,
Value: slog.StringValue(a.Value.Time().Format("2006-01-02T15:04:05.000Z07:00")),
}
}
return a
},
}
if logFormat == "text" {
handler = slog.NewTextHandler(os.Stdout, opts)
} else {
handler = slog.NewJSONHandler(os.Stdout, opts)
}
logger = slog.New(handler)
slog.SetDefault(logger)
}
// logMiddleware creates a structured logging middleware for Gin
func logMiddleware() gin.HandlerFunc {
return gin.LoggerWithFormatter(func(param gin.LogFormatterParams) string {
// Create structured log entry
logger.Info("HTTP Request",
"method", param.Method,
"path", param.Path,
"status", param.StatusCode,
"latency", param.Latency,
"client_ip", param.ClientIP,
"user_agent", param.Request.UserAgent(),
"timestamp", param.TimeStamp.Format("2006-01-02T15:04:05.000Z07:00"),
)
return "" // Return empty string as we handle logging ourselves
})
}
// errorLogger logs errors with structured context
func ErrorLogger(err error, context ...any) {
logger.Error("Application Error",
append([]any{"error", err.Error()}, context...)...,
)
}
func main() { func main() {
// Setup structured logging
setupLogger()
logger.Info("Starting application",
"version", version,
"go_version", runtime.Version(),
"os", runtime.GOOS,
"architecture", runtime.GOARCH,
"num_cpu", runtime.NumCPU(),
)
// Set Gin mode // Set Gin mode
gin.SetMode(gin.ReleaseMode) gin.SetMode(gin.ReleaseMode)
// Create router with custom logger // Create router
r := gin.New() r := gin.Default()
r.Use(logMiddleware())
r.Use(gin.Recovery())
// Add middleware for CORS // Add middleware for CORS
r.Use(func(c *gin.Context) { r.Use(func(c *gin.Context) {
@@ -138,8 +31,7 @@ func main() {
}) })
// Health check endpoint // Health check endpoint
r.GET("/healthz", func(c *gin.Context) { r.GET("/health", func(c *gin.Context) {
logger.Debug("Health check requested", "client_ip", c.ClientIP())
c.JSON(http.StatusOK, gin.H{ c.JSON(http.StatusOK, gin.H{
"status": "ok", "status": "ok",
"version": version, "version": version,
@@ -148,10 +40,6 @@ func main() {
// Main endpoint // Main endpoint
r.GET("/", func(c *gin.Context) { r.GET("/", func(c *gin.Context) {
logger.Info("Root endpoint accessed",
"client_ip", c.ClientIP(),
"user_agent", c.Request.UserAgent(),
)
c.JSON(http.StatusOK, gin.H{ c.JSON(http.StatusOK, gin.H{
"message": "Hello, World!", "message": "Hello, World!",
"version": version, "version": version,
@@ -162,7 +50,6 @@ func main() {
api := r.Group("/api/v1") api := r.Group("/api/v1")
{ {
api.GET("/info", func(c *gin.Context) { api.GET("/info", func(c *gin.Context) {
logger.Debug("API info requested", "client_ip", c.ClientIP())
c.JSON(http.StatusOK, gin.H{ c.JSON(http.StatusOK, gin.H{
"service": "hello-api", "service": "hello-api",
"version": version, "version": version,
@@ -176,104 +63,17 @@ func main() {
} }
if err := c.ShouldBindJSON(&request); err != nil { if err := c.ShouldBindJSON(&request); err != nil {
logger.Warn("Invalid JSON in echo request",
"client_ip", c.ClientIP(),
"error", err.Error(),
)
c.JSON(http.StatusBadRequest, gin.H{ c.JSON(http.StatusBadRequest, gin.H{
"error": "Invalid JSON", "error": "Invalid JSON",
}) })
return return
} }
logger.Info("Echo request processed",
"client_ip", c.ClientIP(),
"message_length", len(request.Message),
)
c.JSON(http.StatusOK, gin.H{ c.JSON(http.StatusOK, gin.H{
"echo": request.Message, "echo": request.Message,
"version": version, "version": version,
}) })
}) })
// Configuration endpoint with detailed logging
api.GET("/config", func(c *gin.Context) {
logger.Debug("Configuration requested", "client_ip", c.ClientIP())
systemInfo := SystemInfo{
GoVersion: runtime.Version(),
OS: runtime.GOOS,
Architecture: runtime.GOARCH,
NumCPU: runtime.NumCPU(),
StartTime: startTime.Format(time.RFC3339),
}
// Get environment variables (excluding sensitive ones)
envVars := make(map[string]string)
sensitiveCount := 0
for _, env := range os.Environ() {
// Skip sensitive environment variables
if !isSensitiveEnvVar(env) {
envVars[env] = os.Getenv(env)
} else {
sensitiveCount++
}
}
logger.Info("Configuration accessed",
"client_ip", c.ClientIP(),
"env_vars_count", len(envVars),
"sensitive_vars_filtered", sensitiveCount,
"uptime", time.Since(startTime).String(),
)
c.JSON(http.StatusOK, gin.H{
"version": version,
"system_info": systemInfo,
"environment": envVars,
"uptime": time.Since(startTime).String(),
})
})
// New logging endpoint to test log levels
api.POST("/log-test", func(c *gin.Context) {
var request struct {
Level string `json:"level"`
Message string `json:"message"`
}
if err := c.ShouldBindJSON(&request); err != nil {
logger.Warn("Invalid JSON in log-test request",
"client_ip", c.ClientIP(),
"error", err.Error(),
)
c.JSON(http.StatusBadRequest, gin.H{
"error": "Invalid JSON",
})
return
}
// Log based on requested level
switch request.Level {
case "debug":
logger.Debug(request.Message, "client_ip", c.ClientIP())
case "info":
logger.Info(request.Message, "client_ip", c.ClientIP())
case "warn":
logger.Warn(request.Message, "client_ip", c.ClientIP())
case "error":
logger.Error(request.Message, "client_ip", c.ClientIP())
default:
logger.Info(request.Message, "client_ip", c.ClientIP(), "level", request.Level)
}
c.JSON(http.StatusOK, gin.H{
"status": "logged",
"level": request.Level,
"message": request.Message,
})
})
} }
// Get port from environment or use default // Get port from environment or use default
@@ -282,37 +82,6 @@ func main() {
port = "8080" port = "8080"
} }
// Start server with structured logging // Start server
logger.Info("Server starting", r.Run(":" + port)
"port", port,
"mode", gin.Mode(),
)
ctx := context.Background()
go func() {
// Graceful shutdown handling
<-ctx.Done()
logger.Info("Shutdown signal received, stopping server...")
}()
err := r.Run(":" + port)
if err != nil {
logger.Error("Server failed to start", "error", err.Error())
os.Exit(1)
}
}
// isSensitiveEnvVar checks if an environment variable contains sensitive information
func isSensitiveEnvVar(env string) bool {
sensitivePrefixes := []string{
"PASSWORD", "SECRET", "KEY", "TOKEN", "CREDENTIAL",
"AWS_", "GITHUB_", "DOCKER_", "KUBERNETES_",
}
for _, prefix := range sensitivePrefixes {
if len(env) >= len(prefix) && env[:len(prefix)] == prefix {
return true
}
}
return false
} }

View File

@@ -2,7 +2,7 @@
BIN_DIR=bin BIN_DIR=bin
APP_NAME=hello-api APP_NAME=hello-api
VERSION=1.0.50 VERSION=1.0.0
build: build:
mkdir -p $(BIN_DIR) mkdir -p $(BIN_DIR)
@@ -17,12 +17,9 @@ test:
# Задача для создания релиза # Задача для создания релиза
# Использование: make release VERSION=1.0.25 # Использование: make release VERSION=1.0.25
release: release:
@if [ -z "$(VERSION)" ]; then \ # @if [ -z "$(VERSION)" ]; then \
echo "Ошибка: Необходимо указать версию в формате v1.0.25"; \ # echo "Ошибка: Необходимо указать версию"; \
echo "Использование: make release VERSION=1.0.25"; \ # echo "Использование: make release VERSION=1.0.25"; \
exit 1; \ # exit 1; \
fi # fi
@./scripts/release-interactive.sh $(VERSION) @./scripts/release-interactive.sh $(VERSION)
release-interactive:
@./scripts/release-interactive.sh

View File

@@ -1,21 +0,0 @@
#!/bin/bash
if [ ! -f go.mod ]; then
echo "go.mod not found in current directory"
exit 1
fi
# Проверяем, изменились ли зависимости
if [ ! -f go.sum ] || ! go mod verify >/dev/null 2>&1; then
echo "Dependencies changed, downloading..."
go mod download
fi
# Собираем для указанной платформы
if [ -n "$1" ] && [ -n "$2" ]; then
echo "Building for $1 $2..."
GOOS=$1 GOARCH=$2 go build -o "bin/hello-api-$1-$2" main.go
else
echo "Building for current platform..."
go build -o bin/hello-api main.go
fi

View File

@@ -17,7 +17,7 @@ get_version_interactive() {
echo "" echo ""
# Запрашиваем новую версию # Запрашиваем новую версию
read -r -p "Введите новую версию (формат X.Y.Z): " VERSION read -p "Введите новую версию (формат X.Y.Z): " VERSION
# Проверяем, что версия не пустая # Проверяем, что версия не пустая
if [ -z "$VERSION" ]; then if [ -z "$VERSION" ]; then
@@ -36,11 +36,8 @@ get_version_interactive() {
echo "📝 Подтверждение:" echo "📝 Подтверждение:"
echo " Текущая версия: $CURRENT_VERSION" echo " Текущая версия: $CURRENT_VERSION"
echo " Новая версия: $VERSION" echo " Новая версия: $VERSION"
if [ "$CURRENT_VERSION" == "$VERSION" ]; then
echo "⚠️ Новая версия совпадает с текущей. Возможно будет обновлен тег ..."
fi
echo "" echo ""
read -r -p "Продолжить? (y/N): " CONFIRM read -p "Продолжить? (y/N): " CONFIRM
if [[ ! $CONFIRM =~ ^[Yy]$ ]]; then if [[ ! $CONFIRM =~ ^[Yy]$ ]]; then
echo "❌ Релиз отменен" echo "❌ Релиз отменен"
@@ -71,27 +68,11 @@ if ! git rev-parse --git-dir > /dev/null 2>&1; then
exit 1 exit 1
fi fi
# Проверяем, существует ли уже тег с такой версией # Проверяем, что нет незакоммиченных изменений
if git tag -l "v$VERSION" | grep -q "v$VERSION"; then # if ! git diff-index --quiet HEAD --; then
echo "⚠️ Тег v$VERSION уже существует!" # echo "Ошибка: Есть незакоммиченные изменения. Сначала закоммитьте их."
echo "" # exit 1
read -r -p "Обновить существующий тег? (y/N): " UPDATE_TAG # fi
if [[ ! $UPDATE_TAG =~ ^[Yy]$ ]]; then
echo "❌ Обновление тега отменено"
exit 0
fi
echo "🔄 Обновляем существующий тег..."
# Удаляем локальный тег
git tag -d "v$VERSION" 2>/dev/null || true
# Удаляем удаленный тег
git push origin ":refs/tags/v$VERSION" 2>/dev/null || true
echo "✅ Старый тег удален"
fi
# Обновляем версию в main.go # Обновляем версию в main.go
echo "📝 Обновляем версию в main.go..." echo "📝 Обновляем версию в main.go..."
@@ -111,24 +92,6 @@ fi
echo "✅ Версия обновлена в main.go" echo "✅ Версия обновлена в main.go"
# Обновляем версию в makefile
echo "📝 Обновляем версию в makefile..."
if [[ "$OSTYPE" == "darwin"* ]]; then
# macOS
sed -i '' "s/^VERSION=.*/VERSION=$VERSION/" makefile
else
# Linux
sed -i "s/^VERSION=.*/VERSION=$VERSION/" makefile
fi
# Проверяем, что изменение применилось
if ! grep -q "^VERSION=$VERSION" makefile; then
echo "Ошибка: Не удалось обновить версию в makefile"
exit 1
fi
echo "✅ Версия обновлена в makefile"
# Выполняем git команды # Выполняем git команды
echo "📦 Добавляем изменения в git..." echo "📦 Добавляем изменения в git..."
git add . git add .
@@ -146,7 +109,6 @@ git push --tags
echo "🎉 Релиз v$VERSION успешно завершен!" echo "🎉 Релиз v$VERSION успешно завершен!"
echo "📋 Выполненные действия:" echo "📋 Выполненные действия:"
echo " - Обновлена версия в main.go" echo " - Обновлена версия в main.go"
echo " - Обновлена версия в makefile"
echo " - Создан коммит с сообщением 'Release v$VERSION'" echo " - Создан коммит с сообщением 'Release v$VERSION'"
echo " - Создан тег v$VERSION" echo " - Создан тег v$VERSION"
echo " - Изменения отправлены в удаленный репозиторий" echo " - Изменения отправлены в удаленный репозиторий"

76
scripts/release.sh Executable file
View File

@@ -0,0 +1,76 @@
#!/bin/bash
# Скрипт для автоматизации релиза
# Использование: ./scripts/release.sh <version>
# Пример: ./scripts/release.sh 1.0.25
set -e # Остановить выполнение при ошибке
# Проверка аргументов
if [ $# -eq 0 ]; then
echo "Ошибка: Необходимо указать версию"
echo "Использование: $0 <version>"
echo "Пример: $0 1.0.25"
exit 1
fi
VERSION=$1
# Проверка формата версии (простая проверка)
if [[ ! $VERSION =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
echo "Ошибка: Неверный формат версии. Используйте формат X.Y.Z (например, 1.0.25)"
exit 1
fi
echo "🚀 Начинаем релиз версии v$VERSION..."
# Проверяем, что мы в git репозитории
if ! git rev-parse --git-dir > /dev/null 2>&1; then
echo "Ошибка: Не найден git репозиторий"
exit 1
fi
# Проверяем, что нет незакоммиченных изменений
if ! git diff-index --quiet HEAD --; then
echo "Ошибка: Есть незакоммиченные изменения. Сначала закоммитьте их."
exit 1
fi
# Обновляем версию в main.go
echo "📝 Обновляем версию в main.go..."
if [[ "$OSTYPE" == "darwin"* ]]; then
# macOS
sed -i '' "s/const version = \"[^\"]*\"/const version = \"$VERSION\"/" main.go
else
# Linux
sed -i "s/const version = \"[^\"]*\"/const version = \"$VERSION\"/" main.go
fi
# Проверяем, что изменение применилось
if ! grep -q "const version = \"$VERSION\"" main.go; then
echo "Ошибка: Не удалось обновить версию в main.go"
exit 1
fi
echo "✅ Версия обновлена в main.go"
# Выполняем git команды
echo "📦 Добавляем изменения в git..."
git add .
echo "💾 Создаем коммит..."
git commit -m "Release v$VERSION"
echo "🏷️ Создаем тег..."
git tag -a "v$VERSION" -m "Release v$VERSION"
echo "🚀 Отправляем изменения и теги..."
git push
git push --tags
echo "🎉 Релиз v$VERSION успешно завершен!"
echo "📋 Выполненные действия:"
echo " - Обновлена версия в main.go"
echo " - Создан коммит с сообщением 'Release v$VERSION'"
echo " - Создан тег v$VERSION"
echo " - Изменения отправлены в удаленный репозиторий"