Fleets Config Management

Overview

ConfigSync

ConfigSync is the orchestrator that deploys and manages ConfigSets across your clusters. It ensures that the desired state defined in your ConfigSets is automatically applied and kept in sync.

ConfigSet

A ConfigSet is a GitOps-managed, declarative specification that defines the resources to be deployed to clusters within a fleet. It can include:

  • Kubernetes manifests
  • Helm charts

Tip: Using ConfigSets allows you to standardize deployments across multiple clusters, improving consistency and reliability.

Setup ConfigSync using Kosmos UI

We will perform a Config operation on the Fleet page and walks you through a simple ConfigSync operation using the Kosmos UI:

Open Fleet Page https://console.kosmos.spcplatform.com/management/fleets/${FLEET_NAME}

Step 1: Open the config tab

  1. Register your cluster on the Kosmos platform, if not already done.
  2. Navigate to the Config tab.

Config Tab

Step 2: Deploy a package

  1. Click the Deploy Package button.
  2. Select the target cluster.
  3. Click Next.

Select a cluster

Tip: Ensure you select the correct cluster to avoid deployment issues.

Step 3: Fill in configuration details

  1. Complete the required fields as shown in the interface.
  2. Click Next to continue.

Step 2 – Configure Package

Step 4: Review and deploy

  1. Review all configuration details carefully.
  2. Click the Deploy button to start the deployment.

Step 3 – Review and Deploy

Note: Double-check the cluster selection and package details before deploying.

Step 5: Verify sync status

  1. Wait approximately 20 seconds for the deployment to complete.
  2. On the Config Overview tab, confirm that 1 Synced is displayed.

Step 4 – Verify Sync Status

Important: The Health status may not show Healthy. Common causes include:

  • Network or firewall issues
  • ECR malfunctions
  • Insufficient compute resources in the node group

Deleting a package

This section explains how to delete a package from the Kosmos platform using the UI.

Step 1: Open the Packages subtab

  1. Navigate to the Config tab of your cluster.
  2. Go to the Packages subtab.
  3. Click the Delete button next to the package you want to remove.

Step 1 – Delete select

Tip: Make sure you select the correct package before deleting to avoid accidental removal.

Step 2: Verify deletion

  1. After deletion, check the Packages subtab to confirm the package is no longer listed.

Step 2 – Verify delete

Note: The package should no longer appear in the list. If it still appears, refresh the page or check for errors.

Edit this page on GitHub