Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/saint-hilaire/lampsible

Lampsible - LAMP stacks via Ansible and super simple CLI
https://github.com/saint-hilaire/lampsible

ansible apache joomla lamp-stack laravel linux mysql php python symfony typo3 wordpress zend

Last synced: about 2 months ago
JSON representation

Lampsible - LAMP stacks via Ansible and super simple CLI

Awesome Lists containing this project

README

        

# Lampsible

## About

Lampsible - LAMP stacks with Ansible and a super simple CLI. This tool can automate anything from
a production ready WordPress site on your VPS to a custom Apache setup on a virtual machine
in your local network.
.

## Requirements

* Local: Unix system with Python 3.8 or newer. Tested on Ubuntu and Gentoo Linux. Might work on macOS, but I haven't tested that. Won't work on Windows.
* Remote: Ubuntu 20 or newer. Might work on older versions, but I doubt it. Support for other distros is planned in a future version.

## Installing

Install with Pip: `python3 -m pip install lampsible`

Alternatively, install from wheel file...: `python3 -m pip install /path/to/local/lampsible-SOME_VERSION-py3-none-any.whl`

... or from source:
```
git clone https://github.com/saint-hilaire/lampsible
cd lampsible
python3 -m pip install .
```

## Sample usage

Lampsible is designed to be very simple to use. If you forget some important
parameter, Lampsible will prompt you for it, or pick some sensible defaults.

Install Apache on your server:

```
lampsible [email protected] apache
```

Install a production ready WordPress site:

```
lampsible [email protected] wordpress \
--ssl-certbot \
--email-for-ssl [email protected]
```

Install a production ready Joomla site:

```
lampsible [email protected] joomla \
--ssl-certbot \
--email-for-ssl [email protected]
```

Install a Laravel app on a test server:

```
lampsible [email protected] laravel \
--ssl-certbot \
--test-cert \
--apache-server-admin [email protected] \
--app-name cool-laravel-app \
--app-build-path /path/to/your/local/cool-laravel-app-0.7rc.tar.gz \
--laravel-artisan-commands key:generate,migrate
```

Set up a LAMP stack with various custom configuration and a self signed SSL certificate on some local VM:

```
lampsible [email protected] lamp-stack \
--ask-remote-sudo \
--ssl-selfsigned \
--database-username dbuser \
--database-name testdb \
--php-version 8.1 \
--apache-vhost-name some-legacy-app \
--apache-document-root /var/www/html/some-legacy-app/some-dir/public \
--php-extensions mysql,xml,mbstring,xdebug,gd
```

Run `lampsible --help` for a full list of options.

## Contributing

Please do! I'd be more than happy to see Issues, Pull Requests and any other kind of feedback ;-)