This example showcases how to use the AWS SQS client with Quarkus. As a prerequisite install Install AWS Command line interface.
Just run it as follows in order to start SQS locally:
docker run --rm --name local-sqs -p 8010:4576 -e SERVICES=sqs -e START_WEB=0 -d localstack/localstack:0.11.1
SQS listens on localhost:8010
for REST endpoints.
Create an AWS profile for your local instance using AWS CLI:
$ aws configure --profile localstack
AWS Access Key ID [None]: test-key
AWS Secret Access Key [None]: test-secret
Default region name [None]: us-east-1
Default output format [None]:
Create a SQS queue and store Queue url in environment variable as we will need to provide it to the our app
$> QUEUE_URL=`aws sqs create-queue --queue-name=ColliderQueue --profile localstack --endpoint-url=http://localhost:8010`
- Run
./mvnw clean package
and thenjava -Dqueue.url=$QUEUE_URL -jar ./target/quarkus-app/quarkus-run.jar
- In dev mode
./mvnw clean quarkus:dev -Dqueue.url=$QUEUE_URL
Shoot with a couple of quarks
curl -XPOST -H"Content-type: application/json" http://localhost:8080/sync/cannon/shoot -d'{"flavor": "Charm", "spin": "1/2"}'
curl -XPOST -H"Content-type: application/json" http://localhost:8080/sync/cannon/shoot -d'{"flavor": "Strange", "spin": "1/2"}'
And receive it from the queue
curl http://localhost:8080/sync/cannon/shoot
Repeat the same using async endpoints
curl -XPOST -H"Content-type: application/json" http://localhost:8080/async/cannon/shoot -d'{"flavor": "Charm", "spin": "1/2"}'
curl -XPOST -H"Content-type: application/json" http://localhost:8080/async/cannon/shoot -d'{"flavor": "Strange", "spin": "1/2"}'
And receive it from the queue
curl http://localhost:8080/async/cannon/shoot
You can compile the application into a native binary using:
./mvnw clean install -Pnative
and run with:
./target/amazon-sqs-quickstart-1.0.0-SNAPSHOT-runner
Build a native image in container by running:
./mvnw package -Pnative -Dnative-image.docker-build=true
Build a docker image:
docker build -f src/main/docker/Dockerfile.native -t quarkus/amazon-sqs-quickstart .
Create a network that connect your container with localstack
docker network create localstack
Stop your localstack container you started at the beginning
docker stop local-sqs
Start localstack and connect to the network
docker run --rm --network=localstack --name localstack -p 8010:4576 -e SERVICES=sqs -e START_WEB=0 -d localstack/localstack:0.11.1
Create queue
$> QUEUE_URL=`aws sqs create-queue --queue-name=ColliderQueue --profile localstack --endpoint-url=http://localhost:8010`
Run quickstart container connected to that network (note that we're using internal port of the localstack)
docker run -i --rm --network=localstack -p 8080:8080 quarkus/amazon-sqs-quickstart -Dquarkus.sqs.endpoint-override=http://localstack:4576
Send messsage
curl -XPOST -H"Content-type: application/json" http://localhost:8080/sync/cannon/shoot -d'{"flavor": "Charm", "spin": "1/2"}'
Receive message
curl http://localhost:8080/sync/cannon/shoot