Makefile: support running examples

The `run-examples-scylla` target is added to the Makefile to run
examples. The examples are built and run against a ScyllaDB instance
running in a Docker container. The `SCYLLA_EXAMPLES_TO_RUN` variable
is used to specify which examples to build and run.

As some examples create the `examples` keyspace and some assume it is not
present, a special example `drop_examples_keyspace` is added to drop the
`examples` keyspace before running any example.
This lets us avoid adding a dependency on `cqlsh` to the system.

Author: wprzytula

Makefile

@@ -120,6 +120,10 @@ CASSANDRA_NO_VALGRIND_TEST_FILTER := $(subst ${SPACE},${EMPTY},AsyncTests.Integr
 :HeartbeatTests.Integration_Cassandra_HeartbeatFailed)
 endif
 
+ifndef SCYLLA_EXAMPLES_URI
+SCYLLA_EXAMPLES_URI := 172.43.0.2
+endif
+
 ifndef SCYLLA_EXAMPLES_TO_RUN
 SCYLLA_EXAMPLES_TO_RUN := \
     async \
@@ -246,7 +250,9 @@ build-integration-test-bin-if-missing:
 		cmake -DCASS_BUILD_INTEGRATION_TESTS=ON -DCMAKE_BUILD_TYPE=Release .. && (make -j 4 || make);\
 	}
 
-SCYLLA_EXAMPLES_TO_RUN_SEMICOLON_SEPARATED := $(subst ${SPACE},;,${SCYLLA_EXAMPLES_TO_RUN})
+# The special example `drop_examples_keyspace` is used to drop the `examples` keyspace before running any example,
+# because some examples create the keyspace and some assume it is not present.
+SCYLLA_EXAMPLES_TO_RUN_SEMICOLON_SEPARATED := $(subst ${SPACE},;,${SCYLLA_EXAMPLES_TO_RUN});drop_examples_keyspace
 
 build-examples:
 	@{\
@@ -338,3 +344,28 @@ endif
 
 run-test-unit: install-cargo-if-missing _update-rust-tooling
 	@cd ${CURRENT_DIR}/scylla-rust-wrapper; RUSTFLAGS="${FULL_RUSTFLAGS}" cargo test
+
+# Currently not used.
+CQLSH := cqlsh
+
+run-examples-scylla: build-examples
+	@sudo sh -c "echo 2097152 >> /proc/sys/fs/aio-max-nr"
+	@# Keep `SCYLLA_EXAMPLES_URI` in sync with the `scylla` service in `docker-compose.yml`.
+	@docker compose -f tests/examples_cluster/docker-compose.yml up -d --wait
+
+	@# Instead of using cqlsh, which would impose another dependency on the system,
+	@# we use a special example `drop_examples_keyspace` to drop the `examples` keyspace.
+	@# CQLSH_HOST=${SCYLLA_EXAMPLES_URI} ${CQLSH} -e "DROP KEYSPACE IF EXISTS EXAMPLES"; \
+
+	@echo "Running examples on scylla ${SCYLLA_VERSION}"
+	@for example in ${SCYLLA_EXAMPLES_TO_RUN} ; do \
+		echo -e "\nRunning example: $${example}"; \
+		build/examples/drop_examples_keyspace/drop_examples_keyspace ${SCYLLA_EXAMPLES_URI} || exit 1; \
+		build/examples/$${example}/$${example} ${SCYLLA_EXAMPLES_URI} || { \
+		    echo "Example \`$${example}\` has failed!"; \
+			docker compose -f tests/examples_cluster/docker-compose.yml down; \
+			exit 42; \
+		}; \
+	done
+
+	@docker compose -f tests/examples_cluster/docker-compose.yml down --remove-orphans