Release v1.0.50

.build.conditions

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

.gitea/workflows/build.yaml

@@ -1,14 +1,24 @@
-name: Release Build
+name: Conditional Release Build
 on:
   push:
     tags:
       - v*
 
 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: golang:1.21
       image: ${{ secrets.DOCKERHUB_USERNAME }}/my-build-golang-runner:latest
     steps:
       - name: Checkout repository
@@ -19,8 +29,6 @@ jobs:
 
       - name: Setup Go
         run: |
-          # Install jq for JSON parsing
-          # apt-get update && apt-get install -y jq
           git --version
           go version
           jq --version
@@ -28,36 +36,51 @@ jobs:
       - 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
-          quick-build linux amd64
-          quick-build linux arm64
-          quick-build windows amd64
-          quick-build darwin amd64
-          quick-build darwin arm64
-
-          # Build 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" \
@@ -70,12 +93,13 @@ jobs:
             }' \
             "https://direct-dev.ru/gitea/api/v1/repos/GiteaAdmin/hello_gitea/releases"
 
-          # Upload assets
+          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 \
@@ -85,15 +109,17 @@ jobs:
               "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:
     runs-on: ubuntu-latest
+    # needs: create-release
+    if: ${{ vars.BUILD_CREATE_DOCKER_IMAGE == 'true' }}
     container:
       image: docker:28.3.2-dind
-    needs: create-release
     steps:
       - name: Checkout repository
         run: |
-          # Install git
           apk add --no-cache git
           
           echo "=== GitHub Variables ==="
@@ -110,7 +136,7 @@ jobs:
         run: |
           # Docker is already installed in docker:dind image
           docker --version
-
+          echo "Setting up Docker Buildx for multi-platform builds..."
           # Setup Docker Buildx for multi-platform builds
           docker buildx create --name go-buildx --use
           docker buildx inspect --bootstrap
@@ -122,6 +148,7 @@ jobs:
       - name: Build multi-platform Docker images
         run: |
           cd hello_gitea
+          echo "Building multi-platform images using buildx..."
           # Build multi-platform images using buildx
           docker buildx build \
             --platform linux/amd64,linux/arm64 \
@@ -129,53 +156,35 @@ jobs:
             --tag ${{ secrets.DOCKERHUB_USERNAME }}/hello-api:latest \
             --push \
             .
+          echo "Multi-platform images built successfully"
+
       - name: Remove buildx
         run: |
+          echo "Removing buildx..."
           docker buildx rm go-buildx
 
   update-to-release-branch:
     runs-on: ubuntu-latest
+    # needs: create-docker-image
+    if: ${{ vars.BUILD_UPDATE_RELEASE_BRANCH == 'true' }}
     container:
       image: docker:28.3.2-dind
-    needs: create-docker-image
     steps:
       - name: Create Release Branch
         run: |
-          echo "=== GitHub Variables ==="
-          echo "github.ref = ${{ github.ref }}"
-          echo "github.ref_name = ${{ github.ref_name }}"
-          echo "github.sha = ${{ github.sha }}"
-          echo "github.repository = ${{ github.repository }}"
-          echo "DOCKERHUB_USERNAME = ${{ secrets.DOCKERHUB_USERNAME }}"
-          echo "DOCKERHUB_TOKEN = ${{ secrets.DOCKERHUB_TOKEN }}"
-          echo "GITEATOKEN = ${{ secrets.GITEATOKEN }}"
-          echo "========================"
-          # Clone repository
-          echo "Cloning repository..."
+          apk add --no-cache git
           git clone https://oauth2:${{ secrets.GITEATOKEN }}@direct-dev.ru/gitea/GiteaAdmin/hello_gitea.git hello_gitea
           cd hello_gitea
           
-          # Configure git
-          echo "Configuring git..."
           git config user.email "info@direct-dev.ru"
           git config user.name "Direct-Dev-Robot"
           
-          # Check if release branch exists
-          echo "Checking if release branch exists..."
           if git ls-remote --heads origin release | grep -q release; then
-            echo "Release branch exists, checking out..."
             git checkout release
-            echo "release branch exists - pulling release branch..."
             git pull origin release
           else
-            echo "release branch does not exist - creating new release branch..."
             git checkout -b release
           fi
           
-          # Reset to the tag commit
-          echo "Resetting to the tag commit ${{ github.ref_name }} ..."
           git reset --hard ${{ github.ref_name }}
-          
-          # Push changes to release branch
-          echo "Pushing changes to release branch..."
           git push origin release --force

Dockerfile

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

Dockerfile.builder

@@ -18,12 +18,6 @@ COPY go.mod go.sum ./
 # Предварительно загружаем все зависимости
 RUN go mod download && go mod verify
 
