The slides from my July Django-District presentation. It shows some of the basics of using the new fabric. I have uploaded the example fabfile.py to slideshare as well.
8. Task Example
def clean(site=None):
"""Remove .pyc files from a site."""
from os import path
if not site:
site = prompt('Please specify which site(s) to
clean (a comma delimited list is accepted): ',
validate=r'^[w-.,]+$')
site_list = site.split(',')
for item in site_list:
path = path.join(env.root_path, item)
sudo("find %s -name '*.pyc' -depth -exec rm {} ;"
% path)
9. Fabric Commands
• require: Make sure that certain environment variables are available.
• prompt: Display a prompt to the user and store the input in the given
variable. Validation is optional.
• put: Upload files to the remote host(s).
• get: Download a file from a remote host.
• run: Run a shell command on the remote host(s).
• sudo: Run a root privileged shell command command on the remote host(s).
• local: Run a command locally.
10. Fabric Contrib Commands
• rsync_project: Synchronize a remote directory with the current project
directory via rsync.
• upload_project: Upload the current project to a remote system, tar-gzipping
during the move.
• exists: Return True if given path exists.
• first: Given one or more file paths, returns first one found, or None.
• upload_template: Render and upload a template text file to a remote host.
• sed: Run a search-and-replace on filename with given regex patterns.
• comment/uncomment: Attempt to (un)comment out all lines in filename
matching regex.
• contains: Return True if filename contains text.
• append: Append string (or list of strings) text to filename.
• confirm: Ask user a yes/no question and return their response as True /False.
11. Fabric Decorators
• hosts: Defines on which host or hosts to execute the wrapped function.
• roles: Defines a list of role names, used to look up host lists.
• runs_once: Prevents wrapped function from running more than once.
@hosts('user1@host1', 'host2', 'user2@host3')
@runs_once
def my_func():
pass
@roles('web')
def my_other_func():
pass
12. Usage Example
$ fab testing clean:site=basenews
[172.16.12.6] sudo: find /var/websites/basenews -name
'*.pyc' -depth -exec rm {} ;
Password for testuser@192.168.56.3:
Done.
Disconnecting from 172.16.12.6... done.
$
13. Example Uses
• Reload web server settings
• Clean .pyc files
• Check out new revision from a SCM repository
• Install packages on servers
• Apply patches
• Restart caching server
• Dump database and restore it locally
15. Thank You
Corey Oordt
The Washington Times
@coordt
coordt@washingtontimes.com
http://opensource.washingtontimes.com/
Notas do Editor
Fabric allows for easy deployment for different environments. Not just for testing vs. production also for database vs. web.
Especially helpful if you need to perform the same tasks on multiple computers, as in a web server farm.
There has been a rather substantial change from the current release (0.1.1) and the pending release (0.9). I’ll be showing the pending release.
Fabric is just the fab command. It looks for a file named fabfile.py in the current directory, but you can specify a specific file. The fabfile.py contains one or more tasks, written in python, that are executed on one or more hosts.
The fabfile typically starts with some environment setup. The env variable is used for standard configs like roledefs and hosts, and anything else you need.
One way of handling multiple environments is to set up tasks that set the correct environment settings. Because fabric allows you to chain tasks, you can specify the appropriate environment task before the deployment task
A task is standard python, with some fabric-specific commands thrown in. In this example there is prompt, sudo, and use of the env variable. The task is run on every host specified.
These are the basic commands that fabric adds.
There are some contributed commands, in the contrib module that provide more functionality.
You can also decorate your tasks to specify a role or specific set of hosts.
In this example, you can see we are chaining the testing environment setup task in front of the clean task. We are passing the site parameter to the clean task. If necessary, it will prompt you for the password for sudo. It will attempt to use the same password on each host.