Camel K API
Resource Types
Build
Build is the Schema for the builds API
Field | Description |
---|---|
|
|
|
|
|
Refer to the Kubernetes API documentation for the fields of the |
|
|
|
CamelCatalog
CamelCatalog represents the languages, components, data formats and capabilities enabled on a given runtime provider. The catalog may be statically generated.
Field | Description |
---|---|
|
|
|
|
|
Refer to the Kubernetes API documentation for the fields of the |
|
the actual state of the catalog |
|
the desired state of the catalog |
Integration
Integration is the Schema for the integrations API
Field | Description |
---|---|
|
|
|
|
|
Refer to the Kubernetes API documentation for the fields of the |
|
the desired Integration specification |
|
the status of the Integration |
IntegrationKit
IntegrationKit defines a container image and additional configuration needed to run an Integration
.
An IntegrationKit
is a generic image generally built from the requirements of an Integration
, but agnostic to it,
in order to be reused by any other Integration
which has the same required set of capabilities. An IntegrationKit
may be used for other kits as a base container layer, when the incremental
build option is enabled.
Field | Description |
---|---|
|
|
|
|
|
Refer to the Kubernetes API documentation for the fields of the |
|
the desired configuration |
|
the actual status |
IntegrationPlatform
IntegrationPlatform is the resource used to drive the Camel K operator behavior.
It defines the behavior of all Custom Resources (IntegrationKit
, Integration
, Kamelet
) in the given namespace.
When the Camel K operator is installed in global
mode,
you will need to specify an IntegrationPlatform
in each namespace where you want the Camel K operator to be executed
Field | Description |
---|---|
|
|
|
|
|
Refer to the Kubernetes API documentation for the fields of the |
|
Internal Types
Artifact
Appears on:
Artifact represents a materialized artifact (a jar dependency or in general a file used by the build)
Field | Description |
---|---|
|
the identification (GAV for maven dependencies or file name for other file types) |
|
where it is located in the builder |
|
the expected location in the runtime |
|
a checksum (SHA1) of the content |
BaseTask
Appears on:
BaseTask is a base for the struct hierarchy
Field | Description |
---|---|
|
name of the task |
BuildCondition
Appears on:
BuildCondition describes the state of a resource at a certain point.
Field | Description |
---|---|
|
Type of integration condition. |
Status of the condition, one of True, False, Unknown. |
|
|
The last time this condition was updated. |
|
Last time the condition transitioned from one status to another. |
|
The reason for the condition’s last transition. |
|
A human-readable message indicating details about the transition. |
BuildSpec
Appears on:
BuildSpec defines the Build operation to be executed
Field | Description |
---|---|
|
The sequence of Build tasks to be performed as part of the Build execution. |
|
The strategy that should be used to perform the Build. |
|
Timeout defines the Build maximum execution duration. The Build deadline is set to the Build start time plus the Timeout duration. If the Build deadline is exceeded, the Build context is canceled, and its phase set to BuildPhaseFailed. |
BuildStatus
Appears on:
BuildStatus defines the observed state of Build
Field | Description |
---|---|
|
describes the phase |
|
the image name built |
|
the digest from image |
|
the base image used for this build |
|
a list of artifacts contained in the build |
|
the error description (if any) |
|
the reason of the failure (if any) |
|
the time when it started |
|
a list of conditions occurred during the build |
|
how long it took for the build Change to Duration / ISO 8601 when CRD uses OpenAPI spec v3 https://github.com/OAI/OpenAPI-Specification/issues/845 |
BuildStrategy(string
alias)
Appears on:
BuildStrategy specifies how the Build should be executed. It will trigger a Maven process that will take care of producing the expected Camel/Camel-Quarkus runtime.
BuildahTask
Appears on:
BuildahTask is used to configure Buildah
Field | Description |
---|---|
|
(Members of |
|
(Members of |
|
log more information |
BuilderTask
Appears on:
BuilderTask is the generic task in charge of building the application image
Field | Description |
---|---|
|
(Members of |
|
the base image layer |
|
the configuration required for the runtime application |
|
Deprecated: no longer in use the source code for the Route(s) |
|
Deprecated: no longer in use |
|
the list of dependencies to use for this build |
|
the list of steps to execute (see pkg/builder/) |
|
the configuration required by Maven for the application build phase |
|
workspace directory to use |
CamelArtifact
Appears on:
CamelArtifact represent the configuration for a feature offered by Camel
Field | Description |
---|---|
|
(Members of Base Camel Artifact dependency |
|
accepted URI schemes |
|
accepted languages |
|
accepted data formats |
|
required dependencies |
|
the Java types used by the artifact feature (ie, component, data format, …) |
CamelArtifactDependency
Appears on:
CamelArtifactDependency represent a maven’s dependency
Field | Description |
---|---|
|
(Members of the maven dependency |
|
provide a list of artifacts to exclude for this dependency |
CamelArtifactExclusion
Appears on:
CamelArtifactExclusion represents an exclusion clause
Field | Description |
---|---|
|
Maven Group |
|
Maven Artifact |
CamelCatalogSpec
Appears on:
CamelCatalogSpec specify what features a Camel runtime provides
Field | Description |
---|---|
|
the runtime targeted for the catalog |
|
artifacts required by this catalog |
|
loaders required by this catalog |
CamelCatalogStatus
Appears on:
CamelCatalogStatus defines the observed state of CamelCatalog. As the catalog is a static resource, we expect it to be empty.
CamelLoader
Appears on:
CamelLoader represents the configuration required to load a DSL
Field | Description |
---|---|
|
(Members of the base Maven artifact required |
|
a list of DSLs supported |
|
a list of additional dependencies required beside the base one |
|
Deprecated: never used a set of general metadata for various purposes |
CamelScheme
Appears on:
CamelScheme represents the scheme used to identify a component in a URI (ie, timer in a timer:xyz endpoint URI)
Field | Description |
---|---|
|
the ID (ie, timer in a timer:xyz URI) |
|
is a passive scheme |
|
is a HTTP based scheme |
|
required scope for consumer |
|
required scope for producers |
CamelSchemeScope
Appears on:
CamelSchemeScope contains scoped information about a scheme
Field | Description |
---|---|
|
list of dependencies needed for this scope |
Capability
Appears on:
Capability is a particular feature which requires a well known set of dependencies
Field | Description |
---|---|
|
|
|
Deprecated: not in use |
ConfigurationSpec
Appears on:
ConfigurationSpec represents a generic configuration specification
Field | Description |
---|---|
|
represents the type of configuration, ie: property, configmap, secret, … |
|
the value to assign to the configuration (syntax may vary depending on the |
|
Deprecated: no longer used |
|
Deprecated: no longer used |
|
Deprecated: no longer used |
DataSpec
Appears on:
DataSpec represents the way the source is materialized in the running Pod
Field | Description |
---|---|
|
the name of the specification |
|
the path where the file is stored |
|
the source code (plain text) |
|
the source code (binary) |
|
the confimap reference holding the source content |
|
the confimap key holding the source content |
|
the content type (tipically text or binary) |
|
if the content is compressed (base64 encrypted) |
Failure
Appears on:
Failure represent a message specifying the reason and the time of an event failure
Field | Description |
---|---|
|
a short text specifying the reason |
the time when the failure has happened |
|
|
the recovery attempted for this failure |
FailureRecovery
Appears on:
FailureRecovery defines the attempts to recover a failure
Field | Description |
---|---|
|
attempt number |
|
maximum number of attempts |
|
(Optional) time of the attempt execution |
Flow
Appears on:
Flow is an unstructured object representing a Camel Flow in YAML/JSON DSL
Field | Description |
---|---|
|
(Members of |
IntegrationCondition
Appears on:
IntegrationCondition describes the state of a resource at a certain point.
Field | Description |
---|---|
Type of integration condition. |
|
Status of the condition, one of True, False, Unknown. |
|
|
The last time this condition was updated. |
|
Last time the condition transitioned from one status to another. |
|
First time the condition status transitioned to True. |
|
The reason for the condition’s last transition. |
|
A human-readable message indicating details about the transition. |
IntegrationKitCondition
Appears on:
IntegrationKitCondition describes the state of a resource at a certain point.
Field | Description |
---|---|
Type of integration condition. |
|
Status of the condition, one of True, False, Unknown. |
|
|
The last time this condition was updated. |
|
Last time the condition transitioned from one status to another. |
|
The reason for the condition’s last transition. |
|
A human-readable message indicating details about the transition. |
IntegrationKitSpec
Appears on:
IntegrationKitSpec defines a container image and additional configurations required to kick off an Integration
which certain features
Field | Description |
---|---|
|
the container image as identify in the container registry |
|
a list of Camel dependecies used by this kit |
|
the profile which is expected by this kit |
|
traits that the kit will execute |
|
configuration used by the kit TODO: we should deprecate in future releases in favour of mount, openapi or camel traits |
|
Maven repositories that can be used by the kit |
IntegrationKitStatus
Appears on:
IntegrationKitStatus defines the observed state of IntegrationKit
Field | Description |
---|---|
|
phase of the kit |
|
base image used by the kit |
|
actual image name of the kit |
|
actual image digest of the kit |
|
list of artifacts used by the kit |
|
failure reason (if any) |
|
the runtime version for which this kit was configured |
|
the runtime provider for which this kit was configured |
|
the platform for which this kit was configured |
|
the Camel K operator version for which this kit was configured |
|
a list of conditions which happened for the events related the kit |
IntegrationPlatformBuildPublishStrategy(string
alias)
Appears on:
IntegrationPlatformBuildPublishStrategy defines the strategy used to package and publish an Integration base image
IntegrationPlatformBuildSpec
Appears on:
IntegrationPlatformBuildSpec contains platform related build information. This configuration can be used to tune the behavior of the Integration/IntegrationKit image builds. You can define the build strategy, the image registry to use and the Maven configuration to adopt.
Field | Description |
---|---|
|
the strategy to adopt for building an Integration base image |
|
the strategy to adopt for publishing an Integration base image |
|
the Camel K Runtime dependency version |
|
the runtime used. Likely Camel Quarkus (we used to have main runtime which has been discontinued since version 1.5) |
|
a base image that can be used as base layer for all images. It can be useful if you want to provide some custom base image with further utility softwares |
|
the image registry used to push/pull Integration images |
|
how much time to wait before time out the build process |
|
Maven configuration used to build the Camel/Camel-Quarkus applications |
|
Deprecated: Use PublishStrategyOptions instead enables Kaniko publish strategy cache |
|
Deprecated: Use PublishStrategyOptions instead the Persistent Volume Claim used by Kaniko publish strategy, if cache is enabled |
|
IntegrationPlatformCluster(string
alias)
Appears on:
IntegrationPlatformCluster is the kind of orchestration cluster the platform is installed into
IntegrationPlatformCondition
Appears on:
IntegrationPlatformCondition describes the state of a resource at a certain point.
Field | Description |
---|---|
Type of integration condition. |
|
Status of the condition, one of True, False, Unknown. |
|
|
The last time this condition was updated. |
|
Last time the condition transitioned from one status to another. |
|
The reason for the condition’s last transition. |
|
A human-readable message indicating details about the transition. |
IntegrationPlatformConditionType(string
alias)
Appears on:
IntegrationPlatformConditionType defines the type of condition
IntegrationPlatformKameletRepositorySpec
Appears on:
IntegrationPlatformKameletRepositorySpec defines the location of the Kamelet catalog to use
Field | Description |
---|---|
|
the remote repository in the format github:ORG/REPO/PATH_TO_KAMELETS_FOLDER |
IntegrationPlatformKameletSpec
Appears on:
IntegrationPlatformKameletSpec define the behavior for all the Kamelets controller by the IntegrationPlatform
Field | Description |
---|---|
|
remote repository used to retrieve Kamelet catalog |
IntegrationPlatformPhase(string
alias)
Appears on:
IntegrationPlatformPhase is the phase of an IntegrationPlatform
IntegrationPlatformResourcesSpec
Appears on:
IntegrationPlatformResourcesSpec contains platform related resources. Deprecated: not used
IntegrationPlatformSpec
Appears on:
IntegrationPlatformSpec defines the desired state of IntegrationPlatform
Field | Description |
---|---|
|
what kind of cluster you’re running (ie, plain Kubernetes or OpenShift) |
|
the profile you wish to use. It will apply certain traits which are required by the specific profile chosen. It usually relates the Cluster with the optional definition of special profiles (ie, Knative) |
specify how to build the Integration/IntegrationKits |
|
|
Deprecated: not used |
|
list of traits to be executed for all the Integration/IntegrationKits built from this IntegrationPlatform |
|
list of configuration properties to be attached to all the Integration/IntegrationKits built from this IntegrationPlatform |
|
configuration to be executed to all Kamelets controlled by this IntegrationPlatform |
IntegrationPlatformStatus
Appears on:
IntegrationPlatformStatus defines the observed state of IntegrationPlatform
Field | Description |
---|---|
|
(Members of |
|
defines in what phase the IntegrationPlatform is found |
|
which are the conditions met (particularly useful when in ERROR phase) |
|
the Camel K operator version controlling this IntegrationPlatform |
|
generic information related to the build of Camel K operator software |
IntegrationSpec
Appears on:
IntegrationSpec specifies the configuration of an Integration. The Integration will be watched by the operator which will be in charge to run the related application, according to the configuration specified.
Field | Description |
---|---|
|
the number of |
|
the sources which contain the Camel routes to run |
|
a source in YAML DSL language which contain the routes to run |
|
Deprecated: Use container trait (container.resources) to manage resources Use openapi trait (openapi.configmaps) to manage OpenAPIs specifications |
|
the reference of the |
|
the list of Camel or Maven dependencies required by the Integration |
|
the profile needed to run this Integration |
|
the traits needed to run this Integration |
|
Pod template customization |
|
Deprecated: Use camel trait (camel.properties) to manage properties Use container trait (mount.configs) to manage configs Use container trait (mount.resources) to manage resources Use container trait (mount.volumes) to manage volumes |
|
additional Maven repositories to be used |
|
custom SA to use for the Integration |
IntegrationStatus
Appears on:
IntegrationStatus defines the observed state of Integration
Field | Description |
---|---|
|
the actual phase |
|
the digest calculated for this Integration |
|
the container image used |
|
a list of dependencies needed by the application |
|
the profile needed to run this Integration |
|
the reference of the |
|
The IntegrationPlatform watching this Integration |
|
a list of sources generated for this Integration |
|
Deprecated: a list of resources generated for this Integration |
|
the runtime version targeted for this Integration |
|
the runtime provider targeted for this Integration |
|
Deprecated: a list of configuration specification |
|
a list of events happened for the Integration |
|
the operator version |
|
the number of replicas |
|
label selector |
|
features offered by the Integration |
|
the timestamp representing the last time when this integration was initialized. |
KanikoTask
Appears on:
KanikoTask is used to configure Kaniko
Field | Description |
---|---|
|
(Members of |
|
(Members of |
|
log more information |
|
use a cache |
KanikoTaskCache
Appears on:
KanikoTaskCache is used to configure Kaniko cache
Field | Description |
---|---|
|
true if a cache is enabled |
|
the PVC used to store the cache |
MavenArtifact
Appears on:
MavenArtifact defines a GAV (Group:Artifact:Version) Maven artifact
Field | Description |
---|---|
|
Maven Group |
|
Maven Artifact |
|
Maven Version |
MavenBuildSpec
Appears on:
MavenBuildSpec defines the Maven configuration plus additional repositories to use
Field | Description |
---|---|
|
(Members of base Maven specification |
|
additional repositories |
|
Servers (auth) |
MavenSpec
Appears on:
MavenSpec —
Field | Description |
---|---|
|
The path of the local Maven repository. |
|
The Maven properties. |
|
A reference to the ConfigMap or Secret key that contains the Maven settings. |
|
Deprecated: use CASecrets The Secret name and key, containing the CA certificate(s) used to connect to remote Maven repositories. It can contain X.509 certificates, and PKCS#7 formatted certificate chains. A JKS formatted keystore is automatically created to store the CA certificate(s), and configured to be used as a trusted certificate(s) by the Maven commands. Note that the root CA certificates are also imported into the created keystore. |
|
The Secrets name and key, containing the CA certificate(s) used to connect to remote Maven repositories. It can contain X.509 certificates, and PKCS#7 formatted certificate chains. A JKS formatted keystore is automatically created to store the CA certificate(s), and configured to be used as a trusted certificate(s) by the Maven commands. Note that the root CA certificates are also imported into the created keystore. |
|
The Maven build extensions. See https://maven.apache.org/guides/mini/guide-using-extensions.html. |
|
The CLI options that are appended to the list of arguments for Maven commands,
e.g., |
PodSpec
Appears on:
PodSpec defines a group of Kubernetes resources
Field | Description |
---|---|
|
Volumes |
|
InitContainers |
|
Containers |
|
EphemeralContainers |
|
RestartPolicy |
|
TerminationGracePeriodSeconds |
|
ActiveDeadlineSeconds |
|
DNSPolicy |
|
NodeSelector |
|
TopologySpreadConstraints |
|
PodSecurityContext |
PodSpecTemplate
Appears on:
PodSpecTemplate represent a template used to deploy an Integration Pod
Field | Description |
---|---|
|
the specification |
PublishTask
Appears on:
PublishTask image publish configuration
Field | Description |
---|---|
|
can be useful to share info with other tasks |
|
base image layer |
|
final image name |
|
where to publish the final image |
RawMessage([]byte
alias)
Appears on:
RawMessage is a raw encoded JSON value. It implements Marshaler and Unmarshaler and can be used to delay JSON decoding or precompute a JSON encoding.
RegistrySpec
Appears on:
RegistrySpec provides the configuration for the container registry
Field | Description |
---|---|
|
if the container registry is insecure (ie, http only) |
|
the URI to access |
|
the secret where credentials are stored |
|
the configmap which stores the Certificate Authority |
|
the registry organization |
Repository
Appears on:
Repository defines a Maven repository
Field | Description |
---|---|
|
identifies the repository |
|
name of the repository |
|
location of the repository |
|
can use snapshot |
|
can use stable releases |
RepositoryPolicy
Appears on:
RepositoryPolicy defines the policy associated to a Maven repository
Field | Description |
---|---|
|
is the policy activated or not |
|
This element specifies how often updates should attempt to occur.
Maven will compare the local POM’s timestamp (stored in a repository’s maven-metadata file) to the remote.
The choices are: |
|
When Maven deploys files to the repository, it also deploys corresponding checksum files.
Your options are to |
ResourceSpec
Appears on:
ResourceSpec represent an attached resource which will be materialized as a file on the running Pod
TODO: we should deprecate in future releases in favour of mount, openapi or camel traits
Field | Description |
---|---|
|
(Members of the content of the resource |
|
the kind of data to expect |
|
the mount path on destination |
RuntimeSpec
Appears on:
RuntimeSpec represents the configuration for the Java runtime in charge to execute the Camel application
Field | Description |
---|---|
|
Camel K Runtime version |
|
Camel main application provider, ie, Camel Quarkus |
|
application entry point (main) to be executed |
|
list of dependencies needed to run the application |
|
set of metadata |
|
features offered by this runtime |
S2iTask
Appears on:
S2iTask is used to configure S2I
Field | Description |
---|---|
|
(Members of |
|
can be useful to share info with other tasks |
|
used by the ImageStream |
Server
Appears on:
Field | Description |
---|---|
|
|
|
|
|
|
|
|
|
SourceSpec
Appears on:
SourceSpec defines the configuration for one or more routes to be executed in a certain Camel DSL language
Field | Description |
---|---|
|
(Members of contains configuration related to the source code |
|
specify which is the language (Camel DSL) used to interpret this source code |
|
Loader is an optional id of the org.apache.camel.k.RoutesLoader that will interpret this source at runtime |
|
Interceptors are optional identifiers the org.apache.camel.k.RoutesLoader uses to pre/post process sources |
|
Type defines the kind of source described by this object |
|
List of property names defined in the source (e.g. if type is "template") |
SpectrumTask
Appears on:
SpectrumTask is used to configure Spectrum
Field | Description |
---|---|
|
(Members of |
|
(Members of |
Task
Appears on:
Task represents the abstract task. Only one of the task should be configured to represent the specific task chosen.
Field | Description |
---|---|
|
a BuilderTask (base task) |
|
a BuildahTask, for Buildah strategy |
|
a KanikoTask, for Kaniko strategy |
|
a SpectrumTask, for Spectrum strategy |
|
a S2iTask, for S2I strategy |
TraitConfiguration
Appears on:
TraitConfiguration represents the expected configuration for a given trait parameter
Field | Description |
---|---|
|
(Members of generic raw message, tipically a map containing the keys (trait parameters) and the values (either single text or array) |
TraitProfile(string
alias)
Appears on:
TraitProfile represents lists of traits that are enabled for the specific installation/integration
TraitSpec
Appears on:
A TraitSpec contains the configuration of a trait
Field | Description |
---|---|
|
TraitConfiguration parameters configuration |
ValueSource
Appears on:
ValueSource —
Field | Description |
---|---|
|
Selects a key of a ConfigMap. |
|
Selects a key of a secret. |