Understanding Satellite Config

With Satellite Config, create a configuration to deploy Kubernetes resources to Red Hat OpenShift on IBM Cloud clusters in your Satellite location or IBM Cloud.

You can create either GitOps-based configurations or Direct Upload configurations.

Understanding GitOps-based configurations

Store Kubernetes resource definitions in a Git repository. Clusters automatically pull and deploy changes from your repository. Select the GitOps template when you create your configuration.

How Satellite configurations work
How GitOps configurations work

A GitOps-based configuration involves the follow high-level steps.

  1. Create a Satellite configuration and specify the repository, Git reference type, Git reference name, and path.
  2. Create a subscription to associate the source repository of resource files with one or more cluster groups.
  3. The resource files in the source repository is automatically deployed to the clusters that belong to the selected cluster group.

Understanding Direct Upload configurations

Upload YAML files manually or from your CI/CD process and manage them through the Satellite Config GUI or CLI. Select the Direct upload template when you create your configuration.

How Satellite configurations work
How Direct upload configurations work

A Direct Upload configuration involves the follow high-level steps.

  1. Create a Satellite configuration and create versions by uploading Kubernetes resource files. Each Kubernetes resource file that you upload represents a version within the configuration.
  2. Create a subscription to associate a version with one or more cluster groups.
  3. The version of the Kubernetes resource file that is specified in the subscription is automatically deployed to the clusters that belong to the selected cluster group.

Key concepts for Satellite Config

Review the following key concepts that are used when you create a Satellite configuration.

Satellite config key concepts.
Term Description
Configuration With Satellite configuration, you can upload or create Kubernetes resource YAML file versions to deploy to a group of clusters. The version that you upload is not applied to your cluster until you add a subscription to your configuration.
Subscription A Satellite subscription specifies which Kubernetes resource is deployed to one or more cluster groups. After you create the subscription, Satellite Config automatically downloads the Kubernetes resource that you specified and starts applying it across all clusters that belong to the cluster group. This process takes a few minutes to complete.
The clusters in your cluster group can exist in your Satellite or in IBM Cloud. To include clusters that you run in IBM Cloud, you must register the cluster with the Satellite Config component and install the Satellite Config agent on this cluster.
Version A version represents a Kubernetes resource YAML file that you uploaded or manually created for a Satellite configuration. You can include any Kubernetes resource in your version and upload as many versions to a configuration as you like. (This concept applies to Direct Upload configurations only.)
Cluster groups A cluster group specifies a set of clusters that are registered with the Satellite Config component and that are included in a Satellite configuration. Clusters that run in your location are automatically registered and can be added to a cluster group. Clusters that run in IBM Cloud must be manually registered with the Satellite Config component before you can add them to a cluster group.