API Documentation

Packages:

jenkins.io/v1

Package v1 is the v1 version of the API.

Resource Types:

App

App is the metadata for an App

Field Description
apiVersion
string
jenkins.io/v1
kind
string
App
metadata
Kubernetes meta/v1.ObjectMeta
(Optional)

Standard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

Refer to the Kubernetes API documentation for the fields of the metadata field.
spec
AppSpec


schemaPreprocessor
Kubernetes core/v1.Container
schemaPreprocessorRole
Kubernetes rbac/v1.Role
pipelineExtension
PipelineExtension

BuildPack

BuildPack represents a set of language specific build packs and associated quickstarts

Field Description
apiVersion
string
jenkins.io/v1
kind
string
BuildPack
metadata
Kubernetes meta/v1.ObjectMeta
(Optional)

Standard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

Refer to the Kubernetes API documentation for the fields of the metadata field.
spec
BuildPackSpec


label
string
gitUrl
string
gitRef
string
quickstartLocations
[]QuickStartLocation

CommitStatus

CommitStatus represents the commit statuses for a particular pull request

Field Description
apiVersion
string
jenkins.io/v1
kind
string
CommitStatus
metadata
Kubernetes meta/v1.ObjectMeta
(Optional)

Standard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

Refer to the Kubernetes API documentation for the fields of the metadata field.
spec
CommitStatusSpec


items
[]CommitStatusDetails

Environment

Environment represents an environment like Dev, Test, Staging, Production where code lives

Field Description
apiVersion
string
jenkins.io/v1
kind
string
Environment
metadata
Kubernetes meta/v1.ObjectMeta
(Optional)

Standard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

Refer to the Kubernetes API documentation for the fields of the metadata field.
spec
EnvironmentSpec


label
string
namespace
string
cluster
string
promotionStrategy
PromotionStrategyType
source
EnvironmentRepository
order
int32
kind
EnvironmentKindType
pullRequestURL
string
teamSettings
TeamSettings
previewGitInfo
PreviewGitSpec
webHookEngine
WebHookEngineType
remoteCluster
bool

RemoteCluster flag indicates if the Environment is deployed in a separate cluster to the Development Environment

status
EnvironmentStatus

EnvironmentRoleBinding

EnvironmentRoleBinding is like a vanilla RoleBinding but applies to a set of Namespaces based on an Environment filter so that roles can be bound to multiple namespaces easily.

For example to specify the binding of roles on all Preview environments or on all permanent environments.

Field Description
apiVersion
string
jenkins.io/v1
kind
string
EnvironmentRoleBinding
metadata
Kubernetes meta/v1.ObjectMeta
(Optional)

Standard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

Refer to the Kubernetes API documentation for the fields of the metadata field.
spec
EnvironmentRoleBindingSpec


subjects
[]Kubernetes rbac/v1.Subject

Subjects holds references to the objects the role applies to.

roleRef
Kubernetes rbac/v1.RoleRef

RoleRef can reference a Role in the current namespace or a ClusterRole in the global namespace. If the RoleRef cannot be resolved, the Authorizer must return an error.

environments
[]EnvironmentFilter

specifies which sets of environments this binding applies to

status
EnvironmentRoleBindingStatus

Extension

Extension represents an extension available to this Jenkins X install

Field Description
apiVersion
string
jenkins.io/v1
kind
string
Extension
metadata
Kubernetes meta/v1.ObjectMeta
(Optional)

Standard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

Refer to the Kubernetes API documentation for the fields of the metadata field.
spec
ExtensionSpec


name
string
description
string
version
string
script
string
when
[]ExtensionWhen
given
ExtensionGiven
parameters
[]ExtensionParameter
namespace
string
uuid
string
children
[]string

Fact

Fact represents observed facts. Apps will generate Facts about the system. A naming schema is required since each Fact has a name that’s unique for the whole system. Apps should prefix their generated Facts with the name of the App, like -. This makes that different Apps can’t possibly have conflicting Fact names.

For an app generating facts on a pipeline, which will be have several different executions, we recommend --.

Field Description
apiVersion
string
jenkins.io/v1
kind
string
Fact
metadata
Kubernetes meta/v1.ObjectMeta
(Optional)

The Fact labels will be used to query the API for interesting Facts. The Apps responsible for creating Facts need to add the relevant labels. For example, creating Facts on a pipeline would create Facts with the following labels { subjectkind: PipelineActivity pipelineName: my-org-my-app-master-23 org: my-org repo: my-app branch: master buildNumber: 23 }

Refer to the Kubernetes API documentation for the fields of the metadata field.
spec
FactSpec


name
string
factType
string
measurements
[]Measurement
statements
[]Statement
(Optional)
original
Original
(Optional)
tags
[]string
(Optional)
subject
ResourceReference
status
FactStatus

GitService

GitService represents a git provider so we can map the host name to a kinda of git service

Field Description
apiVersion
string
jenkins.io/v1
kind
string
GitService
metadata
Kubernetes meta/v1.ObjectMeta
(Optional)

Standard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

Refer to the Kubernetes API documentation for the fields of the metadata field.
spec
GitServiceSpec


gitKind
string
url
string
name
string

PipelineActivity

PipelineActivity represents pipeline activity for a particular run of a pipeline

Field Description
apiVersion
string
jenkins.io/v1
kind
string
PipelineActivity
metadata
Kubernetes meta/v1.ObjectMeta
(Optional)

Standard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

Refer to the Kubernetes API documentation for the fields of the metadata field.
spec
PipelineActivitySpec


pipeline
string
build
string
version
string
status
ActivityStatusType
startedTimestamp
Kubernetes meta/v1.Time
completedTimestamp
Kubernetes meta/v1.Time
steps
[]PipelineActivityStep
buildUrl
string
buildLogsUrl
string
gitUrl
string
gitRepository
string
gitOwner
string
gitBranch
string
author
string
pullTitle
string
releaseNotesURL
string
lastCommitSHA
string
lastCommitMessage
string
lastCommitURL
string
workflow
string
workflowStatus
ActivityStatusType
workflowMessage
string
postExtensions
[]ExtensionExecution
attachments
[]Attachment
batchPipelineActivity
BatchPipelineActivity
context
string
baseSHA
string
status
PipelineActivityStatus

