Tasks

awsfabrictasks.ec2.tasks

General tasks for AWS management.

awsfabrictasks.ec2.tasks.ec2_add_tag

Add tag to EC2 instance. Fails if tag already exists.

Parameters:

• tagname – Name of the tag to set (required).
• value – Value to set the tag to. Default to empty string.

awsfabrictasks.ec2.tasks.ec2_set_tag

Set tag on EC2 instance. Overwrites value if tag exists.

Parameters:

• tagname – Name of the tag to set (required).
• value – Value to set the tag to. Default to empty string.

awsfabrictasks.ec2.tasks.ec2_remove_tag

Remove tag from EC2 instance. Fails if tag does not exist.

Parameters:tagname – Name of the tag to remove (required).

awsfabrictasks.ec2.tasks.ec2_launch_instance

Launch new EC2 instance.

Parameters:

• name – The name to tag the EC2 instance with (required)
• configname – Name of the configuration in awsfab_settings.EC2_LAUNCH_CONFIGS. Prompts for input if not provided as an argument.

awsfabrictasks.ec2.tasks.ec2_start_instance

Start EC2 instance.

Parameters:nowait – Set to True to let the EC2 instance start in the background instead of waiting for it to start. Defaults to False.

awsfabrictasks.ec2.tasks.ec2_stop_instance

Stop EC2 instance.

Parameters:nowait – Set to True to let the EC2 instance stop in the background instead of waiting for it to start. Defaults to False.

awsfabrictasks.ec2.tasks.ec2_list_instances

List EC2 instances in a region (defaults to awsfab_settings.DEFAULT_REGION).

Parameters:

• region – The region to list instances in. Defaults to ``awsfab_settings.DEFAULT_REGION.
• full – Print all attributes, or just the most useful ones? Defaults to False.

awsfabrictasks.ec2.tasks.ec2_print_instance

Print EC2 instance info.

Parameters:full – Print all attributes, or just the most useful ones? Defaults to False.

awsfabrictasks.ec2.tasks.ec2_login

Log into the host specified by –hosts, –ec2names or –ec2ids.

Aborts if more than one host is specified.

awsfabrictasks.ec2.tasks.ec2_rsync_download_dir

Sync the contents of remote_dir into local_dir. E.g.: if remote_dir is /etc, and local_dir is /tmp, the /tmp/etc will be created on the local host, and filled with all files in /etc on the EC2 instance.

Parameters:

• remote_dir – The remote directory to download into local_dir.
• local_dir – The local directory.
• rsync_args – Arguments for rsync. Defaults to -av.
• noconfirm – If this is True, we will not ask for confirmation before proceeding with the operation. Defaults to False.

awsfabrictasks.ec2.tasks.ec2_rsync_upload_dir

Sync the contents of local_dir into remote_dir on the EC2 instance. E.g.: if local_dir is /etc, and remote_dir is /tmp, the /tmp/etc will be created on the EC2 instance, and filled with all files in /etc on the local host.

Parameters:

• local_dir – The local directory to upload to the EC2 instance.
• remote_dir – The remote directory to upload local_dir into.
• rsync_args – Arguments for rsync. Defaults to -av.
• noconfirm – If this is True, we will not ask for confirmation before proceeding with the operation. Defaults to False.

awsfabrictasks.ec2.regions

awsfabrictasks.regions.list_regions

List all regions.

awsfabrictasks.regions.list_zones

List zones in the given region.

Parameters:region – Defaults to awsfab_settings.DEFAULT_REGION.