Deployment Versions
ubiops deployment_versions¶
Command: ubiops deployment_versions
Alias: ubiops versions
ubiops deployment_versions list¶
Command: ubiops deployment_versions list
Description:
List the versions of a deployment.
The <labels>
option can be used to filter on specific labels.
Arguments: -
Options:
-
[required]
-d
/--deployment_name
The deployment name -
-lb
/--labels
Labels defined as key/value pairs
This option can be provided multiple times in a single command -
-fmt
/--format
The output format
ubiops deployment_versions get¶
Command: ubiops deployment_versions get
Description:
Get the version of a deployment.
If you specify the <output_path>
option, this location will be used to store the deployment version settings in a yaml file. You can either specify the <output_path>
as file or directory. If the specified <output_path>
is a directory, the settings will be stored in version.yaml
.
Example of yaml content:
deployment_name: my-deployment
version_name: my-version
version_description: Version created via command line.
version_labels:
my-key-1: my-label-1
my-key-2: my-label-2
environment: python3-8
instance_type: 2048mb
minimum_instances: 0
maximum_instances: 5
maximum_idle_time: 300
request_retention_mode: none
request_retention_time: 604800
maximum_queue_size_express: 100
maximum_queue_size_batch: 100000
has_request_method: true
has_requests_method: false
static_ip: false
Arguments:
- [required]
version_name
Options:
-
[required]
-d
/--deployment_name
The deployment name -
-o
/--output_path
Path to file or directory to store version yaml file -
-q
/--quiet
Suppress informational messages -
-fmt
/--format
The output format
ubiops deployment_versions create¶
Command: ubiops deployment_versions create
Description:
Create a version of a deployment.
It is possible to define the parameters using a yaml file. For example:
deployment_name: my-deployment-name
version_name: my-deployment-version
version_description: Version created via command line.
version_labels:
my-key-1: my-label-1
my-key-2: my-label-2
environment: python3-8
instance_type: 2048mb
minimum_instances: 0
maximum_instances: 1
maximum_idle_time: 300
request_retention_mode: none
request_retention_time: 604800
maximum_queue_size_express: 100
maximum_queue_size_batch: 100000
static_ip: false
Those parameters can also be provided as command options. If both a <yaml_file>
is set and options are given, the options defined by <yaml_file>
will be overwritten by the specified command options. The version name can either be passed as command argument or specified inside the yaml file using <version_name>
.
Arguments:
version_name
Options:
-
-d
/--deployment_name
The deployment name -
-l
/--language
[DEPRECATED] Programming language of code -
-e
/--environment
Environment for the version -
-inst
/--instance_type
Reserved instance type for the version -
-min
/--minimum_instances
Minimum number of instances -
-max
/--maximum_instances
Maximum number of instances -
-t
/--maximum_idle_time
Maximum idle time before shutting down instance (seconds) -
-dm
/--deployment_mode
[DEPRECATED] The type of the deployment version -
-rtm
/--request_retention_mode
Mode of request retention for requests to the version -
-rtt
/--request_retention_time
Number of seconds to store requests to the version -
-qse
/--maximum_queue_size_express
Maximum number of queued express requests to the version -
-qsb
/--maximum_queue_size_batch
Maximum number of queued batch requests to the version -
--static-ip
Whether the deployment version should get a static IP -
-lb
/--labels
Labels defined as key/value pairs
This option can be provided multiple times in a single command -
-desc
/--version_description
The version description -
-f
/--yaml_file
Path to a yaml file that contains version options -
-deployment_py
/--deployment_file
Name of deployment file which contains class Deployment. Must be located in the root of the deployment package directory -
-fmt
/--format
The output format
ubiops deployment_versions update¶
Command: ubiops deployment_versions update
Description:
Update a version of a deployment.
It is possible to define the parameters using a yaml file. For example:
version_description: Version created via command line.
version_labels:
my-key-1: my-label-1
my-key-2: my-label-2
instance_type: 2048mb
minimum_instances: 0
maximum_instances: 1
maximum_idle_time: 300
request_retention_mode: none
request_retention_time: 604800
maximum_queue_size_express: 100
maximum_queue_size_batch: 100000
static_ip: false
You may want to change some deployment options, like, <maximum_instances>
and <instance_Type>
. You can do this by either providing the options in a yaml file and passing the file path as <yaml_file>
, or passing the options as command options. If both a <yaml_file>
is set and options are given, the options defined by <yaml_file>
will be overwritten by the specified command options.
Arguments:
- [required]
version_name
Options:
-
[required]
-d
/--deployment_name
The deployment name -
-n
/--new_name
The new version name -
-deployment_py
/--deployment_file
Name of deployment file which contains class Deployment. Must be located in the root of the deployment package directory -
-f
/--yaml_file
Path to a yaml file that contains version options -
-e
/--environment
Environment for the version -
-inst
/--instance_type
Reserved instance type for the version -
-min
/--minimum_instances
Minimum number of instances -
-max
/--maximum_instances
Maximum number of instances -
-t
/--maximum_idle_time
Maximum idle time before shutting down instance (seconds) -
-rtm
/--request_retention_mode
Mode of request retention for requests to the version -
-rtt
/--request_retention_time
Number of seconds to store requests to the version -
-qse
/--maximum_queue_size_express
Maximum number of queued express requests to the version -
-qsb
/--maximum_queue_size_batch
Maximum number of queued batch requests to the version -
--static-ip
Whether the deployment version should get a static IP -
-lb
/--labels
Labels defined as key/value pairs
This option can be provided multiple times in a single command -
-desc
/--version_description
The version description -
-q
/--quiet
Suppress informational messages
ubiops deployment_versions delete¶
Command: ubiops deployment_versions delete
Description:
Delete a version of a deployment.
Arguments:
- [required]
version_name
Options:
-
[required]
-d
/--deployment_name
The deployment name -
-y
/--assume_yes
Assume yes instead of asking for confirmation -
-q
/--quiet
Suppress informational messages
ubiops deployment_versions wait¶
Command: ubiops deployment_versions wait
Description:
Wait for a deployment version to be ready.
To wait for a specific revision of the version, pass --revision_id
: ubiops versions wait v1 -d deployment-1 --revision_id=ced676ab-423b-4469-97e7-e5179515affb
Arguments:
- [required]
version_name
Options:
-
[required]
-d
/--deployment_name
The deployment name -
-rid
/--revision_id
The deployment version revision ID -
-t
/--timeout
Timeout in seconds for the operation -
--stream_logs
Stream logs while waiting -
-q
/--quiet
Suppress informational messages