PipelineStructure

PipelineStructure contains references to the Pipeline and PipelineRun, and a list of PipelineStructureStages in the pipeline. This allows us to map between a running Pod to its TaskRun, to the TaskRun’s Task and PipelineRun, and finally from there to the stage and potential parent stages that the Pod is actually executing, for use with populating PipelineActivity and providing logs.

Field Description
apiVersion
string
jenkins.io/v1
kind
string
PipelineStructure
metadata
Kubernetes meta/v1.ObjectMeta
(Optional)

Standard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

Refer to the Kubernetes API documentation for the fields of the metadata field.
pipelineRef
string
pipelineRunRef
string
stages
[]PipelineStructureStage

Plugin

Plugin represents a binary plugin installed into this Jenkins X team

Field Description
apiVersion
string
jenkins.io/v1
kind
string
Plugin
metadata
Kubernetes meta/v1.ObjectMeta
(Optional)

Standard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

Refer to the Kubernetes API documentation for the fields of the metadata field.
spec
PluginSpec


subCommand
string
group
string
binaries
[]Binary
description
string
name
string
version
string

Release

Release represents a single version of an app that has been released

Field Description
apiVersion
string
jenkins.io/v1
kind
string
Release
metadata
Kubernetes meta/v1.ObjectMeta
(Optional)

Standard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

Refer to the Kubernetes API documentation for the fields of the metadata field.
spec
ReleaseSpec


name
string
version
string
gitHttpUrl
string
gitCloneUrl
string
commits
[]CommitSummary
issues
[]IssueSummary
pullRequests
[]IssueSummary
dependencyUpdates
[]DependencyUpdate
releaseNotesURL
string
gitRepository
string
gitOwner
string
status
ReleaseStatus

Scheduler

Scheduler is configuration for a pipeline scheduler

Field Description
apiVersion
string
jenkins.io/v1
kind
string
Scheduler
metadata
Kubernetes meta/v1.ObjectMeta
(Optional)

Standard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

Refer to the Kubernetes API documentation for the fields of the metadata field.
spec
SchedulerSpec


schedulerAgent
SchedulerAgent
policy
GlobalProtectionPolicy
presubmits
Presubmits
postsubmits
Postsubmits
trigger
Trigger
approve
Approve
lgtm
Lgtm
externalPlugins
ReplaceableSliceOfExternalPlugins
merger
Merger
plugins
ReplaceableSliceOfStrings

Plugins is a list of plugin names enabled for a repo

configUpdater
ConfigUpdater
welcome
[]*github.com/jenkins-x/jx/pkg/apis/jenkins.io/v1.Welcome
periodics
Periodics
attachments
[]*github.com/jenkins-x/jx/pkg/apis/jenkins.io/v1.Attachment

SourceRepository

SourceRepository is the metadata for an Application/Project/SourceRepository

Field Description
apiVersion
string
jenkins.io/v1
kind
string
SourceRepository
metadata
Kubernetes meta/v1.ObjectMeta
(Optional)

Standard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

Refer to the Kubernetes API documentation for the fields of the metadata field.
spec
SourceRepositorySpec


description
string
provider
string

Provider stores the URL of the git provider such as https://github.com

org
string
repo
string
providerName
string

ProviderName is a logical name for the provider without any URL scheme which can be used in a label selector

providerKind
string

ProviderKind is the kind of provider (github / bitbucketcloud / bitbucketserver etc)

url
string

URL is the web URL of the project page

sshCloneURL
string

SSHCloneURL is the git URL to clone this repository using SSH

httpCloneURL
string

HTTPCloneURL is the git URL to clone this repository using HTTP/HTTPS

scheduler
ResourceReference

Scheduler a reference to a custom scheduler otherwise we default to the Team’s Scededuler

SourceRepositoryGroup

SourceRepositoryGroup is the metadata for an Application/Project/SourceRepository

Field Description
apiVersion
string
jenkins.io/v1
kind
string
SourceRepositoryGroup
metadata
Kubernetes meta/v1.ObjectMeta
Refer to the Kubernetes API documentation for the fields of the metadata field.
spec
SourceRepositoryGroupSpec


metadata
Kubernetes meta/v1.ObjectMeta
Refer to the Kubernetes API documentation for the fields of the metadata field.
repositories
[]ResourceReference
scheduler
ResourceReference

Team

Team represents a request to create an actual Team which is a group of users, a development environment and optional other environments

Field Description
apiVersion
string
jenkins.io/v1
kind
string
Team
metadata
Kubernetes meta/v1.ObjectMeta
(Optional)

Standard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

Refer to the Kubernetes API documentation for the fields of the metadata field.
spec
TeamSpec


label
string
kind
TeamKindType
members
[]string
status
TeamStatus

User

User represents a git user so we have a cache to find by email address

Field Description
apiVersion
string
jenkins.io/v1
kind
string
User
metadata
Kubernetes meta/v1.ObjectMeta
(Optional)

Standard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

Refer to the Kubernetes API documentation for the fields of the metadata field.
user
UserDetails

Deprecated, use Spec

spec
UserDetails


login
string
name
string
email
string
creationTimestamp
Kubernetes meta/v1.Time
url
string
avatarUrl
string
serviceAccount
string
accountReference
[]AccountReference
externalUser
bool

Workflow

Workflow represents pipeline activity for a particular run of a pipeline

Field Description
apiVersion
string
jenkins.io/v1
kind
string
Workflow
metadata
Kubernetes meta/v1.ObjectMeta
(Optional)

Standard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

Refer to the Kubernetes API documentation for the fields of the metadata field.
spec
WorkflowSpec


pipeline
string
steps
[]WorkflowStep
status
WorkflowStatus

AccountReference

(Appears on: UserDetails)

AccountReference is a reference to a user account in another system that is attached to this user

Field Description
provider
string
id
string

ActivityStatusType (string alias)

(Appears on: CoreActivityStep, PipelineActivitySpec)

ActivityStatusType is the status of an activity; usually succeeded or failed/error on completion

ActivityStepKindType (string alias)

(Appears on: PipelineActivityStep)

ActivityStepKindType is a kind of step

AppSpec

