ORDS Developer Docker 镜像

描述

[!IMPORTANT] 重要公告
从 ORDS 24.4.0 版本开始，ords-developer 镜像已被弃用。当前受支持的 ORDS 镜像已发生重大变更；请查阅以下文档了解最新变化：[***] 镜像将于 2026 年 5 月从容器 registry 中完全移除，请考虑迁移至最新版本。

[!NOTE] 此镜像专门构建用于快速启动包含 ORDS 和 APEX 的开发环境，因此不提供支持，不应在生产环境中使用。生产环境请参考 ORDS 镜像：[***]

• ORDS 是一个中间层 Java 应用程序，提供数据库管理 REST API、SQL Developer Web、PL/SQL 网关、SODA for REST，以及发布 RESTful Web 服务以与 Oracle 数据库中的数据和存储过程交互的能力。更多信息请参见 [***]
• Oracle Application Express (APEX) 是一个低代码开发平台，使您能够构建可扩展、安全的企业应用程序，具有世界级功能，可在任何地方部署。更多信息请参见 [***]

版本矩阵

每个镜像使用 Oracle Linux，并包含特定版本的 ORDS 和 APEX。镜像发布时会使用其包含的 ORDS 版本作为标签。通常，镜像中包含的 APEX 版本是创建镜像时公开可用的已发布版本。建议始终使用带有 latest 标签的镜像，以使用最新的 ORDS 和 APEX。

拉取镜像

docker pull container-registry.oracle.com/database/ords-developer:latest

在数据库上安装 ORDS

首次使用镜像时，创建一个目录用于存放 conn_string.txt 文件，该文件将包含容器使用的连接字符串。启动容器时，此目录将被映射为特定卷。以下命令将创建 conn_string.txt，其中包含 CONN_STRING 中指定的 user/password@hostname:port/service_name。将 user、password、hostname、port 和 service_name 替换为实际的数据库连接详情。此外，您可以为 ORDS 配置创建 docker 卷或目录。

mkdir ords_secrets ords_config
chmod 777 ords_config
echo 'CONN_STRING=user/password@hostname:port/service_name'
> ords_secrets/conn_string.txt

运行容器...

docker run --rm --name ords -v `pwd`/ords_secrets/:/opt/oracle/variables -v `pwd`/ords_config/:/etc/ords/config/ -p 8181:8181 container-registry.oracle.com/database/ords-developer:latest

根据需要替换容器名称、目录名称和主机端口号。

[!NOTE] 如果对连接字符串或凭据有疑问，请查看“重要说明”部分。

使用 ORDS 配置卷

您可以设置配置挂载，将 ORDS 配置指向 /etc/ords/config，容器将尝试使用挂载点上的配置启动服务。

使用 ORDS 配置挂载运行容器...

docker run --rm --name ords -v `pwd`/ords_secrets/:/opt/oracle/variables -v `pwd`/ords_config/:/etc/ords/config/ -p 8181:8181 container-registry.oracle.com/database/ords-developer:latest

[!NOTE] 如果是第二次启动容器，且第一次已提供配置卷，则无需再次提供连接字符串文件。容器将使用配置卷中保存的配置启动 ORDS。但如果同时提供配置卷和连接字符串文件，容器在启动 ORDS 前会验证 APEX 是否已安装或是否需要升级，必要时会重新配置 APEX，然后启动 ORDS。

使用预设配置启动 ORDS

要运行容器而不安装/升级数据库，请不要提供 conn_string.txt，而是提供包含有效配置的 config 文件夹。

docker run --rm --name ords -v `pwd`/ords_config/:/etc/ords/config/ -p 8181:8181 container-registry.oracle.com/database/ords-developer:latest

设置 SSL 配置

要在 ORDS 容器上启动安全服务，请创建一个名为“ssl”的文件夹，将证书和密钥文件放入此文件夹，文件必须命名为“cert.crt”和“key.key”。

mkdir -p ords_config/ssl
cp cert_file.crt ords_config/ssl/cert.crt
cp key_file.key ords_config/ssl/key.key

使用配置卷启动服务...

docker run --rm --name ords -v `pwd`/ords_secrets/:/opt/oracle/variables -v `pwd`/ords_config/:/etc/ords/config/ -p 8181:8181 container-registry.oracle.com/database/ords-developer:latest

如果容器检测到证书和密钥文件，将以安全模式启动 ORDS 服务。

自定义脚本

如果需要在容器中运行自定义脚本，可以添加一个卷，将 shell 脚本指向 /ords-entrypoint.d。

docker run --rm --name ords -v /custom_scripts_path/:/ords-entrypoint.d/ -v `pwd`/ords_secrets/:/opt/oracle/variables -v `pwd`/ords_config/:/etc/ords/config/ -p 8181:8181 container-registry.oracle.com/database/ord-developer:latest

容器将安装/升级 APEX 和 ORDS，并在启动 ORDS 服务前按字母顺序运行 /ords-entrypoint.d 中的所有 shell 脚本。

登录 APEX

在浏览器中打开 localhost 及 docker 映射的端口（[***]

- Workspace: internal
- User: ADMIN
- Password: Welcome_1

强烈建议更改此密码。

使用 IGNORE_APEX 变量启动容器

设置 IGNORE_APEX=TRUE 变量后，容器将不会在数据库上安装、升级或配置 Oracle APEX。

docker run --rm -e IGNORE_APEX=TRUE --name ords -v `pwd`/ords_secrets/:/opt/oracle/variables -p 8181:8181 container-registry.oracle.com/database/ords-developer:latest

重要说明

• conn_string.txt 文件是必需的，必须挂载到容器中的 /opt/oracle/variables/ 目录
• 该文件中的 CONN_STRING 变量必须采用以下格式：CONN_STRING=user/password@hostname:port/service_name
• 容器启动时会删除 conn_string.txt 文件。数据库连接详情不会保存在容器的环境变量中。
• 指定的数据库凭据必须具有 SYSDBA 访问权限，因为此数据库账户将用于安装/升级 APEX 和 ORDS 数据库组件。
• 如果数据库已安装早期版本的 APEX，容器将把其升级到容器中打包的版本（前提是发行版的主版本号相同）。为确保升级过程的兼容性，如果 APEX 发行版的主版本号不同，容器将停止。