Oracle 19c Enterprise Edition Docker Setup

Este projeto configura um ambiente Oracle Database 19c Enterprise Edition usando Docker para desenvolvimento e testes.

📋 Pré-requisitos

• Docker e Docker Compose instalados
• Pelo menos 8GB de RAM disponível para o Docker
• Conta Oracle para acessar o Container Registry (container-registry.oracle.com)
• Arquivo de dump arquivo.dmp (opcional)

🔑 Configuração do Oracle Container Registry

Antes de iniciar, você precisa fazer login no Oracle Container Registry:

docker login container-registry.oracle.com

Use suas credenciais da conta Oracle (Oracle Single Sign-On).

🚀 Configuração Inicial

1. Configurar Variáveis de Ambiente

O arquivo .env deve conter:

ORACLE_PASSWORD=oracle123
ORACLE_SID=ORCLCDB
ORACLE_PDB=ORCLPDB1

2. Colocar Arquivo de Dump (Opcional)

Se você tem um arquivo de dump para importar, coloque-o em:

backup/arquivo.dmp

3. Iniciar o Container

docker-compose up -d

⚠️ Primeira inicialização pode levar 15-30 minutos!

📊 Informações de Conexão

Conexão Principal (PDB)

• Host: localhost
• Porta: 1521
• Service Name: ORCLPDB1
• Usuário Sistema: system
• Senha: oracle123

Oracle Enterprise Manager

• URL: https://localhost:5500/em
• Usuário: sys
• Senha: oracle123
• Role: SYSDBA

Usuários Criados Automaticamente

• devuser / oracle123 (com privilégios DBA)
• APP_MOBILE_PROD / oracle123
• INFOCONSIG1 / oracle123

Exemplo de String de Conexão

jdbc:oracle:thin:@localhost:1521:ORCLPDB1

🛠️ Scripts Disponíveis

Resetar Banco de Dados

./reset-db.sh

Remove todos os dados e recria usuários e tablespaces.

Verificar Status

docker-compose ps
docker logs oracle19c

📁 Estrutura de Diretórios

oracle-setup/
├── docker-compose.yml    # Configuração do Docker Compose
├── .env                  # Variáveis de ambiente
├── init.sh              # Script de inicialização
├── reset-db.sh          # Script de reset
├── backup/              # Diretório para arquivos de dump
└── data/                # Dados persistentes do Oracle

🔧 Comandos Úteis

Conectar ao Container

docker exec -it oracle19c bash

Conectar ao SQL*Plus

docker exec -it oracle19c sqlplus system/oracle123@ORCLPDB1

Conectar como SYSDBA

docker exec -it oracle19c sqlplus sys/oracle123@ORCLCDB AS SYSDBA

Ver Logs

docker logs -f oracle19c

Parar e Remover

docker-compose down

Parar e Remover com Volumes

docker-compose down -v

📝 Notas Importantes

1. Primeira Inicialização: O Oracle 19c Enterprise pode levar 15-30 minutos para inicializar completamente na primeira vez.

2. Memória: Oracle 19c Enterprise requer pelo menos 8GB de RAM. Configure adequadamente no Docker Desktop.

3. Persistência: Os dados são mantidos no volume ./data mesmo após reinicialização do container.

4. Licenciamento: Oracle 19c Enterprise Edition requer licença para uso em produção. Para desenvolvimento, consulte os termos da Oracle.

5. Tablespace: O tablespace TS_STTINF01 é criado automaticamente em /opt/oracle/oradata/ORCLCDB/ORCLPDB1/.

🐛 Solução de Problemas

Container não inicia

# Verificar logs
docker logs oracle19c

# Verificar recursos disponíveis
docker stats

# Verificar se fez login no Oracle Container Registry
docker login container-registry.oracle.com

Erro de conexão

# Verificar se o Oracle está rodando
docker exec oracle19c ps aux | grep oracle

# Testar conectividade
docker exec oracle19c sqlplus system/oracle123@ORCLPDB1

Problemas de memória

# No Docker Desktop, aumentar memória para pelo menos 8GB
# Verificar uso atual
docker stats oracle19c

Problemas de espaço

# Limpar volumes não utilizados
docker volume prune

# Verificar uso de espaço
docker system df

📚 Recursos Adicionais

• Oracle Database 19c Documentation
• Oracle Container Registry
• Oracle Enterprise Manager
• Oracle SQL Developer

⚖️ Licenciamento

Oracle Database 19c Enterprise Edition requer licença comercial para uso em produção. Para desenvolvimento e teste, consulte:

• Oracle Technology Network License Agreement
• Oracle Database Free Development License

🤝 Contribuição

Para contribuir com melhorias:

1. Faça um fork do projeto
2. Crie uma branch para sua feature
3. Commit suas mudanças
4. Abra um Pull Request