v1alpha1

type Argument struct {
	Name    string `json:"name"`
	Default string `json:"default"`
}

type ArgumentValue ParameterItem

type ArtifactItem struct {
	// Artifact name
	Name string `json:"name"`
	// Path of the artifact
	Path string `json:"path"`
	// Source of the artifact. When artifact is used as input, this is needed.
	// It's in the format of: <stage name>/<artifact name>
	// +Optional
	Source string `json:"source"`
}

type ClusterCredential struct {
	// Server represents the address of cluster.
	Server string `json:"server"`
	// User is a user of the cluster.
	User string `json:"user"`
	// Password is the password of the corresponding user.
	Password string `json:"password"`
	// BearerToken is the credential to access cluster.
	BearerToken string `json:"bearerToken"`
	// TLSClientConfig is the config about TLS
	TLSClientConfig *TLSClientConfig `json:"tlsClientConfig,omitempty"`
	// KubeConfig is the config about kube config
	KubeConfig *cmd_api.Config `json:"kubeConfig,omitempty"`
}

type ContainerGroup string

type CronTrigger struct {
	Schedule string `json:"schedule"`
}

type DelegationWorkload struct {
	// Type identifies what kind of workload this is, for example 'notification', Cyclone doesn't need to understand it.
	Type string `json:"type"`
	// URL of the target service. Cyclone would send POST request to this URL.
	URL string `json:"url"`
	// Config is a json string that configure how to run this workload, it's interpreted by external services.
	Config string `json:"config"`
}

type ExecutionCluster struct {
	// Metadata for the resource, like kind and apiversion
	meta_v1.TypeMeta `json:",inline"`
	// Metadata for the particular object, including name, namespace, labels, etc
	meta_v1.ObjectMeta `json:"metadata,omitempty"`
	// Spec is the Workflow specification
	Spec ExecutionClusterSpec `json:"spec"`
}

type ExecutionClusterList struct {
	meta_v1.TypeMeta `json:",inline"`
	meta_v1.ListMeta `json:"metadata"`
	Items            []ExecutionCluster `json:"items"`
}

type ExecutionClusterSpec struct {
	// Credential is the credential info of the cluster
	Credential ClusterCredential `json:"credential"`
}

type ExecutionContext struct {
	// Name of the execution cluster
	Cluster string `json:"cluster"`
	// Namespace is namespace where to run workflow
	Namespace string `json:"namespace"`
	// PVC is the PVC used to run workflow
	PVC string `json:"pvc"`
}

type GlobalVariable struct {
	Name  string `json:"name,omitempty"`
	Value string `json:"value,omitempty"`
}

type Inputs struct {
	// Resources used as input
	Resources []ResourceItem `json:"resources,omitempty"`
	// Parameters used as input
	Arguments []ArgumentValue `json:"arguments,omitempty"`
	// Artifacts to output
	Artifacts []ArtifactItem `json:"artifacts,omitempty"`
}

type IntegrationBind struct {
	// IntegrationType is type of integration to bind for this resource type, for example 'DockerRegistry'
	IntegrationType string `json:"integrationType"`
	// ParamBindings binds parameters of one resource type to the integration. It's a map with keys being
	// parameter names of the resource type, and values being the parameter names of the integration type.
	ParamBindings map[string]string `json:"paramBindings"`
}

type IntegrationItem struct {
	// Type is the integration type
	Type string `json:"type"`
	// Name is the default value of the corresponding type of integration
	Name string `json:"name"`
}

type KeyValue struct {
	Key   string `json:"key"`
	Value string `json:"value"`
}

type Notification struct {
	// Policy represents the policy to send notifications.
	Policy NotificationPolicy `json:"policy"`
	// Receivers represents the receivers of notifications.
	Receivers []NotificationReceiver `json:"receivers"`
}

type NotificationPolicy string

type NotificationReceiver struct {
	// Type represents the way to send notifications.
	Type NotificationType `json:"type"`
	// Addresses represents the addresses to receive notifications.
	Addresses []string `json:"addresses"`
}

type NotificationResult string

type NotificationStatus struct {
	// Result represents the result of sending notifications.
	Result NotificationResult `json:"result"`
	// Message represents the detailed message for result.
	Message string `json:"message"`
}

type NotificationType string

