Merge a03cb57c38 into 26cf99b6d7

README.md

@@ -1,4 +1,4 @@
-# Parkers Pterodactyl eggs repo
+# Parkers Pterodactyl eggs repo
 
 I am working on adding a large collection of public eggs for the Pterodactyl community.
 
@@ -83,7 +83,8 @@ If you are reading this it looks like you are looking to add an egg to your serv
 
 ### noSQL
 
-* [MongoDB](/database/nosql/mongodb)
+* [mongoDB](/database/nosql/mongodb)
+* [cassandra](/database/nosql/cassandra)
 * [rethinkdb](/database/nosql/rethinkdb)
 
 ### SQL Databases

database/nosql/cassandra/README.md

@@ -0,0 +1,61 @@
+# Apache Cassandra
+
+### From the [Apache Cassandra](https://cassandra.apache.org/) website
+Apache Cassandra is an open source NoSQL distributed database trusted by thousands of companies for scalability and high availability without compromising performance. 
+Linear scalability and proven fault-tolerance on commodity hardware or cloud infrastructure make it the perfect platform for mission-critical data.
+
+### Installation
+Follow the common egg installation guide to install the egg on your Pterodactyl instance.
+You have to specifiy the Cassandra version to install using the "Cassandra Version" variable.
+By default, version 4.0.0 will be installed.
+
+The version to install has to be available on the mirrors.ae-online.de mirror - which is one of the official mirrors.
+
+You can choose between a Java 11/Python 3 (Cassandra >= 4.0.0) and Java 8/Python 2 (Cassandra < 4.0.0) image 
+
+### Security
+
+#### General usage
+Allowing general users to use this egg is potentially dangerous as the user can modify the Cassandra startup script,
+which is a simple shell script located in the mounted `/home/container` directory. Only trusted users
+should have access to a Cassandra server hosted with this egg to prevent malicious use!
+
+#### Authentication
+The automated configuration of the egg won't allow disable authentication for Cassandra.
+
+The default credentials are:
+ - Username: cassandra
+ - Password: cassandra
+
+The first thing you should do after the first start is changing this password or creating an entirely new user
+while removing the default one. Especially if your instance is exposed to the internet!
+Don't forget to update the login credentials for the default user in the eggs variables after changing them
+for the server to work properly!
+
+**Not changing the password right after the first startup is a big security flaw!**
+
+Example command you can enter into the Pterodactyl console after CQLSH is connected to change the password:
+```
+ALTER USER cassandra WITH PASSWORD 'SomePasswordYouShouldSpecifyOnYourOwn!';
+```
+
+#### Internet Access
+Cassandra recommends to not expose the service to the internet. 
+Therefore, it is recommended to run this egg in an internal network or behind a firewall, 
+that is properly configured to restrict access to the service from outside of your network.
+Note that Docker bypasses IPTables (and because of this also UFW) by default and needs additional configuration!
+
+If you still want to expose the Cassandra service to the internet, configure Cassandra to use an encrypted connection!
+
+### Update support
+The egg _should_ keep the `conf` and `data` folder when reinstalling, to prevent destroying the configuration by accident. 
+
+If you want to reset the server completly, remove the `conf` and `data` directory manually before reinstalling.
+
+### Server Ports
+
+Ports required to run the server in a table format.
+
+| Port                          | default |
+| ----------------------------- | ------- |
+| Cassandra CQL Native Tansport | 9042    |

database/nosql/cassandra/egg-apache-cassandra.json