(Appears on: App)

AppSpec provides details of the metadata for an App

Field Description
schemaPreprocessor
Kubernetes core/v1.Container
schemaPreprocessorRole
Kubernetes rbac/v1.Role
pipelineExtension
PipelineExtension

Approve

(Appears on: SchedulerSpec)

Approve specifies a configuration for a single approve.

The configuration for the approve plugin is defined as a list of these structures.

Field Description
issueRequired
bool

IssueRequired indicates if an associated issue is required for approval in the specified repos.

requireSelfApproval
bool

RequireSelfApproval requires PR authors to explicitly approve their PRs. Otherwise the plugin assumes the author of the PR approves the changes in the PR.

lgtmActsAsApprove
bool

LgtmActsAsApprove indicates that the lgtm command should be used to indicate approval

ignoreReviewState
bool

IgnoreReviewState causes the approve plugin to ignore the GitHub review state. Otherwise: * an APPROVE github review is equivalent to leaving an “/approve” message. * A REQUEST_CHANGES github review is equivalent to leaving an /approve cancel” message.

Attachment

(Appears on: PipelineActivitySpec)

Field Description
name
string
urls
[]string

BatchPipelineActivity

(Appears on: PipelineActivitySpec)

BatchPipelineActivity contains information about a batch build, used by both the batch build and its comprising PRs for linking them together

Field Description
batchBuildNumber
string
batchBranchName
string
pullRequestInfo
[]PullRequestInfo

Binary

(Appears on: PluginSpec)

Binary provies the details of a downloadable binary

Field Description
goarch
string
goos
string
url
string

BranchProtectionContextPolicy

(Appears on: ProtectionPolicy)

BranchProtectionContextPolicy configures required git provider contexts. Strict determines whether merging to the branch invalidates existing contexts.

Field Description
contexts
ReplaceableSliceOfStrings

Contexts appends required contexts that must be green to merge

strict
bool

Strict overrides whether new commits in the base branch require updating the PR if set

Brancher

(Appears on: Postsubmit, Presubmit)

Brancher is for shared code between jobs that only run against certain branches. An empty brancher runs against all branches.

Field Description
skipBranches
ReplaceableSliceOfStrings

Do not run against these branches. Default is no branches.

branches
ReplaceableSliceOfStrings

Only run against these branches. Default is all branches.

BuildPackSpec

(Appears on: BuildPack)

BuildPackSpec is the specification of an BuildPack

Field Description
label
string
gitUrl
string
gitRef
string
quickstartLocations
[]QuickStartLocation

ChartRef

(Appears on: ExtensionRepositoryReference)

Field Description
repo
string
repoName
string
name
string

CommitStatusCommitReference

(Appears on: CommitStatusDetails)

Field Description
gitUrl
string
pullRequest
string
sha
string

CommitStatusDetails

(Appears on: CommitStatusSpec)

Field Description
pipelineActivity
ResourceReference
Items
[]CommitStatusItem
checked
bool
commit
CommitStatusCommitReference
context
string

CommitStatusItem

(Appears on: CommitStatusDetails)

Field Description
name
string
description
string
pass
bool

CommitStatusSpec

(Appears on: CommitStatus)

CommitStatusSpec provides details of a particular commit status

Field Description
items
[]CommitStatusDetails

CommitSummary

(Appears on: ReleaseSpec)

CommitSummary is the summary of a commit

Field Description
message
string
sha
string
url
string
author
UserDetails
committer
UserDetails
branch
string
issueIds
[]string

ConfigMapSpec

(Appears on: ConfigUpdater)

ConfigMapSpec contains configuration options for the configMap being updated by the config-updater plugin.

Field Description
name
string

Name of ConfigMap

key
string

Key is the key in the ConfigMap to update with the file contents. If no explicit key is given, the basename of the file will be used.

namespace
string

Namespace in which the configMap needs to be deployed. If no namespace is specified it will be deployed to the ProwJobNamespace.

additional_namespaces
[]string

Namespaces in which the configMap needs to be deployed, in addition to the above namespace provided, or the default if it is not set.

-
[]string

Namespaces is the fully resolved list of Namespaces to deploy the ConfigMap in

ConfigUpdater

(Appears on: SchedulerSpec)

ConfigUpdater holds configuration for the config updater plugin

Field Description
map
map[string]github.com/jenkins-x/jx/pkg/apis/jenkins.io/v1.ConfigMapSpec
configFile
string
pluginFile
string
ConfigMap
ConfigMapSpec
(Optional)

ContextPolicy

(Appears on: Merger, RepoContextPolicy)

ContextPolicy configures options about how to handle various contexts.

Field Description
skipUnknownContexts
bool

whether to consider unknown contexts optional (skip) or required.

requiredContexts
ReplaceableSliceOfStrings
requiredIfPresentContexts
ReplaceableSliceOfStrings
optionalContexts
ReplaceableSliceOfStrings
fromBranchProtection
bool

Infer required and optional jobs from Branch Protection configuration

CoreActivityStep

(Appears on: PreviewActivityStep, PromoteActivityStep, PromotePullRequestStep, PromoteUpdateStep, StageActivityStep)

CoreActivityStep is a base step included in Stages of a pipeline or other kinds of step

Field Description
name
string
description
string
status
ActivityStatusType
startedTimestamp
Kubernetes meta/v1.Time
completedTimestamp
Kubernetes meta/v1.Time

DependencyUpdate

(Appears on: ReleaseSpec)

DependencyUpdate describes an dependency update message from the commit log

Field Description
DependencyUpdateDetails
DependencyUpdateDetails

(Members of DependencyUpdateDetails are embedded into this type.)

paths
[]DependencyUpdatePath

DependencyUpdateDetails

(Appears on: DependencyUpdate)

DependencyUpdateDetails are the details of a dependency update

Field Description
host
string
owner
string
repo
string
component, omitempty
string
url
string
fromVersion
string
fromReleaseHTMLURL
string
fromReleaseName
string
toVersion
string
toReleaseHTMLURL
string
toReleaseName
string

DependencyUpdatePath ([]github.com/jenkins-x/jx/pkg/apis/jenkins.io/v1.DependencyUpdateDetails alias)

(Appears on: DependencyUpdate)

