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 a detailed description with examples, refer to <a href="https://github.com/redhat-appstudio/book/blob/main/book/HAS/hybrid-application-service-api.md"> 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 a detailed description with examples, refer to <a href="https://github.com/redhat-appstudio/book/blob/main/book/HAS/hybrid-application-service-api.md"> 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 a detailed description with examples, refer to <a href="https://github.com/redhat-appstudio/book/blob/main/book/HAS/hybrid-application-service-api.md"> 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 |