vino/docs/api/vino.md
Kostiantyn Kalynovskyi eda3300093 Add BMH credentials support
With this change there will be only one supported credential per
VINO CR. Since the CR is mounted inside the sushy tools container,
sushy startup script can access these credentials and set up
authentication. This approach allows to get basic functionality
working, in the future, we would probably want to hide these
credentials in a secret so they can't be seen in plain text from
VINO CR.

Change-Id: I4aa2fb1ee1f5633b889acfa901283f5fa51ad2c1
2021-03-01 16:30:21 +00:00

16 KiB

Vino API reference

Packages:

airship.airshipit.org/v1

Package v1 contains API Schema definitions for the airship v1 API group

Resource Types:

    BMCCredentials

    (Appears on: VinoSpec)

    BMCCredentials contain credentials that will be used to create BMH nodes sushy tools will use these credentials as well, to set up authentication

    Field Description
    username
    string
    password
    string

    CPUConfiguration

    (Appears on: VinoSpec)

    CPUConfiguration CPU node configuration

    Field Description
    cpuExclude
    string

    Exclude CPU example 0-4,54-60

    DaemonSetOptions

    (Appears on: VinoSpec)

    DaemonSetOptions be used to spawn vino-builder, libvirt, sushy an

    Field Description
    namespacedName
    NamespacedName
    libvirtImage
    string
    sushyImage
    string
    vinoBuilderImage
    string
    nodeAnnotatorImage
    string

    DiskDrivesTemplate

    (Appears on: NodeSet)

    DiskDrivesTemplate defines disks on the VM

    Field Description
    name
    string
    type
    string
    path
    string
    options
    DiskOptions

    DiskOptions

    (Appears on: DiskDrivesTemplate)

    DiskOptions disk options

    Field Description
    sizeGb
    int
    sparse
    bool

    IPPool

    IPPool is the Schema for the ippools API

    Field Description
    metadata
    Kubernetes meta/v1.ObjectMeta
    Refer to the Kubernetes API documentation for the fields of the metadata field.
    spec
    IPPoolSpec


    subnet
    string
    ranges
    []Range
    allocatedIPs
    []string
    status
    IPPoolStatus

    IPPoolSpec

    (Appears on: IPPool)

    IPPool tracks allocation ranges and statuses within a specific subnet IPv4 or IPv6 subnet. It has a set of ranges of IPs within the subnet from which IPs can be allocated by IPAM, and a set of IPs that are currently allocated already.

    Field Description
    subnet
    string
    ranges
    []Range
    allocatedIPs
    []string

    IPPoolStatus

    (Appears on: IPPool)

    IPPoolStatus defines the observed state of IPPool

    NamespacedName

    (Appears on: DaemonSetOptions, NodeSet)

    NamespacedName to be used to spawn VMs

    Field Description
    name
    string
    namespace
    string

    Network

    (Appears on: VinoSpec)

    Network defines libvirt networks

    Field Description
    name
    string

    Network Parameter defined

    subnet
    string
    allocationStart
    string
    allocationStop
    string
    dns_servers
    []string
    routes
    []VMRoutes

    NetworkInterface

    (Appears on: NodeSet)

    NetworkInterface define interface on the VM

    Field Description
    name
    string

    Define parameter for network interfaces

    type
    string
    network
    string
    mtu
    int
    options
    map[string]string

    NodeSelector

    (Appears on: VinoSpec)

    NodeSelector identifies nodes to create VMs on

    Field Description
    matchLabels
    map[string]string

    Node type needs to specified

    NodeSet

    (Appears on: VinoSpec)

    NodeSet node definitions

    Field Description
    name
    string

    Parameter for Node master or worker-standard

    count
    int
    labels
    VMNodeFlavor
    libvirtTemplate
    NamespacedName
    networkInterfaces
    NetworkInterface
    diskDrives
    DiskDrivesTemplate
    networkDataTemplate
    NamespacedName

    NetworkDataTemplate reference a Secret containing a template key

    Range

    (Appears on: IPPoolSpec)

    Range has (inclusive) bounds within a subnet from which IPs can be allocated

    Field Description
    start
    string
    stop
    string

    VMNodeFlavor

    (Appears on: NodeSet)

    VMNodeFlavor labels for node to be annotated

    Field Description
    vmFlavor
    map[string]string

    VMRoutes

    (Appears on: Network)

    VMRoutes defined

    Field Description
    to
    string
    via
    string

    Vino

    Vino is the Schema for the vinoes API

    Field Description
    metadata
    Kubernetes meta/v1.ObjectMeta
    Refer to the Kubernetes API documentation for the fields of the metadata field.
    spec
    VinoSpec


    nodeSelector
    NodeSelector

    Define nodelabel parameters

    configuration
    CPUConfiguration

    Define CPU configuration

    networks
    []Network

    Define network parameters

    nodes
    []NodeSet

    Define node details

    daemonSetOptions
    DaemonSetOptions

    DaemonSetOptions defines how vino will spawn daemonset on nodes

    vmBridge
    string

    VMBridge defines the single interface name to be used as a bridge for VMs

    bmcCredentials
    BMCCredentials

    BMCCredentials contain credentials that will be used to create BMH nodes sushy tools will use these credentials as well, to set up authentication

    status
    VinoStatus

    VinoSpec

    (Appears on: Vino)

    VinoSpec defines the desired state of Vino

    Field Description
    nodeSelector
    NodeSelector

    Define nodelabel parameters

    configuration
    CPUConfiguration

    Define CPU configuration

    networks
    []Network

    Define network parameters

    nodes
    []NodeSet

    Define node details

    daemonSetOptions
    DaemonSetOptions

    DaemonSetOptions defines how vino will spawn daemonset on nodes

    vmBridge
    string

    VMBridge defines the single interface name to be used as a bridge for VMs

    bmcCredentials
    BMCCredentials

    BMCCredentials contain credentials that will be used to create BMH nodes sushy tools will use these credentials as well, to set up authentication

    VinoStatus

    (Appears on: Vino)

    VinoStatus defines the observed state of Vino

    This page was automatically generated with gen-crd-api-reference-docs