added {README,DEPLOY}.rst
Signed-off-by: rscnt <rascnt@gmail.com>
This commit is contained in:
		
					parent
					
						
							
								ef9849c56f
							
						
					
				
			
			
				commit
				
					
						7066e190e8
					
				
			
		
					 2 changed files with 66 additions and 0 deletions
				
			
		
							
								
								
									
										64
									
								
								DEPLOY.rst
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										64
									
								
								DEPLOY.rst
									
										
									
									
									
										Normal file
									
								
							| 
						 | 
					@ -0,0 +1,64 @@
 | 
				
			||||||
 | 
					dynamicweb deploy steps
 | 
				
			||||||
 | 
					=======================
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					The Makefile has a couple of tasks that can be useful when deploying the project, if using please
 | 
				
			||||||
 | 
					configure the values for the ssh host, user, port and target directory.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					1. Upload the project.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					   It's recommended to *make* use of the task 'rsync_upload' (See Makefile for more info.)
 | 
				
			||||||
 | 
					   If there's access to the git repo, just pull from master/develop.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					2. Install system dependencies.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					   If using debian, you could *make* use of the task 'install_debian_packages'.
 | 
				
			||||||
 | 
					   One cloud use the task 'install_debian_packages', which first do an update and then
 | 
				
			||||||
 | 
					   it installs the packages listed in the file ./requirements.debian.txt.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					3. Make a new virtualenv with python3.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					   In the requirements.debian.txt, 'virtualenvwrapper' is listed, maybe you could do:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					   $ source /usr/share/virtualenvwrapper/virtualenvwrapper_lazy.sh
 | 
				
			||||||
 | 
					   $ mkvirtualenv dynamicweb --python=/usr/bin/python3
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					4. Install the requirements.txt for the dynamicweb project.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					   Problem is you need an ssh key that exists in a github account, because I use two or three github repos
 | 
				
			||||||
 | 
					   for some packages, which they egg in pypi doesn't work well with python3, it's annoying...
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					   $ pip -r requirements.txt
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					5. Database/Memcached settings.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					   Create postgres user: https://wiki.debian.org/PostgreSql.
 | 
				
			||||||
 | 
					   Create postgres database.
 | 
				
			||||||
 | 
					   Set postgres settings on dynamicweb/dynamicweb/settings.py
 | 
				
			||||||
 | 
					   Memcached should be already installed, we just need to check if the service is running.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					6. Make migrations and sync the database
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					   Run:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					   $ python manage.py makemigratoins
 | 
				
			||||||
 | 
					   $ python manage.py syncdb
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					7. Setup a circus configuration.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					   [http://circus.readthedocs.org/en/0.11.1/]
 | 
				
			||||||
 | 
					   You could use the circus.ungleich.ini file in configs/ :
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					       $ circusd --daemon configs/circus.ungleich.ini
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					   That will start a new process for the webapp.
 | 
				
			||||||
 | 
					   To stop, restart, reload or see the status use circusctl.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					       $ circusctl
 | 
				
			||||||
 | 
					       ...
 | 
				
			||||||
 | 
					       (circusctl) reload webapp
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					8. Configure nginx proxy.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					   There's an example for the nginx proxy in configs/nginx.proxy.conf.
 | 
				
			||||||
 | 
					   For the stating server one can just copy configs/nginx.proxy.conf -> /etc/nginx/conf.d/ungleich.proxy.conf.
 | 
				
			||||||
 | 
					   Remember to comment/delete/change the configuration /etc/nginx/sites-enabled/default.
 | 
				
			||||||
							
								
								
									
										2
									
								
								README.rst
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										2
									
								
								README.rst
									
										
									
									
									
										Normal file
									
								
							| 
						 | 
					@ -0,0 +1,2 @@
 | 
				
			||||||
 | 
					Ungleich 
 | 
				
			||||||
 | 
					========
 | 
				
			||||||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue