From 4f0b923c4f2bc9be80bf1e7ca61cc66c354cc7e0 Mon Sep 17 00:00:00 2001 From: Alex Auvolat Date: Wed, 29 Jan 2025 12:06:58 +0100 Subject: [PATCH] admin api: small fixes --- doc/api/garage-admin-v2.yml | 2 +- doc/drafts/admin-api.md | 2 +- src/api/admin/api.rs | 22 ++++++++++++++++++---- src/api/admin/api_server.rs | 2 +- src/api/admin/cluster.rs | 4 ++-- src/api/admin/macros.rs | 19 ++++++++++++++++++- 6 files changed, 41 insertions(+), 10 deletions(-) diff --git a/doc/api/garage-admin-v2.yml b/doc/api/garage-admin-v2.yml index 0b948135..725c1d01 100644 --- a/doc/api/garage-admin-v2.yml +++ b/doc/api/garage-admin-v2.yml @@ -91,7 +91,7 @@ paths: example: "ec79480e0ce52ae26fd00c9da684e4fa56658d9c64cdcecb094e936de0bfe71f" garageVersion: type: string - example: "v0.9.0" + example: "v2.0.0" garageFeatures: type: array items: diff --git a/doc/drafts/admin-api.md b/doc/drafts/admin-api.md index ca60ead1..eb327307 100644 --- a/doc/drafts/admin-api.md +++ b/doc/drafts/admin-api.md @@ -53,7 +53,7 @@ Returns an HTTP status 200 if the node is ready to answer user's requests, and an HTTP status 503 (Service Unavailable) if there are some partitions for which a quorum of nodes is not available. A simple textual message is also returned in a body with content-type `text/plain`. -See `/v2/health` for an API that also returns JSON output. +See `/v2/GetClusterHealth` for an API that also returns JSON output. ### Other special endpoints diff --git a/src/api/admin/api.rs b/src/api/admin/api.rs index eac93b6e..39e05d51 100644 --- a/src/api/admin/api.rs +++ b/src/api/admin/api.rs @@ -13,9 +13,21 @@ use crate::admin::EndpointHandler; use crate::helpers::is_default; // This generates the following: +// // - An enum AdminApiRequest that contains a variant for all endpoints -// - An enum AdminApiResponse that contains a variant for all non-special endpoints +// +// - An enum AdminApiResponse that contains a variant for all non-special endpoints. +// This enum is serialized in api_server.rs, without the enum tag, +// which gives directly the JSON response corresponding to the API call. +// This enum does not implement Deserialize as its meaning can be ambiguous. +// +// - An enum TaggedAdminApiResponse that contains the same variants, but +// serializes as a tagged enum. This allows it to be transmitted through +// Garage RPC and deserialized correctly upon receival. +// Conversion from untagged to tagged can be done using the `.tagged()` method. +// // - AdminApiRequest::name() that returns the name of the endpoint +// // - impl EndpointHandler for AdminApiHandler, that uses the impl EndpointHandler // of each request type below for non-special endpoints admin_endpoints![ @@ -60,6 +72,9 @@ admin_endpoints![ // ********************************************** // Special endpoints +// +// These endpoints don't have associated *Response structs +// because they directly produce an http::Response // ********************************************** #[derive(Serialize, Deserialize)] @@ -153,11 +168,11 @@ pub struct GetClusterHealthResponse { pub struct ConnectClusterNodesRequest(pub Vec); #[derive(Serialize, Deserialize)] -pub struct ConnectClusterNodesResponse(pub Vec); +pub struct ConnectClusterNodesResponse(pub Vec); #[derive(Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct ConnectClusterNodeResponse { +pub struct ConnectNodeResponse { pub success: bool, pub error: Option, } @@ -331,7 +346,6 @@ pub struct UpdateKeyResponse(pub GetKeyInfoResponse); #[derive(Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct UpdateKeyRequestBody { - // TODO: id (get parameter) goes here pub name: Option, pub allow: Option, pub deny: Option, diff --git a/src/api/admin/api_server.rs b/src/api/admin/api_server.rs index 92da3245..b835322d 100644 --- a/src/api/admin/api_server.rs +++ b/src/api/admin/api_server.rs @@ -176,7 +176,7 @@ impl ApiHandler for AdminApiServer { impl ApiEndpoint for Endpoint { fn name(&self) -> Cow<'static, str> { match self { - Self::Old(endpoint_v1) => Cow::Owned(format!("v1:{}", endpoint_v1.name())), + Self::Old(endpoint_v1) => Cow::Borrowed(endpoint_v1.name()), Self::New(path) => Cow::Owned(path.clone()), } } diff --git a/src/api/admin/cluster.rs b/src/api/admin/cluster.rs index 112cb542..0cfd744a 100644 --- a/src/api/admin/cluster.rs +++ b/src/api/admin/cluster.rs @@ -151,11 +151,11 @@ impl EndpointHandler for ConnectClusterNodesRequest { .await .into_iter() .map(|r| match r { - Ok(()) => ConnectClusterNodeResponse { + Ok(()) => ConnectNodeResponse { success: true, error: None, }, - Err(e) => ConnectClusterNodeResponse { + Err(e) => ConnectNodeResponse { success: false, error: Some(format!("{}", e)), }, diff --git a/src/api/admin/macros.rs b/src/api/admin/macros.rs index d68ba37f..7082577f 100644 --- a/src/api/admin/macros.rs +++ b/src/api/admin/macros.rs @@ -14,7 +14,7 @@ macro_rules! admin_endpoints { )* } - #[derive(Serialize, Deserialize)] + #[derive(Serialize)] #[serde(untagged)] pub enum AdminApiResponse { $( @@ -22,6 +22,13 @@ macro_rules! admin_endpoints { )* } + #[derive(Serialize, Deserialize)] + pub enum TaggedAdminApiResponse { + $( + $endpoint( [<$endpoint Response>] ), + )* + } + impl AdminApiRequest { pub fn name(&self) -> &'static str { match self { @@ -35,6 +42,16 @@ macro_rules! admin_endpoints { } } + impl AdminApiResponse { + fn tagged(self) -> TaggedAdminApiResponse { + match self { + $( + Self::$endpoint(res) => TaggedAdminApiResponse::$endpoint(res), + )* + } + } + } + #[async_trait] impl EndpointHandler for AdminApiRequest { type Response = AdminApiResponse;