runtime

Documentation

Overview

Package runtime contains code of all infrastructure runtimes supported by Kusion.

Index

• Constants
• type ApplyRequest
• type ApplyResponse
• type DeleteRequest
• type DeleteResponse
• type KubernetesRuntime
  • func (k *KubernetesRuntime) Apply(ctx context.Context, request *ApplyRequest) *ApplyResponse
  • func (k *KubernetesRuntime) Delete(ctx context.Context, request *DeleteRequest) *DeleteResponse
  • func (k *KubernetesRuntime) Read(ctx context.Context, request *ReadRequest) *ReadResponse
  • func (k *KubernetesRuntime) Watch(ctx context.Context, request *WatchRequest) *WatchResponse
  • func (k *KubernetesRuntime) WatchByRelation(ctx context.Context, cur *unstructured.Unstructured, ...) (<-chan k8swatch.Event, *unstructured.Unstructured, error)
  • func (k *KubernetesRuntime) WatchBySelector(ctx context.Context, o *unstructured.Unstructured, gvk schema.GroupVersionKind, ...) (<-chan k8swatch.Event, error)
• type ReadRequest
• type ReadResponse
• type Runtime
  • func NewKubernetesRuntime() (Runtime, error)
• type WatchRequest
• type WatchResponse

Constants

const (
	Kubernetes models.Type = "Kubernetes"
	Terraform  models.Type = "Terraform"
)

Types

type ApplyRequest

type ApplyRequest struct {
	// PriorResource is the last applied resource saved in state storage
	PriorResource *models.Resource

	// PlanResource is the resource we want to apply in this request
	PlanResource *models.Resource

	// DryRun means this a dry-run request and will not make any changes in actual infra
	DryRun bool
}

type ApplyResponse

type ApplyResponse struct {
	// Resource is the result returned by Runtime
	Resource *models.Resource

	// Status contains messages will show to users
	Status status.Status
}

type DeleteRequest

type DeleteRequest struct {
	// Resource represents the resource we want to delete from the actual infra
	Resource *models.Resource
}

type DeleteResponse

type DeleteResponse struct {
	// Status contains messages will show to users
	Status status.Status
}

type KubernetesRuntime

type KubernetesRuntime struct {
	// contains filtered or unexported fields
}

func (*KubernetesRuntime) Apply

func (k *KubernetesRuntime) Apply(ctx context.Context, request *ApplyRequest) *ApplyResponse

Apply kubernetes Resource by client-go

func (*KubernetesRuntime) Delete

func (k *KubernetesRuntime) Delete(ctx context.Context, request *DeleteRequest) *DeleteResponse

Delete kubernetes Resource by client-go

func (*KubernetesRuntime) Read

func (k *KubernetesRuntime) Read(ctx context.Context, request *ReadRequest) *ReadResponse

Read kubernetes Resource by client-go

func (*KubernetesRuntime) Watch

func (k *KubernetesRuntime) Watch(ctx context.Context, request *WatchRequest) *WatchResponse

Watch kubernetes resource by client-go

func (*KubernetesRuntime) WatchByRelation

func (k *KubernetesRuntime) WatchByRelation(
	ctx context.Context,
	cur *unstructured.Unstructured,
	gvk schema.GroupVersionKind,
	related func(watched, cur *unstructured.Unstructured) bool,
) (<-chan k8swatch.Event, *unstructured.Unstructured, error)

WatchByRelation watched resources by giving gvk if related() return true

func (*KubernetesRuntime) WatchBySelector

func (k *KubernetesRuntime) WatchBySelector(
	ctx context.Context,
	o *unstructured.Unstructured,
	gvk schema.GroupVersionKind,
	labelStr string,
) (<-chan k8swatch.Event, error)

WatchBySelector watch resources by gvk and filter by selector

type ReadRequest

type ReadRequest struct {
	// PriorResource is the last applied resource saved in state storage
	PriorResource *models.Resource

	// PlanResource is the resource we want to apply in this request
	PlanResource *models.Resource
}

type ReadResponse

type ReadResponse struct {
	// Resource is the result read from the actual infra
	Resource *models.Resource

	// Status contains messages will show to users
	Status status.Status
}

type Runtime

type Runtime interface {
	// Apply means modify this Resource to the desired state described in the request,
	// and it will turn into creating or updating a Resource in most scenarios.
	// If the infrastructure runtime already provides an Apply method that conform to this method's semantics meaning,
	// like the Kubernetes Runtime, you can directly invoke this method without any conversion.
	// PlanResource and priorState are given in this method for the runtime which would make a
	// three-way-merge (planState,priorState and live state) when implementing this interface
	Apply(ctx context.Context, request *ApplyRequest) *ApplyResponse

	// Read the latest state of this Resource
	Read(ctx context.Context, request *ReadRequest) *ReadResponse

	// Delete this Resource in the actual infrastructure and return success if this Resource is not exist
	Delete(ctx context.Context, request *DeleteRequest) *DeleteResponse

	// Watch the latest state or event of this Resource.
	// This is an optional method for the Runtime to implement,
	// but it will be very helpful for us to know what is happening when applying this Resource
	Watch(ctx context.Context, request *WatchRequest) *WatchResponse
}

Runtime represents an actual infrastructure runtime managed by Kusion and every runtime implements this interface can be orchestrated by Kusion like normal K8s resources. All methods in this interface are designed for manipulating one Resource at a time and will be invoked in operations like Apply, Preview, Destroy, etc.

func NewKubernetesRuntime

func NewKubernetesRuntime() (Runtime, error)

NewKubernetesRuntime create a new KubernetesRuntime

type WatchRequest

type WatchRequest struct {
	// Resource represents the resource we want to watch from the actual infra
	Resource *models.Resource
}

type WatchResponse

type WatchResponse struct {
	ResultChs []<-chan watch.Event

	// Status contains messages will show to users
	Status status.Status
}