feat(mesh): deployment_artifact.v1 proto + first in-repo Grpc.Tools codegen

The repo has consumed packaged gRPC clients (LocalDb.Replication,
HistorianGateway.Client) but never compiled a proto locally. This adds the
Grpc.Tools toolchain to Commons and a deployment_artifact.proto with a single
server-streaming Fetch(deployment_id) -> stream ArtifactChunk RPC, generating
both the server base and the client stub (GrpcServices="Both") so central
(Host/AdminUI) and the node (Runtime) share one reference. A compile-touch test
pins the codegen: it stops compiling if generation regresses.

Claude-Session: https://claude.ai/code/session_01GASWkNEi68FSCtvr6rLoEW
This commit is contained in:
Joseph Doherty
2026-07-22 19:04:58 -04:00
parent 9d1e60c00c
commit 62e8f54f71
4 changed files with 83 additions and 0 deletions
@@ -0,0 +1,26 @@
syntax = "proto3";
package deployment_artifact.v1;
option csharp_namespace = "ZB.MOM.WW.OtOpcUa.Commons.Protos.DeploymentArtifact.V1";
// Central serves the deployed-configuration artifact bytes to a driver node (per-cluster mesh
// Phase 3). Only admin-role nodes — which hold the central SQL connection — serve; driver nodes in
// FetchAndCache mode are the clients. The bytes travel here, out-of-band, precisely so they never
// ride an Akka message and hit the frame-size limit.
service DeploymentArtifactService {
// Streams the artifact for a sealed deployment as ordered chunks. NotFound when the id is
// unknown, the deployment is not sealed, or the blob is empty (existence-hiding + the #485
// "empty bytes are never an empty config" rule). The client verifies
// SHA-256(reassembled) == the RevisionHash it already holds from DispatchDeployment, so no hash
// is carried here.
rpc Fetch(FetchRequest) returns (stream ArtifactChunk);
}
message FetchRequest {
string deployment_id = 1;
}
message ArtifactChunk {
bytes data = 1;
}
@@ -11,6 +11,24 @@
<PackageReference Include="ZB.MOM.WW.Audit"/>
</ItemGroup>
<!-- Per-cluster mesh Phase 3: the first locally-compiled proto in the repo (all other gRPC here
is packaged clients). Grpc.Tools generates both the server base and the client stub from
deployment_artifact.proto; Google.Protobuf + Grpc.Core.Api carry the generated code's runtime
types. Placed in Commons so both the central server (Host/AdminUI) and the node client
(Runtime) get the types from one reference. -->
<ItemGroup>
<PackageReference Include="Google.Protobuf"/>
<PackageReference Include="Grpc.Core.Api"/>
<PackageReference Include="Grpc.Tools">
<PrivateAssets>all</PrivateAssets>
<IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
</PackageReference>
</ItemGroup>
<ItemGroup>
<Protobuf Include="Protos\deployment_artifact.proto" GrpcServices="Both"/>
</ItemGroup>
<ItemGroup>
<ProjectReference Include="..\ZB.MOM.WW.OtOpcUa.Core.Abstractions\ZB.MOM.WW.OtOpcUa.Core.Abstractions.csproj"/>
</ItemGroup>