Add servers and tags objects with overlays (#26)

* Add servers and tags objects with overlays

* Remove commented out lines

* Remove extra lines per automated review

* Change info.version to semver

We can keep minor, non-breaking changes to overlay functionality without making it seem like a major version change

* Apply suggestion from review

---------

Co-authored-by: Kat Batuigas <[email protected]>

Author: kbatuigas

admin/overlays/update-tags.yaml admin/v1-overlays/update-tags.yamladmin/overlays/update-tags.yaml renamed to admin/v1-overlays/update-tags.yaml

@@ -2,7 +2,7 @@
 overlay: 1.0.0
 info:
   title: Redpanda Admin API Tags
-  version: v1
+  version: 1.0.0
 
 actions:
   - target: $.tags[?(@.name=="Mount and unmount topics")]

admin/v2-overlays/add-servers-object.yaml

@@ -0,0 +1,12 @@
+# This overlay adds the servers object to the Redpanda Admin API v2 specification.
+
+overlay: 1.0.0
+info:
+  title: Admin API v2 Servers
+  version: 1.0.0
+
+actions:
+  - target: "$"
+    update:
+      servers:
+        - url: http://localhost:9644

admin/v2-overlays/create-and-update-tags.yaml

@@ -0,0 +1,24 @@
+# This overlay extends the Redpanda Admin API specification by creating an
+# end-user facing list of tags and applying them to the relevant endpoints.
+overlay: 1.0.0
+info:
+  title: Redpanda Admin API v2 Tags
+  version: 1.0.0
+
+actions:
+  # Add tags object to the root level
+  - target: "$"
+    update:
+      tags:
+        - name: Brokers
+          description: See details about brokers in a Redpanda cluster, including client connections.
+        - name: Shadow Links
+          description: Manage shadow links for disaster recovery and migration.
+  
+  # Rename BrokerService endpoint tags
+  - target: "$.paths.*.*.tags[?(@ == 'BrokerService')]"
+    update: "Brokers"
+  
+  # Rename ShadowLinkService endpoint tags
+  - target: "$.paths.*.*.tags[?(@ == 'ShadowLinkService')]"
+    update: "Shadow Links"