Update container info.

Author: anthony-tuininga

doc/src/user_guide/installation.rst

@@ -1030,6 +1030,38 @@ Python versions.
 
        python -m pip install oracledb-3.1.0-cp312-cp312-macosx_10_13_universal2.whl
 
+.. _docker:
+
+Using python-oracledb Containers
+================================
+
+Dockerfiles showing installation of Python and python-oracledb on Oracle Linux
+are available from
+`github.com/oracle/docker-images/tree/main/OracleLinuxDevelopers
+<https://github.com/oracle/docker-images/tree/main/OracleLinuxDevelopers>`__.
+
+Containers built from these Dockerfiles can be pulled from the GitHub Container
+Registry:
+
+- `oraclelinux9-python <https://github.com/oracle/docker-images/pkgs/container/
+  oraclelinux9-python>`__
+- `oraclelinux8-python <https://github.com/oracle/docker-images/pkgs/container/
+  oraclelinux8-python>`__
+
+For example, you can pull a container for Python 3.12 on Oracle Linux 9 using::
+
+    docker pull ghcr.io/oracle/oraclelinux9-python:3.12-oracledb
+
+Or use it in a Dockerfile like::
+
+    FROM ghcr.io/oracle/oraclelinux9-python:3.12-oracledb
+
+**Sample Containers**
+
+There are two python-oracledb containers with samples located in
+`/samples/containers
+<https://github.com/oracle/python-oracledb/tree/main/samples/containers>`__.
+
 .. _configprovidermodules:
 
 Installing Centralized Configuration Provider Modules for python-oracledb

samples/README.md

@@ -28,8 +28,9 @@ This directory contains samples for python-oracledb.
 
 ### Examples in a Container
 
-The [sample_container](./sample_container) directory has a Dockerfile that will
-build a container with the samples and a running Oracle Database.
+The [containers](./containers) directory has Dockerfiles for building a
+container with the samples and a running Oracle Database, and for creating a
+development environment.
 
 ### Notebooks
 

samples/containers/README.md

@@ -0,0 +1,19 @@
+# python-oracledb Containers
+
+## Samples
+
+This directory contains Dockerfiles for creating sample containers:
+
+- [Samples and Oracle Database](./samples_and_db) - a container with a running database, python-oracledb, and all the samples
+- [Application development](./app_dev) - a container with python-oracledb and the Apache web server with WSGI. This is useful for creating your own applications
+
+## Container images for Linux Developers
+
+Additional Dockerfiles showing installation of Python and python-oracle on
+Oracle Linux are available from
+[github.com/oracle/docker-images/tree/main/OracleLinuxDevelopers](https://github.com/oracle/docker-images/tree/main/OracleLinuxDevelopers).
+
+Containers can be pulled from the GitHub Container Registry:
+
+- [oraclelinux9-python](https://github.com/oracle/docker-images/pkgs/container/oraclelinux9-python)
+- [oraclelinux8-python](https://github.com/oracle/docker-images/pkgs/container/oraclelinux8-python)