Application API Reference
appstudio.redhat.com/v1alpha1
Package v1alpha1 contains API Schema definitions for the appstudio v1alpha1 API group
Application
Application is the Schema for the applications API. For description, refer to Application API Reference Hybrid Application Service Kube API </a>
| Field | Description | Default | Validation |
|---|---|---|---|
|
|
||
|
|
||
|
Refer to Kubernetes API documentation for fields of |
||
|
|||
|
ApplicationGitRepository
ApplicationGitRepository defines a git repository for a given Application resource (either appmodel or gitops)
| Field | Description | Default | Validation |
|---|---|---|---|
|
URL refers to the repository URL that should be used. If not specified, a GitOps repository under the |
||
|
Branch corresponds to the branch in the repository that should be used |
||
|
Context corresponds to the context within the repository that should be used |
ApplicationList
ApplicationList contains a list of Application
| Field | Description | Default | Validation |
|---|---|---|---|
|
|
||
|
|
||
|
Refer to Kubernetes API documentation for fields of |
||
|
ApplicationSpec
ApplicationSpec defines the desired state of Application
| Field | Description | Default | Validation |
|---|---|---|---|
|
DisplayName refers to the name that an application will be deployed with in App Studio. |
||
|
AppModelRepository refers to the git repository that will store the application model (a devfile) |
||
|
GitOpsRepository refers to the git repository that will store the gitops resources. |
||
|
Description refers to a brief description of the application. |
ApplicationStatus
ApplicationStatus defines the observed state of Application
| Field | Description | Default | Validation |
|---|---|---|---|
|
Conditions is an array of the Application’s status conditions |
||
|
Devfile corresponds to the devfile representation of the Application resource |
Component
Component is the Schema for the components API. For description, refer to Application API Reference Hybrid Application Service Kube API </a>
| Field | Description | Default | Validation |
|---|---|---|---|
|
|
||
|
|
||
|
Refer to Kubernetes API documentation for fields of |
||
|
|||
|
ComponentDetectionDescription
ComponentDetectionDescription holds all the information about the component being detected
| Field | Description | Default | Validation |
|---|---|---|---|
|
DevfileFound tells if a devfile is found in the component |
||
|
Language specifies the language of the component detected |
||
|
ProjectType specifies the type of project for the component detected |
||
|
ComponentStub is a stub of the component detected with all the info gathered from the devfile or service detection |
ComponentDetectionMap
Underlying type: map[string]ComponentDetectionDescription
ComponentDetectionMap is a map containing all the components and their detected information
ComponentDetectionQuery
ComponentDetectionQuery is the Schema for the componentdetectionqueries API. For description, refer to Application API Reference Hybrid Application Service Kube API </a>
| Field | Description | Default | Validation |
|---|---|---|---|
|
|
||
|
|
||
|
Refer to Kubernetes API documentation for fields of |
||
ComponentDetectionQueryList
ComponentDetectionQueryList contains a list of ComponentDetectionQuery
| Field | Description | Default | Validation |
|---|---|---|---|
|
|
||
|
|
||
|
Refer to Kubernetes API documentation for fields of |
||
|
ComponentDetectionQuerySpec
ComponentDetectionQuerySpec defines the desired state of ComponentDetectionQuery
| Field | Description | Default | Validation |
|---|---|---|---|
|
Git Source for a Component. |
||
|
Secret describes the name of an optional Kubernetes secret containing a Personal Access Token to access the git repostiory. |
||
|
It defines if should generate random characters at the end of the component name instead of a predicted default value |
ComponentDetectionQueryStatus
ComponentDetectionQueryStatus defines the observed state of ComponentDetectionQuery
| Field | Description | Default | Validation |
|---|---|---|---|
|
Conditions is an array of the ComponentDetectionQuery’s status conditions |
||
|
ComponentDetected gives a list of components and the info from detection |
ComponentList
ComponentList contains a list of Component
| Field | Description | Default | Validation |
|---|---|---|---|
|
|
||
|
|
||
|
Refer to Kubernetes API documentation for fields of |
||
|
ComponentSource
ComponentSource describes the Component source
| Field | Description | Default | Validation |
|---|---|---|---|
|
Git Source for a Component. |
ComponentSourceUnion
| Field | Description | Default | Validation |
|---|---|---|---|
|
Git Source for a Component. |
ComponentSpec
ComponentSpec defines the desired state of Component
| Field | Description | Default | Validation |
|---|---|---|---|
|
ComponentName is name of the component to be added to the Application. The name must adhere to DNS-1123 validation. |
MaxLength: 63 |
|
|
Application is the name of the application resource that the component belongs to. |
Pattern: |
|
|
Secret describes the name of a Kubernetes secret containing either: |
||
|
Source describes the Component source. |
||
|
Compute Resources required by this component. |
||
|
The number of replicas to deploy the component with. |
||
|
The port to expose the component over. |
||
|
The route to expose the component with. |
||
|
An array of environment variables to add to the component (ValueFrom not currently supported) |
||
|
The container image to build or create the component from |
||
|
Whether or not to bypass the generation of GitOps resources for the Component. Defaults to false. |
||
|
The list of components to be nudged by this components build upon a successful result. |
ComponentStatus
ComponentStatus defines the observed state of Component
| Field | Description | Default | Validation |
|---|---|---|---|
|
Conditions is an array of the Component’s status conditions |
||
|
Webhook URL generated by Builds |
||
|
ContainerImage stores the associated built container image for the component |
||
|
The devfile model for the Component CR |
||
|
GitOps specific status for the Component CR |
||
|
The last built commit id (SHA-1 checksum) from the latest component build. |
||
|
The last digest image component promoted with. |
||
|
The list of names of Components whose builds nudge this resource (their spec.build-nudges-ref[] references this component) |
GitOpsStatus
GitOpsStatus contains GitOps repository-specific status for the component
| Field | Description | Default | Validation |
|---|---|---|---|
|
RepositoryURL is the gitops repository URL for the component |
||
|
Branch is the git branch used for the gitops repository |
||
|
Context is the path within the gitops repository used for the gitops resources |
||
|
ResourceGenerationSkipped is whether or not GitOps resource generation was skipped for the component |
||
|
CommitID is the most recent commit ID in the GitOps repository for this component |
GitSource
| Field | Description | Default | Validation |
|---|---|---|---|
|
An HTTPS URL representing the git repository to create the component from. |
||
|
Specify a branch/tag/commit id. If not specified, default is |
||
|
A relative path inside the git repo containing the component |
||
|
If specified, the devfile at the URI will be used for the component. Can be a local path inside the repository, or an external URL. |
||
|
If specified, the dockerfile at the URI will be used for the component. Can be a local path inside the repository, or an external URL. |
Snapshot
Snapshot is the Schema for the snapshots API
| Field | Description | Default | Validation |
|---|---|---|---|
|
|
||
|
|
||
|
Refer to Kubernetes API documentation for fields of |
||
|
|||
|
SnapshotArtifacts
SnapshotArtifacts is a placeholder section for 'artifact links' we want to maintain to other AppStudio resources.
For example: here I’m imagining we might want to keep track of container image <⇒ (source code repo, commit sha) links, Which might be useful to present to the user within the UI.
| Field | Description | Default | Validation | ||
|---|---|---|---|---|---|
|
|
SnapshotComponent
SnapshotComponent
| Field | Description | Default | Validation |
|---|---|---|---|
|
Name is the name of the component |
||
|
ContainerImage is the container image to use when deploying the component, as part of a Snapshot |
||
|
Source describes the Component source. |
SnapshotList
SnapshotList contains a list of Snapshot
| Field | Description | Default | Validation |
|---|---|---|---|
|
|
||
|
|
||
|
Refer to Kubernetes API documentation for fields of |
||
|
SnapshotSpec
SnapshotSpec defines the desired state of Snapshot
| Field | Description | Default | Validation |
|---|---|---|---|
|
Application is a reference to the name of an Application resource within the same namespace, which defines the target application for the Snapshot (when used with a Binding). |
||
|
DisplayName is a user-visible, user-definable name for the resource (and is not used for any functional behaviour) |
||
|
DisplayDescription is a user-visible, user definable description for the resource (and is not used for any functional behaviour) |
||
|
Components field contains the sets of components to deploy as part of this snapshot. |
||
|
Artifacts is a placeholder section for 'artifact links' we want to maintain to other AppStudio resources. |
SnapshotStatus
SnapshotStatus defines the observed state of Snapshot
| Field | Description | Default | Validation |
|---|---|---|---|
|
Conditions represent the latest available observations for the Snapshot |