As of JENKINS-28689 there is a Workflow step binding the agent. This survives Jenkins restarts in the common case:

      node {
        sshagent('...') {
          sh 'ssh user@host command' // restart Jenkins after connection made
        }
      }
      

      or

      node {
        sshagent('...') {
          sleep 999 // ← restart Jenkins here
          sh 'ssh user@host command'
        }
      }
      

      but in this case

      node {
        sshagent('...') {
          sh '''
      sleep 999 # ← restart Jenkins here
      ssh ...
      '''
        }
      }
      

      the shell script will be launched with one $SSH_AUTH_SOCK; then Jenkins will be restarted, killing the agent server; then after restart a new server will be started with a new socket address, defining a new $SSH_AUTH_SOCK for subsequent forked processes, yet the existing scripts continues to run and when ssh is launched it will fail to connect to the old server and die.

      The solution for this problem would be to reuse a socket address across restarts.

      Another even less common case would be

      node {
        sshagent('...') {
          sh '''
      sleep 999
      # ← restart Jenkins here
      ssh ...
      '''
        }
      }
      

      where the request to use the private key happens to come while Jenkins is restarting. That can only be solved by forking an external process for the agent server so that it survives the loss of the slave agent.

      A related issue is that the current implementation will probably not survive a disconnection and reconnection of the slave agent with the Jenkins master still running, since it relies on onResume and lacks a ComputerListener. The forked agent approach would of course address that as well.

          [JENKINS-29810] ssagent step to survive Jenkins restarts

          Jesse Glick created issue -
          Jesse Glick made changes -
          Link New: This issue is blocking JENKINS-28689 [ JENKINS-28689 ]
          Manuel Recena Soto made changes -
          Assignee New: Manuel Recena Soto [ recena ]
          Jesse Glick made changes -
          Epic Link New: JENKINS-35399 [ 171192 ]
          R. Tyler Croy made changes -
          Workflow Original: JNJira [ 164886 ] New: JNJira + In-Review [ 181724 ]
          Andrew Bayer made changes -
          Labels Original: workflow New: pipeline workflow
          Andrew Bayer made changes -
          Labels Original: pipeline workflow New: pipeline
          Jesse Glick made changes -
          Link New: This issue depends on JENKINS-36997 [ JENKINS-36997 ]
          Jesse Glick made changes -
          Summary Original: Agent which can survive Jenkins restarts New: ssagent step to survive Jenkins restarts
          Jesse Glick made changes -
          Assignee Original: Manuel Recena Soto [ recena ]

            Unassigned Unassigned
            jglick Jesse Glick
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated: