awssh 0.1.7 → 0.1.8
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +54 -4
- data/lib/awssh/version.rb +1 -1
- metadata +1 -1
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 9bf2bc6af45327f88c6e032246ac5e1beb9f1979
|
4
|
+
data.tar.gz: a1805533506765999724bf828d04ad64161e3d13
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 879626d24b5607ece2ece803ff912342fe094716d492fdde96f89fb7c94768e4f2ee4188ea0943f69ab2f373f353f125dfb14fef10f59fb369c76b743228001e
|
7
|
+
data.tar.gz: 39a7216cbe5473ba181f9056a281fc362a4b8fd3ab3914d4be466e4f3d4c8c8d85efc47a65f8f8561b6e64a0161fd8a9c30f947f908a10c820b0f8433ac65e28
|
data/README.md
CHANGED
@@ -13,7 +13,7 @@ Generally, you will install this directly:
|
|
13
13
|
|
14
14
|
$ gem install awssh
|
15
15
|
|
16
|
-
|
16
|
+
or, add this line to your application's Gemfile:
|
17
17
|
|
18
18
|
gem 'awssh'
|
19
19
|
|
@@ -21,6 +21,18 @@ And then execute:
|
|
21
21
|
|
22
22
|
$ bundle
|
23
23
|
|
24
|
+
## Requirement
|
25
|
+
|
26
|
+
The only requirement of the tool is that the Name tag on the instance maps to the DNS record.
|
27
|
+
Generally, `awssh` expects that if the name of the instance is `foo.bar`, then it can
|
28
|
+
connect to the server by appending the domain name as `foo.bar.example.com`.
|
29
|
+
|
30
|
+
If you unset the domain name in the config, it will not append it. As such, if your Name
|
31
|
+
tag maps directly to the DNS name, it will work as well.
|
32
|
+
|
33
|
+
In the future, I might add a templated way for handling hostnames, to allow for
|
34
|
+
more customization in DNS lookup.
|
35
|
+
|
24
36
|
## Usage
|
25
37
|
|
26
38
|
```
|
@@ -49,6 +61,33 @@ Options:
|
|
49
61
|
-u, --user override user setting
|
50
62
|
|
51
63
|
```
|
64
|
+
## Examples
|
65
|
+
Given a list of servers:
|
66
|
+
```
|
67
|
+
web1.staging
|
68
|
+
app1.staging
|
69
|
+
web1.production
|
70
|
+
web2.production
|
71
|
+
app1.production
|
72
|
+
app2.production
|
73
|
+
app3.production
|
74
|
+
```
|
75
|
+
|
76
|
+
Connect to web1.staging
|
77
|
+
```
|
78
|
+
awssh web1 staging #=> web1.staging
|
79
|
+
```
|
80
|
+
|
81
|
+
Connect to all staging servers
|
82
|
+
```
|
83
|
+
awssh -m staging #=> web1.staging, app1.staging
|
84
|
+
```
|
85
|
+
|
86
|
+
Connect to all production servers, except app3.
|
87
|
+
The hat `^` negates a match.
|
88
|
+
```
|
89
|
+
awssh -m production ^app3 #=> web1.production, web2.production, app1.production, app2.production
|
90
|
+
```
|
52
91
|
|
53
92
|
## Config
|
54
93
|
```
|
@@ -64,9 +103,20 @@ cache: "~/.awssh.cache" # cache file location
|
|
64
103
|
expires: 86400 # cache expiration time (in seconds)
|
65
104
|
```
|
66
105
|
|
106
|
+
## Multi SSH
|
107
|
+
|
108
|
+
`csshX` is available on Mac OSX through brew.
|
109
|
+
|
110
|
+
`cssh` is available on linux, through apt or yum.
|
111
|
+
|
112
|
+
If there are other programs like this, please let me know.
|
113
|
+
|
114
|
+
Eventually, I'd like to support the programs with templated commands, to allow
|
115
|
+
for more advanced usage.
|
116
|
+
|
67
117
|
## Caching
|
68
118
|
|
69
|
-
Maintains a simple cache with expiration (default: 1 day)
|
119
|
+
Maintains a simple cache with expiration (default: 1 day).
|
70
120
|
The cache just contains the list of servers' names.
|
71
121
|
You can disable the cache by setting the cache value to false in the config file.
|
72
122
|
|
@@ -74,13 +124,13 @@ You can disable the cache by setting the cache value to false in the config file
|
|
74
124
|
|
75
125
|
To get around using multiple RVM's and still have access to awssh command
|
76
126
|
|
77
|
-
alias awssh='rvm <rvm version> do awssh'
|
127
|
+
`alias awssh='rvm <rvm version> do awssh'`
|
78
128
|
|
79
129
|
When you install awssh into your default ruby, then change to a project ruby,
|
80
130
|
the awssh gem is no longer available. This allows you to use the awssh gem
|
81
131
|
from ruby. Just specify the default rvm version in <rvm verison> above.
|
82
132
|
|
83
|
-
alias awssh='rvm 2.1.2 do awssh'
|
133
|
+
`alias awssh='rvm 2.1.2 do awssh'`
|
84
134
|
|
85
135
|
## Contributing
|
86
136
|
|
data/lib/awssh/version.rb
CHANGED