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 option "Discover existing application"


Moving forward to the Configuration section, enter a name for your framework and select a plan and a team.


Move to the last step "App Discovery" and enter the label that you have assigned to your applications on Kubernetes, so Shipa can, later on, use it to identify your apps.


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 an environment using the intended cluster and namespace, so Shipa can use the labels to discover the existing applications

Creating an environment

Visit the Environment section and following the instructions of Environment Management create a logical group containing the cluster where your existing apps are running, the namespace where such apps are, and the previously created framework.


Discovered Applications

Once the policy framework is bound to the cluster through an Environment, 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.

1302 1300

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