Initial documentation for the sshkeyshare plugin 33/8933/1
authorAndrew Gauld <ag1282@att.com>
Mon, 28 Aug 2017 14:47:29 +0000 (10:47 -0400)
committerAndrew Gauld <ag1282@att.com>
Mon, 28 Aug 2017 14:48:20 +0000 (10:48 -0400)
Change-Id: I3bdbc12486cf47e6c1ecc326a8f4fbd1aa03c924
Issue-Id: CCSDK-65
Signed-off-by: Andrew Gauld <ag1282@att.com>
sshkeyshare/README.md

index 00ec8cd..5fa7804 100644 (file)
@@ -18,5 +18,39 @@ limitations under the License.
 ============LICENSE_END=========================================================
 -->
 
-# sshkeyshare
-Cloudify plugin for creating ssh keypairs on the fly
+# sshkeyshare plugin
+Cloudify plugin for creating ssh key pairs on the fly
+# Description
+The sshkeyshare Cloudify plugin creates an ssh key pair that can be used,
+by VMs or other containers spun up by a Cloudify blueprint, for establishing
+connections, among them.  The blue print can, for example, provide the
+private key to one VM and the public one to another, as part of their
+initial configuration, to allow the one with the private key to
+automatically connect to the other one, to run commands.
+# Plugin Requirements
+* Python versions
+ * 2.7.x
+
+Note: These requirements apply to the VM where Cloudify Manager itself runs.
+
+Note: Cloudify Manager, itself, requires Pythong 2.7.x (and CentOS 7).
+
+# Types
+## ccsdk.nodes.ssh.keypair
+**Derived From:** cloudify.nodes.Root
+
+**Properties:**
+This type has no properties
+
+**Mapped Operations:**
+* `cloudify.interfaces.lifecycle.create` Creates a new ssh keypair
+using ssh-keygen
+
+**Attributes:**
+* `public` A string containing the public key of the newly created
+keypair.
+* `base64private` A single line base-64 encoded representation of
+the content of the private key file for the newly created keypair.
+
+# Relationships
+This plugin does not define or use any relationships