Informative Commands

yo compat

Show a compatibility matrix of images and shapes.

Not all images are compatible with all shapes. In fact, the relationship can be quite complex. This command exists mostly to satisfy curiosity. It formats a quite large matrix of official images and shapes, where an “X” is marked if the shape for that row is compatible with the image of that column.

When you select OS and version, Yo will automatically select the image version compatible with your shape, so you should never need to know these details.

usage: yo compat [-h] [--shape SHAPE] [--os OS] [--image IMAGE] [--image-names] [--width WIDTH]

Named Arguments

--shape, -S

shape name or fnmatch(3) pattern: filters shapes in table

Default: “*”

--os

OS name or fnmatch(3) pattern: filters OS in table

Default: “*”

--image

image name or fnmatch(3) pattern to filter by image name (only used when –image-names is specified)

Default: “*”

--image-names

display the image name rather than the OS name

Default: False

--width

Width of column for shape names

Default: 24

yo images

List images available to use for launching an instance.

This lists all official images as well as custom images (created by a user in your tenancy). Yo searches for custom images in the compartments indicated by configuration “yo.instance_compartment_id” (that is, the compartment you create instances within) as well as any value from “yo.image_compartment_ids”.

Custom images will have a “Creator” field, while official images will have this field blank. For official images, there are typically more than one image for a particular “OS” and “version” combination: images get updated with the latest packages regularly. It’s easiest for you to simply specify your desired OS and version in yo launch (or your instance profile) rather than searching for an image name here.

usage: yo images [-h] [--verbose] [os]

Positional Arguments

os

Operating system and version, separated by colon (:)

Named Arguments

--verbose, -v

Print detailed image information

Default: False

yo limits

Display your tenancy & region’s service limits.

usage: yo limits [-h] [--service {compute,block-storage}] [--shape SHAPE]

Named Arguments

--service, -s

Possible choices: compute, block-storage

which service to view limits of

Default: “compute”

--shape, -S

shape to get info about

yo os

List official OS and version combinations.

usage: yo os [-h]

yo shape

Get info about a single shape.

usage: yo shape [-h] shape

Positional Arguments

shape

shape to get info about

yo shapes

List instance shape options.

usage: yo shapes [-h] [--verbose] [--cpu | --disk | --gpu | --availability] [--filter {bm,vm,amd,intel,arm,flex,gpu,disk}]

Named Arguments

--verbose, -v

print detailed shape information

Default: False

--cpu

display detailed CPU information (default)

Default: False

--disk

display detailed disk information

Default: False

--gpu

display detailed gpu information

Default: False

--availability, -a

display availability across domains (long load time)

Default: False

--filter, -f

Possible choices: bm, vm, amd, intel, arm, flex, gpu, disk

filter to shapes with particular features (multiple allowed)