Skip to main content

fabric setup scripts and fabric utils library

Project description

Fabric tasks in order to set up and maintain configurations, software installations and other things on a local or remote linux system (most functionality for Debian/Ubuntu).

“dotfiles on steroids”

Usage

fabsetup is a `fabric <http://www.fabfile.org/>`__ script.

# task infos

## list all tasks: '-l'
fabsetup -l

## show details: '-d'
fabsetup -d new_addon


# run tasks

fabsetup setup.regex_repl

## on your local host:
fabsetup setup.pencil3 -H localhost

## remote host:
fabsetup up -H example.com

`Setup-Howtos <./howtos>`__:

Known fabsetup-addons

Please contribute: Create your own fabsetup-addon and make a pull request which adds your fabsetup-addon to the known_pip_addons in fabsetup/addons.py and to this README.md.

Installation

As a pypi package with command pip2 (recommended way):

pip2 install fabsetup

# install addon, eg. fabsetup-theno-termdown
pip2 install fabsetup-theno-termdown

Raspberry Pi

On a fresh raspbian (Debian) you will need at least the following packages before installing fabsetup with pip:

sudo apt install -y git python python-pip libffi-dev libssl-dev tree curl && sudo pip install fabsetup

The whole installation will take about 15 minutes on a Raspi 3 with raspbian stretch, so you can make yourself a tea. Note: You do not need to type pip2 as pip defaults to the python2-variant of pip. If you run $ pip install fabsetup as normal usr (without sudo) pip will install with --user setting by default so fabsetup is located under ~/.local/bin. In this case you need to add ~/.local/bin to $PATH which is located in /etc/profile.

Update:

pip2 install --upgrade fabsetup

# update addon (also updates fabsetup)
pip2 install --upgrade fabsetup-theno-termdown

Install without superuser privileges:

pip2 install --user fabsetup

When running with --user pip installs the command fabsetup at ~/.local/bin. Assure that ~/.local/bin is set in your $PATH environment variable.

Uninstall:

pip2 uninstall --yes fabsetup
pip2 uninstall --yes fabsetup-addon-theno

You also can clone the github repository instead of using pip2 install:

# install requirements
sudo apt-get install  git  fabric
pip2 install --user utlz

git clone  https://github.com/theno/fabsetup.git  ~/.fabsetup

# from ~/.fabsetup dir use `fab` instead of `fabsetup`
cd ~/.fabsetup
fab -l

Development

Devel commands:

# save changes
git commit -am 'I describe my changes'

# upload to github
git push origin master

# update version number in fabsetup/_version.py

# create and publish package at pypi
fab -f fabfile-dev.py  pypi

# clean up
fab -f fabfile-dev.py  clean

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
fabsetup-0.8.0.tar.gz (133.5 kB) Copy SHA256 hash SHA256 Source None Mar 2, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page