fabric:container-create-ssh
Name
fabric:container-create-ssh — creates one or more new containers through SSH
Synopsis
fabric:container-create-ssh [
--help
] [
--host host
] [
--path path
] [
--user user
] [
--password password
] [
--private-key keyPath
] [
--port port
] [
--ssh-retries retries
] [
--proxy-uri URI
] [
--ensemble-server
] [
--profile profileID
] [
--version version
] [
--jvm-optsjvmOpts
] [
--resolver policy
] {
Name
} [
Number
]
Description
Specifically, this command provisions the container as follows:
- Logs into the specified SSH host, using either the provided username and password or using the provided username and private key.
- Runs a script on the remote host that that downloads the container runtime to the remote host. The runtime files are downloaded through a Maven proxy server. By default, the script uses the oldest Maven proxy server in the current ensemble (every Fabric Server has a Maven proxy server deployed in it). You can optionally override the default Maven proxy by specifying the
--proxy-urioption. The script would then use the specified Maven proxy server to download the container runtime.NoteThe ability to override the Maven proxy is important in certain cases (for example, in a cloud deployment) where the remote host might not be able to access the default Maven proxy server. - Starts up the newly installed container (or containers) and installs the specified fabric profile (or profiles).
By default, the newly created containers belong to the current fabric (that is, the same fabric as the container from which you invoked the command). It is possible, however, to create a container on the remote host that acts as the seed for a completely new fabric, separate from the current one. To create a new fabric on the remote host, invoke the
fabric:container-create-ssh command with the --ensemble-server flag, which makes the newly created container (or containers) a Fuse Server. The newly created Fuse Server on the remote host does not join the current ensemble: it belongs to an independent ensemble (a new fabric).
Arguments
Table 8.11, “fabric:container-create-ssh Arguments” describes the command's arguments.
| Argument | Interpretation |
|---|---|
--help | Displays the online help for this command |
--host | (Required) Host name to SSH into. |
--path | Path on the remote filesystem where the container is to be installed. |
--user | (Required) User name for login. |
--password | Password for login. If the password is omitted, private key authentication is used instead. |
--private-key | Specifies the path to the private key on the local file system. The default is ~/.ssh/id_rsa on *NIX platforms or C:\Documents and Settings\UserName\.ssh\id_rsa on Windows. |
--port | The IP port number for the SSH connection. |
--ssh-retries | Maximum number or times to retry SSH connection. |
--proxy-uri | URL of the Maven proxy server used to download the container runtime. |
--ensemble-server | Whether the new container should be a Fabric Server. |
--profile | A list of profile IDs to associate with the new container. |
--version | Specifies the version of the new container (the version must be created in advance using fabric:version-create). Defaults to the current default version (use version-list to find the current default). |
--jvm-opts | Specify options to pass to the container's JVM. |
--resolver | Specifies how the container will report its address to other containers. Valid values are localip, localhostname, publicip, publichostname, manualip. For more information see fabric:container-resolver-set. |
Name | (Required) The name of the container to create. When creating multiple containers, it serves as a prefix. |
Number | The number of containers that should be created. |
Related topics
For more details about resolver policies, see:
| fabric:container-resolver-list |
| fabric:container-resolver-set |
| fabric:create |
