Skip to content
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

Management Framework HLD - Phase II #550

Merged
merged 6 commits into from
Jan 8, 2021

Conversation

anand-kumar-subramanian
Copy link
Contributor

Management Framework HLD - Phase II contains the following

  • Translib API changes and new APIs for REST and Telemetry to consume.
  • RESTCONF yang library and other enhancements
  • CVL API changes, platform and custom validation support

@anand-kumar-subramanian anand-kumar-subramanian changed the title Manangement Framework HLD - Phase II Management Framework HLD - Phase II Jan 8, 2020
doc/mgmt/Management Framework.md Show resolved Hide resolved
doc/mgmt/Management Framework.md Show resolved Hide resolved
doc/mgmt/Management Framework.md Show resolved Hide resolved
func Subscribe(paths []string, q *queue.PriorityQueue, stop chan struct{}) ([]*IsSubscribeResponse, error)
func IsSubscribeSupported(paths []string) ([]*IsSubscribeResponse, error)
func Action(req ActionRequest) (ActionResponse, error)
func Bulk(req BulkRequest) (BulkResponse, error)

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do you have REST performance numbers to share to community? ex: add-delete-add vlan workflows etc..

doc/mgmt/Management Framework.md Show resolved Hide resolved
doc/mgmt/Management Framework.md Show resolved Hide resolved
doc/mgmt/Management Framework.md Show resolved Hide resolved
doc/mgmt/Management Framework.md Show resolved Hide resolved
sachinholla added a commit to sachinholla/sonic-buildimage that referenced this pull request Jun 17, 2020
REST and telemetry servers were using "DEVICE_METADATA|x509" table for
server certificate configurations. This table has been deprecated now.
Enhanced REST server startup script to read server certificate file
path configurations from REST_SERVER table. Three more attributes -
server_crt, server_key and ca_crt are introduced as described in
sonic-net/SONiC#550.

For backard compatibility, certificate configurations are read from
old "DEVICE_METADATA|x509" table if they (server_crt, server_key and
ca_crt) are not present in REST_SERVER table.

Fixes bug sonic-net#4291

Signed-off-by: Sachin Holla <[email protected]>
lguohan pushed a commit to sonic-net/sonic-buildimage that referenced this pull request Jun 19, 2020
REST and telemetry servers were using "DEVICE_METADATA|x509" table for
server certificate configurations. This table has been deprecated now.
Enhanced REST server startup script to read server certificate file
path configurations from REST_SERVER table. Three more attributes -
server_crt, server_key and ca_crt are introduced as described in
sonic-net/SONiC#550.

For backard compatibility, certificate configurations are read from
old "DEVICE_METADATA|x509" table if they (server_crt, server_key and
ca_crt) are not present in REST_SERVER table.

Fixes bug #4291

Signed-off-by: Sachin Holla <[email protected]>
@renukamanavalan renukamanavalan merged commit 42b2150 into sonic-net:master Jan 8, 2021
@chenkelly
Copy link

Hi @anand-kumar-subramanian
Are the enhancements described in the HLD fully developed?
For example, in 3.1.2.2 REST said "REST client will use the OpenAPI generated client SDK to send the request to the REST server."
After we checked current mk file (https://github.com/Azure/sonic-mgmt-framework/blob/master/models/openapi_codegen.mk#L26), still using swagger-codegen.
In 3.2.1.1.5 Special handling, don't see related processing about 'maxItems' and 'minItems'.
We will be grateful for any help you can provide.

@faraazbrcm
Copy link

@chenkelly
Are the enhancements described in the HLD fully developed?

The HLD content and the code present in Github seem to be not in sync. Recently Server moved to the OpenAPI generator (https://github.com/OpenAPITools/openapi-generator).

As per 3.1.1 in HLD - "In case of OpenAPI spec, it is directly given to the OpenAPI generator to generate the REST client SDK and REST server stubs in golang. In this case the REST server takes care of validating the incoming request to be OpenAPI compliant before giving the same to Translib."

The maxItems and minItems should be supported. The expectation is that generated stub should contain the validation code.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

7 participants