Develop

.gitignore

@@ -0,0 +1,66 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+venv/
+ENV/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Node
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+dist/
+dist-ssr/
+*.local
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Logs
+*.log
+logs/
+
+# OS
+Thumbs.db
+
+# Terraform artifacts (infrastructure)
+infrastructure/**/.terraform/
+infrastructure/**/*.tfstate
+infrastructure/**/*.tfstate.*
+infrastructure/**/crash.log
+infrastructure/**/.terraform.lock.hcl
+
+# Terraform secrets (облако)
+infrastructure/**/terraform.tfvars
+infrastructure/**/*.auto.tfvars
+

CI/CHECK_REGISTRY.md

@@ -0,0 +1,124 @@
+# Проверка Container Registry
+
+## Быстрая проверка
+
+### 1. Список реестров
+
+```bash
+yc container registry list
+```
+
+Вывод должен показать ваш реестр с ID (например, `crp50gpc30l3tbd4rtj0`).
+
+### 2. Список образов в реестре
+
+```bash
+# Замените REGISTRY_ID на ваш ID реестра
+yc container image list --registry-id crp50gpc30l3tbd4rtj0
+```
+
+Или по имени реестра:
+
+```bash
+yc container image list --registry-name devops-portfolio
+```
+
+### 3. Детальная информация об образе
+
+```bash
+# По ID образа
+yc container image get --id crpjf10o8ke35dcsh20k
+
+# Или по имени и тегу
+yc container image get --name crp50gpc30l3tbd4rtj0/backend:latest
+```
+
+### 4. Проверка доступа через Docker
+
+**Важно**: Если у вас настроен credential helper для `yc`, нужно либо отключить его, либо использовать другой профиль.
+
+#### Вариант 1: Отключить credential helper для cr.yandex
+
+```bash
+# Проверить текущую конфигурацию
+cat ~/.docker/config.json
+
+# Если есть credential helper для cr.yandex, можно временно отключить его
+# или использовать другой профиль
+```
+
+#### Вариант 2: Использовать IAM токен напрямую
+
+```bash
+# Создать IAM токен
+TOKEN=$(yc iam create-token)
+
+# Логин (может не работать, если включен credential helper)
+echo "$TOKEN" | docker login --username iam --password-stdin cr.yandex
+```
+
+#### Вариант 3: Настроить credential helper правильно
+
+```bash
+# Настроить Docker для работы с Yandex Container Registry
+yc container registry configure-docker
+```
+
+### 5. Проверка pull образа
+
+```bash
+# Попробовать скачать образ
+docker pull cr.yandex/crp50gpc30l3tbd4rtj0/backend:latest
+```
+
+### 6. Проверка push образа
+
+```bash
+# Создать тестовый образ
+docker tag <local-image> cr.yandex/crp50gpc30l3tbd4rtj0/test:latest
+
+# Попробовать загрузить
+docker push cr.yandex/crp50gpc30l3tbd4rtj0/test:latest
+```
+
+## Текущее состояние вашего реестра
+
+- **Registry ID**: `crp50gpc30l3tbd4rtj0`
+- **Registry Name**: `devops-portfolio`
+- **Образы**:
+  - `backend:latest` (59.0 MB)
+  - `frontend:latest` (23.0 MB)
+
+## Проверка прав доступа
+
+```bash
+# Проверить, какие роли назначены вашему аккаунту
+yc container registry list-access-bindings --id crp50gpc30l3tbd4rtj0
+```
+
+## Устранение проблем
+
+### Ошибка: "unauthorized"
+
+1. Проверьте, что IAM токен действителен (не истёк)
+2. Проверьте права доступа к реестру
+3. Убедитесь, что используете правильный Registry ID
+
+### Ошибка: "credential helper"
+
+Если Docker использует credential helper от `yc`, можно:
+1. Временно отключить его в `~/.docker/config.json`
+2. Использовать другой профиль: `yc container registry configure-docker --profile <PROFILE>`
+3. Использовать переменные окружения вместо credential helper
+
+### Проверка токена
+
+```bash
+# Создать новый токен
+yc iam create-token
+
+# Проверить, что токен работает
+yc config set token $(yc iam create-token)
+yc container registry list
+```
+

CI/README.md

@@ -0,0 +1,58 @@
+# CI Scripts
+
+В каталоге собраны вспомогательные скрипты, которые используются для ручного запуска или в GitHub Actions workflow для подготовки артефактов перед Terraform.
+
+> **📋 Перед использованием CI/CD**: Настройте секреты в GitHub согласно инструкции в [SECRETS.md](SECRETS.md)
+
+> **📝 GitHub Actions workflow**: Файл `.github/workflows/ci.yml` содержит конфигурацию автоматического CI/CD пайплайна.
+
+> **🔧 Проблемы?**: См. [TROUBLESHOOTING.md](TROUBLESHOOTING.md) для решения частых проблем.
+
+## `build_backend.sh`
+
+Собирает backend-образ и публикует его в Yandex Container Registry.
+
+Переменные окружения (обязательные):
+
+| Переменная        | Описание |
+|-------------------|----------|
+| `REGISTRY_ID`     | ID Container Registry (например, `crp50gpc30l3tbd4rtj0`). |
+| `IMAGE_TAG`       | Тег образа (`latest`, `dev`, `$CI_COMMIT_SHORT_SHA`). |
+| `YC_OAUTH_TOKEN`  | OAuth/IAM токен, полученный через `yc iam create-token`. |
+
+Пример локального запуска:
+
+```bash
+export REGISTRY_ID=crp50gpc30l3tbd4rtj0
+export IMAGE_TAG=dev
+export YC_OAUTH_TOKEN=$(yc iam create-token)
+./CI/build_backend.sh
+```
+
+В GitHub Actions workflow переменные настраиваются автоматически через секреты (`REGISTRY_ID`, `YC_OAUTH_TOKEN`). `IMAGE_TAG` по умолчанию использует `${{ github.sha }}` (полный хеш коммита).
+
+## `build_frontend.sh`
+
+Собирает React/Vite фронтенд и выгружает готовый `dist/` в Object Storage (Yandex S3).
+
+Переменные окружения (обязательные):
+
+| Переменная              | Описание |
+|-------------------------|----------|
+| `STATIC_BUCKET_NAME`    | Имя бакета (например, `kulibin-devops-portfolio`). |
+| `API_GATEWAY_ENDPOINT`  | URL API Gateway, который будет подставлен в `VITE_API_BASE_URL`. |
+| `AWS_ACCESS_KEY_ID`     | Access key для Object Storage (из Terraform output). |
+| `AWS_SECRET_ACCESS_KEY` | Secret key для Object Storage (из Terraform output). |
+
+Пример запуска:
+
+```bash
+export STATIC_BUCKET_NAME=kulibin-devops-portfolio
+export API_GATEWAY_ENDPOINT=https://d5dm4d9170q82do7f5m8.lievo6ut.apigw.yandexcloud.net
+export AWS_ACCESS_KEY_ID=$(terraform -chdir=infrastructure/serverless output -raw static_site_access_key)
+export AWS_SECRET_ACCESS_KEY=$(terraform -chdir=infrastructure/serverless output -raw static_site_secret_key)
+./CI/build_frontend.sh
+```
+
+В GitHub Actions workflow переменные (`STATIC_BUCKET_NAME`, `API_GATEWAY_ENDPOINT`, `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`) автоматически извлекаются из Terraform outputs. Скрипт выполняет `npm ci`, `npm run build` и `yc storage s3 cp --recursive dist/ ...`.
+