DependencyUpdatePath is the path of a dependency update

EnvironmentFilter

(Appears on: EnvironmentRoleBindingSpec)

EnvironmentFilter specifies the environments to apply the role binding to

Field Description
kind
EnvironmentKindType
includes
[]string
excludes
[]string

EnvironmentKindType (string alias)

(Appears on: EnvironmentFilter, EnvironmentSpec)

EnvironmentKindType is the kind of an environment

EnvironmentRepository

(Appears on: EnvironmentSpec)

EnvironmentRepository is the repository for an environment using GitOps

Field Description
kind
EnvironmentRepositoryType
url
string
ref
string

EnvironmentRepositoryType (string alias)

(Appears on: EnvironmentRepository)

EnvironmentRepositoryType is the repository type

EnvironmentRoleBindingSpec

(Appears on: EnvironmentRoleBinding)

EnvironmentRoleBindingSpec is the specification of an EnvironmentRoleBinding

Field Description
subjects
[]Kubernetes rbac/v1.Subject

Subjects holds references to the objects the role applies to.

roleRef
Kubernetes rbac/v1.RoleRef

RoleRef can reference a Role in the current namespace or a ClusterRole in the global namespace. If the RoleRef cannot be resolved, the Authorizer must return an error.

environments
[]EnvironmentFilter

specifies which sets of environments this binding applies to

EnvironmentRoleBindingStatus

(Appears on: EnvironmentRoleBinding)

EnvironmentRoleBindingStatus is the status for an EnvironmentRoleBinding resource

Field Description
version
string

EnvironmentSpec

(Appears on: Environment)

EnvironmentSpec is the specification of an Environment

Field Description
label
string
namespace
string
cluster
string
promotionStrategy
PromotionStrategyType
source
EnvironmentRepository
order
int32
kind
EnvironmentKindType
pullRequestURL
string
teamSettings
TeamSettings
previewGitInfo
PreviewGitSpec
webHookEngine
WebHookEngineType
remoteCluster
bool

RemoteCluster flag indicates if the Environment is deployed in a separate cluster to the Development Environment

EnvironmentStatus

(Appears on: Environment)

EnvironmentStatus is the status for an Environment resource

Field Description
version
string

EnvironmentVariable

(Appears on: ExtensionExecution)

Field Description
name
string
value
string

ExtensionConfig

ExtensionConfig is the configuration and enablement for an extension inside an app

Field Description
name
string
namespace
string
parameters
[]ExtensionParameterValue

ExtensionDefinition

ExtensionDefinition defines an Extension

Field Description
name
string
namespace
string
uuid
string
description
string
when
[]ExtensionWhen
given
ExtensionGiven
children
[]ExtensionDefinitionChildReference
scriptFile
string
parameters
[]ExtensionParameter

ExtensionDefinitionChildReference

(Appears on: ExtensionDefinition)

ExtensionDefinitionChildReference provides a reference to a child

Field Description
uuid
string
name
string
namespace
string
remote
string
tag
string

ExtensionDefinitionReference

ExtensionRepositoryReference references a GitHub repo that contains extension definitions

Field Description
remote
string
tag
string

ExtensionExecution

(Appears on: PipelineActivitySpec)

ExtensionExecution is an executable instance of an extension which can be attached into a pipeline for later execution. It differs from an Extension as it cannot have children and parameters have been resolved to environment variables

Field Description
name
string
description
string
script
string
environmentVariables
[]EnvironmentVariable
given
ExtensionGiven
namespace
string
uuid
string

ExtensionGiven (string alias)

(Appears on: ExtensionDefinition, ExtensionExecution, ExtensionSpec)