@@ -0,0 +1,60 @@
+{
+    "_comment": "DO NOT EDIT: FILE GENERATED AUTOMATICALLY BY PTERODACTYL PANEL - PTERODACTYL.IO",
+    "meta": {
+        "version": "PTDL_v1",
+        "update_url": null
+    },
+    "exported_at": "2021-08-03T22:11:40+02:00",
+    "name": "Apache Cassandra",
+    "author": "p.zarrad@outlook.de",
+    "description": "Apache Cassandra is an open source NoSQL distributed database trusted by thousands of companies for scalability and high availability without compromising performance. Linear scalability and proven fault-tolerance on commodity hardware or cloud infrastructure make it the perfect platform for mission-critical data.",
+    "features": null,
+    "images": [
+        "ghcr.io\/parkervcp\/yolks:cassandra_java11_python3",
+        "ghcr.io\/parkervcp\/yolks:cassandra_java8_python2"
+    ],
+    "file_denylist": [],
+    "startup": ".\/start.sh",
+    "config": {
+        "files": "{\r\n    \"conf\/jvm-server.options\": {\r\n        \"parser\": \"file\",\r\n        \"find\": {\r\n            \"#-Xms\": \"-Xms128M\",\r\n            \"#-Xmx\": \"-Xmx{{server.build.memory}}M\"\r\n        }\r\n    },\r\n    \"conf\/jvm11-server.options\": {\r\n        \"parser\": \"file\",\r\n        \"find\": {\r\n            \"#-Xms\": \"-Xms128M\",\r\n            \"#-Xmx\": \"-Xmx{{server.build.memory}}M\"\r\n        }\r\n    },\r\n    \"conf\/jvm8-server.options\": {\r\n        \"parser\": \"file\",\r\n        \"find\": {\r\n            \"#-Xms\": \"-Xms128M\",\r\n            \"#-Xmx\": \"-Xmx{{server.build.memory}}M\"\r\n        }\r\n    },\r\n    \"conf\/cassandra.yaml\": {\r\n        \"parser\": \"file\",\r\n        \"find\": {\r\n            \"native_transport_port\": \"native_transport_port: {{server.build.default.port}}\",\r\n            \"# rpc_address\": \"rpc_address: 0.0.0.0\",\r\n            \"rpc_address\": \"rpc_address: 0.0.0.0\",\r\n            \"# broadcast_rpc_address\": \"broadcast_rpc_address: {{server.build.default.ip}}\",\r\n            \"broadcast_rpc_address\": \"broadcast_rpc_address: {{server.build.default.ip}}\",\r\n            \"authenticator: AllowAllAuthenticator\": \"authenticator: PasswordAuthenticator\",\r\n            \"authorizer: AllowAllAuthorizer\": \"authorizer: CassandraAuthorizer\"\r\n        }\r\n    }\r\n}",
+        "startup": "{\r\n    \"done\": \"Connected to\"\r\n}",
+        "logs": "{}",
+        "stop": "EXIT;"
+    },
+    "scripts": {
+        "installation": {
+            "script": "#!\/bin\/sh\r\n# Switch to mounted directory\r\ncd \/mnt\/server\r\n# Cleanup previous install if available\r\nfind . -maxdepth 1 ! -name \"conf\" ! -name \"data\" ! -name . -exec rm -rf {} \\;\r\nif [ -d \"conf\" ]; then mv conf conf.bak; fi\r\n# Download and extract Cassandra\r\ncurl -L https:\/\/mirrors.ae-online.de\/apache\/cassandra\/${CASSANDRA_VERSION}\/apache-cassandra-${CASSANDRA_VERSION}-bin.tar.gz --output cassandra.tar.gz\r\ntar -zxvf cassandra.tar.gz\r\nmv -n apache-cassandra-*\/* .\/\r\nrm -rf cassandra.tar.gz apache-cassandra*\r\n# Create startup script\r\ncurl -L https:\/\/raw.githubusercontent.com\/parkervcp\/eggs\/master\/database\/nosql\/cassandra\/start.sh --output start.sh\r\nchmod 755 start.sh\r\n# Restore custom config\r\nif [ -d \"conf.bak\" ]; then rm -rf conf; mv conf.bak conf; rm -rf conf.bak; fi",
+            "container": "ghcr.io\/pterodactyl\/installers:alpine",
+            "entrypoint": "ash"
+        }
+    },
+    "variables": [
+        {
+            "name": "Cassandra Version",
+            "description": "The version of Cassandra to install. By default the latest version is being installed.",
+            "env_variable": "CASSANDRA_VERSION",
+            "default_value": "4.0.0",
+            "user_viewable": true,
+            "user_editable": true,
+            "rules": "required|string|max:20"
+        },
+        {
+            "name": "Cassandra Username",
+            "description": "The username used when connecting to the started Cassandra, to make a CQLSH available in the Pterodactyl console. This value must be set to an existing user for the egg to work properly. You can create a custom user and enter it here instead of using the default one.",
+            "env_variable": "CASSANDRA_USER",
+            "default_value": "cassandra",
+            "user_viewable": true,
+            "user_editable": true,
+            "rules": "required|string|max:32"
+        },
+        {
+            "name": "Cassandra Password",
+            "description": "The password used when connecting to the started Cassandra, to make a CQLSH available in the Pterodactyl console. This value must be set to the password of the user specified using the \"Cassandra Username\" variable. It is highly recommended to change the password of the default Cassandra user right after the first start. After updating the password on the server, update this variable too for the egg to work properly!",
+            "env_variable": "CASSANDRA_PASSWORD",
+            "default_value": "cassandra",
+            "user_viewable": true,
+            "user_editable": true,
+            "rules": "required|string|max:128"
+        }
+    ]
+}

database/nosql/cassandra/start.sh

@@ -0,0 +1,35 @@
+#!/bin/ash
+# Start Cassandra
+echo "Starting Cassandra..."
+./bin/cassandra -R -p cassandra.pid
+# Wait for successful startup
+while ! ./bin/cqlsh -u "$CASSANDRA_USER" -p "$CASSANDRA_PASSWORD" -e 'describe cluster' 127.0.0.1 $SERVER_PORT; do
+    echo "Still awaiting Cassandra startup..."
+ 	sleep 10;
+    if ! kill -0 $(cat cassandra.pid); then
+    	echo "It seems Cassandra has crashed!"
+        exit 1
+    fi
+done
+# Connect with CQLSH
+echo "Launching CQLSH..."
+if [ "$CASSANDRA_PASSWORD" = 'cassandra' ]; then
+    echo ""
+    echo ""
+    echo ""
+    echo "IMPORTANT:"
+    echo "YOUR CASSANDRA PASSWORD SEEMS TO BE THE DEFAULT ONE, PLEASE CHANGE IT!"
+    echo ""
+    echo ""
+    echo ""
+fi
+./bin/cqlsh -u "$CASSANDRA_USER" -p "$CASSANDRA_PASSWORD" -t 127.0.0.1 $SERVER_PORT
+# Stop server when CQLSH is stopped
+echo "Stopping Cassandra gracefully..."
+cassandraPid=$(cat cassandra.pid)
+kill $cassandraPid
+while kill -0 $cassandraPid; do
+    echo "Still waiting for Cassandra to exit..."
+ 	sleep 5;
+done
+echo "Cassandra exited gracefully!"