apemanager: Introduce proto-s for apemanager service #46

Merged
fyrchik merged 1 commit from aarifullin/frostfs-api:feat/apemanager into master 2024-04-27 13:48:05 +00:00
Member
  • Introduce proto-s for APEManagerService and related types.
  • Introduce a new status section related to APEManagerService.
  • Generate proto-docs.
* Introduce proto-s for `APEManagerService` and related types. * Introduce a new status section related to `APEManagerService`. * Generate proto-docs.
aarifullin force-pushed feat/apemanager from 102965060d to 1293e2092b 2024-04-24 15:15:52 +00:00 Compare
aarifullin requested review from storage-core-committers 2024-04-24 15:15:57 +00:00
aarifullin requested review from storage-core-developers 2024-04-24 15:15:57 +00:00
fyrchik requested review from realloc 2024-04-24 15:49:46 +00:00
fyrchik requested review from storage-services-committers 2024-04-24 15:49:46 +00:00
fyrchik requested review from storage-services-developers 2024-04-24 15:49:47 +00:00
acid-ant reviewed 2024-04-25 06:52:24 +00:00
@ -0,0 +149,4 @@
message ListChainsResponse {
message Body {
// The list of serialized rule chain.
repeated bytes chains = 1;
Member

Why not to use type Chain here instead of bytes?

Why not to use type `Chain` here instead of `bytes`?
Member

And the same approach for set\get.

And the same approach for `set\get`.
Author
Member

Would you like to see Chain as alias for bytes?

Or you want this Chain see here? Let's consider what does it lead to:

  1. We are obliged to support Chain-s in frostfs-api/frostfs-api-go and Chain in policy-engine. Actually, frostfs-api needs to mirror structures in policy-engine
  2. We need converters from protobuf to policy-engine-s structures
Would you like to see `Chain` as alias for `bytes`? Or you want this [Chain](https://git.frostfs.info/TrueCloudLab/policy-engine/src/branch/master/pkg/chain/chain.go#L28-L34) see here? Let's consider what does it lead to: 1. We are obliged to support `Chain`-s in `frostfs-api/frostfs-api-go` and `Chain` in `policy-engine`. Actually, `frostfs-api` needs to mirror structures in `policy-engine` 2. We need converters from protobuf to `policy-engine`-s structures
Member

Right, how about the same chain structure here as in policy-engine repo. Just want to know why bytes used here?

Right, how about the same `chain` structure here as in `policy-engine` repo. Just want to know why `bytes` used here?
Author
Member

We agreed to keep []byte but as one of representation option

We agreed to keep `[]byte` but as one of representation option
acid-ant marked this conversation as resolved
aarifullin force-pushed feat/apemanager from 1293e2092b to 5e860e4997 2024-04-25 16:52:49 +00:00 Compare
dstepanov-yadro requested changes 2024-04-26 07:33:46 +00:00
@ -0,0 +1,172 @@
syntax = "proto3";
package neo.fs.v2.apemanager;

neo -> frostfs

neo -> frostfs
Author
Member

Please, check

I renamed neo.fs.v2.apemanager to frostfs.v2.apemanager. I suppose we don't need to name it like frostfs.fs.v2.apemanager

Please, check I renamed `neo.fs.v2.apemanager` to `frostfs.v2.apemanager`. I suppose we don't need to name it like `frostfs.fs.v2.apemanager`
@ -0,0 +6,4 @@
import "session/types.proto";
option go_package = "git.frostfs.info/TrueCloudLab/frostfs-api-go/v2/apemanager/grpc;apemanager";
option csharp_namespace = "Neo.FileStorage.API.ApeManager";

Please drop this line. We don't use c# now.

Please drop this line. We don't use c# now.
Author
Member

Fixed

Fixed
@ -0,0 +20,4 @@
// ChainTarget is an object to which a rule chain is defined.
message ChainTarget {
TargetType type = 1 [ json_name = "type" ];

Is this message special? Why does json_name defined?

Is this message special? Why does `json_name` defined?
Author
Member

I removed json tags. I don't think they are really required

I removed json tags. I don't think they are really required
Owner

We use them when we need to use camelCase (per some "best practice", probably from google, but I cannot find the link) instead of snake_case (protojson default).

We use them when we need to use `camelCase` (per some "best practice", probably from google, but I cannot find the link) instead of `snake_case` (protojson default).
aarifullin force-pushed feat/apemanager from 5e860e4997 to 39992c49fa 2024-04-26 16:40:20 +00:00 Compare
acid-ant approved these changes 2024-04-26 19:14:27 +00:00
dstepanov-yadro approved these changes 2024-04-27 13:47:42 +00:00
fyrchik merged commit c94b8ab6ae into master 2024-04-27 13:48:05 +00:00
Sign in to join this conversation.
No reviewers
TrueCloudLab/storage-core-developers
TrueCloudLab/storage-services-committers
TrueCloudLab/storage-services-developers
No milestone
No project
No assignees
4 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: TrueCloudLab/frostfs-api#46
No description provided.