Documentation needed to interface with tackle-pathfinder from Tackle Inventory

[djwhatle]

Hi , @jonathanvila , @mrizzi , @carlosthe19916 I'm onboarding to the Tackle project along with @jortel and @mansam right now.

(Note: From demos I've seen, I think Pathfinder is already integrated with Tackle Inventory quite heavily. I am curious about the relationship between the two though, and how Pathfinder is currently consumed over what API. I'm asking these questions on all projects that Inventory is meant to interface with)

We are working to learn how the Tackle App Inventory can interface with other tools in the Tackle suite, and trying to define the requirements of the App Inventory data model.

It would be helpful to have a reference doc on the public interface of tackle-pathfinder (TPF) so that we can get an idea of how TPF this would tie in with Tackle Inventory, and what changes might be needed to the Tackle Inventory data model:

• Expected inputs / outputs of TPF (examples would be useful)
• Methods for invoking TPF (REST? CLI? Java API? Something else?)
• Is there a Quay.io container auto-build set up so we can consume TPF easily running as a Pod on OpenShift?
• Is there a deploy YAML available with a deployment definition for TPF and any required auxiliary OpenShift resources (e.g. namespaces, services, routes). This would let us quickly play around with TPF using other info provided. We may be able to assist here if needed.

Do documents detailing the public interface of TPF exist? Even some simple examples would be useful to get started.

cc @rromannissen @jwmatthews @PhilipCattanach

[PhilipCattanach]

@djwhatle, A great starting point for each project are the README files. The Application Controls and Pathfinder have detailed README files.

Application Inventory, the Controls and Pathfinder are Quarkus microservices, they are not java libraries and hence there is no CLI or java API invocation method.

With regard to the container image there is a github action (https://github.com/konveyor/tackle-pathfinder/blob/main/.github/workflows/push.yml) that builds native image and pushes it to quay.io with the appropriate tag.

Within https://github.com/konveyor/tackle/tree/main/kubernetes there are templates that facilitate the manual deployment of Tackle to a Kubernetes/OCP environment. Remember Kubernetes is our primary target. This is the unrecomended approach, I would strongly encourage you to use the Tackle Operator.

The best way to start understanding the expected inputs/outputs is to look at the tests (e.g. https://github.com/konveyor/tackle-pathfinder/blob/main/src/test/java/io/tackle/pathfinder/controllers/AssessmentsResourceTest.java#L80) Quarkus also lets developers have the OpenAPI Rest Endpoints documentation page.