quarkus-astra-demo

ASTRA is the simplest way to run Cassandra with zero operations at all - just push the button and get your cluster. No credit card required, $25.00 USD credit every month, roughly 5M writes, 30M reads, 40GB storage monthly - sufficient to run small production workloads.

To use this project:

✅ Clone the repo

✅ Register (if needed) and Sign In to Astra https://astra.datastax.com: You can use your Github, Google accounts or register with an email.

Make sure to chose a password with minimum 8 characters, containing upper and lowercase letters, at least one number and special character

✅ Create a "pay as you go" plan

Follow this guide, to set up a pay as you go database with a free $25 monthly credit.

• Select the pay as you go option: Includes $25 monthly credit - no credit card needed to set up.

You will find below which values to enter for each field.

• For the database name - free_db. While Astra allows you to fill in these fields with values of your own choosing, please follow our recommendations to ensure the application runs properly.

• For the keyspace name - free. It's really important that you use the name "free" for the code to work.

You can technically use whatever you want and update the code to reflect the keyspace. This is really to get you on a happy path for the first run.

• For provider and region: Choose and provider (either GCP or AWS). Region is where your database will reside physically (choose one close to you or your users).

• Create the database. Review all the fields to make sure they are as shown, and click the Create Database button.

You will see your new database pending in the Dashboard.

The status will change to Active when the database is ready, this will only take 2-3 minutes. You will also receive an email when it is ready.

✅ Download your secure connect bundle from the connect screen

✅ Create a token for your app to use in the settings screen

✅ Create and populate your application.properties file:

cp  ./src/main/resources/application.properties.template ./src/main/resources/application.properties

✅ Replace the following lines to point at your scb and with your token:

quarkus.cassandra.cloud.secure-connect-bundle=<</PATH_TO_SCB.ZIP>>
quarkus.cassandra.auth.password=AstraCS:<<REPLACE_ME:REPLACE_ME>>

If you prefer to stub out the code yourself, pull the puzzle branch instead and give it a try. This main branch has the required endpoints stubbed out.

This project uses Quarkus, the Supersonic Subatomic Java Framework.

If you want to learn more about Quarkus, please visit the website: https://quarkus.io/

Running the application in dev mode

You can run your application in dev mode that enables live coding using:

./mvnw clean quarkus:dev

📗 Expected output

Once the application is running navigate to http://localhost:8080.

Packaging and running the application

The application can be packaged using ./mvnw package. It produces the quarkus-run.jar file in the /target/quarkus-app directory. Be aware that it’s not an über-jar as the dependencies are copied into the target/quarkus-app/lib directory.

The application is now runnable using java -jar target/quarkus-app/quarkus-run.jar.

Creating a native executable

You can create a native executable using: ./mvnw package -Pnative.

Or, if you don't have GraalVM installed, you can run the native executable build in a container using: ./mvnw package -Pnative -Dquarkus.native.container-build=true.

Make sure you have a container runtime (docker/podman/etc) installed

You can then execute your native executable with: ./target/quarkus-astra-demo-0.01-runner

If you want to learn more about building native executables, please consult https://quarkus.io/guides/building-native-image.

Running on Red Hat Developer Sandbox

Run this application on the free Red Hat Developer Sandbox. All you need to do is create an account and then click here to load the workspace!