Makefile: support running examples

The `run-examples` 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 \
@@ -151,6 +155,9 @@ SCYLLA_EXAMPLES_TO_RUN := \
 	# cloud <- out of interest for us, not related to ScyllaDB
 	# dse <- out of interest for us, not related to ScyllaDB
 endif
+# 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 += drop_examples_keyspace
 
 ifndef CCM_COMMIT_ID
 	export CCM_COMMIT_ID := master
@@ -330,3 +337,28 @@ endif
 
 run-test-unit: install-cargo-if-missing _update-rust-tooling
 	@cd ${CURRENT_DIR}/scylla-rust-wrapper; RUSTFLAGS="--cfg cpp_rust_unstable --cfg cpp_integration_testing" 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