airship/vino
Code Issues Proposed changes
vino/docs/api/vino.md
Matt McEuen e4d8d7d23b Make IPAM idempotent 
This makes IPAM functionality idempotent, so that is plays nicely
with the fact that the vino controller will frequently be reconciling
the input CRs that trigger IP assignment.  With this change, IPAM
will remember who asked for an IP already, and will give the same
IP back if asked again.

Change-Id: I7c6b99c2e087178a04d13bafe87909279994e26b
2021-03-04 14:47:40 -06:00

17 KiB
Raw Blame History

Vino API reference

Packages:

airship.airshipit.org/v1

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

Resource Types:

    AllocatedIP

    (Appears on: IPPoolSpec)

    AllocatedIP Allocates an IP to an entity

    Field Description
    ip
    string
    allocatedTo
    string

    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
    []AllocatedIP
    status
    IPPoolStatus

    IPPoolSpec

    (Appears on: IPPool)

    IPPoolSpec 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
    []AllocatedIP

    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