Oracle REST Data Services (ORDS) Docker镜像构建与部署指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00902/article/details/148465549

Oracle REST Data Services (ORDS) Docker镜像构建与部署指南

docker-images docker-images：这是一个包含 Docker 镜像的仓库。它提供了一些常见的 Docker 镜像，包括 Oracle 数据库、MySQL 数据库等。使用方法是在 Docker 官方文档中查找相应的教程和示例。项目地址: https://gitcode.com/gh_mirrors/do/docker-images

概述

Oracle REST Data Services (ORDS) 是Oracle官方提供的RESTful服务中间件，它能够将Oracle数据库转换为REST API服务。本文详细介绍如何使用Docker容器化部署ORDS服务，帮助开发者快速搭建REST API开发环境。

准备工作

环境要求

已安装Docker引擎
至少4GB可用内存
熟悉基本的Docker操作命令

获取ORDS安装包

有两种方式获取ORDS安装包：

手动下载：从Oracle官网获取最新版ORDS的ZIP包，放置在dockerfiles目录下
自动下载：如果不手动提供安装包，构建脚本会自动下载最新版本

重要提示：不要手动解压下载的ZIP包，构建脚本会自动处理解压操作。

镜像构建

基础镜像说明

ORDS镜像基于oracle/serverjre:8构建，这是一个包含Oracle Server JRE 8的基础镜像。构建前需要确保：

已从容器注册表获取该基础镜像
或者本地已构建该基础镜像

使用构建脚本

项目提供了buildContainerImage.sh脚本简化构建过程：

./buildContainerImage.sh -h

常用参数说明：

-i：忽略MD5校验
-o：传递额外的Docker构建参数

自定义构建

高级用户可以直接使用docker build命令：

docker build -f Dockerfile -t oracle/restdataservices:custom .

容器部署

网络配置

ORDS需要与Oracle数据库通信，建议创建专用Docker网络：

docker network create ords-network

数据库容器启动

确保数据库容器使用相同网络：

docker run --name oracledb --network=ords-network oracle/database:12.2.0.1-ee

ORDS容器启动

典型启动命令示例：

docker run --name my-ords \
--network=ords-network \
-p 8080:8888 \
-e ORACLE_HOST=oracledb \
-e ORACLE_PORT=1521 \
-e ORACLE_SERVICE=ORCLPDB1 \
-e ORACLE_PWD=MySysPassword1 \
-e ORDS_PWD=MyOrdsPassword1 \
-v /my/local/path:/opt/oracle/ords/config/ords \
oracle/restdataservices:3.0.12

关键参数说明：

| 参数 | 说明 | 默认值 | |------|------|--------| | --network | 指定Docker网络 | - | | -p | 端口映射(主机端口:容器端口) | - | | ORACLE_HOST | 数据库主机名 | localhost | | ORACLE_PORT | 数据库端口 | 1521 | | ORACLE_SERVICE | 数据库服务名 | ORCLPDB1 | | ORACLE_PWD | SYS用户密码 | - | | ORDS_PWD | ORDS_PUBLIC_USER密码 | - | | CONTEXT_ROOT | REST API上下文路径 | ords | | -v | 配置文件持久化挂载 | - |