Успешный SSH с рабочего компьютера ничего не говорит о GitLab Runner: у него другой исходящий IP, DNS, сеть и набор файлов. Запустите ручной diagnostic job в том же executor и разделите три этапа: доступность host:port, проверка host key и аутентификация deploy-пользователя.
Не включайте set -x и не печатайте приватный ключ. В журнале нужны hostname, port, имя пользователя, тип executor, ref pipeline и последняя безопасная строка ssh -vvv. Значение CI variable и содержимое credentials никогда не выводятся.
Текст ошибки выбирает следующую проверку
| Ошибка job | Слой | Что проверить |
|---|---|---|
| Connection timed out | Сеть | Firewall, allowlist исходящего IP и маршрут runner |
| Connection refused | Сервис | SSH слушает нужный адрес и port |
| Could not resolve hostname | DNS | Имя внутри runner и опечатка variable |
| Host key verification failed | Доверие к серверу | SSH_KNOWN_HOSTS и фактический host key |
| Permission denied publickey | Пользователь и ключ | ssh-agent, authorized_keys и имя deploy user |
| Key error in libcrypto | Формат variable | File variable и завершающий LF |
Ключ принадлежит автоматизации, не сотруднику
- Создайте отдельную пару ключей для конкретного проекта и окружения.
- Публичный ключ добавьте ограниченному deploy-пользователю на сервере.
- Приватную часть сохраните как file type CI/CD variable.
- Ограничьте variable нужным environment и protected refs по модели релиза.
- Подготовьте процедуру ротации и немедленного удаления ключа.
GitLab отдельно отмечает, что file variable сохраняет многострочный формат, а ключ должен заканчиваться переводом строки LF. Если job из merge request не видит protected variable, это не SSH-сбой: сначала проверьте, должен ли этот ref вообще получать production-секрет.
known_hosts закрепляется заранее
Соберите публичный host key сервера по доверенному каналу и сохраните его в SSH_KNOWN_HOSTS. GitLab не рекомендует выполнять ssh-keyscan прямо в CI job: в момент соединения вы ещё не подтвердили, с каким сервером разговариваете. Не лечите ошибку опцией StrictHostKeyChecking=no.
Минимальный job ничего не деплоит
before_script:
- eval "$(ssh-agent -s)"
- chmod 400 "$SSH_PRIVATE_KEY"
- ssh-add "$SSH_PRIVATE_KEY"
- install -m 700 -d ~/.ssh
- cp "$SSH_KNOWN_HOSTS" ~/.ssh/known_hosts
- chmod 644 ~/.ssh/known_hosts
script:
- ssh -o BatchMode=yes deploy@example.test "id"example.test заменяется вашим подтверждённым host, а команда id лишь проверяет non-interactive вход и не меняет сервер. После успеха добавляйте отдельную ограниченную deploy-команду. Если ключ должен разрешать только один скрипт, настройте forced command и права каталога на стороне сервера.
Deploy-пользователь получает минимальные права
Не подключайтесь root и не давайте CI общий sudo без ограничений. Пользователю достаточно читать каталог артефактов, переключать конкретный release или вызывать утверждённый deploy entrypoint. Authorized_keys, ownership и shell проверяются для того же имени пользователя, которое указано в job.
Pipeline проверяется в том же контексте, что release
- Запустить diagnostic job на том же runner и ref, где ломается deploy.
- Подтвердить TCP-доступность host и port без SSH-ключа.
- Проверить host key из file variable и остановиться при несовпадении.
- Выполнить BatchMode-команду без изменения файлов.
- Проверить protected branch или tag, на котором доступна переменная.
- Заменить ключ тестовой ротацией и убедиться, что старый перестал работать.
Для разбора сохраните тип runner, ref, hostname и port, точный класс SSH-ошибки, fingerprint публичного ключа и права deploy-пользователя. Приватный ключ, переменные и полный verbose log с потенциальными секретами передавать нельзя.