Application Profile
An application profile is an organization-level runtime blueprint for applications. Applications reference a profile by profileName; the profile then controls the deployment target and defaults such as cluster selection, provider selection, resources, and tier behavior.
Use profiles to keep application manifests portable. A developer can deploy the same application manifest to a different environment by changing the profile reference instead of embedding cluster access details in the application.
What a Profile Contains
| Field | Purpose |
|---|---|
profileName | DNS-style profile name used by application manifests. |
clusterName | Optional fixed target cluster. This is the clearest option when you already know the cluster. |
cloudProvider | Optional provider and region selection for platform-assisted target selection. |
| Tier settings | Optional runtime tier for image-based applications. |
The profile selected by an application should be treated as part of the application deployment contract. If an application needs to move to a different profile, create or redeploy the application with the intended profileName.
Discover Inputs
List clusters:
astroctl infra k8s get
List supported cloud providers:
astroctl cloud list
List provider regions:
astroctl cloud aws regions list
astroctl cloud gcp regions list
astroctl cloud azure regions list
List available profile tiers:
astroctl app profile tiers
Get one tier:
astroctl app profile tiers standard
Manifest Examples
Fixed Cluster
Use clusterName when you want the profile to deploy to a specific cluster:
profileName: dev-profile
clusterName: dev-stack-aws
Apply it:
astroctl app profile apply -f dev-profile.yaml
Provider and Region
Use cloudProvider when the platform should select a target from a provider and region:
profileName: gcp-us-west2-profile
cloudProvider:
providerName: gcp
region: us-west2
Apply it:
astroctl app profile apply -f gcp-us-west2-profile.yaml
Platform Selection
If you omit both clusterName and cloudProvider, the platform can select an eligible target based on available organization configuration:
profileName: platform-selected-profile
Apply it:
astroctl app profile apply -f platform-selected-profile.yaml
Manage Profiles
Console
Profiles are created and selected in the Deploy Application wizard's Profile step: choose an existing profile for the target cluster, or define a new one inline while deploying an application.
CLI
List profiles:
astroctl app profile get
Get one profile:
astroctl app profile get dev-profile
Delete a profile:
astroctl app profile delete -n dev-profile
Deleting a profile can affect applications that reference it. Confirm no running application depends on the profile before deleting it.
See the application profile CLI reference for every subcommand.
Nova
Ask in plain language, for example "list my application profiles" or "create a profile that targets the dev-stack-aws cluster." Because deleting a profile can break applications that reference it, Nova confirms the exact profile with you before removing it.