Skip to content

sourcetoad/ssh-socket-action

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SSH Socket Setup GitHub Action

Set up (or re-use) an SSH socket with a private key.

Usage

Inputs

Following inputs can be used as step.with keys

Name Required Type Description
host Yes String Remote hostname.
port No Number SSH Port (default: 22).
socket-path No String Path at which to create socket.
key Yes String base64 private key
lifetime No Number Seconds to keep key (default: 600)
purge-entry No Boolean Purge known_hosts entry for host (default: true)

You may encode your private key in base64 via:

openssl base64 -in {PRIVATE_KEY_FILE} -out {OUTPUT_PRIVATE_KEY_FILE}

Store that in GitHub Secrets to securely pass to the action.

Outputs

Name Description
socket-path Path at which socket was created
agent-pid SSH Agent PID.

Example usage

- name: SSH Socket Setup
  id: ssh-socket-action
  uses: sourcetoad/ssh-socket-action@v1
  with:
      host: github.com
      port: 22 # optional
      socket-path: /tmp/ssh_agent.sock # optional
      key: ${{ secrets.BASE64_SECRET_KEY }}

- name: Use SSH socket
  run: ls -l "${{ steps.ssh-socket-action.outputs.socket-path }}"

Development

Install package dependencies:

yarn install

Build dist/index.js:

ncc build index.js

Install as Local Action

For quicker troubleshooting cycles, the action can be copied directly into another project. This way, changes to the action and it's usage can happen simultaneously, in one commit.

  1. Copy this repository into your other project as .github/actions/ssh-socket-action. Be careful: simply cloning in place will likely install it as a submodule--make sure to copy the files without .git
  2. In your other project's workflow, in the action step, set
    uses: ./.github/actions/ssh-socket-action
  3. When making changes to the local action, make sure to rebuild dist and commit it