-
Notifications
You must be signed in to change notification settings - Fork 15
import
import [options] <template> - import a Subutai template
Options:
--token, -t <string token> token to access private templates in global repository
Examples:
subutai import master
subutai import management
subutai import id:73e95ab2-b9f8-4ca9-bbf4-34e22fc6ebfc
subutai import foo@tom:1.0.0
Description:
The import command deploys a Subutai template on a Resource Host. The import algorithm works with both the global template repository and a local directory to provide more flexibility to enable working with published and custom local templates. Official published templates in the global repository have a overriding scope over custom local artifacts if there's any template naming conflict.
A concrete template can be referenced while cloning by specifying its ID
subutai clone id:73e95ab2-b9f8-4ca9-bbf4-34e22fc6ebfc foo
Or a full template reference can be used to always specify a concrete version of a template of a concrete owner,
subutai clone foo@tom:1.0.0 (name@owner:version)
Using the full template reference is preferable since template ID might change
If Internet access is lost, or it is not possible to upload custom templates to the repository, the filesystem path /mnt/lib/lxc/tmpdir/ could be used as local repository; the import sub command checks this directory if a requested published template or the global repository is not available.
Importing example from local:
subutai import {archive_name} --local
The import binding handles security checks to confirm the authenticity and integrity of templates. Besides using strict SSL connections for downloads, it verifies the fingerprint and its checksum for each template: an MD5 hash sum signed with author's GPG key. Import executes different integrity and authenticity checks of the template transparent to the user to protect system integrity from all possible risks related to template data transfers over the network.
The import binding retrieves the latest available template version from repository.
The repository supports public, group private (shared), and private files. Import without specifying a security token can only access public templates.
subutai import management is a special operation which differs from the import of other templates. Besides the usual template deployment operations, "import management" demotes the template, starts its container, transforms the host network, and forwards a few host ports, etc.