Ошибка push на GitLab: доступ запрещён, диагностика и решения

git push origin main
# [email protected]: Permission denied (publickey).
# fatal: Could not read from remote repository.

# Проверить SSH подключение к GitLab
ssh -T [email protected]
# Welcome to GitLab, @username!  ← успех
# Permission denied (publickey). ← проблема

# Подробная диагностика
ssh -vT [email protected] 2>&1 | head -30

# Создать SSH ключ (если нет)
ssh-keygen -t ed25519 -C "[email protected]"

# Добавить ключ в ssh-agent
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

# Скопировать публичный ключ
cat ~/.ssh/id_ed25519.pub

# Добавить в GitLab
# User Settings → SSH Keys → Add new key
# Вставить ключ, указать срок действия, сохранить

# Проверить
ssh -T [email protected]
# Welcome to GitLab, @username!

git push origin feature/my-changes
# remote: GitLab: You are not allowed to push code to this project.
# ! [remote rejected] feature/my-changes -> feature/my-changes (pre-receive hook declined)

# Или:
# remote: GitLab: You are not allowed to push code to protected branches on this project.

# Запросить повышение роли у Maintainer/Owner:
# Project → Project Settings → Members → ваш аккаунт → изменить роль на Developer

# Если вы Maintainer: изменить роль другому пользователю
# Project → Manage → Members → выбрать пользователя → изменить роль

git push origin main
# remote: GitLab: You are not allowed to push code to protected branches on this project.

# Решение 1: Push в новую ветку и создать MR
git checkout -b feature/my-fix
git push origin feature/my-fix
# Затем создать Merge Request в GitLab

# Решение 2: Изменить настройки защиты (если вы Maintainer/Owner)
# Project → Settings → Repository → Protected Branches
# Найти main → изменить "Allowed to push" на Developer

# Решение 3: Если нужен push с force
git push --force-with-lease origin main
# Только если Maintainer и настройка "Allowed to force push" включена

git push https://gitlab.com/user/project.git
# remote: HTTP Basic: Access denied. The provided password or token is incorrect.
# fatal: Authentication failed

# Создать Personal Access Token в GitLab
# User Settings → Access Tokens → Add new token
# Scope: api (или write_repository для минимальных прав)

# Использовать токен
git push https://gitlab.com/user/project.git
# Username: ваш_логин
# Password: glpat-xxxxxxxxxxxx  ← токен (начинается с glpat-)

# Или вставить токен в URL
git remote set-url origin https://oauth2:[email protected]/user/project.git

# Кешировать учётные данные
git config --global credential.helper store

# Deploy Token: для CI/CD пайплайнов (чтение/запись)
# Project → Settings → Repository → Deploy tokens
# Создать токен с write_repository scope

# Использование deploy token
git clone https://deploy-token-user:[email protected]/user/project.git

# Deploy Key: SSH ключ только для чтения (для деплоя)
# Project → Settings → Repository → Deploy keys
# Добавить публичный SSH ключ

# Deploy keys по умолчанию read-only
# Для push включить: "Grant write permissions to this key"

git push origin main
# remote: The project you were looking for could not be found or you
#   don't have permission to view it.
# fatal: repository 'https://gitlab.com/user/project.git/' not found

# Проверить URL
git remote -v

# Частые причины:
# 1. Проект перенесён или переименован
git remote set-url origin [email protected]:new-group/new-name.git

# 2. Нет доступа к приватному проекту
# Запросить доступ или убедиться что вошли в правильный аккаунт

# 3. Проект в группе
git remote set-url origin [email protected]:group-name/project.git

# 4. Нет доступа к репозиторию в группе
# Group → Manage → Members → добавить себя

# Ошибка: SSL certificate problem
git push
# SSL certificate problem: self signed certificate

# Решение: добавить CA сертификат
git config --global http.sslCAInfo /path/to/ca.crt
# Или добавить хост
git config --global http.https://gitlab.company.com.sslVerify false

# Ошибка: нестандартный SSH порт
# Если GitLab использует порт не 22
git remote set-url origin ssh://[email protected]:2222/user/project.git

# ~/.ssh/config
cat >> ~/.ssh/config << 'EOF'
Host gitlab.company.com
    Port 2222
    IdentityFile ~/.ssh/id_ed25519_work
EOF

# Ошибка: timeout при подключении
# Возможно, порт заблокирован. Попробовать HTTPS
git remote set-url origin https://gitlab.company.com/user/project.git

# Если push отклонён из-за push rules:
# remote: GitLab: Commit message does not follow the pattern.
# remote: GitLab: Author's commit email does not follow the pattern.

# Проверить правила:
# Project → Settings → Repository → Push rules

# Типичные правила:
# - Commit message должен соответствовать паттерну (Jira ID, Conventional Commits)
# - Email автора должен быть корпоративным
# - Запрет push secrets (токены, пароли в коде)
# - Запрет force push

# Шаг 1: Проверить SSH
ssh -T [email protected]

# Шаг 2: Проверить remote URL
git remote -v

# Шаг 3: Проверить роль на проекте
# GitLab UI: Project → Manage → Members → найти себя

# Шаг 4: Проверить защиту ветки
# GitLab UI: Project → Settings → Repository → Protected Branches

# Шаг 5: Включить трассировку
GIT_SSH_COMMAND="ssh -v" git push 2>&1

# Шаг 6: Проверить через API
curl --header "PRIVATE-TOKEN: your_token" \
  "https://gitlab.com/api/v4/projects/user%2Fproject/members/all"