Relocate Management API to K8ssandra org

Author: emerkle826

README.md

@@ -1,117 +1,132 @@
-# Management API for Apache Cassandra®
+# Management API for Apache Cassandra™
 
-![Java CI](https://github.com/datastax/management-api-for-apache-cassandra/workflows/Java%20CI/badge.svg)
-![Docker Release](https://github.com/datastax/management-api-for-apache-cassandra/workflows/Docker%20Release/badge.svg)
+![Java CI](https://github.com/k8ssandra/management-api-for-apache-cassandra/workflows/Java%20CI/badge.svg)
+![Docker Release](https://github.com/k8ssandra/management-api-for-apache-cassandra/workflows/Docker%20Release/badge.svg)
 ## Introduction
 
-   Cassandra® operations have historically been command line driven. 
-   The management of operational tools for Apache Cassandra® have been mostly 
-   outsourced to teams who manage their specific environments.  
-   
+   Cassandra operations have historically been command line driven.
+   The management of operational tools for Apache Cassandra have been mostly
+   outsourced to teams who manage their specific environments.
+
    The result is a fragmented and tribal set of best practices, workarounds,
    and edge cases.
-   
+
    The Management API is a sidecar service layer that attempts to build a well supported
-   set of operational actions on Cassandra® nodes that can be administered centrally.
-   It currently works with official [Apache Cassandra®](https://cassandra.apache.org) 3.11.x an 4.0 
+   set of operational actions on Cassandra nodes that can be administered centrally.
+   It currently works with official [Apache Cassandra](https://cassandra.apache.org) 3.11.x and 4.0
    via a drop in java agent.
-   
-   * Lifecycle Management 
+
+   * Lifecycle Management
        * Start Node
        * Stop Node
    * Configuration Management (alpha)
        * Change YAML
        * Change jvm-opts
-   * Health Checks 
+   * Health Checks
        * Kubernetes liveness/readiness checks
-       * Consistency level checks 
-   * Per node actions 
+       * Consistency level checks
+   * Per node actions
        * All nodetool commands
-     
+
 ## Design Principles
   * Secure by default
   * Simple to use and extend
   * CQL Only for all C* interactions
     * Operations: Use `CALL` method for invoking via CQL
-    * Observations: Rely on System Views 
-  
-  The Management API has no configuration file.  Rather, it can only be configured from a 
-  small list of command line flags.  Communication by default can only be via **unix socket** 
+    * Observations: Rely on System Views
+
+  The Management API has no configuration file.  Rather, it can only be configured from a
+  small list of command line flags.  Communication by default can only be via **unix socket**
   or via a **http(s) endpoint** with optional TLS client auth.
-  
-  In a containerized setting the Management API represents **PID 1** and will be 
-  responsible for the lifecycle of Cassandra® via the API.
-  
-  Communication between the Management API and Cassandra® is via a local **unix socket** using
-  CQL as it's only protocol.  This means, out of the box Cassandra® can be started
+
+  In a containerized setting the Management API represents **PID 1** and will be
+  responsible for the lifecycle of Cassandra via the API.
+
+  Communication between the Management API and Cassandra is via a local **unix socket** using
+  CQL as it's only protocol.  This means, out of the box Cassandra can be started
   securely with no open ports!  Also, using CQL only means operators can
   execute operations via CQL directly if they wish.
-  
+
   Each Management API is responsible for the local node only.  Coordination across nodes
   is up to the caller.  That being said, complex health checks can be added via CQL.
-    
+
 ## Building
 
 ### Containers
-    
-First you need to build the Management API base image:
-    
+
+First you need to build the Management API base image
+
+(*Deprecated: For Cassandra 3.11 and 4.0 images, as well as DSE 6.8 images, you do not need to build the Management API builder image*):
+
     docker build -t management-api-for-apache-cassandra-builder -f ./Dockerfile-build .
 
-Then you need to build the image based on the actual Cassandra® version, either the 3.11 or 4.0:
+Then you need to build the image based on the actual Cassandra version, either the 3.11 or 4.0:
 
 **NOTE:** For building 3.11 images, you will need to have the [Docker buildx plugin](https://docs.docker.com/buildx/working-with-buildx/) installed.
 
     #Create a docker image with management api and C* 3.11 (version 3.11.7 and newer are supported, replace `3.11.10` with the version you want below)
     docker buildx build --load --build-arg CASSANDRA_VERSION=3.11.10 --tag mgmtapi-3_11 --file Dockerfile-oss --target oss311 --platform linux/amd64 .
-    
+
     #Create a docker image with management api and C* 4.0
     docker build -t mgmtapi-4_0 -f Dockerfile-4_0 .
 
-You can also build an image based on Datastax Astra Cassandra® 4.0 sources. First checkout [sources](https://github.com/datastax/cassandra/tree/astra) and build a tgz distribution:
-    
+You can also build an image based on Datastax Astra Cassandra 4.0 sources. First checkout [sources](https://github.com/datastax/cassandra/tree/astra) and build a tgz distribution:
+
     ant artifacts
-    
+
 Then copy the tgz archive into the astra-4.0 directory of the Management API sources and run:
-    
+
     cd astra-4.0
     docker build -t datastax/astra:4.0 .
-   
+
 Finally build the Management API image:
-    
+
     cd ..
     docker build -t mgmtapi-astra-4_0 -f Dockerfile-astra-4_0 .
 
-    
+
 ### Standalone
-    
+
     mvn -DskipTests package
     mvn test
-    
+    mvn integration-test -Drun311tests=true -Drun40tests=true
+
+**NOTE 1:** Running ````integration-test````s will also run unit tests.
+
+**NOTE 2:** Running ````integration-test````s requires at least one of ````-Drun311tests````, ````-Drun40tests```` or ````-DrunDSEtests```` to be set to ````true```` (you can set any combination of them to ````true````).
+
+**NOTE 3:** In order to run DSE integration tests, you must also enable the ````dse```` profile:
+
+    mvn integration-test -P dse -DrunDSEtests=true
+
 ## REST API
-   [The current Swagger/OpenAPI documentation](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/datastax/management-api-for-apache-cassandra/master/management-api-server/doc/openapi.json&nocors)
-   
+   [The current Swagger/OpenAPI documentation](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/k8ssandra/management-api-for-apache-cassandra/master/management-api-server/doc/openapi.json&nocors)
+
    Also readable from url root: ````/openapi.json````
-  
+
 ## Usage
 
   The latest releases are on Docker Hub:
-     [Management API for Apache Cassandra® 3.11.7](https://hub.docker.com/repository/docker/datastax/cassandra-mgmtapi-3_11_7) and 
-     [Management API for Apache Cassandra® 4.0 alpha3](https://hub.docker.com/repository/docker/datastax/cassandra-mgmtapi-4_0_0).
- 
+
+  - [Management API for Apache Cassandra 3.11.7](https://hub.docker.com/repository/docker/datastax/cassandra-mgmtapi-3_11_7)
+  - [Management API for Apache Cassandra 3.11.8](https://hub.docker.com/repository/docker/datastax/cassandra-mgmtapi-3_11_8)
+  - [Management API for Apache Cassandra 3.11.9](https://hub.docker.com/repository/docker/datastax/cassandra-mgmtapi-3_11_9)
+  - [Management API for Apache Cassandra 3.11.10](https://hub.docker.com/repository/docker/datastax/cassandra-mgmtapi-3_11_10)
+  - [Management API for Apache Cassandra 4.0-beta4](https://hub.docker.com/repository/docker/datastax/cassandra-mgmtapi-4_0_0).
+
   For running standalone the jars can be downloaded from the github release:
-     [Management API Releases Zip](https://github.com/datastax/management-api-for-apache-cassandra/releases)
+     [Management API Releases Zip](https://github.com/k8ssandra/management-api-for-apache-cassandra/releases)
+
+  The Management API can be run as a standalone service or along with the Kubernetes
+  [cass-operator](https://github.com/datastax/cass-operator).
 
-  The Management API can be run as a standalone service or along with the Kubernetes 
-  [cass-operator](https://github.com/datastax/cass-operator). 
-  
   The Management API is configured from the CLI. To start the service with a C* version built above, run:
-     
-     > docker run -p 8080:8080 -it --rm mgmtapi-4_0 
-     
+
+     > docker run -p 8080:8080 -it --rm mgmtapi-4_0
+
      > curl http://localhost:8080/api/v0/probes/liveness
      OK
-     
+
      # Check service and C* are running
      > curl http://localhost:8080/api/v0/probes/readiness
      OK
@@ -124,8 +139,6 @@ Once you have DSE jars published locally, follow these steps:
 # The builder image needs to have Maven settings.xml (that provides access to Artifactory):
 cp $HOME/.m2/settings.xml $PWD
 
-docker build -t management-api-for-dse-builder -f ./Dockerfile-build-dse .
-
 docker build -t mgmtapi-dse -f Dockerfile-dse-68 .
 
 docker run -p 8080:8080 -it --rm mgmtapi-dse
@@ -137,34 +150,34 @@ docker run -p 8080:8080 -it --rm mgmtapi-dse
 
   To start the service with a locally installed C* or DSE instance, you would run the below commands. The Management API will figure out
   through `--db-home` whether it points to a C* or DSE folder
-    
+
     # REQUIRED: Add management api agent to C*/DSE startup
     > export JVM_EXTRA_OPTS="-javaagent:$PWD/management-api-agent/target/datastax-mgmtapi-agent-0.1.0-SNAPSHOT.jar"
-        
+
     > alias mgmtapi="java -jar management-api-server/target/datastax-mgmtapi-server-0.1.0-SNAPSHOT.jar"
-    
+
     # Start the service with a local unix socket only, you could also pass -H http://localhost:8080 to expose a port
     > mgmtapi --db-socket=/tmp/db.sock --host=unix:///tmp/mgmtapi.sock --db-home=<pathToCassandraOrDseHome>
-    
+
     # Cassandra/DSE will be started by the service by default unless you pass --explicit-start flag
-    
+
     # Check the service is up
     > curl --unix-socket /tmp/mgmtapi.sock http://localhost/api/v0/probes/liveness
-    OK 
-    
+    OK
+
     # Check C*/DSE is up
-    > curl --unix-socket /tmp/mgmtapi.sock http://localhost/api/v0/probes/readiness 
+    > curl --unix-socket /tmp/mgmtapi.sock http://localhost/api/v0/probes/readiness
     OK
-    
+
     # Stop C*/DSE
     curl -XPOST --unix-socket /tmp/mgmtapi.sock http://localhost/api/v0/lifecycle/stop
     OK
 
 # CLI Help
   The CLI help covers the different options:
-    
+
     mgmtapi --help
-    
+
     NAME
             cassandra-management-api - REST service for managing an Apache
             Cassandra or DSE node
@@ -238,15 +251,15 @@ docker run -p 8080:8080 -it --rm mgmtapi-dse
                 This options value must be a path on the file system that must be
                 readable.
 
-    
+
     COPYRIGHT
             Copyright (c) DataStax 2020
-    
+
     LICENSE
             Please see https://www.apache.org/licenses/LICENSE-2.0 for more
             information
 
-  
+
 ## Roadmap
   * CQL based configuration changes
   * Configuration as system table

management-api-agent-common/README.md

@@ -1,6 +1,6 @@
 # Management API Agent
 
-The Agent is the bridge between the Management API and the instance of Cassandra or DSE it controls.
+The Agent is the bridge between the Management API and the instance of Apache Cassandra™ or DSE it controls.
 This is accomplished by adding the agent jarfile to the startup options of the server with the `-javaagent`
 directive. See the [main README](../README.md#using-the-service-with-a-locally-installed-c-or-dse-instance)
 as an example.

management-api-server/doc/openapi.json

@@ -1,8 +1,8 @@
 {
   "openapi" : "3.0.1",
   "info" : {
-    "title" : "Management API for Apache Cassandra",
-    "description" : "This is a Restful service for operating Apache Cassandra.  You can find out more about the Management API on [Github](http://github.com/datastax/management-api-for-apache-cassandra)",
+    "title" : "Management API for Apache Cassandra™",
+    "description" : "This is a Restful service for operating Apache Cassandra.  You can find out more about the Management API on [Github](http://github.com/k8ssandra/management-api-for-apache-cassandra)",
     "license" : {
       "name" : "Apache 2.0",
       "url" : "http://www.apache.org/licenses/LICENSE-2.0.html"

management-api-server/src/main/resources/openapi-configuration.json

@@ -7,8 +7,8 @@
     "openAPI": {
         "info": {
             "version": "0.1",
-            "title": "Management API for Apache Cassandra",
-            "description": "This is a Restful service for operating Apache Cassandra.  You can find out more about the Management API on [Github](http://github.com/datastax/management-api-for-apache-cassandra)",
+            "title": "Management API for Apache Cassandra™",
+            "description": "This is a Restful service for operating Apache Cassandra.  You can find out more about the Management API on [Github](http://github.com/k8ssandra/management-api-for-apache-cassandra)",
             "license": {
                 "name": "Apache 2.0",
                 "url": "http://www.apache.org/licenses/LICENSE-2.0.html"