Skip to main content

Documentation Index

Fetch the complete documentation index at: https://astronomer-preview.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Astro Private Cloud uses Helm to install and manage some platform-level settings that apply to all users and Deployments. The Astronomer Helm chart includes configurations for areas such as:
  • Identity provider integrations
  • Registry backends
  • Resource allocation limits
You can apply any platform customizations to your cluster using a YAML configuration. values.yaml contains settings for both the Astronomer Helm chart, as well as Helm charts for system components like ElasticSearch and nginx. Using Helm allows you to keep all of your configurations in a single file that you can version and store securely. Use this document to learn how to retrieve your existing Helm configuration, modify configurations, and apply your changes to your cluster.
1
Retrieve your current cluster configuration
2
The best way to add or modify configurations is to start with your existing values.yaml file. To retrieve the current values.yaml file of an existing APC cluster, run the following command:
3
helm get values -o yaml <your-installation-release-name> -n <your-installation-namespace> > values.yaml
4
This command will overwrite any file called values.yaml you have in your current directory.
5
Alternatively, your team might use version management to store your existing Helm configuration. In this case, retrieve, update, and store your configuration file according to your team’s workflows. If your configuration file includes secrets, ensure it is encrypted before storing it in version control.
6
Update your configurations
7
  • Create a copy of your values.yaml file so that you can compare your existing configuration to your new configuration.
  • In your copied file, update the values for the configurations you want to change. To update a configuration you haven’t already specified, copy the corresponding default values from the relevant default Helm chart into your values.yaml file and then modify the value.
    • 8
    When you have finished updating the configuration, ensure that they have the same relative order and indentation as they do in the default configuration file. If they don’t, your changes might not be properly applied. The name of the Helm charts you’re modifying should be the first items in the file, such as in the following example:
    9
    global:
  <your-global-configuration>

astronomer:
  <your-astronomer-configuration>

alertmanager:
  <your-alertmanager-configuration>

nginx:
  <your-nginx-configuration>
    10
    A number of configurations, including those for user permissions and identity providers, must be set in theastronomer.houston.configsection of the Astronomer Helm chart, but the default values forhouston.configare not available for reference in the Astronomer Helm repository. To view the default configurations for this section, see theAstronomer documentation repository.
    11
    Push changes to your cluster
    12
  • Copy your platform namespace and release name. These are both likely to be astronomer. Your platform release name can be found in your list of active namespaces, which you can view by running the following command:
    • 13
    kubectl get ns
    14
    To locate your platform release name, run:
    15
    helm ls -n <your-installation-namespace>
    16
  • Save your updated values.yaml file and run the following command to apply it as a Helm upgrade:
    • 17
    helm upgrade <your-installation-release-name> astronomer/astronomer -f <your-updated-config-yaml-file> -n <your-installation-namespace> --set astronomer.houston.upgradeDeployments.enabled=false
    18
    Setting astronomer.houston.upgradeDeployments.enabled=false ensures that no Airflow components in Deployments are restarted during your upgrade.
    19
  • Run the following command to confirm that your configuration was applied:
    • 20
    helm get values <your-installation-release-name> -n <your-installation-namespace>