Application Discovery

You can leverage Shipa to discover and map existing applications, giving developers and operators visibility into applications previously deployed to a cluster.

You can use the steps below to have your applications mapped:

Creating a Policy Framework

When creating a policy framework to map existing applications, choose the Advanced option


Moving forward to the General section, in the Kubernetes Namespace section, enter the name of the namespace where you have your applications deployed:


You can move forward with the follow-on steps as usual. The important one for us here is the App Discovery step:

Here you can enter the label that you have assigned to your applications on Kubernetes


Shipa will use this label to connect to your existing namespace and map the current applications and objects deployed into it.


Application labels

You can find your application labels in different ways, such as checking the labels used by Helm during deployment or using the kubectl describe command.

The Naming Suffix, along with the label's value entered above, generates a name for your applications in Shipa once imported.

The combination of suffix and application name can only have up to 40 characters. It must start with a letter and must only contain letters, numbers, or dashes.

Once you save the framework, you can bind it to the cluster where the namespace and applications already exist.


Bind policy framework to cluster

You can find detailed information on how to bind your policy framework to your cluster here

Discovered Applications

Once the policy framework is bound to the cluster, Shipa will map the objects and show the applications in the dashboard. This process should take a couple of minutes.

Once Shipa maps the applications, Shipa will leverage some of the policy framework information to give you details such as the application owner, the policy framework it belongs to, and the object dependency map for the mapped applications.

16311631 16371637

Application Discovery Events

Once you the application discovery process start, you can find detailed event information of the process by using the following command:

kubectl get events -n shipa -w | grep deployment/shipa-controller

This command can be used to monitor the progress or help you troubleshoot any issues faced when discovering applications with Shipa.

Removing Application Discovery Frameworks

To remove Frameworks that have an auto-discovery feature, since the Shipa Controller will pick these up fairly quickly, the approach will be to remove the Label the Framework is looking for. Then wait for the application re-discovery to complete.


After clearing out the Label, wait for the re-discovery process to take place.

kubectl get events -n shipa -w | grep deployment/shipa-controller

Did this page help you?