type Outputs struct {
	// Resources used as output
	Resources []ResourceItem `json:"resources,omitempty"`
	// Artifacts to output
	Artifacts []ArtifactItem `json:"artifacts,omitempty"`
}

type ParameterConfig struct {
	// Whose parameters to configure
	Name string `json:"name"`
	// Parameters ...
	Parameters []ParameterItem `json:"parameters"`
}

type ParameterItem struct {
	// Name of the parameter
	Name string `json:"name"`
	// Value of the parameter
	Value *string `json:"value"`
	// Description of the parameter
	Description string `json:"description,omitempty"`
	// Required indicates whether this parameter is required
	Required bool `json:"required,omitempty"`
}

type Persistent struct {
	// Name of the PVC to hold the resource
	PVC string `json:"pvc"`
	// Path of resource in the PVC
	Path string `json:"path"`
	// Whether to pull resource when there already be data
	PullPolicy ResourcePullPolicy `json:"pullPolicy"`
}

type PodInfo struct {
	Name      string `json:"name"`
	Namespace string `json:"namespace"`
}

type PodWorkload struct {
	// Stage inputs
	Inputs Inputs `json:"inputs,omitempty"`
	// Stage outputs
	Outputs Outputs `json:"outputs,omitempty"`
	// Stage workload specification
	Spec corev1.PodSpec `json:"spec"`
	// Stage workload metadata
	Meta *PodWorkloadMeta `json:"metadata,omitempty"`
}

type PodWorkloadMeta struct {
	// Labels is a map of string keys and values that can be used to organize and categorize
	// (scope and select) objects.
	Labels map[string]string `json:"labels,omitempty"`
	// Annotations is an unstructured key value map stored with a resource that may be
	// set by external tools to store and retrieve arbitrary metadata. They are not
	// queryable and should be preserved when modifying objects.
	Annotations map[string]string `json:"annotations,omitempty"`
}

type PresetVolume struct {
	// Type of the volume
	Type PresetVolumeType `json:"type"`
	// Path is path in host, PVC, or key path in Secret, ConfigMap.
	Path string `json:"path"`
	// MountPath is path in container that this preset volume will be mounted.
	MountPath string `json:"mountPath"`
	// SubPath is subpath to mount in container, for example, if MountPath is '/etc', SubPath is 'app.config', then
	// final file would be '/etc/app.config' in container
	SubPath string `json:"subPath"`
	// ObjectName is name of the source object if preset volume type is Secret, ConfigMap, PVC
	ObjectName *string `json:"objectName,omitempty"`
	// Scope defines the which containers to apply the preset volumes
	ContainerGroup ContainerGroup `json:"containerGroup"`
}

type PresetVolumeType string

type Project struct {
	// Metadata for the resource, like kind and apiversion
	meta_v1.TypeMeta `json:",inline"`
	// Metadata for the particular object, including name, namespace, labels, etc
	meta_v1.ObjectMeta `json:"metadata,omitempty"`
	// Spec is the Workflow specification
	Spec ProjectSpec `json:"spec"`
	// Status is status of the project, it holds statistics info of a project
	Status *ProjectStatus `json:"status,omitempty"`
}

type ProjectList struct {
	meta_v1.TypeMeta `json:",inline"`
	meta_v1.ListMeta `json:"metadata"`
	Items            []Project `json:"items"`
}

type ProjectSpec struct {
	// Integrations contains default value of various type of integrations.
	Integrations []IntegrationItem `json:"integrations"`

	// Quota is the default quota of the workflow under it,
	// eg map[core_v1.ResourceName]string{"requests.cpu": "2", "requests.memory": "4Gi"}
	Quota map[core_v1.ResourceName]string `json:"quota"`
}

type ProjectStatus struct {
	WorkflowCount int `json:"workflowCount"`
}

type Resource struct {
	// Metadata for the resource, like kind and apiversion
	metav1.TypeMeta `json:",inline"`
	// Metadata for the particular object, including name, namespace, labels, etc
	metav1.ObjectMeta `json:"metadata,omitempty"`
	// Resource specification
	Spec ResourceSpec `json:"spec"`
}

