fabric:container-create
Name
fabric:container-create, container-create — creates one or more Fabric Containers
Synopsis
fabric:container-create [
--help
] {[
--parent ParentID
] | [
--url URL
]} [
--proxy-uri ProxyURI
] [
--ensemble-server
] [
--profile ProfileID
] [
--resolver policy
] [
--version Version
] [
--jvm-opts JvmOpts
] {
Name
} [
Number
]
Examples
This command is a generic container create command. It combines the functionality of the
fabric:container-create-child, fabric:container-create-cloud, and fabric:container-create-ssh commands. The type of container that is created, depends on the specified URL.
- Child container
- To create a child container, specify a URL in the following format:
child://ParentName
Where ParentName is the name of the child's parent container. - Cloud container
- To create a cloud container, specify a URL in the following format:
jclouds://ProviderId?imageId=ImageID&locationId=LocationID&group=Group&user=User
For a detailed explanation of the options appearing in this URL, see fabric:container-create-cloud. - SSH container
- To create an SSH container with username and password credentials, specify a URL in the following format:
ssh://User:Password@Host:Port
Where User and Password are the credentials for logging in to the machine at Host:Port, through the SSH protocol.To create an SSH container with username and private key credentials, specify a URL in the following format:ssh://User@Host:Port?privateKeyFile=KeyPath
Where KeyPath is the pathname of the private key file on the local filesystem.
Arguments
Table 8.8, “fabric:container-create Arguments” describes the command's arguments.
| Argument | Interpretation |
|---|---|
--help | Displays the online help for this command |
--parent | Specifies the parent container's ID. |
--url | Specifies the URL of the new container. |
--proxy-uri | Specifies the Maven proxy URI to use. |
--ensemble-server | Specifies if the new container should be a Fabric Server. |
--profile | Specifies a list of profiles to deploy into the new container. |
--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. |
--version | Specifies the version of the profiles used by the new container. Defaults to the current default version. |
--jvm-opts | Specifies options to pass to the container's JVM. |
Name | Specifies the name of the new container. When creating multiple containers, the name serves as a prefix. |
Number | Specifies the number of containers that should be created. |
