Update README.md

Adding Docker tutorial

Update README.md
Adding Docker tutorial
Filipe Medeiros · GitHub
1 parent 278f2c30
Showing 1 changed file with 161 additions and 11 deletions Show diff stats
README.md
@@ -333,32 +333,182 @@ Once this is done, the breadcrumbs of the &#39;Create discipline&#39; page is as follows
 [Home]() / [Courses]() / [Course Name]() / Create Subject
+## 1. Docker
+O Docker possui um Daemon para gerenciamento de conteiners. Sua instalação possui uma documentação oficial e pode ser conferida nas páginas:
+[Instalando Docker no Windows](https://docs.docker.com/docker-for-windows/)
-## Docker image
+[Instalando Docker no Mac OSX](https://docs.docker.com/docker-for-mac/)
-Já tendo o docker instalado para executar o amadeus é preciso executar o seguinte comando:
+[Instalando Docker no Ubuntu](https://docs.docker.com/engine/installation/linux/docker-ce/ubuntu/)
+## 2. Importando conteiner Docker do Amadeus LMS
+
+Com o Docker instalado, é possível importar uma imagem pré-configurada do Amadeus LMS comos seguintes comandos:
+
+Baixe a imagem diretamente do repositório do Amadeus LMS:
+``` bash
+sudo docker pull filipecmedeiros/amadeus:1.0
+```
+Execute o conteiner:
 ``` bash
-	sudo docker run -itp 9000:9000 jailsondias/amadeus:0.1
+sudo docker run -itp 8000:80 filipecmedeiros/amadeus:1.0
 ```
-Depois que ja estiver no ambiente do docker execute os seguintes comandos:
+Inicie o banco de dados Postgres e o servidor web Nginx:
+``` bash
+/etc/init.d/postgresql start
+/etc/init.d/nginx start
+``` 
+
+Obs.: Espere alguns minutos até o servidor iniciar.
+Execute o Amadeus:
 ``` bash
-	/etc/init.d/postgresql start
-	/etc/init.d/nginx start
-	cd amadeuslms
+cd /home/amadeuslms/
+gunicorn amadeus.wsgi:application
 ```
-Espere mais ou menos um minuto para que o PostgreSQL inicie e depois disso execute o seguinte comando:
+Para sair do docker e continuar com o Amadeus LMS executando no container só é preciso apertar crtl + p + q.
+
+## 3. Exportando conteiner Docker com Amadeus
+
+Para gerar sua própria imagem do Amadeus, disponibilizamos um exemplo utilizando Ubuntu 16.04 LTS + Postgres + Nginx:
+
+### 3.1 Preparando o conteiner
+Faça o download de uma imagem do ubuntu:
+``` bash
+sudo docker pull ubuntu:16.04
+```
+Execute o conteiner a partir da imagem do ubuntu que acabou de ser baixada:
+``` bash
+sudo docker run -itp 8000:80 ubuntu:16.04
+```
+Antes de tudo, é necessário fazer um update para poder fazer o download de qualquer software:
+``` bash
+apt-get update
+```
+A linguagem padrão utilizada é ASC II, faça a migração para UTF-8:
+``` bash
+export LANG=C.UTF-8
+```
+Após estes passos, o conteiner está preparado para fazer o download dos softwares e dependências
+necessárias:
+``` bash
+apt-get install nano gettext nginx python3 python3-pip git postgresql postgresql-contrib libpq-dev
+python3-dev
+```
+Inicie o banco de dados Postgres:
+``` bash
+/etc/init.d/postgresql start
+```
+Inicie o servidor web Nginx:
 ``` bash
-	gunicorn amadeus.wsgi:application
+/etc/init.d/nginx start
 ```
-Agora só precisa abrir o navegador com localhost:9000 que vai abrir a página inicial do amadeus, caso apareça uma página de erro aperte crtl + c no terminal do docker e execute novamente o gunicorn.
+### 3.2 Preparando o banco de dados Postgres
-Caso queira sair do docker e continuar com o amadeus executando no container só é preciso apertar crtl + p + q.
+Faça login como usuário admin do Postgres:
+``` bash
+su postgres
+```
+Crie um banco de dados:
+``` bash
+createdb amadeus
+```
+Para executar comandos SQL, utilize o comando:
+```bash
+psql
+```
+Então execute o comando para criar um usuário do Amadeus no banco de dados:
+``` sql
+CREATE ROLE amadeus_admin WITH LOGIN SUPERUSER PASSWORD 'amadeus';
+```
+Para sair, execute:
+``` sql
+/q
+```
+E em seguida, para sair do usuário Postgres:
+``` bash
+exit
+```
+### 3.3 Preparando o Amadeus
+Faça o download do Amadeus a partir do repositório git:
+``` bash
+git clone https://github.com/amadeusproject/amadeuslms.git
+```
+Crie um arquivo chamado local_settings.py no diretório /amadeuslms/amadeus/ :
+```bash
+nano /amadeuslms/amadeus/local_settings.py
+```
+E adicione os valores do banco de dados que acabou de ser criado:
+``` python
+import os
+DEBUG = True
+DATABASES = {
+	'default': {
+	'ENGINE': 'django.db.backends.postgresql',
+	'NAME': 'amadeus',
+	'USER': 'amadeus_admin',
+	'PASSWORD': 'amadeus',
+	'HOST': '127.0.0.1',
+	'PORT': '5432',
+	}
+}
+ ```
+Aplique as migrações do Amadeus ao banco de dados:
+```bash
+cd amadeuslms/
+python3 manage.py migrate
+```
+Ative as configurações de tradução do Amadeus:
+```bash 
+python3 manage.py compilemessages
+```
+Crie o usuário Admin do Amadeus:
+``` bash
+python3 manage.py createsuperuser
+```
+### 3.4 Preparando o Nginx
+Para fazer a configuração do Nginx, edite o arquivo default localizado em /etc/nginx/sitesavaliables e adicione as configurações:
+``` bash
+nano /etc/nginx/sites-avaliables/default
+```
+``` bash
+upstream backend {
+ server localhost:8000;
+}
+server {
+ listen 80 default_server;
+ listen 443 ssl;
+ server_name _;
+
+ root /home/amadeuslms;
+ index index.html;
+ charset utf-8;
+ location / {
+ try_files $uri @proxy_to_app;
+ }
+ location /uploads {
+ autoindex on;
+ alias /home/amadeuslms/amadeus/uploads/;
+ }
+ location @proxy_to_app {
+ proxy_pass http://backend;
+ proxy_http_version 1.1;
+ proxy_set_header Upgrade $http_upgrade;
+ proxy_set_header Connection "upgrade";
+ proxy_set_header Host $http_host;
+ }
+}
+```
+Para executar o Amadeus LMS:
+``` bash
+cd /home/amadeuslms/
+gunicorn amadeus.wsgi:application
+```
+Para sair do docker e continuar com o Amadeus LMS executando no container só é preciso apertar crtl + p + q.
 ## Link's úteis
 [Git - Introdução e comandos básicos(PT-BR)](https://github.com/fernandomayer/git-rautu/blob/master/0_configuracao-inicial.md)
	@@ -333,32 +333,182 @@ Once this is done, the breadcrumbs of the 'Create discipline' page is as follows		@@ -333,32 +333,182 @@ Once this is done, the breadcrumbs of the 'Create discipline' page is as follows
333		333
334	[Home]() / [Courses]() / [Course Name]() / Create Subject	334	[Home]() / [Courses]() / [Course Name]() / Create Subject
335		335
		336	+## 1. Docker
		337	+O Docker possui um Daemon para gerenciamento de conteiners. Sua instalação possui uma documentação oficial e pode ser conferida nas páginas:
336		338
		339	+[Instalando Docker no Windows](https://docs.docker.com/docker-for-windows/)
337		340
338	-## Docker image	341	+[Instalando Docker no Mac OSX](https://docs.docker.com/docker-for-mac/)
339		342
340	-Já tendo o docker instalado para executar o amadeus é preciso executar o seguinte comando:	343	+[Instalando Docker no Ubuntu](https://docs.docker.com/engine/installation/linux/docker-ce/ubuntu/)
341		344
		345	+## 2. Importando conteiner Docker do Amadeus LMS
		346	+
		347	+Com o Docker instalado, é possível importar uma imagem pré-configurada do Amadeus LMS comos seguintes comandos:
		348	+
		349	+Baixe a imagem diretamente do repositório do Amadeus LMS:
		350	+``` bash
		351	+sudo docker pull filipecmedeiros/amadeus:1.0
		352	+```
		353	+Execute o conteiner:
342	``` bash	354	``` bash
343	- sudo docker run -itp 9000:9000 jailsondias/amadeus:0.1	355	+sudo docker run -itp 8000:80 filipecmedeiros/amadeus:1.0
344	```	356	```
345	-Depois que ja estiver no ambiente do docker execute os seguintes comandos:	357	+Inicie o banco de dados Postgres e o servidor web Nginx:
		358	+``` bash
		359	+/etc/init.d/postgresql start
		360	+/etc/init.d/nginx start
		361	+```
		362	+
		363	+Obs.: Espere alguns minutos até o servidor iniciar.
346		364
		365	+Execute o Amadeus:
347	``` bash	366	``` bash
348	- /etc/init.d/postgresql start
349	- /etc/init.d/nginx start
350	- cd amadeuslms	367	+cd /home/amadeuslms/
		368	+gunicorn amadeus.wsgi:application
351	```	369	```
352	-Espere mais ou menos um minuto para que o PostgreSQL inicie e depois disso execute o seguinte comando:
353		370
		371	+Para sair do docker e continuar com o Amadeus LMS executando no container só é preciso apertar crtl + p + q.
		372	+
		373	+## 3. Exportando conteiner Docker com Amadeus
		374	+
		375	+Para gerar sua própria imagem do Amadeus, disponibilizamos um exemplo utilizando Ubuntu 16.04 LTS + Postgres + Nginx:
		376	+
		377	+### 3.1 Preparando o conteiner
		378	+Faça o download de uma imagem do ubuntu:
		379	+``` bash
		380	+sudo docker pull ubuntu:16.04
		381	+```
		382	+Execute o conteiner a partir da imagem do ubuntu que acabou de ser baixada:
		383	+``` bash
		384	+sudo docker run -itp 8000:80 ubuntu:16.04
		385	+```
		386	+Antes de tudo, é necessário fazer um update para poder fazer o download de qualquer software:
		387	+``` bash
		388	+apt-get update
		389	+```
		390	+A linguagem padrão utilizada é ASC II, faça a migração para UTF-8:
		391	+``` bash
		392	+export LANG=C.UTF-8
		393	+```
		394	+Após estes passos, o conteiner está preparado para fazer o download dos softwares e dependências
		395	+necessárias:
		396	+``` bash
		397	+apt-get install nano gettext nginx python3 python3-pip git postgresql postgresql-contrib libpq-dev
		398	+python3-dev
		399	+```
		400	+Inicie o banco de dados Postgres:
		401	+``` bash
		402	+/etc/init.d/postgresql start
		403	+```
		404	+Inicie o servidor web Nginx:
354	``` bash	405	``` bash
355	- gunicorn amadeus.wsgi:application	406	+/etc/init.d/nginx start
356	```	407	```
357	-Agora só precisa abrir o navegador com localhost:9000 que vai abrir a página inicial do amadeus, caso apareça uma página de erro aperte crtl + c no terminal do docker e execute novamente o gunicorn.	408	+### 3.2 Preparando o banco de dados Postgres
358		409
359	-Caso queira sair do docker e continuar com o amadeus executando no container só é preciso apertar crtl + p + q.	410	+Faça login como usuário admin do Postgres:
		411	+``` bash
		412	+su postgres
		413	+```
		414	+Crie um banco de dados:
		415	+``` bash
		416	+createdb amadeus
		417	+```
		418	+Para executar comandos SQL, utilize o comando:
		419	+```bash
		420	+psql
		421	+```
		422	+Então execute o comando para criar um usuário do Amadeus no banco de dados:
		423	+``` sql
		424	+CREATE ROLE amadeus_admin WITH LOGIN SUPERUSER PASSWORD 'amadeus';
		425	+```
		426	+Para sair, execute:
		427	+``` sql
		428	+/q
		429	+```
		430	+E em seguida, para sair do usuário Postgres:
		431	+``` bash
		432	+exit
		433	+```
		434	+### 3.3 Preparando o Amadeus
		435	+Faça o download do Amadeus a partir do repositório git:
		436	+``` bash
		437	+git clone https://github.com/amadeusproject/amadeuslms.git
		438	+```
		439	+Crie um arquivo chamado local_settings.py no diretório /amadeuslms/amadeus/ :
		440	+```bash
		441	+nano /amadeuslms/amadeus/local_settings.py
		442	+```
		443	+E adicione os valores do banco de dados que acabou de ser criado:
		444	+``` python
		445	+import os
		446	+DEBUG = True
		447	+DATABASES = {
		448	+ 'default': {
		449	+ 'ENGINE': 'django.db.backends.postgresql',
		450	+ 'NAME': 'amadeus',
		451	+ 'USER': 'amadeus_admin',
		452	+ 'PASSWORD': 'amadeus',
		453	+ 'HOST': '127.0.0.1',
		454	+ 'PORT': '5432',
		455	+ }
		456	+}
		457	+ ```
		458	+Aplique as migrações do Amadeus ao banco de dados:
		459	+```bash
		460	+cd amadeuslms/
		461	+python3 manage.py migrate
		462	+```
		463	+Ative as configurações de tradução do Amadeus:
		464	+```bash
		465	+python3 manage.py compilemessages
		466	+```
		467	+Crie o usuário Admin do Amadeus:
		468	+``` bash
		469	+python3 manage.py createsuperuser
		470	+```
		471	+### 3.4 Preparando o Nginx
		472	+Para fazer a configuração do Nginx, edite o arquivo default localizado em /etc/nginx/sitesavaliables e adicione as configurações:
		473	+``` bash
		474	+nano /etc/nginx/sites-avaliables/default
		475	+```
		476	+``` bash
		477	+upstream backend {
		478	+ server localhost:8000;
		479	+}
		480	+server {
		481	+ listen 80 default_server;
		482	+ listen 443 ssl;
		483	+ server_name _;
		484	+
		485	+ root /home/amadeuslms;
		486	+ index index.html;
		487	+ charset utf-8;
		488	+ location / {
		489	+ try_files $uri @proxy_to_app;
		490	+ }
		491	+ location /uploads {
		492	+ autoindex on;
		493	+ alias /home/amadeuslms/amadeus/uploads/;
		494	+ }
		495	+ location @proxy_to_app {
		496	+ proxy_pass http://backend;
		497	+ proxy_http_version 1.1;
		498	+ proxy_set_header Upgrade $http_upgrade;
		499	+ proxy_set_header Connection "upgrade";
		500	+ proxy_set_header Host $http_host;
		501	+ }
		502	+}
		503	+```
360		504
		505	+Para executar o Amadeus LMS:
		506	+``` bash
		507	+cd /home/amadeuslms/
		508	+gunicorn amadeus.wsgi:application
		509	+```
361		510
		511	+Para sair do docker e continuar com o Amadeus LMS executando no container só é preciso apertar crtl + p + q.
362	## Link's úteis	512	## Link's úteis
363	[Git - Introdução e comandos básicos(PT-BR)](https://github.com/fernandomayer/git-rautu/blob/master/0_configuracao-inicial.md)	513	[Git - Introdução e comandos básicos(PT-BR)](https://github.com/fernandomayer/git-rautu/blob/master/0_configuracao-inicial.md)
364		514