https://github.com/dyne/shuriken
A tool to throw confs around like a ninja
https://github.com/dyne/shuriken
config server speed ssh
Last synced: about 1 month ago
JSON representation
A tool to throw confs around like a ninja
- Host: GitHub
- URL: https://github.com/dyne/shuriken
- Owner: dyne
- Created: 2017-03-18T23:29:43.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2021-08-30T15:11:33.000Z (almost 5 years ago)
- Last Synced: 2025-01-11T22:22:25.398Z (over 1 year ago)
- Topics: config, server, speed, ssh
- Language: Shell
- Size: 167 KB
- Stars: 2
- Watchers: 5
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Shuriken
*A tool to throw confs around like a ninja*
[](http://www.dyne.org)
## Why another script?
Shuriken is a tool to facilitate the tedious task of copying config files and ssh keys across servers; to do so it follows a very minimalist approach, leveraging the power of script generation directly in the clipboard and ready to paste in a terminal, rather than dealing with file transfers and file permissions.
When a file is imported from stdin, Shuriken detects what it is and imports it into its repository (usually in `~/.shuriken`) where all public keys and configurations are stored.
When an ssh key is exported (from the shuriken repository or an absolute path to a file) Shuriken will prepare a script ready to be pasted in from the clipboard, containing commands to create the user if doesn't exists, copy the ssh key file in place and set the correct permissions.
## Dependencies
Make sure both **zsh** and **xclip** are installed.
## Usage
Create a `~/.shuriken` directory and then a `keys` subdir inside it
```
mkdir -p ~/.shuriken/keys
```
Place the public keys of your friends and colleagues inside it, one file per person with a list of ssh public keys inside, one per line.
Run `shuriken my-friends-name` for any file in `~/.shuriken/keys/my-friends-name.pub` (the .pub extension is mandatory) this will place a script into your clipboard that is ready to be run on the root shell of another server. The script will:
1. create a `my-friends-name` user and its home directory
2. upload the ssh public key of my-friends-name so that he or she can access the account
# License
Copyright (C) 2017 Dyne.org Foundation
Shuriken is designed, written and maintained by Denis Roio
This source code is free software; you can redistribute it and/or
modify it under the terms of the GNU Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.
This source code is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. Please refer
to the GNU Public License for more details.
You should have received a copy of the GNU Public License along with
this source code; if not, write to: Free Software Foundation, Inc.,
675 Mass Ave, Cambridge, MA 02139, USA.