type ResourceItem struct {
	// Resource name
	Name string `json:"name"`
	// Type is type of the resource, for example, Git, Image
	Type string `json:"type"`
	// For input resource, this is the path that resource will be mounted in workload container.
	// Resolver would resolve resources and mount it in this path.
	// For output resource, this is the path in the workload container specify output data, for
	// the moment, only one path can be given. In the resolver container, data specified here would
	// be mounted in /workspace/data by default. Resolver will then push resource to remote server.
	// TODO(ChenDe): For output resource, need support multiple paths.
	Path string `json:"path"`
}

type ResourceList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata"`
	Items           []Resource `json:"items"`
}

type ResourcePullPolicy string

type ResourceSpec struct {
	// Image to resolve this kind of resource.
	Resolver string `json:"resolver,omitempty"`
	// Resource type, e.g. image, git, kv, general.
	Type string `json:"type"`
	// Persistent resource to PVC.
	Persistent *Persistent `json:"persistent"`
	// Parameters of the resource
	Parameters []ParameterItem `json:"parameters"`
	// SupportedOperations defines what operations the resource type supported,
	// it's only used to register a resource type. When you create a resource for
	// workflow, just ignore it.
	SupportedOperations []string `json:"operations"`
	// IntegrationBind binds the resource type to integration (represent a external data source).
	// It's used when define a resource type.
	IntegrationBind *IntegrationBind `json:"bind,omitempty"`
}

type SCMTrigger struct {
	// Secret represents the secret of integrated SCM.
	Secret string `json:"secret"`
	// Repo represents full repo name without server address.
	// for GitHub, GitLab, Bitbucket, it is ordinarily in format of 'owner/repo-name',
	// for SVN, it is stored of the RepoUUID of the SVN repo. you can get the SVN repo
	// UUID by command:
	//
	// 'svn info --show-item repos-uuid --username {user} --password {password} --non-interactive
	// --trust-server-cert-failures unknown-ca,cn-mismatch,expired,not-yet-valid,other
	// --no-auth-cache {remote-svn-address}'
	Repo string `json:"repo"`
	// SCMTriggerPolicy represents trigger policies for SCM events.
	SCMTriggerPolicy `json:",inline"`
}

type SCMTriggerBasic struct {
	// Enabled represents whether enable this policy.
	Enabled bool `json:"enabled"`
}

type SCMTriggerPolicy struct {
	// Push represents trigger policy for push events.
	Push SCMTriggerPush `json:"push"`
	// TagRelease represents trigger policy for tag release events.
	TagRelease SCMTriggerTagRelease `json:"tagRelease"`
	// PullRequest represents trigger policy for pull request events.
	PullRequest SCMTriggerPullRequest `json:"pullRequest"`
	// PullRequestComment represents trigger policy for pull request comment events.
	PullRequestComment SCMTriggerPullRequestComment `json:"pullRequestComment"`
	// PostCommit represents trigger policy for post commit events.
	PostCommit SCMTriggerPostCommit `json:"postCommit"`
}

type SCMTriggerPostCommit struct {
	SCMTriggerBasic `json:",inline"`

	// RootURL represents SVN repository root url, this root is retrieved by
	//
	// 'svn info --show-item repos-root-url --username {user} --password {password} --non-interactive
	// --trust-server-cert-failures unknown-ca,cn-mismatch,expired,not-yet-valid,other
	// --no-auth-cache {remote-svn-address}'
	//
	// e.g: http://192.168.21.97/svn/caicloud
	RootURL string `json:"rootURL"`

	// WorkflowURL represents repository url of the workflow that the wrokflowTrigger related to,
	// Cyclone will checkout code from this URL while executing WorkflowRun.
	// e.g: http://192.168.21.97/svn/caicloud/cyclone
	WorkflowURL string `json:"workflowURL"`
}

type SCMTriggerPullRequest struct {
	SCMTriggerBasic `json:",inline"`

	// Branches represents the pr target branches list to filter PullRequest events.
	Branches []string `json:"branches"`
}

type SCMTriggerPullRequestComment struct {
	SCMTriggerBasic `json:",inline"`
	// Comments represents the comment lists to filter pull request comment events.
	Comments []string `json:"comments"`
}

type SCMTriggerPush struct {
	SCMTriggerBasic `json:",inline"`
	// Branches represents the branch lists to filter push events.
	Branches []string `json:"branches"`
}

