Merge branch 'cassandra-5.0' into trunk

Author: smiklosovic

pylib/Dockerfile.ubuntu.py3

@@ -1,9 +1,10 @@
 == Overview
 
 This directory contains code primarily for cqlsh. cqlsh uses cqlshlib in this directory.
+Currently, cqlshlib drops support for Python 2.7. Python 3.6 and 3.7 are deprecated, making Python 3.8+ the recommended version.
 
 == Requirements
-. Python 3.8-3.11 (for cqlsh)
+. Python 3.8+ (for cqlsh)
 . virtualenv
 . Docker (optional)
 
@@ -27,22 +28,18 @@ You can run tests on the python style compliance issues with:
 In order to run tests in a virtual environment for cqlshlib, run cassandra-cqlsh-tests.sh in this directory. It will
 automatically setup a virtualenv with the appropriate version of Python and run tests inside it.
 
-There are Dockerfiles that can be used to test whether cqlsh works with a default, barebones
-Python installation. Assuming Cassandra's source is checked out at `$CASSANDRA_DIR`. To test, first
-build the Docker image containing the barebones Python installation -
+To run cqlsh using publicly available Docker images to connect to Cassandra on the same host, with `$CASSANDRA_DIR` pointing to either the source or install directory where `bin/cqlsh` is located.
 
-  $ docker build . --file Dockerfile.ubuntu.py3 -t ubuntu-lts-py3
+For Python 3.11:
 
-Next, run cqlsh inside the newly built image -
+  $ docker run -v $CASSANDRA_DIR:/code -it python:3.11-slim /code/bin/cqlsh host.docker.internal
 
-  $ docker run -v $CASSANDRA_DIR:/code -it ubuntu-lts-py3:latest /code/bin/cqlsh host.docker.internal
+For Python 3.8:
 
-If `host.docker.internal` isn't supported, then you can use `--net="host"` with `docker run`:
+  $ docker run -v $CASSANDRA_DIR:/code -it python:3.8-slim /code/bin/cqlsh host.docker.internal
 
-  $ docker run --net="host" -v $CASSANDRA_DIR:/code -it ubuntu-lts-py3:latest /code/bin/cqlsh
+If `host.docker.internal` isn't supported, then you can use `--net="host"`:
 
-This will try to spawn a cqlsh instance inside the Docker container running Ubuntu LTS (18.04)
-with minimal Python installation. It will try to connect to the Cassandra instance running on the
-Docker host at port 9042. If you have Cassandra running elsewhere, replace host.docker.internal
-with the IP / hostname as usual. Please ensure that the IP / host is accessible from _within_ the
-Docker container.
+  $ docker run --net="host" -v $CASSANDRA_DIR:/code -it python:3.11-slim /code/bin/cqlsh
+
+This will try to spawn a cqlsh instance inside the Docker container with a minimal Python installation. It will try to connect to the Cassandra instance running on the Docker host at port 9042. If you have Cassandra running elsewhere, replace host.docker.internal with the IP / hostname as usual. Please ensure that the IP / host is accessible from _within_ the Docker container.