@cofy-x/axern-sdk 0.6.2 → 0.7.0

package/dist/proto/axern/control/node/v1/node_control.proto

@@ -1,443 +0,0 @@
-syntax = "proto3";
-
-package axern.control.node.v1;
-
-option go_package = "github.com/cofy-x/axern/sdk/go/gen/axern/control/node/v1;nodev1";
-
-import "axern/control/common/v1/common.proto";
-import "axern/control/capability/v1/capability.proto";
-import "axern/control/tunnel/v1/tunnel.proto";
-import "google/protobuf/timestamp.proto";
-
-enum RootfsType {
-  ROOTFS_TYPE_UNSPECIFIED = 0;
-  ROOTFS_TYPE_LOCAL = 1;
-  ROOTFS_TYPE_IMAGE = 2;
-  ROOTFS_TYPE_S3 = 3;
-}
-
-enum MountType {
-  MOUNT_TYPE_UNSPECIFIED = 0;
-  MOUNT_TYPE_LOCAL = 1;
-  MOUNT_TYPE_OCI = 2;
-  MOUNT_TYPE_NYDUS = 3;
-  MOUNT_TYPE_OSS = 4;
-  MOUNT_TYPE_EROFS = 5;
-}
-
-enum ComponentState {
-  COMPONENT_STATE_UNSPECIFIED = 0;
-  COMPONENT_STATE_READY = 1;
-  COMPONENT_STATE_WARMING = 2;
-  COMPONENT_STATE_DEGRADED = 3;
-  COMPONENT_STATE_ERROR = 4;
-  COMPONENT_STATE_DISABLED = 5;
-}
-
-enum NodeState {
-  NODE_STATE_UNSPECIFIED = 0;
-  NODE_STATE_READY = 1;
-  NODE_STATE_DRAINING = 2;
-  NODE_STATE_DISABLED = 3;
-  NODE_STATE_UNREACHABLE = 4;
-}
-
-message PoolState {
-  int32 using = 1;
-  int32 idle = 2;
-  int32 capacity = 3;
-  int32 unavailable = 4;
-}
-
-message ResourcesSummary {
-  int64 axnoded_committed_milli = 1;
-  int64 axnoded_used_milli = 2;
-  int64 axnoded_cpu_unbounded_count = 3;
-  int64 axnoded_committed_bytes = 4;
-  int64 axnoded_used_bytes = 5;
-  int64 axnoded_memory_unbounded_count = 6;
-  int64 axnoded_ephemeral_storage_committed_bytes = 7;
-  int64 axnoded_ephemeral_storage_used_bytes = 8;
-  int64 axnoded_ephemeral_storage_unbounded_count = 9;
-}
-
-// NodeMemoryBudget is the node-observed scheduling boundary. The system
-// reserve covers node-local control processes and is never charged to a
-// namespace or allocation.
-enum NodeMemoryBudgetMode {
-  NODE_MEMORY_BUDGET_MODE_UNSPECIFIED = 0;
-  // Capacity and internal usage are observed from the delegated cgroup v2
-  // domain. Runtime-specific hard-limit capabilities remain separate facts.
-  NODE_MEMORY_BUDGET_MODE_CGROUP_V2 = 1;
-  // Local-development capacity is observed from the configured node resource
-  // source without claiming a cgroup hard boundary.
-  NODE_MEMORY_BUDGET_MODE_DISABLED_DEV = 2;
-}
-
-message NodeMemoryBudget {
-  // Physical capacity reported by the selected node resource source. This is
-  // a consistency/diagnostic fact and is never added to allocatable memory.
-  int64 physical_capacity_bytes = 1;
-  // The resource source's schedulable value before the Axern system reserve.
-  int64 source_allocatable_bytes = 2;
-  // A finite value further caps source_allocatable_bytes; zero with
-  // delegated_root_limit_finite=false represents kernel `max`.
-  int64 delegated_root_limit_bytes = 3;
-  bool delegated_root_limit_finite = 4;
-  int64 system_reserve_bytes = 5;
-  int64 effective_allocatable_bytes = 6;
-  int64 local_commitment_bytes = 7;
-  int64 cleanup_debt_bytes = 8;
-  int64 internal_current_bytes = 9;
-  // Identity of the capacity domain. Production uses the boot-scoped cgroup
-  // mount/root identity; disabled_dev uses a boot-scoped resource-source
-  // identity and cannot satisfy runtime hard-limit requirements.
-  string capacity_identity = 10;
-  google.protobuf.Timestamp sampled_at = 11;
-  int32 retiring_cgroup_count = 12;
-  int64 oldest_retiring_age_seconds = 13;
-  bool system_reserve_exhausted = 14;
-  NodeMemoryBudgetMode mode = 15;
-}
-
-message PoolsSummary {
-  PoolState cgroup = 1;
-  PoolState interface = 2;
-  // Required aggregate runtime capacity contract owned by axnoded.
-  PoolState runtime_slots = 3;
-}
-
-message AxnodedSummary {
-  ComponentState state = 1;
-  bool ready = 2;
-  int32 running_containers = 3;
-  repeated string running_allocation_ids = 4;
-  repeated string active_allocation_ids = 5;
-}
-
-message ImagemgrSummary {
-  ComponentState state = 1;
-  bool reachable = 2;
-  int32 daemon_count = 3;
-  int32 mounted_image_count = 4;
-  int32 imported_image_count = 5;
-}
-
-message ImagefsdSummary {
-  ComponentState state = 1;
-  bool reachable = 2;
-  bool chunkdb_present = 3;
-  int64 chunk_count = 4;
-  int64 chunkdb_used_bytes = 5;
-  double chunkdb_usage_percent = 6;
-}
-
-message BpfNetSummary {
-  ComponentState state = 1;
-  bool enabled = 2;
-  bool ready = 3;
-  string mode = 4;
-  bool needs_snat_fallback = 5;
-  bool needs_full_dnat_fallback = 6;
-  bool needs_localhost_compat = 7;
-}
-
-message VolumedSummary {
-  ComponentState state = 1;
-  bool reachable = 2;
-  int32 published_volume_count = 3;
-  google.protobuf.Timestamp last_reconcile_at = 4;
-  string last_reconcile_error = 5;
-  int32 last_reconcile_retained_count = 6;
-  int32 last_reconcile_unpublished_count = 7;
-  int32 last_reconcile_active_allocation_count = 8;
-  int32 last_reconcile_stale_allocation_count = 9;
-  int32 last_reconcile_invalid_volume_count = 10;
-}
-
-message NodeStorageSummary {
-  string target = 1;
-  int64 capacity_bytes = 2;
-  int64 used_bytes = 3;
-  int64 available_bytes = 4;
-  int64 inodes_total = 5;
-  int64 inodes_used = 6;
-  int64 inodes_available = 7;
-  bool collected = 8;
-  string error = 9;
-  int64 system_reserve_bytes = 10;
-  int64 reserved_bytes = 11;
-  int64 allocatable_bytes = 12;
-  int64 active_reservations = 13;
-  string filesystem_type = 14;
-  string mount_identity = 15;
-  int64 allocation_used_bytes = 16;
-  bool unlinked_backing_usage_unknown = 17;
-}
-
-message ComponentsSummary {
-  AxnodedSummary axnoded = 1;
-  ImagemgrSummary imagemgr = 2;
-  ImagefsdSummary imagefsd = 3;
-  BpfNetSummary bpfnet = 4;
-  VolumedSummary volumed = 5;
-}
-
-message LocalitySummary {
-  string key = 1;
-  RootfsType rootfs_type = 2;
-  MountType mount_type = 3;
-  bool mounted = 4;
-  int32 retained_runtime_count = 5;
-  int32 retained_rootfs_count = 6;
-  int32 running_container_count = 7;
-  bool nydus_daemon_alive = 8;
-  int64 chunkdb_total_chunks = 9;
-  int64 chunkdb_used_bytes = 10;
-  int64 chunkdb_recent_access_age_secs = 11;
-  int64 peer_healthy_count = 12;
-  int64 peer_unhealthy_count = 13;
-  int64 peer_hinted_count = 14;
-  string environment_id = 15;
-}
-
-message NodeSummary {
-  google.protobuf.Timestamp collected_at = 1;
-  ResourcesSummary resources = 2;
-  PoolsSummary pools = 3;
-  ComponentsSummary components = 4;
-  repeated LocalitySummary locality = 5;
-  NodeState node_state = 6;
-  map<string, string> labels = 7;
-  axern.control.capability.v1.CapabilitySnapshot capability_snapshot = 8;
-  axern.control.common.v1.ResourceQuantity capacity = 9;
-  axern.control.common.v1.ResourceQuantity allocatable = 10;
-  repeated NodeStorageSummary storage = 11;
-  NodeMemoryBudget memory_budget = 12;
-}
-
-message RegisterNodeRequest {
-  string node_id = 1;
-  repeated string runtimes = 2;
-  string node_target = 3;
-  string node_auth_token = 4;
-}
-
-message RegisterNodeResponse {}
-
-message ReportNodeRequest {
-  string node_id = 1;
-  repeated string runtimes = 2;
-  NodeSummary summary = 3;
-  string node_target = 4;
-  string node_auth_token = 5;
-}
-
-message ReportNodeResponse {}
-
-message AllocationStatusObservation {
-  string allocation_id = 1;
-  int64 attempt = 2;
-  axern.control.common.v1.AllocationStatus status = 3;
-  int32 exit_code = 4;
-  bool exit_code_known = 5;
-  string message = 6;
-  google.protobuf.Timestamp observed_at = 7;
-  bool ready = 8;
-  string readiness_message = 9;
-  // diagnostic_code is the bounded, machine-readable terminal or degraded
-  // cause observed by the node. The message remains operator context and is
-  // never parsed to recover this code.
-  axern.control.common.v1.WorkloadDiagnosticCode diagnostic_code = 10;
-}
-
-message BatchReportAllocationStatusRequest {
-  string node_id = 1;
-  string node_auth_token = 2;
-  repeated AllocationStatusObservation observations = 3;
-}
-
-message BatchReportAllocationStatusResponse {}
-
-// AllocationCapabilityConditionReport is deliberately independent from
-// lifecycle status. Updating capability conditions cannot make an allocation
-// RUNNING, READY, terminal, or alter its exit status/message.
-message AllocationCapabilityConditionReport {
-  string allocation_id = 1;
-  int64 attempt = 2;
-  axern.control.capability.v1.CapabilityConditionSet condition_set = 3;
-}
-
-message BatchReportAllocationCapabilityConditionsRequest {
-  string node_id = 1;
-  string node_auth_token = 2;
-  repeated AllocationCapabilityConditionReport reports = 3;
-}
-
-message BatchReportAllocationCapabilityConditionsResponse {}
-
-// AllocationMemoryObservation is a bounded latest-value report from the host
-// cgroup. Runtime-specific diagnostics such as `runsc usage --full` are not
-// included because they cannot be added to these kernel counters.
-enum AllocationMemoryCleanupState {
-  ALLOCATION_MEMORY_CLEANUP_STATE_UNSPECIFIED = 0;
-  ALLOCATION_MEMORY_CLEANUP_STATE_ASSIGNED = 1;
-  ALLOCATION_MEMORY_CLEANUP_STATE_RETIRING = 2;
-}
-
-message AllocationMemoryObservation {
-  string allocation_id = 1;
-  int64 attempt = 2;
-  int64 revision = 3;
-  google.protobuf.Timestamp observed_at = 4;
-  int64 request_bytes = 5;
-  // Zero means the sandbox has no per-allocation hard limit. Usage and cgroup
-  // identity remain observable, while the control-verification fields must be
-  // false and swap_current_bytes is informational rather than constrained.
-  int64 limit_bytes = 6;
-  int64 current_bytes = 7;
-  int64 peak_bytes = 8;
-  int64 swap_current_bytes = 9;
-  int64 anon_bytes = 10;
-  int64 file_bytes = 11;
-  int64 shmem_bytes = 12;
-  int64 kernel_bytes = 13;
-  int64 dirty_bytes = 14;
-  int64 writeback_bytes = 15;
-  uint64 event_high = 16;
-  uint64 event_max = 17;
-  uint64 event_oom = 18;
-  uint64 event_oom_kill = 19;
-  uint64 event_oom_group_kill = 20;
-  double psi_some_avg10 = 21;
-  double psi_full_avg10 = 22;
-  uint64 psi_some_total_usec = 23;
-  uint64 psi_full_total_usec = 24;
-  string cgroup_identity = 25;
-  string runtime = 26;
-  bool parent_controls_verified = 27;
-  bool leaf_controls_verified = 28;
-  bool pid_roles_verified = 29;
-  AllocationMemoryCleanupState cleanup_state = 30;
-  // psi_available distinguishes an unsupported per-cgroup PSI interface from
-  // a supported interface that currently reports zero pressure. When false,
-  // all PSI values above must be zero.
-  bool psi_available = 31;
-  // peak_available reports whether peak_bytes came from the kernel
-  // memory.peak interface. Older cgroup v2 kernels may omit that optional
-  // file; in that case peak_bytes equals current_bytes and is only a sampled
-  // lower bound. Hard-limit evidence never depends on this observability bit.
-  bool peak_available = 32;
-}
-
-message BatchReportAllocationMemoryObservationsRequest {
-  string node_id = 1;
-  string node_auth_token = 2;
-  repeated AllocationMemoryObservation observations = 3;
-}
-
-message BatchReportAllocationMemoryObservationsResponse {}
-
-message WatchExecutionLeasesRequest {
-  string node_id = 1;
-  int64 after_revision = 2;
-  string node_auth_token = 3;
-}
-
-message WatchExecutionLeasesResponse {
-  repeated axern.control.common.v1.ExecutionLease leases = 1;
-  int64 current_revision = 2;
-}
-
-message WatchTunnelSessionsRequest {
-  string node_id = 1;
-  int64 after_revision = 2;
-  string node_auth_token = 3;
-}
-
-message NodeTunnelSession {
-  axern.control.tunnel.v1.TunnelSession session = 1;
-  string node_token = 2;
-}
-
-message WatchTunnelSessionsResponse {
-  repeated NodeTunnelSession sessions = 1;
-  int64 current_revision = 2;
-}
-
-message ReportTunnelSessionStatusRequest {
-  string session_id = 1;
-  axern.control.tunnel.v1.TunnelSessionStatus status = 2;
-  string reason = 3;
-  string bound_addr = 4;
-  string node_id = 5;
-  string node_auth_token = 6;
-}
-
-message ReportTunnelSessionStatusResponse {}
-
-enum PlacementCandidateState {
-  PLACEMENT_CANDIDATE_STATE_UNSPECIFIED = 0;
-  PLACEMENT_CANDIDATE_STATE_ELIGIBLE = 1;
-  PLACEMENT_CANDIDATE_STATE_REJECTED = 2;
-}
-
-enum PlacementRejectionReason {
-  PLACEMENT_REJECTION_REASON_UNSPECIFIED = 0;
-  PLACEMENT_REJECTION_REASON_STALE_HEARTBEAT = 1;
-  PLACEMENT_REJECTION_REASON_STALE_SUMMARY = 2;
-  PLACEMENT_REJECTION_REASON_RUNTIME_UNSUPPORTED = 3;
-  PLACEMENT_REJECTION_REASON_AXNODED_NOT_READY = 4;
-  PLACEMENT_REJECTION_REASON_IMAGEMGR_UNAVAILABLE = 5;
-  PLACEMENT_REJECTION_REASON_IMAGEFSD_UNAVAILABLE = 6;
-  PLACEMENT_REJECTION_REASON_NODE_DRAINING = 7;
-  PLACEMENT_REJECTION_REASON_NODE_DISABLED = 8;
-  PLACEMENT_REJECTION_REASON_NODE_SELECTOR_MISMATCH = 9;
-  PLACEMENT_REJECTION_REASON_INSUFFICIENT_CPU = 10;
-  PLACEMENT_REJECTION_REASON_INSUFFICIENT_MEMORY = 11;
-  PLACEMENT_REJECTION_REASON_PORTS_UNSUPPORTED = 12;
-  PLACEMENT_REJECTION_REASON_NETWORK_UNSUPPORTED = 13;
-  PLACEMENT_REJECTION_REASON_CAPABILITY_UNSUPPORTED = 14;
-  PLACEMENT_REJECTION_REASON_NODE_RETIRED = 15;
-  PLACEMENT_REJECTION_REASON_INSUFFICIENT_EPHEMERAL_STORAGE = 16;
-  PLACEMENT_REJECTION_REASON_NODE_MEMORY_SYSTEM_RESERVE_EXHAUSTED = 17;
-  PLACEMENT_REJECTION_REASON_NODE_MEMORY_BUDGET_UNAVAILABLE = 18;
-}
-
-message PlacementRank {
-  bool mounted_match = 1;
-  int32 retained_rootfs_count = 2;
-  int32 retained_runtime_count = 3;
-  bool nydus_daemon_alive = 4;
-  int64 chunkdb_recent_access_age_secs = 5;
-  int64 peer_healthy_count = 6;
-  int64 peer_hinted_count = 7;
-  bool bpfnet_preferred = 8;
-  bool idle_pool_ready = 9;
-  int64 axnoded_used_milli = 10;
-  int64 axnoded_used_bytes = 11;
-  int64 axnoded_active_instances = 12;
-}
-
-message PlacementCandidate {
-  string node_id = 1;
-  PlacementCandidateState state = 2;
-  repeated PlacementRejectionReason rejection_reasons = 3;
-  int64 heartbeat_age_secs = 4;
-  int64 summary_age_secs = 5;
-  PoolsSummary pools = 6;
-  ResourcesSummary resources = 7;
-  LocalitySummary locality = 8;
-  PlacementRank rank = 9;
-}
-
-service NodeControl {
-  rpc RegisterNode(RegisterNodeRequest) returns (RegisterNodeResponse) {}
-  rpc ReportNode(ReportNodeRequest) returns (ReportNodeResponse) {}
-  rpc BatchReportAllocationStatus(BatchReportAllocationStatusRequest) returns (BatchReportAllocationStatusResponse) {}
-  rpc BatchReportAllocationCapabilityConditions(BatchReportAllocationCapabilityConditionsRequest) returns (BatchReportAllocationCapabilityConditionsResponse) {}
-  rpc BatchReportAllocationMemoryObservations(BatchReportAllocationMemoryObservationsRequest) returns (BatchReportAllocationMemoryObservationsResponse) {}
-  rpc WatchExecutionLeases(WatchExecutionLeasesRequest) returns (stream WatchExecutionLeasesResponse) {}
-  rpc WatchTunnelSessions(WatchTunnelSessionsRequest) returns (stream WatchTunnelSessionsResponse) {}
-  rpc ReportTunnelSessionStatus(ReportTunnelSessionStatusRequest) returns (ReportTunnelSessionStatusResponse) {}
-}