type SCMTriggerTagRelease struct {
	SCMTriggerBasic `json:",inline"`
}

type Stage struct {
	// Metadata for the resource, like kind and apiversion
	metav1.TypeMeta `json:",inline"`
	// Metadata for the particular object, including name, namespace, labels, etc
	metav1.ObjectMeta `json:"metadata,omitempty"`
	// Stage specification
	Spec StageSpec `json:"spec,omitempty"`
}

type StageEvent struct {
	// Event name
	Name string `json:"name"`
	// This should be a short, machine understandable string that gives the reason
	// for the transition into the object's current status.
	Reason string `json:"reason,omitempty"`
	// A human-readable description of the status of this operation.
	Message string `json:"message,omitempty"`
	// The time at which the most recent occurrence of this event was recorded.
	LastTimestamp metav1.Time `json:"lastTimestamp,omitempty"`
	// The number of times this event has occurred.
	Count int32 `json:"count,omitempty"`
}

type StageItem struct {
	// Name of stage
	Name string `json:"name"`
	// Input artifacts that this stage needed, we bind the artifacts source here.
	Artifacts []ArtifactItem `json:"artifacts"`
	// Stages that this stage depends on.
	Depends []string `json:"depends"`
	// Trivial indicates whether this stage is critical in the workflow. If set to true, it means the workflow
	// can tolerate failure of this stage. In this case, all other stages can continue to execute and the overall
	// status of the workflow execution can still be succeed.
	Trivial bool `json:"trivial"`
}

type StageList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata"`
	Items           []Stage `json:"items"`
}

type StageSpec struct {
	// Pod kind workload
	Pod *PodWorkload `json:"pod,omitempty"`
	// Delegation kind workload, this stage would be executed externally.
	Delegation *DelegationWorkload `json:"delegation,omitempty"`
}

type StageStatus struct {
	// Information of the pod
	Pod *PodInfo `json:"pod"`
	// Conditions of a stage
	Status Status `json:"status"`
	// Key-value outputs of this stage
	Outputs []KeyValue `json:"outputs"`
	// Stages that this stage depends on.
	Depends []string `json:"depends"`
	// Trivial indicates whether this stage is critical in the workflow. If set to true, it means the workflow
	// can tolerate failure of this stage. In this case, all other stages can continue to execute and the overall
	// status of the workflow execution can still be succeed.
	Trivial bool `json:"trivial"`
	// Events of the stage
	Events []StageEvent `json:"events"`
}

type Status struct {
	// Phase with value: Running, Waiting, Completed, Error
	Phase StatusPhase `json:"phase"`

	// LastTransitionTime is the last time the status transitioned from one status to another.
	// +optional
	LastTransitionTime metav1.Time `json:"lastTransitionTime,omitempty"`

	// The reason for the status's last transition.
	// +optional
	Reason string `json:"reason,omitempty"`

	// A human readable message indicating details about the transition.
	// +optional
	Message string `json:"message,omitempty"`

	// StartTime is the start time of processing stage/workflowrun
	StartTime metav1.Time `json:"startTime,omitempty"`
}

type StatusPhase string

type TLSClientConfig struct {
	// Server should be accessed without verifying the TLS certificate. For testing only.
	Insecure bool `json:"insecure,omitempty" bson:"insecure"`

	// CAFile is the trusted root certificates for server
	CAFile string `json:"caFile,omitempty" bson:"caFile"`

	// CAData holds PEM-encoded bytes (typically read from a root certificates bundle).
	// CAData takes precedence over CAFile
	CAData []byte `json:"caData,omitempty" bson:"caData"`
}

type TriggerType string

type Workflow struct {
	// Metadata for the resource, like kind and apiversion
	metav1.TypeMeta `json:",inline"`
	// Metadata for the particular object, including name, namespace, labels, etc
	metav1.ObjectMeta `json:"metadata,omitempty"`
	// Workflow specification
	Spec WorkflowSpec `json:"spec"`
}

type WorkflowList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata"`
	Items           []Workflow `json:"items"`
}

type WorkflowRun struct {
	// Metadata for the resource, like kind and apiversion
	metav1.TypeMeta `json:",inline"`
	// Metadata for the particular object, including name, namespace, labels, etc
	metav1.ObjectMeta `json:"metadata,omitempty"`
	// Workflow run specification
	Spec WorkflowRunSpec `json:"spec"`
	// Status of workflow execution
	Status WorkflowRunStatus `json:"status,omitempty"`
}

