Docker Oracle XE 11g 安装与使用指南

1. 项目目录结构及介绍

当你通过 git clone https://github.com/wnameless/docker-oracle-xe-11g.git 克隆此项目到本地时，你会看到以下主要的目录结构：

.
├── Dockerfile            # 构建镜像的基础文件
├── README.md            # 项目的主读我文件，包含了基本信息和说明
├── LICENSE              # 项目的许可协议文件
├── docker-compose.yml   # Docker Compose 的配置文件，用于定义服务和网络
└── init                 # 初始化脚本目录
    ├── create_tablespace.sql      # 创建表空间的初始化SQL脚本
    └── startup.sh                 # 启动时执行的Shell脚本，可以进行自定义数据库初始化

Dockerfile

这个文件是构建 Oracle XE 11g Docker 镜像的核心文件。它列出了所有必要的命令来创建 Docker 镜像，包括从基础镜像出发添加必要的软件包、环境变量设定以及运行时的默认指令。

init 目录

这个目录存放了在容器启动或重建时由 docker-entrypoint.sh 调用的各种初始化脚本。例如：

create_tablespace.sql

这是 SQL 脚本的一个示例，可以在数据库第一次启动时自动执行以创建新的表空间。这样可以简化部署过程中的初始数据库配置步骤。

startup.sh

这是一个可定制的 Shell 脚本，在 Docker 容器首次启动时运行。你可以在这里放置任何自定义的数据库初始化命令或者系统级别的设置动作。

2. 项目的启动文件介绍

项目的主启动依赖于 docker-entrypoint.sh 文件（尽管该文件可能不直接出现在列出的基本目录中），这是 Docker 在容器启动时调用的标准入口点。这个脚本通常位于镜像的根目录下，其职责是在容器内部执行所有必需的初始化步骤和启动服务。

主要功能

• 环境变量配置: 根据预先定义的环境变量(如 ORACLE_SID, ORACLE_HOME) 自动配置Oracle实例。
• 初始化脚本执行: 运行 init 目录下的任何 SQL 或 Shell 脚本来预设数据库状态。
• 监听端口开启: 启动监听器以便外部访问 Oracle 数据库。
• 守护进程运行: 最终启动 Oracle 数据库的后台服务，使应用能够正常运作。

3. 项目的配置文件介绍

虽然原始的仓库没有明确的配置文件，但配置主要通过环境变量传递给 docker-entrypoint.sh 和 Docker Compose 配置文件（如果有）。以下是一些关键的环境变量：

• ORACLE_SID: 数据库的系统标识符 (SID)，通常是 XE。
• ORACLE_PDB_NAME: 可插入数据库的名字，默认情况下不是必须的，因为 Oracle XE 版本不支持 PDBs。
• ORACLE_HOME: Oracle 数据库的安装路径。
• ORACLE_ALLOW_REMOTE: 是否允许远程连接，默认为禁用，需要显式设置为 true 来启用。

如果你使用的是 docker-compose.yml 来管理你的服务，那么大部分这些配置都会在这个文件中找到，如下所示：

version: '3'
services:
  db:
    image: wnameless/oracle-xe-11g
    environment:
      - ORACLE_SID=XE
      - ORACLE_PDB_NAME=
      - ORACLE_HOME=/opt/oracle/app/oracle/product/11.2.0/xe
      - ORACLE_ALLOW_REMOTE=true
    ports:
      - 1521:1521
      - 5500:5500
    volumes:
      - ./data:/var/lib/oracle/xe

以上信息提供了关于如何设置环境变量、映射端口以及数据卷的基本指导，这些都是容器化应用程序操作的关键部分。