Успешный 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 hostnameDNSИмя внутри runner и опечатка variable
Host key verification failedДоверие к серверуSSH_KNOWN_HOSTS и фактический host key
Permission denied publickeyПользователь и ключssh-agent, authorized_keys и имя deploy user
Key error in libcryptoФормат variableFile 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

  1. Запустить diagnostic job на том же runner и ref, где ломается deploy.
  2. Подтвердить TCP-доступность host и port без SSH-ключа.
  3. Проверить host key из file variable и остановиться при несовпадении.
  4. Выполнить BatchMode-команду без изменения файлов.
  5. Проверить protected branch или tag, на котором доступна переменная.
  6. Заменить ключ тестовой ротацией и убедиться, что старый перестал работать.

Для разбора сохраните тип runner, ref, hostname и port, точный класс SSH-ошибки, fingerprint публичного ключа и права deploy-пользователя. Приватный ключ, переменные и полный verbose log с потенциальными секретами передавать нельзя.

Проверенные источники