ams.amc launch¶
Launch an instance
Synopsis¶
Launch an instance.
When you launch an instance, you can:
Enable graphics support with the ‘–enable-graphics’ flag.
Specify the application version to launch with the ‘–version’ flag.
Enable addons with the ‘–addons’ flag.
Enable access to the instance with the ‘–service’ flag.
Pass user date to the instance with the ‘–userdata’ or ‘–userdata-path’ flags.
See https://anbox-cloud.io/docs/exp/instances and https://anbox-cloud.io/docs/howto/instance/launch for detailed information about instances.
ams.amc launch ( <app_id> | <image_id> ) [flags]
Examples¶
$ amc launch foo --enable-graphics
$ amc launch foo --version 2
$ amc launch foo --enable-graphics --userdata '{"display_width":1920, "display_height":1080, "fps": 60}'
$ amc launch foo --service tcp:8080 --service tcp,udp:9000-9100 --addons bar --raw
Options¶
-a, --addons string Comma-separated list of addons to install in the instance (raw instances only)
-c, --cpus int Number of CPU cores to be assigned for the instance (for example, 2). If not specified, the number of CPU cores specified by the instance type will be used. (default 2)
--devmode Enable developer mode for the instance (default disabled)
--disable-watchdog Disable watchdog for the instance (regular instances only)
-d, --disk-size string Disk size of the instance (for example, 5GB). If not specified, the disk size specified by the instance type will be used.
--display-density int Pixel density of the virtual display of the instance (default 240)
--display-size string Size of the virtual display of the instance in the format <width>x<height> (default "1280x720")
--enable-graphics Enable graphics for the instance (default: disabled)
--enable-streaming Enable streaming for the instance (default: disabled)
-f, --features string Comma-separated list of features to enable for the Anbox runtime inside the instance
--fps int Frame rate the virtual display of the instance (default 60)
-g, --gpu-slots int Number of GPU slots to be assigned for the instance (for example, 1). If not specified, the number of GPU slots specified by the instance type will be used. (default -1)
-h, --help help for launch
-m, --memory string Memory to be assigned for the instance (for example, 3GB). If not specified, the memory specified by the instance type will be used.
--metrics-server string Metrics server to which the instance sends its data
--name string Name of the instance. Must be unique
--no-wait Don't wait for the instance to start before returning (default: disabled)
-n, --node string LXD node to use for creating the instance
-p, --platform string Anbox platform to use
-r, --raw If specified, create a raw instance for the specified image instead of an application instance
-s, --service stringArray Services to expose on the instance IP endpoint for external access (public or private)
--tags string Comma-separated list of tags to set for the instance
-t, --timeout string Maximum time to wait for the operation to complete (default "5m")
--userdata string String with additional user data to be pushed into the created instance
--userdata-path string Path to a file with additional user data to be pushed into the created instance
--version int Specific version of an application or image to use when creating an instance (default -1)
--vm Create a virtual machine instead of a container (default: disabled)
-v, --vpu-slots int Number of VPU slots to be assigned for the instance (for example, 1). If not specified, the number of VPU slots specified by the instance type will be used. (default -1)
SEE ALSO¶
ams.amc - Anbox Management Client