airship/sip
Code Issues Proposed changes
sip/docs/api/sipcluster.md
Drew Walters fe4c9a7221 Add Redfish support to Jump Host service 
This change brings Redfish support to the Jump Host service, enabling
sub-cluster operators to reboot virtual machines in their sub-cluster.
With a Secret containing sub-cluster host information (e.g. BMC
addresses, BMC usernames, BMC password) and a ConfigMap containing a
wrapper script for DMTF's redfishtool, a user in a sub-cluster's Jump
Pod can manage their hosts by executing /sip/scripts/reboot [CMD].

Signed-off-by: Drew Walters <andrew.walters@att.com>
Change-Id: Iff71ad2287cb095ebe92445a4a09771697efa5ee
2021-02-23 14:37:25 +00:00

9.0 KiB
Raw Blame History

SIPCluster API reference

Packages:

airship.airshipit.org/v1

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

Resource Types:

    BMCOpts

    (Appears on: JumpHostService)

    BMCOpts contains options for BMC communication.

    Field Description
    proxy
    bool

    JumpHostService

    (Appears on: SIPClusterServices)

    JumpHostService is an infrastructure service type that represents the sub-cluster jump-host service.

    Field Description
    inline
    SIPClusterService
    bmc
    BMCOpts
    sshkey
    string

    NodeSet

    (Appears on: SIPClusterSpec)

    NodeSet are the the list of Nodes objects workers, or ControlPlane that define expectations for the Tenant Clusters Includes artifacts to associate with each defined namespace Such as : - Roles for the Nodes - Flavor for theh Nodes image - Scheduling expectations - Scale of the group of Nodes

    Field Description
    vmFlavor
    string

    VMFlavor is essentially a Flavor label identifying the type of Node that meets the construction reqirements
    spreadTopology
    SpreadTopology

    PlaceHolder until we define the real expected Implementation Scheduling define constraints that allow the SIP Scheduler to identify the required BMH’s to allow CAPI to build a cluster
    count
    VMCount

    Count defines the scale expectations for the Nodes

    SIPCluster

    SIPCluster is the Schema for the sipclusters API

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

    clusterName
    string

    ClusterName is the name of the cluster to associate machines with
    nodes
    map[./pkg/api/v1.VMRole]./pkg/api/v1.NodeSet

    Nodes defines the set of nodes to schedule for each vm role.
    services
    SIPClusterServices

    Services defines the services that are deployed when a SIPCluster is provisioned.
    status
    SIPClusterStatus

    SIPClusterService

    (Appears on: JumpHostService, SIPClusterServices)

    Field Description
    image
    string
    nodeLabels
    map[string]string
    nodePort
    int
    nodeInterfaceId
    string
    clusterIP
    string

    SIPClusterServices

    (Appears on: SIPClusterSpec)

    SIPClusterServices defines the services that are deployed when a SIPCluster is provisioned.

    Field Description
    loadBalancer
    []SIPClusterService

    LoadBalancer defines the sub-cluster load balancer services.
    auth
    []SIPClusterService

    Auth defines the sub-cluster authentication services.
    jumpHost
    []JumpHostService

    JumpHost defines the sub-cluster jump host services.

    SIPClusterSpec

    (Appears on: SIPCluster)

    SIPClusterSpec defines the desired state of a SIPCluster

    Field Description
    clusterName
    string

    ClusterName is the name of the cluster to associate machines with
    nodes
    map[./pkg/api/v1.VMRole]./pkg/api/v1.NodeSet

    Nodes defines the set of nodes to schedule for each vm role.
    services
    SIPClusterServices

    Services defines the services that are deployed when a SIPCluster is provisioned.

    SIPClusterStatus

    (Appears on: SIPCluster)

    SIPClusterStatus defines the observed state of SIPCluster

    Field Description
    conditions
    []Kubernetes meta/v1.Condition

    SpreadTopology (string alias)

    (Appears on: NodeSet)

    VMCount

    (Appears on: NodeSet)

    VMCount

    Field Description
    active
    int

    INSERT ADDITIONAL STATUS FIELD - define observed state of cluster Important: Run “make” to regenerate code after modifying this file
    standby
    int

    VMRole (string alias)

    VMRole defines the states the provisioner will report the tenant has having.

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