Giters

zowe / api-layer

The API Mediation Layer provides a single point of access for mainframe service REST APIs.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

API Mediation Layer UI Landing Page Icon Meanings

dkelosky opened this issue · comments

commented

While trying to start API ML, I was able to see this within my UI:
image

What is the meaning of the yellow exclamation mark versus the red one? Should there be a hover or some other way to explain what the symbols mean?

commented

The red mark means that the service isn't ready and that it prevents the API Mediation Layer from working properly.
The yellow mark means that the service isn't ready, but it doesn't prevent the general workings of the API Mediation Layer.

The authentication service needs to be corrected in how it is calculated. There is even an existing bug about it.

Few questions for you:

  • With the Spring Cloud Gateway, we will need to reimplement this page anyway. Do you believe that this page in itself is useful?
  • And if you believe it's useful do you believe we should fix this for V2 as well as improve it in V3?

I am a bit uncertain on what does this page tries to solve as the problem. Based on what I see it looks as if the people are validating that the API ML is up and running via this page.

  • If this is the case and the only problem, it looks as if this page should be part of the Discovery service and maybe we need to understand more in detail what other key services should be shown and to what level.
commented

With the Spring Cloud Gateway, we will need to reimplement this page anyway. Do you believe that this page in itself is useful?

It feels useful in that it is sort of like an IVP to make sure things are started/starting up.

And if you believe it's useful do you believe we should fix this for V2 as well as improve it in V3?

My opinion is yes. Given that it is something that users interact with, we want to present a polished look and feel for both supported versions of Zowe.

I am a bit uncertain on what does this page tries to solve as the problem. Based on what I see it looks as if the people are validating that the API ML is up and running via this page.

I agree.

If this is the case and the only problem, it looks as if this page should be part of the Discovery service and maybe we need to understand more in detail what other key services should be shown and to what level.

That's an interesting thought. I'm not clear to which service this page belongs to currently. Currently though it seems like it helps represent the state of Zowe services, while discovery would also include all other services (and might lead to confusion on which services are actually needed to run API ML).

commented

Ok, marking it as enhancement to be done with the open question on what exact services should be shown and where should the page live going forward.