Português (Brasil) | English |
---|---|
## Descrição | ## Description |
Este repositório contém a configuração de um ambiente Docker para o Oracle Database Express Edition 21c (Oracle XE). A configuração usa o Docker Compose para orquestrar os contêineres necessários para executar o banco de dados Oracle em um ambiente isolado. Este setup é ideal para desenvolvedores que precisam de um ambiente Oracle local para testes e desenvolvimento. | This repository contains the Docker setup for Oracle Database Express Edition 21c (Oracle XE). The configuration uses Docker Compose to orchestrate the containers required to run the Oracle database in an isolated environment. This setup is ideal for developers who need a local Oracle environment for testing and development. |
## Requisitos | ## Requirements |
- Docker - Docker Compose |
- Docker - Docker Compose |
## Instruções de Uso | ## Usage Instructions |
1. Clone o repositório: git clone https://github.com/sandrofpaula/oracle-21c-xe-docker.git cd oracle-21c-xe-docker 2. Suba os contêineres: docker-compose up -d Isso iniciará o contêiner do Oracle XE e o banco de dados estará acessível em localhost:1521 . 3. Acesse o Oracle Enterprise Manager: Acesse via browser em: https://localhost:5500/em 4. Para parar os contêineres: docker-compose down |
1. Clone the repository: git clone https://github.com/sandrofpaula/oracle-21c-xe-docker.git cd oracle-21c-xe-docker 2. Start the containers: docker-compose up -d This will start the Oracle XE container, and the database will be accessible at localhost:1521 . 3. Access Oracle Enterprise Manager: Open in your browser: https://localhost:5500/em 4. To stop the containers: docker-compose down |
## Configurações | ## Configuration |
- Portas: - 1521 : Porta padrão do Oracle Database. - 5500 : Porta para o Oracle Enterprise Manager. - Variáveis de Ambiente: - ORACLE_PASSWORD : Define a senha para os usuários administrativos (sys , system ). - ORACLE_CHARACTERSET : Define o conjunto de caracteres do banco de dados para AL32UTF8 . |
- Ports: - 1521 : Default port for Oracle Database. - 5500 : Port for Oracle Enterprise Manager. - Environment Variables: - ORACLE_PASSWORD : Sets the password for administrative users (sys , system ). - ORACLE_CHARACTERSET : Sets the database character set to AL32UTF8 . |
## Volumes | ## Volumes |
O volume oracle-data é usado para persistir os dados do banco de dados, garantindo que eles não sejam perdidos entre reinicializações do contêiner. |
The oracle-data volume is used to persist the database data, ensuring that it is not lost between container restarts. |
## Rede | ## Network |
A rede oracle-net é uma rede do tipo bridge usada para a comunicação entre contêineres. |
The oracle-net is a bridge network used for communication between containers. |
## Usar SQL Developer para Gerenciamento | ## Using SQL Developer for Management |
Se você está buscando uma interface gráfica para gerenciar o banco de dados, você pode usar o Oracle SQL Developer, que é uma ferramenta gratuita e poderosa para administração de bancos de dados Oracle. Você pode baixar o SQL Developer aqui e conectar-se ao Oracle 21c XE usando as seguintes credenciais: - Host: localhost - Porta: 1521 (baseado no seu mapeamento) ou 1522 (caso haja conflito) - Service Name: XEPDB1 (para conectar ao PDB padrão) ou XE (para conectar ao CDB) - Usuário: system - Senha: oracle123 |
If you are looking for a graphical interface to manage the database, you can use Oracle SQL Developer, which is a free and powerful tool for Oracle database administration. You can download SQL Developer here and connect to Oracle 21c XE using the following credentials: - Host: localhost - Port: 1521 (based on your mapping) or 1522 (in case of conflict) - Service Name: XEPDB1 (to connect to the default PDB) or XE (to connect to the CDB) - User: system - Password: oracle123 |
## Comandos Úteis | ## Useful Commands |
- Para reconstruir a imagem Docker: docker-compose up --build -d - Para visualizar os logs: docker-compose logs -f - Para parar os contêineres: docker-compose down |
- To rebuild the Docker image: docker-compose up --build -d - To view logs: docker-compose logs -f - To stop the containers: docker-compose down |
echo "# oracle-21c-xe-docker" >> README.md
git init
git add README.md
git commit -m "first commit"
git branch -M main
git remote add origin https://github.com/sandrofpaula/oracle-21c-xe-docker.git
git push -u origin main
git remote add origin https://github.com/sandrofpaula/oracle-21c-xe-docker.git
git branch -M main
git push -u origin main
Após a criação do contêiner do Oracle XE, você pode conectar outros contêineres à mesma rede para que eles possam se comunicar entre si. Aqui estão os passos para fazer isso:
-
Liste os contêineres em execução:
docker ps
Este comando exibe todos os contêineres em execução, mostrando informações como o
Container ID
e oName
de cada contêiner. Essas informações são úteis para identificar o contêiner que você deseja conectar à rede. -
Inspecione o contêiner para verificar as redes conectadas:
docker inspect <container_id_or_name> | grep -i "network"
Este comando exibe detalhes sobre as redes às quais o contêiner está conectado, filtrando a saída para mostrar apenas as informações relacionadas à rede (
NetworkMode
). Isso ajuda a identificar se o contêiner já está conectado à rede desejada ou se precisa ser conectado manualmente. -
Conecte o contêiner à rede desejada:
docker network connect <nome_da_rede> <nome_do_container>
<nome_da_rede>
: O nome da rede Docker à qual você deseja conectar o contêiner.<nome_do_container>
: O nome ou ID do contêiner que você deseja conectar à rede.
Este comando conecta o contêiner especificado à rede, permitindo que ele se comunique com outros contêineres na mesma rede. Isso é particularmente útil quando você tem um contêiner de aplicação que precisa se conectar ao banco de dados Oracle XE para acessar e manipular os dados.
Suponha que você tenha um contêiner chamado my_app_container
e deseja conectá-lo à rede oracle-net
, que é a rede onde o contêiner do Oracle XE está conectado. Você executaria o seguinte comando:
docker network connect oracle-net my_app_container
Agora, o contêiner my_app_container
pode se comunicar diretamente com o contêiner Oracle XE através da rede oracle-net
.