-
Notifications
You must be signed in to change notification settings - Fork 14
doc: add documentation for local operator console #122
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Conversation
514463b
to
b32b3d9
Compare
|
||
This document explains the Local Operator Console(LOC) from the API point of view. | ||
|
||
This document is similarly structured as PROFILE.md, because the topic is very similar. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Should we also introduce LOC here? What it is, when it is needed, difference between LOC and LPS, etc. Or will there be a separate md file in the EVE repo that would be linked here?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I added a short explanation and a table with the differences. If you know more differences, please let me know.
OPERATOR_CONSOLE.md
Outdated
GET /api/v2/edgedevice/certs | ||
``` | ||
|
||
Returns the controller certificates. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We should also document the payload for each endpoint. Name of the mime type (application/x-proto-binary
), protobuf message name + link to its definition.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I added the mime type and the protobuf message name including the filename where it is defined.
OPERATOR_CONSOLE.md
Outdated
POST /api/v2/edgedevice/id/$UUID/compound-config | ||
``` | ||
|
||
Returns edge device config as part of the compound config. It also includes: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This should mention that the device config is in the same format as from the controller (EdgeDevConfig
) and also signed by the controller.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I added the word "signed" and mention EdgeDevConfig
and where it is defined.
OPERATOR_CONSOLE.md
Outdated
POST /api/v2/edgedevice/id/$UUID/metrics | ||
``` | ||
|
||
This is where the metrics are sent. Similar to the controller. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Similar to the controller
-> Similar to the controller API
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
fixed (twice).
75663d1
to
eaeafdb
Compare
Signed-off-by: Christoph Ostarek <[email protected]>
eaeafdb
to
d9f7569
Compare
add some LOC documentation