types.go

/*
Copyright 2016 The Fission Authors.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

package fission

import (
	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"

	fv1 "github.com/fission/fission/pkg/apis/fission.io/v1"
)

type (
	ChecksumType                 = fv1.ChecksumType
	Checksum                     = fv1.Checksum
	ArchiveType                  = fv1.ArchiveType
	Archive                      = fv1.Archive
	EnvironmentReference         = fv1.EnvironmentReference
	SecretReference              = fv1.SecretReference
	ConfigMapReference           = fv1.ConfigMapReference
	BuildStatus                  = fv1.BuildStatus
	PackageSpec                  = fv1.PackageSpec
	PackageStatus                = fv1.PackageStatus
	PackageRef                   = fv1.PackageRef
	FunctionPackageRef           = fv1.FunctionPackageRef
	ExecutorType                 = fv1.ExecutorType
	StrategyType                 = fv1.StrategyType
	FunctionSpec                 = fv1.FunctionSpec
	InvokeStrategy               = fv1.InvokeStrategy
	ExecutionStrategy            = fv1.ExecutionStrategy
	FunctionReferenceType        = fv1.FunctionReferenceType
	FunctionReference            = fv1.FunctionReference
	Runtime                      = fv1.Runtime
	Builder                      = fv1.Builder
	EnvironmentSpec              = fv1.EnvironmentSpec
	AllowedFunctionsPerContainer = fv1.AllowedFunctionsPerContainer
	HTTPTriggerSpec              = fv1.HTTPTriggerSpec
	KubernetesWatchTriggerSpec   = fv1.KubernetesWatchTriggerSpec
	MessageQueueType             = fv1.MessageQueueType
	MessageQueueTriggerSpec      = fv1.MessageQueueTriggerSpec
	TimeTriggerSpec              = fv1.TimeTriggerSpec
	RecorderSpec                 = fv1.RecorderSpec
)

type (
	// Errors returned by the Fission API.
	Error struct {
		Code    errorCode `json:"code"`
		Message string    `json:"message"`
	}

	errorCode int
)

//
// Fission-Environment interface. The following types are not
// exposed in the Fission API, but rather used by Fission to
// talk to environments.
//
type (
	FunctionLoadRequest struct {
		// FilePath is an absolute filesystem path to the
		// function. What exactly is stored here is
		// env-specific. Optional.
		FilePath string `json:"filepath"`

		// FunctionName has an environment-specific meaning;
		// usually, it defines a function within a module
		// containing multiple functions. Optional; default is
		// environment-specific.
		FunctionName string `json:"functionName"`

		// URL to expose this function at. Optional; defaults
		// to "/".
		URL string `json:"url"`

		// Metatdata
		FunctionMetadata *metav1.ObjectMeta
	}
)

const EXECUTOR_INSTANCEID_LABEL = fv1.EXECUTOR_INSTANCEID_LABEL
const POOLMGR_INSTANCEID_LABEL = fv1.POOLMGR_INSTANCEID_LABEL

const (
	ChecksumTypeSHA256 = fv1.ChecksumTypeSHA256
)

const (
	// ArchiveTypeLiteral means the package contents are specified in the Literal field of
	// resource itself.
	ArchiveTypeLiteral = fv1.ArchiveTypeLiteral

	// ArchiveTypeUrl means the package contents are at the specified URL.
	ArchiveTypeUrl = fv1.ArchiveTypeUrl
)

const (
	BuildStatusPending   = fv1.BuildStatusPending
	BuildStatusRunning   = fv1.BuildStatusRunning
	BuildStatusSucceeded = fv1.BuildStatusSucceeded
	BuildStatusFailed    = fv1.BuildStatusFailed
	BuildStatusNone      = fv1.BuildStatusNone
)

const (
	AllowedFunctionsPerContainerSingle   = fv1.AllowedFunctionsPerContainerSingle
	AllowedFunctionsPerContainerInfinite = fv1.AllowedFunctionsPerContainerInfinite
)

const (
	ExecutorTypePoolmgr   = fv1.ExecutorTypePoolmgr
	ExecutorTypeNewdeploy = fv1.ExecutorTypeNewdeploy
)

const (
	StrategyTypeExecution = fv1.StrategyTypeExecution
)

const (
	SharedVolumeUserfunc   = fv1.SharedVolumeUserfunc
	SharedVolumePackages   = fv1.SharedVolumePackages
	SharedVolumeSecrets    = fv1.SharedVolumeSecrets
	SharedVolumeConfigmaps = fv1.SharedVolumeConfigmaps
)

const (
	MessageQueueTypeNats = fv1.MessageQueueTypeNats
	MessageQueueTypeASQ  = fv1.MessageQueueTypeASQ
)

const (
	// FunctionReferenceFunctionName means that the function
	// reference is simply by function name.
	FunctionReferenceTypeFunctionName = fv1.FunctionReferenceTypeFunctionName

	// Other function reference types we'd like to support:
	//   Versioned function, latest version
	//   Versioned function. by semver "latest compatible"
	//   Set of function references (recursively), by percentage of traffic
)

const (
	ErrorInternal = iota

	ErrorNotAuthorized
	ErrorNotFound
	ErrorNameExists
	ErrorInvalidArgument
	ErrorNoSpace
	ErrorNotImplmented
	ErrorChecksumFail
	ErrorSizeLimitExceeded
)

// must match order and len of the above const
var errorDescriptions = []string{
	"Internal error",
	"Not authorized",
	"Resource not found",
	"Resource exists",
	"Invalid argument",
	"No space",
	"Not implemented",
	"Checksum verification failed",
	"Size limit exceeded",
}

const (
	ArchiveLiteralSizeLimit int64 = 256 * 1024
)

const (
	FissionBuilderSA = "fission-builder"
	FissionFetcherSA = "fission-fetcher"

	SecretConfigMapGetterCR = "secret-configmap-getter"
	SecretConfigMapGetterRB = "secret-configmap-getter-binding"

	PackageGetterCR = "package-getter"
	PackageGetterRB = "package-getter-binding"

	ClusterRole = "ClusterRole"
)