aws-ssh-resolver 0.0.2 → 0.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +20 -32
  3. metadata +2 -2
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: f935d670a01180e51698c25ea3ca209884f43556
4
- data.tar.gz: ee1f14a33bcbe6b9ead7babf3fd625d96f3de9c0
3
+ metadata.gz: 48b42c80586cba35d4917fba72f764eba15bdb57
4
+ data.tar.gz: d7fe8b98efb41cd92e415a32e601534e134eafd5
5
5
  SHA512:
6
- metadata.gz: 02580ee44766981ab87b40e4f5f8bdac0cd1ab5e0e1ce3082f393272fac7b144bfa4f9b3c568834d6bb66b40b54f20c698cce7a2b162e737c516bd213fddd5fc
7
- data.tar.gz: 013f95baba3d2fef334144d5995bdc373992b9e6ece6e88287ca2ee2937047c2fc70128ead909c8e50c3e2dedf34f0f2e70a819fa3e0aadad6b6c5d9c37933c9
6
+ metadata.gz: 0ea88291e226d0cd730e7f8ff6a497a97734cfdf4302a7b143708e7095f2be6a8116bb00461f2f457be9f53534b1fda40c14cd6ab812fd78c5b9d77e9b574df0
7
+ data.tar.gz: d7d6ea498c200312ac63aac4fbd0fcfc5e21c796916472e2925181fcd996070715984d8f3cc901848afa686ac0cd93ba208c0b8fe3043ebb63c55b497ad6017f
data/README.md CHANGED
@@ -1,35 +1,21 @@
1
- # aws-ssh-resolver - Resolve AWS EC2 HostNames for OpenSSH configuration - $Release:0.0.2$
1
+ # aws-ssh-resolver - Resolve AWS EC2 HostNames for OpenSSH configuration - $Release:0.0.3$
2
2
 
3
3
  `aws-ssh-resolver` keeps AWS EC2 HostNames in OpenSSH configuration
4
- file in sync with Amazon cloud making it easier for a user to use
5
- OpenSSH, and related tools, on Amazon Platform.
4
+ file in sync with Amazon cloud making it easier for to use OpenSSH,
5
+ and related tools, on Amazon Platform.
6
6
 
7
7
  ## The Problem
8
8
 
9
- Every EC2 instance on Amazon platform has a Private IP address, and a
10
- DNS hostname resolving to this address. Private IP cannot be reached
11
- directly from the Internet, and the Private DNS name can be resolved
12
- only on the network that the instance is in. An instance may be
13
- assigned a Public IP Address, and corresponding Public DNS name. The
14
- Public IP is accessible from the Internet, and the Public DNS name is
15
- resolvable outside the network of the instance. Public IPs come from
16
- Amazon's pool of public IP address, and an instance may not reuse the
17
- IP address, once it is released. For example, stopping, or
18
- terminating, an instance releases the Public IP Address. See Amazon
19
- [documentation](http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-instance-addressing.html)
20
- for more details.
21
-
22
-
23
- Amazon EC2 Instance IP Addressing presents several challenges for SSH
24
- usage, or any SSH related tool e.g.
25
- [ansible](http://www.ansible.com/home),
9
+ [Amazon EC2 Instance IP Addressing](http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-instance-addressing.html)
10
+ sets several challenges for SSH usage, and for any tool using SSH
11
+ connections e.g. [ansible](http://www.ansible.com/home),
26
12
  [fabric](http://www.fabfile.org/),
27
13
  [serverspec](http://serverspec.org/) etc.
28
14
 
29
- * Public DNS Name encodes the Public IP Address. Each time an instance
30
- is assigned a new IP address, it also gets a new Public DNS name, In
31
- essence this means that the task of managing DNS names becomes
32
- comparable to the task of managing IP addresses.
15
+ * Amazon Public DNS Names encode Public IP Addresses. Each time an
16
+ instance is assigned a new IP address, it also gets a new Public DNS
17
+ name. In essence this means that the task of managing DNS names
18
+ becomes comparable to the task of managing IP addresses.
33
19
 
34
20
  * Using an IP address to contact an instance is complicated, because
35
21
  Public IP Address, once released, cannot be reused. Using fixed IP
@@ -62,7 +48,10 @@ addresses the challenges above
62
48
  configuration in OpenSSH allows users to create a transparent
63
49
  multihop SSH connection to EC2 instances with Private IP Address
64
50
  only
65
-
51
+
52
+ For more background information, see
53
+ [blog post](https://jarjuk.wordpress.com/2015/09/08/using-openssh-on-aws-platform/#more-273https://jarjuk.wordpress.com/2015/09/08/using-openssh-on-aws-platform/#more-273).
54
+
66
55
  ## Usage
67
56
 
68
57
  ### Installation
@@ -84,11 +73,10 @@ file `ssh/config.aws` with any fixed configuration. Running
84
73
  **aws-ssh-resolver** updates this file, but does not interfere with
85
74
  the content user has entered.
86
75
 
87
- **Notice**: If `ssh/config.aws` -file does not exist, the first
88
- **aws-ssh-resolver** run creates the initial version of
89
- `ssh/config.aws` automatically using `ssh/config.init`. This avoids
90
- the need to check in the mutable `ssh/config.aws` into a version
91
- nncontrol system.
76
+ **Notice**: The first **aws-ssh-resolver** run creates the initial
77
+ version of `ssh/config.aws` automatically using `ssh/config.init`, if
78
+ `ssh/config.aws` -file does not exist, . This avoids the need to check
79
+ in the mutable `ssh/config.aws` into a version control system.
92
80
 
93
81
  ### Update OpenSSH Configuration file
94
82
 
@@ -98,7 +86,7 @@ command:
98
86
 
99
87
  aws ec2 describe-instances | bundle exec aws-ssh-resolver.rb resolve
100
88
 
101
- The command extract EC2 Tag/DNS information, and writes
89
+ The command extracts EC2 Tag/DNS information, and writes
102
90
  `host`/`HostName` configuration entries in `ssh/config.aws` -file. In
103
91
  this file `host` value is taken from `Name` tag on an EC2 instance,
104
92
  and `HostName` value is taken from `PublicDnsName` on an EC2
@@ -207,7 +195,7 @@ OpenSSH uses the proxy definition to access it.
207
195
 
208
196
  ### Using OpenSSH Configuration to Access ASW Instances
209
197
 
210
- The configuration in `ssh/configaws` allows us to use tag name
198
+ The configuration in `ssh/config.aws` allows us to use tag name
211
199
  `myFront1` to make a SSH connection to machine with the DNS name
212
200
  `c2-52-19-117-227.eu-west-1.compute.amazonaws.com` simply with command
213
201
 
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-ssh-resolver
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.0.2
4
+ version: 0.0.3
5
5
  platform: ruby
6
6
  authors:
7
7
  - jarjuk
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2015-09-07 00:00:00.000000000 Z
11
+ date: 2015-09-10 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: thor