ExtensionGiven specifies the condition (if the extension is executing in a pipeline on which the extension should execute. By default Always.

ExtensionParameter

(Appears on: ExtensionDefinition, ExtensionSpec)

ExtensionParameter describes a parameter definition for an extension

Field Description
name
string
description
string
environmentVariableName
string
defaultValue
string

ExtensionParameterValue

(Appears on: ExtensionConfig)

Field Description
name
string
value
string

ExtensionRepositoryReference

Field Description
url
string
github
string
chart
ChartRef

ExtensionSpec

(Appears on: Extension)

ExtensionSpec provides details of an extension available for a team

Field Description
name
string
description
string
version
string
script
string
when
[]ExtensionWhen
given
ExtensionGiven
parameters
[]ExtensionParameter
namespace
string
uuid
string
children
[]string

ExtensionWhen (string alias)

(Appears on: ExtensionDefinition, ExtensionSpec)

ExtensionWhen specifies when in the lifecycle an extension should execute. By default Post.

ExternalPlugin

ExternalPlugin holds configuration for registering an external plugin.

Field Description
name
string

Name of the plugin.

endpoint
string

Endpoint is the location of the external plugin. Defaults to the name of the plugin, ie. “http://{{name}}”.

events
ReplaceableSliceOfStrings

ReplaceableSliceOfStrings are the events that need to be demuxed by the hook server to the external plugin. If no events are specified, everything is sent.

FactSpec

(Appears on: Fact)

FactSpec is the specification of a Fact

Field Description
name
string
factType
string
measurements
[]Measurement
statements
[]Statement
(Optional)
original
Original
(Optional)
tags
[]string
(Optional)
subject
ResourceReference

FactStatus

(Appears on: Fact)

FactStatus is the status for an Fact resource

Field Description
version
string

GitServiceSpec

(Appears on: GitService)

GitServiceSpec is the specification of an GitService

Field Description
gitKind
string
url
string
name
string

GitStatus

(Appears on: PromoteUpdateStep)

GitStatus the status of a git commit in terms of CI/CD

Field Description
url
string
status
string

GlobalProtectionPolicy

(Appears on: SchedulerSpec)

GlobalProtectionPolicy defines the default branch protection policy for the scheduler

Field Description
ProtectionPolicy
ProtectionPolicy
(Optional)
protectTested
bool

ImportModeType (string alias)

(Appears on: TeamSettings)

ImportModeType is the type of import mode for new projects in a team

IssueLabel

(Appears on: IssueSummary)

Field Description
name
string
url
string
color
string

IssueSummary

(Appears on: ReleaseSpec)

IssueSummary is the summary of an issue

Field Description
id
string
url
string
title
string
body
string
state
string
message
string
user
UserDetails
assignees
[]UserDetails
closedBy
UserDetails
creationTimestamp
Kubernetes meta/v1.Time
labels
[]IssueLabel

JobBase

(Appears on: Periodic, Postsubmit, Presubmit)

JobBase contains attributes common to all job types

Field Description
name
string

The name of the job. Must match regex [A-Za-z0-9-._]+ e.g. pull-test-infra-bazel-build

labels
ReplaceableMapOfStringString

ReplaceableMapOfStringString are added to jobs and pods created for this job.

maxConcurrency
int

MaximumConcurrency of this job, 0 implies no limit.

agent
string

Agent that will take care of running this job.

cluster
string

Cluster is the alias of the cluster to run this job in. (Default: kube.DefaultClusterAlias)

namespace
string

Namespace is the namespace in which pods schedule. empty: results in scheduler.DefaultNamespace

spec
Kubernetes core/v1.PodSpec

Spec is the Kubernetes pod spec used if Agent is kubernetes.



Lgtm

(Appears on: SchedulerSpec)

Lgtm specifies a configuration for a single lgtm. The configuration for the lgtm plugin is defined as a list of these structures.

Field Description
reviewActsAsLgtm
bool

ReviewActsAsLgtm indicates that a Github review of “approve” or “request changes” acts as adding or removing the lgtm label

storeTreeHash
bool

StoreTreeHash indicates if tree_hash should be stored inside a comment to detect squashed commits before removing lgtm labels

trustedTeamForStickyLgtm
string

WARNING: This disables the security mechanism that prevents a malicious member (or compromised GitHub account) from merging arbitrary code. Use with caution.

StickyLgtmTeam specifies the Github team whose members are trusted with sticky LGTM, which eliminates the need to re-lgtm minor fixes/updates.

Measurement

(Appears on: FactSpec)

Measurement is a percentage or a count, something measured that the system will capture within a fact

Field Description
name
string
measurementType
string
measurementValue
int
tags
[]string

Merger

(Appears on: SchedulerSpec)

Merger defines the options used to merge the PR

Field Description
-
time.Duration

SyncPeriod specifies how often Merger will sync jobs with Github. Defaults to 1m.

-
time.Duration

StatusUpdatePeriod

targetUrl
string

URL for status contexts.

prStatusBaseUrl
string

PRStatusBaseURL is the base URL for the PR status page. This is used to link to a merge requirements overview in the status context.

blockerLabel
string

BlockerLabel is an optional label that is used to identify merge blocking Git Provider issues. Leave this blank to disable this feature and save 1 API token per sync loop.

squashLabel
string

SquashLabel is an optional label that is used to identify PRs that should always be squash merged. Leave this blank to disable this feature.

maxGoroutines
int

MaxGoroutines is the maximum number of goroutines spawned inside the controller to handle org/repo:branch pools. Defaults to 20. Needs to be a positive number.

mergeMethod
string

Override the default method of merge. Valid options are squash, rebase, and merge.

policy
ContextPolicy

ContextOptions defines the default merge options. If not set it will infer the required and optional contexts from the jobs configured and use the Git Provider combined status; otherwise it may apply the branch protection setting or let user define their own options in case branch protection is not used.

Original

(Appears on: FactSpec)

Original contains the report

Field Description
mimetype
string
url
string
tags
[]string

Periodic

Periodic defines a job to be run periodically

Field Description
JobBase
JobBase
(Optional)
interval
string

Interval to wait between two runs of the job.

cron
string

Cron representation of job trigger time

tags
ReplaceableSliceOfStrings

Tags for config entries

Periodics

(Appears on: SchedulerSpec)

Periodics is a list of jobs to be run periodically

Field Description
entries
[]*github.com/jenkins-x/jx/pkg/apis/jenkins.io/v1.Periodic

Items are the post submit configurations

replace
bool

Replace the existing entries

PipelineActivitySpec

(Appears on: PipelineActivity)

PipelineActivitySpec is the specification of the pipeline activity

Field Description
pipeline
string
build
string
version
string
status
ActivityStatusType
startedTimestamp
Kubernetes meta/v1.Time
completedTimestamp
Kubernetes meta/v1.Time
steps
[]PipelineActivityStep
buildUrl
string
buildLogsUrl
string
gitUrl
string
gitRepository
string
gitOwner
string
gitBranch
string
author
string
pullTitle
string
releaseNotesURL
string
lastCommitSHA
string
lastCommitMessage
string
lastCommitURL
string
workflow
string
workflowStatus
ActivityStatusType
workflowMessage
string
postExtensions
[]ExtensionExecution
attachments
[]Attachment
batchPipelineActivity
BatchPipelineActivity
context
string
baseSHA
string

PipelineActivityStatus

(Appears on: PipelineActivity)

PipelineActivityStatus is the status for an Environment resource

Field Description
version
string

PipelineActivityStep

(Appears on: PipelineActivitySpec)

PipelineActivityStep represents a step in a pipeline activity

Field Description
kind
ActivityStepKindType
stage
StageActivityStep
promote
PromoteActivityStep
preview
PreviewActivityStep

PipelineExtension

(Appears on: AppSpec)

PipelineExtension defines the image and command of an app which wants to modify/extend the pipeline

Field Description
name
string

Name of the container specified as a DNS_LABEL.

image
string

Docker image name.

command
string

Entrypoint array. Not executed within a shell.

args
[]string

Arguments to the entrypoint.

PipelineStageAndChildren

(Appears on: PipelineStageAndChildren)

PipelineStageAndChildren represents a single stage and its children.

Field Description
Stage
PipelineStructureStage
Parallel
[]PipelineStageAndChildren
Stages
[]PipelineStageAndChildren

PipelineStructureStage

(Appears on: PipelineStructure, PipelineStageAndChildren)

PipelineStructureStage contains the stage’s name, one of either a reference to the Task corresponding to the stage if it has steps, a list of sequential stage names nested within this stage, or a list of parallel stage names nested within this stage, and information on this stage’s depth within the PipelineStructure as a whole, the name of its parent stage, if any, the name of the stage before it in execution order, if any, and the name of the stage after it in execution order, if any.

Field Description
name
string
taskRef
string
(Optional)

Must have one of TaskRef+TaskRunRef, Stages, or Parallel

taskRunRef
string
(Optional)

Populated during pod discovery, not at initial creation time.

stages
[]string
(Optional)
parallel
[]string
(Optional)
depth
byte
parent
string
(Optional)
previous
string
(Optional)
next
string
(Optional)

PluginSpec

(Appears on: Plugin)

PluginSpec provides details of a binary plugin available for a team

Field Description
subCommand
string
group
string
binaries
[]Binary
description
string
name
string
version
string

Postsubmit

Postsubmit runs on push events.

Field Description
JobBase
JobBase
(Optional)
RegexpChangeMatcher
RegexpChangeMatcher
(Optional)
Brancher
Brancher
(Optional)
context
string

Context is the name of the GitHub status context for the job.

report
bool

Report will comment and set status on GitHub.

Postsubmits

(Appears on: SchedulerSpec)

Postsubmits is a list of Postsubmit job configurations that can optionally completely replace the Postsubmit job configurations in the parent scheduler

Field Description
entries
[]*github.com/jenkins-x/jx/pkg/apis/jenkins.io/v1.Postsubmit

Items are the post submit configurations

replace
bool

Replace the existing entries

Presubmit

Presubmit defines a job configuration for pull requests

Field Description
JobBase
JobBase
(Optional)
Brancher
Brancher
(Optional)
RegexpChangeMatcher
RegexpChangeMatcher
(Optional)
alwaysRun
bool

AlwaysRun automatically for every PR, or only when a comment triggers it. By default true.

context
string

Context is the name of the Git Provider status context for the job.

optional
bool

Optional indicates that the job’s status context should not be required for merge. By default false.

report
bool

Report enables reporting the job status on the git provider

trigger
string

Trigger is the regular expression to trigger the job. e.g. @k8s-bot e2e test this RerunCommand must also be specified if this field is specified. (Default: (?m)^/test (?:.*? )?<job name>(?: .*?)?$)

rerunCommand
string

The RerunCommand to give users. Must match Trigger. Trigger must also be specified if this field is specified. (Default: /test <job name>)

mergeMethod
string

Override the default method of merge. Valid options are squash, rebase, and merge.

queries
[]*github.com/jenkins-x/jx/pkg/apis/jenkins.io/v1.Query
policy
ProtectionPolicies
context_options
RepoContextPolicy

ContextOptions defines the merge options. If not set it will infer the required and optional contexts from the jobs configured and use the Git Provider combined status; otherwise it may apply the branch protection setting or let user define their own options in case branch protection is not used.

Presubmits

(Appears on: SchedulerSpec)

Presubmits is a list of Presubmit job configurations that can optionally completely replace the Presubmit job configurations in the parent scheduler

Field Description
entries
[]*github.com/jenkins-x/jx/pkg/apis/jenkins.io/v1.Presubmit

Items are the Presubmit configurtations

replace
bool

Replace the existing entries

PreviewActivityStep

(Appears on: PipelineActivityStep)

PreviewActivityStep is the step of creating a preview environment as part of a Pull Request pipeline

Field Description
CoreActivityStep
CoreActivityStep

(Members of CoreActivityStep are embedded into this type.)

environment
string
pullRequestURL
string
applicationURL
string

PreviewGitSpec

(Appears on: EnvironmentSpec)

PreviewGitSpec is the preview git branch/pull request details

Field Description
name
string
url
string
user
UserSpec
title
string
description
string
buildStatus
string
buildStatusUrl
string
appName
string
applicationURL
string

PromoteActivityStep

(Appears on: PipelineActivityStep)

PromoteActivityStep is the step of promoting a version of an application to an environment

Field Description
CoreActivityStep
CoreActivityStep

(Members of CoreActivityStep are embedded into this type.)

environment
string
pullRequest
PromotePullRequestStep
update
PromoteUpdateStep
applicationURL
string

PromotePullRequestStep

(Appears on: PromoteActivityStep)

PromotePullRequestStep is the step for promoting a version to an environment by raising a Pull Request on the git repository of the environment

Field Description
CoreActivityStep
CoreActivityStep

(Members of CoreActivityStep are embedded into this type.)

pullRequestURL
string
mergeCommitSHA
string

PromoteUpdateStep

(Appears on: PromoteActivityStep)

PromoteUpdateStep is the step for updating a promotion after the Pull Request merges to master

Field Description
CoreActivityStep
CoreActivityStep

(Members of CoreActivityStep are embedded into this type.)

statuses
[]GitStatus

PromoteWorkflowStep

(Appears on: WorkflowStep)

PromoteWorkflowStep is the step of promoting a version of an application to an environment

Field Description
environment
string

PromotionEngineType (string alias)

(Appears on: TeamSettings)

PromotionEngineType is the type of promotion implementation the team uses

PromotionStrategyType (string alias)

(Appears on: EnvironmentSpec)

PromotionStrategyType is the type of a promotion strategy

ProtectionPolicies

(Appears on: Presubmit)

ProtectionPolicies defines the branch protection policies

Field Description
ProtectionPolicy
ProtectionPolicy
(Optional)
Replace
bool
(Optional)
entries
map[string]*github.com/jenkins-x/jx/pkg/apis/jenkins.io/v1.ProtectionPolicy

ProtectionPolicy

(Appears on: GlobalProtectionPolicy, ProtectionPolicies)

ProtectionPolicy for merging.

Field Description
protect
bool

Protect overrides whether branch protection is enabled if set.

requiredStatusChecks
BranchProtectionContextPolicy

RequiredStatusChecks configures github contexts

enforceAdmins
bool

Admins overrides whether protections apply to admins if set.

restrictions
Restrictions

Restrictions limits who can merge

requiredPullRequestReviews
ReviewPolicy

RequiredPullRequestReviews specifies approval/review criteria.

ProwConfigType (string alias)

(Appears on: TeamSettings)

ProwConfigType is the type of prow configuration

ProwEngineType (string alias)

(Appears on: TeamSettings)

ProwEngineType is the type of prow execution engine

PullRequestInfo

(Appears on: BatchPipelineActivity)

PullRequestInfo contains information about a PR, like its PR and Build numbers

Field Description
pullRequestNumber
string
lastBuildNumberForCommit
string

PullRequestMergeType (string alias)

PullRequestMergeType enumerates the types of merges the Git Provider API can perform https://developer.github.com/v3/pulls/#merge-a-pull-request-merge-button

Query

Query is turned into a Git Provider search query. See the docs for details: https://help.github.com/articles/searching-issues-and-pull-requests/

Field Description
excludedBranches
ReplaceableSliceOfStrings
includedBranches
ReplaceableSliceOfStrings
labels
ReplaceableSliceOfStrings
missingLabels
ReplaceableSliceOfStrings
milestone
string
reviewApprovedRequired
bool

QuickStartLocation

(Appears on: BuildPackSpec, TeamSettings)

QuickStartLocation

Field Description
gitUrl
string
gitKind
string
owner
string
includes
[]string
excludes
[]string

RegexpChangeMatcher

(Appears on: Postsubmit, Presubmit)

RegexpChangeMatcher is for code shared between jobs that run only when certain files are changed.

Field Description
runIfChanged
string

RunIfChanged defines a regex used to select which subset of file changes should trigger this job. If any file in the changeset matches this regex, the job will be triggered

ReleaseSpec

(Appears on: Release)

ReleaseSpec is the specification of the Release

Field Description
name
string
version
string
gitHttpUrl
string
gitCloneUrl
string
commits
[]CommitSummary
issues
[]IssueSummary
pullRequests
[]IssueSummary
dependencyUpdates
[]DependencyUpdate
releaseNotesURL
string
gitRepository
string
gitOwner
string

ReleaseStatus

(Appears on: Release)

ReleaseStatus is the status of a release

Field Description
status
ReleaseStatusType

ReleaseStatusType (string alias)

(Appears on: ReleaseStatus)

ReleaseStatusType is the status of a release; usually deployed or failed at completion

ReplaceableMapOfStringContextPolicy

(Appears on: RepoContextPolicy)

ReplaceableMapOfStringContextPolicy is a map of context policies that can optionally completely replace any context policies defined in the parent scheduler

Field Description
replace
bool
Items
map[string]*github.com/jenkins-x/jx/pkg/apis/jenkins.io/v1.ContextPolicy

ReplaceableMapOfStringString

(Appears on: JobBase)

ReplaceableMapOfStringString is a map of strings that can optionally completely replace the map of strings in the parent scheduler

Field Description
entries
map[string]string
replace
bool

Replace the existing entries

ReplaceableSliceOfExternalPlugins

(Appears on: SchedulerSpec)

ReplaceableSliceOfExternalPlugins is a list of external plugins that can optionally completely replace the plugins in any parent SchedulerSpec

Field Description
Replace
bool
entries
[]*github.com/jenkins-x/jx/pkg/apis/jenkins.io/v1.ExternalPlugin

ReplaceableSliceOfStrings

(Appears on: BranchProtectionContextPolicy, Brancher, ContextPolicy, ExternalPlugin, Periodic, Query, Restrictions, SchedulerSpec)

ReplaceableSliceOfStrings is a slice of strings that can optionally completely replace the slice of strings defined in the parent scheduler

Field Description
entries
[]string

Items is the string values

replace
bool

Replace the existing entries

RepoContextPolicy

(Appears on: Presubmit)

RepoContextPolicy overrides the policy for repo, and any branch overrides.

Field Description
ContextPolicy
ContextPolicy
branches
ReplaceableMapOfStringContextPolicy

ResourceReference

(Appears on: CommitStatusDetails, FactSpec, SourceRepositoryGroupSpec, SourceRepositorySpec, TeamSettings)

Field Description
apiVersion
string

API version of the referent.

kind
string

Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds

name
string

Name of the referent. More info: http://kubernetes.io/docs/user-guide/identifiers#names

uid
k8s.io/apimachinery/pkg/types.UID

UID of the referent. More info: http://kubernetes.io/docs/user-guide/identifiers#uids

Restrictions

(Appears on: ProtectionPolicy, ReviewPolicy)

Restrictions limits who can merge Users and Teams entries are appended to parent lists.

Field Description
users
ReplaceableSliceOfStrings
teams
ReplaceableSliceOfStrings

ReviewPolicy

(Appears on: ProtectionPolicy)

ReviewPolicy specifies git provider approval/review criteria. Any nil values inherit the policy from the parent, otherwise bool/ints are overridden. Non-empty lists are appended to parent lists.

Field Description
dismissalRestrictions
Restrictions

Restrictions appends users/teams that are allowed to merge

dismissStaleReviews
bool

DismissStale overrides whether new commits automatically dismiss old reviews if set

requireCodeOwnerReviews
bool

RequireOwners overrides whether CODEOWNERS must approve PRs if set

requiredApprovingReviewCount
int

Approvals overrides the number of approvals required if set (set to 0 to disable)

SchedulerAgent

(Appears on: SchedulerSpec)

SchedulerAgent defines the scheduler agent configuration

Field Description
agent
string

Agent defines the agent used to schedule jobs, by default Prow

SchedulerSpec

(Appears on: Scheduler)

SchedulerSpec defines the pipeline scheduler (e.g. Prow) configuration

Field Description
schedulerAgent
SchedulerAgent
policy
GlobalProtectionPolicy
presubmits
Presubmits
postsubmits
Postsubmits
trigger
Trigger
approve
Approve
lgtm
Lgtm
externalPlugins
ReplaceableSliceOfExternalPlugins
merger
Merger
plugins
ReplaceableSliceOfStrings

Plugins is a list of plugin names enabled for a repo

configUpdater
ConfigUpdater
welcome
[]*github.com/jenkins-x/jx/pkg/apis/jenkins.io/v1.Welcome
periodics
Periodics
attachments
[]*github.com/jenkins-x/jx/pkg/apis/jenkins.io/v1.Attachment

SourceRepositoryGroupSpec

(Appears on: SourceRepositoryGroup)

SourceRepositoryGroupSpec is the metadata for an Application/Project/SourceRepository

Field Description
metadata
Kubernetes meta/v1.ObjectMeta
Refer to the Kubernetes API documentation for the fields of the metadata field.
repositories
[]ResourceReference
scheduler
ResourceReference

SourceRepositorySpec

(Appears on: SourceRepository)

SourceRepositorySpec provides details of the metadata for an App

Field Description
description
string
provider
string

Provider stores the URL of the git provider such as https://github.com

org
string
repo
string
providerName
string

ProviderName is a logical name for the provider without any URL scheme which can be used in a label selector

providerKind
string

ProviderKind is the kind of provider (github / bitbucketcloud / bitbucketserver etc)

url
string

URL is the web URL of the project page

sshCloneURL
string

SSHCloneURL is the git URL to clone this repository using SSH

httpCloneURL
string

HTTPCloneURL is the git URL to clone this repository using HTTP/HTTPS

scheduler
ResourceReference

Scheduler a reference to a custom scheduler otherwise we default to the Team’s Scededuler

StageActivityStep

(Appears on: PipelineActivityStep)

StageActivityStep represents a stage of zero to more sub steps in a jenkins pipeline

Field Description
CoreActivityStep
CoreActivityStep

(Members of CoreActivityStep are embedded into this type.)

steps
[]CoreActivityStep

Statement

(Appears on: FactSpec)

Statement represents a decision that was made, for example that a promotion was approved or denied

Field Description
name
string
statementType
string
measurementValue
bool
tags
[]string

StorageLocation

(Appears on: TeamSettings)

StorageLocation

Field Description
classifier
string
gitUrl
string
gitBranch
string
bucketUrl
string

TeamKindType (string alias)

(Appears on: TeamSpec)

TeamKindType is the kind of an Team

TeamProvisionStatusType (string alias)

(Appears on: TeamStatus)

TeamProvisionStatusType is the kind of an Team

TeamSettings

(Appears on: EnvironmentSpec)

TeamSettings the default settings for a team

Field Description
useGitOps
bool
askOnCreate
bool
branchPatterns
string
forkBranchPatterns
string
quickstartLocations
[]QuickStartLocation
buildPackUrl
string
buildPackRef
string
helmBinary
string
postPreviewJobs
[]Kubernetes batch/v1.Job
promotionEngine
PromotionEngineType
noTiller
bool
helmTemplate
bool
gitServer
string
organisation
string
envOrganisation
string
pipelineUsername
string
pipelineUserEmail
string
dockerRegistryOrg
string
gitPublic
bool
kubeProvider
string
appsRepository
string
buildPackName
string
storageLocations
[]StorageLocation
deployKind
string
importMode
ImportModeType

ImportMode indicates what kind of

prowEngine
ProwEngineType

ProwEngine is the kind of prow engine used such as knative build or build pipeline

versionStreamUrl
string

VersionStreamURL contains the git clone URL for the Version Stream which is the set of versions to use for charts, images, packages etc

versionStreamRef
string

VersionStreamRef contains the git ref (tag or branch) in the VersionStreamURL repository to use as the version stream

appPrefixes
[]string

AppsPrefixes is the list of prefixes for appNames

defaultScheduler
ResourceReference
prowConfig
ProwConfigType

ProwConfig is the way we manage prow configurations

profile
string

Profile is the profile in use (see jx profile)

bootRequirements
string

BootRequirements is a marshaled string of the jx-requirements.yaml used in the most recent run for this cluster

TeamSpec

(Appears on: Team)

TeamSpec is the specification of an Team

Field Description
label
string
kind
TeamKindType
members
[]string

TeamStatus

(Appears on: Team)

TeamStatus is the status for an Team resource

Field Description
provisionStatus
TeamProvisionStatusType
message
string

Trigger

(Appears on: SchedulerSpec)

Trigger specifies a configuration for a single trigger.

The configuration for the trigger plugin is defined as a list of these structures.

Field Description
trustedOrg
string

TrustedOrg is the org whose members’ PRs will be automatically built for PRs to the above repos. The default is the PR’s org.

joinOrgUrl
string

JoinOrgURL is a link that redirects users to a location where they should be able to read more about joining the organization in order to become trusted members. Defaults to the Github link of TrustedOrg.

onlyOrgMembers
bool

OnlyOrgMembers requires PRs and/or /ok-to-test comments to come from org members. By default, trigger also include repo collaborators.

ignoreOkToTest
bool

IgnoreOkToTest makes trigger ignore /ok-to-test comments. This is a security mitigation to only allow testing from trusted users.

UserDetails

(Appears on: User, CommitSummary, IssueSummary)

UserDetails containers details of a user

Field Description
login
string
name
string
email
string
creationTimestamp
Kubernetes meta/v1.Time
url
string
avatarUrl
string
serviceAccount
string
accountReference
[]AccountReference
externalUser
bool

UserSpec

(Appears on: PreviewGitSpec)

UserSpec is the user details

Field Description
username
string
name
string
linkUrl
string
imageUrl
string

WebHookEngineType (string alias)

(Appears on: EnvironmentSpec)

WebHookEngineType is the type of webhook processing implementation the team uses

Welcome

Welcome welcome plugin config

Field Description
message_template
string

WorkflowPreconditions

(Appears on: WorkflowStep)

WorkflowPreconditions is the trigger to start a step

Field Description
environments
[]string

the names of the environments which need to have promoted before this step can be triggered

WorkflowSpec

(Appears on: Workflow)

WorkflowSpec is the specification of the pipeline activity

Field Description
pipeline
string
steps
[]WorkflowStep

WorkflowStatus

(Appears on: Workflow)

WorkflowStatus is the status for an Environment resource

Field Description
version
string

WorkflowStatusType (string alias)

WorkflowStatusType is the status of an activity; usually succeeded or failed/error on completion

WorkflowStep

(Appears on: WorkflowSpec)

WorkflowStep represents a step in a pipeline activity

Field Description
kind
WorkflowStepKindType
name
string
description
string
trigger
WorkflowPreconditions
promote
PromoteWorkflowStep

WorkflowStepKindType (string alias)

(Appears on: WorkflowStep)

WorkflowStepKindType is a kind of step


Generated with gen-crd-api-reference-docs on git commit 31fac5d26.


Last modified October 22, 2019: release 0.0.1167 (242139c)