Commits

Mikhail Korobov committed afdc77e

More docs for provided fab commands

Comments (0)

Files changed (1)

       If there are other sites on server (not managed by django-fab-deploy)
       they may become unaccessible due to these changes.
 
+Working with the server
+-----------------------
+
+django-fab-deploy provides additional commands that should be useful for
+updating the server:
+
+1. Source changes are deployed with :func:`fab_deploy.deploy.push` command::
+
+       fab push
+
+   Another example (deploy changes on 'prod' server, update pip
+   requirements and perform migrations in one step::
+
+       fab prod push:pip_update,migrate
+
+2. Update web server configuration::
+
+       fab setup_web_server
+
+3. Update django configuration (:file:`config.server.py`)::
+
+       fab update_django_config
+
+4. Requirements are updated with :func:`fab_deploy.virtualenv.pip_update`
+   command. Update requirements listed in reqs/active.txt::
+
+       fab pip_update
+
+   Update requirements listed in reqs/my_apps.txt::
+
+       fab pip_update:my_apps
+
+5. Remotely change hg branch (assuming :attr:`env.conf.VCS` == 'hg')::
+
+       fab up:my_branch
+
+Full list of commands can be found :doc:`here <reference>`.
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.