NAME¶

pint - Public-cloud INformation Tracker

SYNOPSIS¶

pint providers [options]

pint image_states [options]

pint provider server_types|regions|images|servers [options]

DESCRIPTION¶

pint A client for the SUSE Public Cloud Information service at https://susepubliccloudinfo.suse.com/v1/ The SUSE Public Cloud Information service provides information about the SUSE maintained and operated update infrastructure as well as the SUSE published guest images in Public Cloud provider frameworks. It also provides the generic metadata information like the list of available providers, image states, server types and regions.

The information service provides a REST API which flows from generic to to specific using the general format as follows:

https://susepubliccloudinfo.suse.com/v1/

<framework>

[<region>]/

<data-selector>/

<data-target>.<format>

For example:

https://susepubliccloudinfo.suse.com/v1/providers.json

Provides list of all providers in JSON format.

https://susepubliccloudinfo.suse.com/v1/images/states.json

Provides list of all image states in JSON format.

https://susepubliccloudinfo.suse.com/v1/amazon/servers/types.json

Provides list of all server types in Amazon Web Service EC2 in JSON format.

https://susepubliccloudinfo.suse.com/v1/amazon/regions.json

Provides list of all known regions in Amazon Web Service EC2 in JSON format.

https://susepubliccloudinfo.suse.com/v1/amazon/servers.json

Provides information about all servers part of the SUSE update infrastructure in Amazon Web Services EC2 in JSON format.

https://susepubliccloudinfo.suse.com/v1/google/images/active.json

Provides information about all the active images in Google Compute images in JSON format.

https://susepubliccloudinfo.suse.com/v1/microsoft/West%20US/images/active.xml

Provides information about all active images in Microsoft Azure in the 'West US' region.

The pint command line client provides a convenience tool to access the information provided by the information service and provides additional filtering capabilities.

ARGUMENTS¶

<framework>

One of the supported cloud frameworks, amazon, google, microsoft or oracle. The <framework> argument specifies for which cloud provider the information should be retrieved.

<data-selector>

One of the supported information types, images or servers. The <data-selector> argument specifies the type of the information of interest. With the images argument information about the SUSE published images in the given framework is retrieved. When the servers argument is provided information about the SUSE operated servers in the SUSE maintained update infrastructure is retrieved.

OPTIONS¶

--active

The active option is only valid when used with the images argument. It provides information about the latest published images. The latest published images are the only images considered active while all images released prior to the current images are considered deprecated even if some of the previously released images may still be available for launch.

--deleted

The deleted option is only valid when used with the images argument. It provides information about deleted images. Deleted images are images that were previously published but have been superceded by newer images and have surpassed the deprecation period of 6 months.

--deprecated

The deprecated option is only valid when used with the images argument. It provides information about images that can still be launched but are considered deprecated. The SUSE deprecation period is 6 months.

--filter

Filter the information based on the given value(s). If the information is to be filtered on more than one entry type provide a comma separated list. The output is a subset of results that match all the filters. The filter option specifies one or more of the valid data entries for the chosen <data-selector> and is a valid option for the images and servers arguments. Name filters ( name, replacementname ) can be partial string matches (~), partial string exclusions (!), or regular expression matches (%). Date filters ( deletedon, deprecatedon, publishedon ) can be less than, equal or greater than a specified date, in the format yyyymmdd. Valid filter values for images are:

deletedon>, deletedon=, deletedon<,

deprecatedon>, deprecatedon=, deprecatedon<,

id=,

name~, name!, name%,

publishedon>, publishedon=, publishedon<,

replacementid=,

replacementname~, replacementname!, replacementname%.

Note that not all filters will be populated for all images in all frameworks.

Valid filter values for servers are:

ip=,

name~. name!. name%.

Note that the name for all update servers (SMT servers) is the same in each cloud framework. For example smt-azure.susecloud.net in the Microsoft Azure Public Cloud framework. The names are not resolvable via DNS lookup. The name for all region servers are the same, regionserver across all cloud frameworks.

-h --help

Print a help message.

--json

Set the output format to JSON format. The option is mutually exclusive with the --xml option. XML is the default output format if neither option is provided.

--region

Specify the region for which the information is supposed to be retrieved. If no information is specified information for all regions in the given framework is retrieved.

--regionserver

The regionserver option is only valid when used with the servers argument. It provides information about the regionservers in the given framework. Region servers are systems operated and maintained by SUSE that associate your instance in the given region with the region local SMT (update) servers.

--smt

The smt option is only valid when used with the servers argument. It provides information about the SMT (update) servers operated and maintained by SUSE.

-v --version

Print the current version of the program

EXAMPLE¶

pint google servers --smt --json

Will provide information about all SMT servers running in Google Compute Engine in JSON format.

pint amazon images --region us-west-2 --active --xml

Will provide information about the active images in Amazon Web Services EC2 in the us-west-2 region (Oregon).

pint microsoft images --active --filter="name~priority"

Will provide information about the active 'priority' images in Microsoft Azure.

AUTHORS¶

Robert Schweikert (rjschwei@suse.com), James Mason (jmason@suse.com)