Repository files navigation

Este projeto possibilita a execução doOracle Database 11g Express Edition (Oracle XE) em uma box Vagrant ou num contêiner Docker. De qualquer forma, quando utilizado o Vagrant, o provisionamento da box será realizado através do Docker. Quando a opção for utilizar o Docker, no Windows ou no OS X, a máquina que executa o servidor Docker poderá ser construída (mais facilmente) através de uma das seguintes formas: utilizando oBoot2docker ou, mais a recentemente, o Docker Machine.

O Vagrant pode provisionar uma VM utilizando o Docker. Talvez essa seja a solução mais simples e rápida para utilizar este projeto no caso de você estar utilizando um ambiente Windows ou OS X. Não será necessário instalar o Docker pois o Vagrant sabe como provisionar máquinas através dele mesmo sem o uso de seus binários.

Optando pelo uso do Vagrant, a execução do Oracle XE através deste projeto pode ser realizada com um único comando:

cp Vagrantfile.1 Vagrantfilevagrant up

O provisionamento da máquina criada será realizado através do Docker seguindo as instruções doVagrantfile e, após a finalização desse processo, você poderá utilizar acessar o Oracle XE.

Utilize as seguintes informações para estabelecer uma conexão:

• hostname: localhost
• port: 1521
• sid: xe
• username: system
• password: oracle

Salvar uma box é uma boa opção para poder restaurá-la rapidamente e não precisar perder tempo no seu provisionamento. Para isso, pare a box:

vagrant halt

Em seguida, empacote-a:

vagrant package --output oracle-xe.box

Agora, destrua a box (se tiver certeza que já foi gerado o arquivopackage.box):

vagrant destroy

Uma nota: No Cygwin,ocorre um erro na tentativa de execução do comando acima. A solução é acrescentar o parâmetro--force ao final desse comando.

vagrant box add --name oracle-xe oracle-xe.boxcp Vagrantfile.2 Vagrantfilevagrant up

Se você estiver utilizando o Linux em teu desktop, o uso do Vagrant perde o sentido. Nesse caso, é extremamente mais simples e rápida a utilização do Docker.

Em ambientes Windows ou OS X, se você não desejar utilizar o Vagrant, você precisará fazer a instalação do Boot2Docker ou do Docker Machine. Essas aplicações são necessárias para criar uma VM (Linux) que executará o servidor Docker e o contêiner oracle-xe criado neste projeto.

No OS X, as instruções de instalação do Docker estão emhttps://docs.docker.com/installation/mac/.

Para utilizar o Docker no Fedora, leiahttps://docs.docker.com/installation/fedora/.

No Windows, siga os procedimentos descritos emhttp://docs.docker.com/windows/step_one/. Alternativamente, utilize oChocolatey para fazer a instalação dessas ferramentas. Instruções para isso podem ser encontradas emhttps://github.com/paulojeronimo/dicas-windows/blob/master/chocolatey.md#docker-e-docker-machine.

Um servidor Docker pode ser hospedado no ambiente Windows se for criada uma máquina virtual Linux através do Boot2Docker ou do Docker Image. O Boot2Docker é um projeto menos abrangente e mais simples que o Docker Image. Esse último é a solução mais atual.

Todos os procedimentos a seguir são realizados num shell (Bash) aberto pelo Cygwin.

docker-machine env --shell bash dm1

eval $(docker-machine env --shell bash dm1)

docker-machine ip dm1

Verifique se a imagemoracle-xe já é listada como na saída do comando a seguir:

$ docker imagesREPOSITORY                          TAG                 IMAGE ID            CREATED             VIRTUAL SIZEoracle-xe                           latest              923b5341870b        12 seconds ago      2.241 GB...

Caso a tua execução do comando acima não apresente uma saída similar:

• Se você não possuir o arquivo da imagem (oracle-xe.tar), faça sua geração seguindo os passos em"Construção e salvamento da imagem" para gerar a imagem e salvá-la nesse arquivo.
• Se você já possuir o arquivo da imagem não será necessária a sua construção. Sendo assim, vocẽ poderá simplesmente fazer o seu carregamento:

docker load -i oracle-xe.tar

Execute o contêiner:

$ docker run --name oracle-xe -d -p 1522:22 -p 1521:1521 oracle-xeacff4b050f8e983367945ad0677efd8f9d89f100dad27ad52bb1a063e69d2f59

Verifique se ele está mesmo em execução:

$ docker psCONTAINER ID        IMAGE               COMMAND                CREATED              STATUS              PORTS                                                    NAMESacff4b050f8e        oracle-xe:latest    "/bin/sh -c '/usr/sb   About a minute ago   Up About a minute   0.0.0.0:1521->1521/tcp, 8080/tcp, 0.0.0.0:1522->22/tcp   oracle-xe

Após inicializado o contêiner, você pode abrir oOracle SQL Developer e testar uma conexão ao Oracle XE. Os parâmetros para essa conexão são os seguintes:

hostname: localhostport: 1521sid: xeusername: systempassword: oracle

Se desejar acessar o shell do contêiner do Oracle XE, execute:

ssh -p 1522 root@localhost

A senha doroot éadmin.

Quando não precisar mais do Oracle XE em execução, pare o contêiner:

docker stop oracle-xe

Você pode verificar se ele foi realmente parado com o comandodocker ps.

Para colocar o contêiner e em execução novamente, execute:

docker start oracle-xe

Lembre-se que você pode, a qualquer momento, verificar o status de execução do contêiner através do comandodocker ps.

Quando desejar remover o Oracle XE (isso destuirá todos os bancos), remova o contêiner:

docker rm oracle-xe

Clone o projeto:

git clone https://github.com/paulojeronimo/docker-oracle-xe.git

Construa a imagem (esse procedimento deve demorar ... vá tomar um café enquanto isso):

docker build --rm -t oracle-xe .

Verifique se a imagem está sendo listada:

$ docker imagesREPOSITORY                          TAG                 IMAGE ID            CREATED             VIRTUAL SIZEoracle-xe                           latest              923b5341870b        12 seconds ago      2.241 GB...

Salve a imagem (gerando o arquivooracle-xe.tar):

docker save -o oracle-xe.tar oracle-xe

Para remover a imagem (por exemplo, para ganhar espaço no disco) execute:

docker rmi oracle-xe