type WorkflowRunList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata"`
	Items           []WorkflowRun `json:"items"`
}

type WorkflowRunSpec struct {
	// Reference to a Workflow
	WorkflowRef *corev1.ObjectReference `json:"workflowRef"`
	// Stages in the workflow to start execution
	StartStages []string `json:"startStages"`
	// Stages in the workflow to end execution
	EndStages []string `json:"endStages"`
	// Maximum time this workflow can run
	Timeout string `json:"timeout"`
	// ServiceAccount used in the workflow execution
	ServiceAccount string `json:"serviceAccount"`
	// ResourceParams represents parameters for resources
	ResourceParams []ParameterConfig `json:"resources"`
	// StageParams represents parameters for stages
	StageParams []ParameterConfig `json:"stages"`
	// Execution context which specifies namespace and PVC used
	ExecutionContext *ExecutionContext `json:"executionContext"`
	// PresetVolumes volumes are preset volumes that will be mounted to all stage pods. For the moment, two kinds
	// of volumes supported, namely HostPath, PV. Users can make use of preset volumes to inject timezone, certificates
	// from host to containers, or mount data from PV to be used in containers.
	PresetVolumes []PresetVolume `json:"volumes,omitempty"`
	// GlobalVariables are global variables that can be used in all stages within the workflow in a run. Different to
	// global values defined in workflow, values defined here MUST be concrete value (string only for the moment). We
	// can regard global variables in workflow as value templates (for example, $(random:5)), and final values must be
	// populated in workflow run.
	// Values defined here will override those defined in the workflow. If a variable is defined in workflow but not here,
	// it would be populated (final value generated) here when workflowrun created by workflowrun controller.
	GlobalVariables []GlobalVariable `json:"globalVariables,omitempty"`
}

type WorkflowRunStatus struct {
	// Status of all stages
	Stages map[string]*StageStatus `json:"stages"`
	// Overall status
	Overall Status `json:"overall"`
	// Whether gc is performed on this WorkflowRun, such as deleting pods.
	Cleaned bool `json:"cleaned"`
	// Notifications represents the status of sending notifications.
	Notifications map[string]NotificationStatus `json:"notifications,omitempty"`
}

type WorkflowSpec struct {
	Resources *corev1.ResourceRequirements
	Stages    []StageItem `json:"stages"`

	// Notification represents the notification config of workflowrun result.
	Notification Notification `json:"notification,omitempty"`

	// GlobalVariables are global variables that can be used in stages or resources parameters. For example, a
	// global variable 'IMAGE_TAG' set here can be used in resource parameters as '${variables.IMAGE_TAG}. Format
	// for the variable reference is ${variables.<variable_name>}
	GlobalVariables []GlobalVariable `json:"globalVariables,omitempty"`
}

type WorkflowTrigger struct {
	// Metadata for the resource, like kind and apiversion
	metav1.TypeMeta `json:",inline"`
	// Metadata for the particular object, including name, namespace, labels, etc
	metav1.ObjectMeta `json:"metadata,omitempty"`
	// Specification of this workflow trigger
	Spec WorkflowTriggerSpec `json:"spec"`
	// Status of this trigger
	Status WorkflowTriggerStatus `json:"status"`
}

type WorkflowTriggerList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata"`
	Items           []WorkflowTrigger `json:"items"`
}

type WorkflowTriggerSpec struct {
	// Type of this trigger, Cron or Webhook
	Type TriggerType `json:"type"`
	// Parameters of the trigger to run workflow
	Parameters []ParameterItem `json:"parameters"`
	// Cron represents cron trigger config.
	Cron CronTrigger `json:"cron,omitempty"`
	// SCM represents webhook trigger config.
	SCM SCMTrigger `json:"scm,omitempty"`
	// Whether this trigger is disabled, if set to true, no workflow will be triggered
	Disabled bool `json:"disabled"`
	// Spec to run the workflow
	WorkflowRunSpec `json:",inline"`
}

type WorkflowTriggerStatus struct {
	// Count represents triggered times.
	Count int `json:"count"`
}