-# Создаем скрипт для быстрой сборки
-COPY scripts/quick-build.sh /usr/local/bin/quick-build
-
-# делаем скрипт исполняемым
-RUN chmod +x /usr/local/bin/quick-build
-
 # Устанавливаем переменные окружения
 ENV GOPATH=/go
 ENV PATH=$PATH:/go/bin:/usr/local/bin    

README.md

@@ -1,12 +1,15 @@
 # Hello Gitea API
 
-Простой REST API сервер, построенный на Go с использованием Gin framework.
+Современный REST API сервер, построенный на Go с использованием Gin framework и структурированного логирования.
 
 ## 🚀 Возможности
 
 - ✅ REST API с JSON ответами
 - ✅ Health check endpoint
 - ✅ CORS поддержка
+- ✅ **Современное структурированное логирование** (Go 1.24+)
+- ✅ **Настраиваемые уровни и форматы логирования**
+- ✅ **Системная информация и мониторинг**
 - ✅ Мультиплатформенная сборка
 - ✅ Docker образы для Linux AMD64/ARM64
 - ✅ Автоматические релизы через Gitea Actions
@@ -37,6 +40,8 @@ go run main.go
 
 ## 🔧 Конфигурация
 
+### Основные настройки
+
 Сервер запускается на порту 8080 по умолчанию. Можно изменить через переменную окружения:
 
 ```bash
@@ -44,46 +49,98 @@ export PORT=3000
 ./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
 
 ### GET /
+
 Основной endpoint
 
 **Ответ:**
+
 ```json
 {
   "message": "Hello, World!",
-  "version": "1.0.0"
+  "version": "1.0.33"
 }
 ```
 
 ### GET /healthz
+
 Health check endpoint
 
 **Ответ:**
+
 ```json
 {
   "status": "ok",
-  "version": "1.0.0"
+  "version": "1.0.33"
 }
 ```
 
 ### GET /api/v1/info
+
 Информация о сервисе
 
 **Ответ:**
+
 ```json
 {
   "service": "hello-api",
   "status": "running",
-  "version": "1.0.0"
+  "version": "1.0.33"
 }
 ```
 
 ### POST /api/v1/echo
+
 Echo endpoint - возвращает отправленное сообщение
 
 **Запрос:**
+
 ```json
 {
   "message": "Hello from client!"
@@ -91,18 +148,149 @@ Echo endpoint - возвращает отправленное сообщение
 ```
 
 **Ответ:**
+
 ```json
 {
   "echo": "Hello from client!",
-  "version": "1.0.0"
+  "version": "1.0.33"
 }
 ```
 
-## 🛠 Разработка
+### 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.21+
+- Go 1.24+
 - Gin framework
 
 ### Сборка
@@ -128,16 +316,42 @@ GOOS=darwin GOARCH=arm64 go build -o hello-api-darwin-arm64 main.go
 ### Тестирование
 
 ```bash
-# Запуск сервера
+# Запуск сервера с отладочным логированием
+export LOG_LEVEL=DEBUG
+export LOG_FORMAT=text
 go run main.go
 
 # Тестирование API
 curl http://localhost:8080/
 curl http://localhost:8080/healthz
 curl http://localhost:8080/api/v1/info
+curl http://localhost:8080/api/v1/config
+
+# Тестирование echo
 curl -X POST http://localhost:8080/api/v1/echo \
   -H "Content-Type: application/json" \
   -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
@@ -161,8 +375,6 @@ curl -X POST http://localhost:8080/api/v1/echo \
 
 Таким образом, данный файл обеспечивает автоматическую сборку и публикацию артефактов проекта при выпуске новых версий, что упрощает процесс релиза и гарантирует наличие актуальных образов и бинарников для пользователей.
 
-
-
 ## 📄 Лицензия
 
-MIT License
+MIT Licens

docs/gitea-actions-guide.md

@@ -1,6 +1,7 @@
 # Настройка Gitea Actions для Go проекта: Полное руководство
 
 ```metadata
+id: 4
 readTime: 15-20 минут  
 date: 2025-07-27 18:00  
 author: Direct-Dev(aka Антон Кузнецов)  
@@ -27,7 +28,7 @@ C. [Настройка Gitea Runner в LXC контейнере](#настрой
 
 Gitea Actions — это встроенная система непрерывной интеграции и развертывания (CI/CD) в Gitea, которая позволяет автоматизировать процессы сборки, тестирования и развертывания ваших проектов. Большой плюс этой системы в том, что она достаточна не требовательна к ресурсам и может быть развернута в собственном изолированном окружении.
 
-В этой статье мы рассмотрим пример работы с данной системой, на примере того как настроить Gitea Actions для Go проекта с автоматической сборкой мультиплатформенных бинарников, созданием Docker образов и публикацией релизов.
+В этой статье мы рассмотрим как работать с данной системой, на примере настройки Gitea Actions для Go проекта с автоматической сборкой мультиплатформенных бинарников, созданием Docker образов и публикацией релизов.
 
 ### Итак, что мы будем делать
 
@@ -35,6 +36,7 @@ Gitea Actions — это встроенная система непрерывн
 - Создадим Docker образы для Linux AMD64 и ARM64
 - Настроим публикацию в Docker Hub
 - Автоматизируем создание релизов с бинарниками
+- Сделаем коммит в отдельную ветку - которую можно связать с CD системой (flux/ArgoCD)
 - Настроим триггеры на основе Git тегов
 
 ## Подготовка проекта
@@ -45,15 +47,18 @@ Gitea Actions — это встроенная система непрерывн
 
 ``` text
 hello_gitea/
-├── main.go              # Основной код приложения
-├── go.mod               # Зависимости Go
-├── go.sum               # Хеши зависимостей
-├── Dockerfile           # Docker образ
-├── .gitea/              # Конфигурация Gitea Actions
+├── .gitea/                   # Конфигурация Gitea Actions
    └── workflows/
-       └── build.yaml   # Workflow для сборки
-├── README.md            # Документация
-└── .gitignore           # Исключения Git
+       └── build.yaml         # Workflow для сборки
+├── main.go                   # Основной код приложения
+├── go.mod                    # Зависимости Go
+├── go.sum                    # Хеши зависимостей
+├── Dockerfile                # Docker образ
+├── Dockerfile.builder        # Docker образ для образа-билдера проекта
+├── scripts/                  # Вспомогательные скрипты
+   └── release-interactive.sh # Скрипт для пушинга релиза
+├── README.md                 # Документация
+└── .gitignore                # Исключения Git
 ```
 
 ### Анализ кода
@@ -245,6 +250,7 @@ jobs:
     runs-on: ubuntu-latest
     container:
       # image: golang:1.21
+      # image: ${{ secrets.DOCKERHUB_USERNAME }}/my-build-golang-runner:builder-1.0.32
       image: ${{ secrets.DOCKERHUB_USERNAME }}/my-build-golang-runner:latest      
     steps:
       - name: Checkout repository
@@ -264,29 +270,51 @@ jobs:
       - name: Build all binaries
         run: |
           cd hello_gitea
-          mkdir -p bin
 
-          # Build for all platforms
+          # Проверяем, изменились ли зависимости
+          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" \
@@ -299,12 +327,13 @@ jobs:
             }' \
             "https://direct-dev.ru/gitea/api/v1/repos/GiteaAdmin/hello_gitea/releases"
 
-          # Upload assets
+          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 \
@@ -314,6 +343,8 @@ jobs:
               "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:
     runs-on: ubuntu-latest
     container:
@@ -339,9 +370,9 @@ jobs:
         run: |
           # Docker is already installed in docker:dind image
           docker --version
-
+          echo "Setting up Docker Buildx for multi-platform builds..."
           # Setup Docker Buildx for multi-platform builds
-          docker buildx create --use
+          docker buildx create --name go-buildx --use
           docker buildx inspect --bootstrap
 
       - name: Login to Docker Hub
@@ -351,6 +382,7 @@ jobs:
       - name: Build multi-platform Docker images
         run: |
           cd hello_gitea
+          echo "Building multi-platform images using buildx..."
           # Build multi-platform images using buildx
           docker buildx build \
             --platform linux/amd64,linux/arm64 \
@@ -358,6 +390,12 @@ jobs:
             --tag ${{ secrets.DOCKERHUB_USERNAME }}/hello-api:latest \
             --push \
             .
+          echo "Multi-platform images built successfully"
+
+      - name: Remove buildx
+        run: |
+          echo "Removing buildx..."
+          docker buildx rm go-buildx
 
   update-to-release-branch:
     runs-on: ubuntu-latest
@@ -367,6 +405,7 @@ jobs:
     steps:
       - name: Create Release Branch
         run: |
+          echo "Creating release branch..."
           echo "=== GitHub Variables ==="
           echo "github.ref = ${{ github.ref }}"
           echo "github.ref_name = ${{ github.ref_name }}"
@@ -405,6 +444,7 @@ jobs:
           # Push changes to release branch
           echo "Pushing changes to release branch..."
           git push origin release --force
+          echo "Changes pushed to release branch successfully"
 ```
 
 ### Разберемся как работает workflow
@@ -450,6 +490,19 @@ RUN apt-get update && \
     jq && \
     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"]
 ```
@@ -467,7 +520,7 @@ docker buildx build \
     .
 ```
 
-решение рабочее но надо всегда иметь под рукой АРм с buildx или лучше автоматизировать все и сделать задачу для сборки на раннере `.gitea/workflows/build-builder.yaml`
+решение рабочее, но надо всегда иметь под рукой комп с buildx - лучше автоматизировать все и сделать задачу для сборки на раннере `.gitea/workflows/build-builder.yaml`
 
 ```yaml
 name: Build Builder Docker Image

go.mod

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

main.go

@@ -1,21 +1,127 @@
 package main
 
 import (
-	"log"
+	"context"
+	"log/slog"
 	"net/http"
 	"os"
+	"runtime"
+	"time"
 
 	"github.com/gin-gonic/gin"
 )
 
-const version = "1.0.31"
+const version = "1.0.50"
+
+// 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() {
+	// 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
 	gin.SetMode(gin.ReleaseMode)
 
-	// Create router
-	r := gin.Default()
+	// Create router with custom logger
+	r := gin.New()
+	r.Use(logMiddleware())
+	r.Use(gin.Recovery())
 
 	// Add middleware for CORS
 	r.Use(func(c *gin.Context) {
@@ -33,6 +139,7 @@ func main() {
 
 	// Health check endpoint
 	r.GET("/healthz", func(c *gin.Context) {
+		logger.Debug("Health check requested", "client_ip", c.ClientIP())
 		c.JSON(http.StatusOK, gin.H{
 			"status":  "ok",
 			"version": version,
@@ -41,6 +148,10 @@ func main() {
 
 	// Main endpoint
 	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{
 			"message": "Hello, World!",
 			"version": version,
@@ -51,6 +162,7 @@ func main() {
 	api := r.Group("/api/v1")
 	{
 		api.GET("/info", func(c *gin.Context) {
+			logger.Debug("API info requested", "client_ip", c.ClientIP())
 			c.JSON(http.StatusOK, gin.H{
 				"service": "hello-api",
 				"version": version,
@@ -64,17 +176,104 @@ func main() {
 			}
 
 			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{
 					"error": "Invalid JSON",
 				})
 				return
 			}
 
+			logger.Info("Echo request processed",
+				"client_ip", c.ClientIP(),
+				"message_length", len(request.Message),
+			)
+
 			c.JSON(http.StatusOK, gin.H{
 				"echo":    request.Message,
 				"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
@@ -83,9 +282,37 @@ func main() {
 		port = "8080"
 	}
 
-	// Start server
+	// Start server with structured logging
+	logger.Info("Server starting",
+		"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 {
-		log.Fatal(err)
+		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
+}

makefile

@@ -2,7 +2,7 @@
 
 BIN_DIR=bin
 APP_NAME=hello-api
-VERSION=1.0.31
+VERSION=1.0.50
 
 build:
 	mkdir -p $(BIN_DIR)

scripts/quick-build.sh

@@ -13,7 +13,9 @@ fi
 
 # Собираем для указанной платформы
 if [ -n "$1" ] && [ -n "$2" ]; then
-    GOOS=$1 GOARCH=$2 go build -o "hello-api-$1-$2" main.go
+    echo "Building for $1 $2..."
+    GOOS=$1 GOARCH=$2 go build -o "bin/hello-api-$1-$2" main.go
 else
-    go build -o hello-api main.go
+    echo "Building for current platform..."
+    go build -o bin/hello-api main.go
 fi

scripts/release-interactive.sh

@@ -36,6 +36,9 @@ get_version_interactive() {
     echo "📝 Подтверждение:"
     echo "   Текущая версия: $CURRENT_VERSION"
     echo "   Новая версия: $VERSION"
+    if [ "$CURRENT_VERSION" == "$VERSION" ]; then
+        echo "⚠️  Новая версия совпадает с текущей. Возможно будет обновлен тег ..."      
+    fi
     echo ""
     read -r -p "Продолжить? (y/N): " CONFIRM
     
@@ -68,11 +71,27 @@ if ! git rev-parse --git-dir > /dev/null 2>&1; then
     exit 1
 fi
 
-# Проверяем, что нет незакоммиченных изменений
-# if ! git diff-index --quiet HEAD --; then
-#     echo "Ошибка: Есть незакоммиченные изменения. Сначала закоммитьте их."
-#     exit 1
-# fi
+# Проверяем, существует ли уже тег с такой версией
+if git tag -l "v$VERSION" | grep -q "v$VERSION"; then
+    echo "⚠️  Тег v$VERSION уже существует!"
+    echo ""
+    read -r -p "Обновить существующий тег? (y/N): " UPDATE_TAG
+    
+    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
 echo "📝 Обновляем версию в main.go..."