kunstmaan / skylab
Skylab is a 100% backwards compatible PHP port of the Python based hosting scripts used at Kunstmaan. By using the Cilex, Symfony Components and lot's of good code samples from the Composer project we hope to create an application where everyone in our organisation can work with, and if issues or ne
Installs: 26
Dependents: 0
Suggesters: 0
Security: 0
Stars: 11
Watchers: 16
Forks: 14
Open Issues: 9
Requires
- cilex/cilex: ~1.1
- ckdarby/php-uptimerobot: ^0.1.0
- cleentfaar/slack: dev-master
- doctrine/annotations: v1.2.7
- doctrine/collections: v1.3.0
- edyan/neuralyzer: dev-0.1x-maintenance
- guzzlehttp/guzzle: 5.3.2
- kunstmaan/cilex-twig: 1.0.x
- kunstmaan/pwgen-php: 0.1.x
- padraic/phar-updater: ^1.0
- raven/raven: 0.12.*
- sgrodzicki/pingdom: dev-master
- stecman/symfony-console-completion: ~0.4.4
- symfony/debug: 2.8
- symfony/dependency-injection: 2.8
- symfony/filesystem: 2.8
- symfony/serializer: ~2.1
- symfony/yaml: ~2.1
- dev-master
- 2.2.3
- 2.2.2
- 2.2.1
- 2.2.0
- 2.1.5
- 2.1.4
- 2.1.3
- 2.1.2
- 2.1.1
- 2.1.0
- 2.0.4
- 2.0.3
- 2.0.2
- 2.0.1
- 2.0.0
- 2.0.0-alpha
- 1.0.22
- 1.0.21
- 1.0.20
- 1.0.19
- 1.0.18
- 1.0.17
- 1.0.16
- 1.0.15
- 1.0.14
- 1.0.13
- 1.0.12
- 1.0.11
- 1.0.10
- 1.0.9
- 1.0.8
- 1.0.7
- 1.0.6
- 1.0.5
- 1.0.4
- 1.0.3
- 1.0.2
- 1.0.1
- 1.0.0
- 0.1.5
- 0.1.4
- 0.1.3
- 0.1.2
- 0.1.0
- 0.0.13
- 0.0.12
- 0.0.11
- 0.0.10
- 0.0.9
- 0.0.8
- 0.0.7
- 0.0.6
- 0.0.5
- 0.0.4
- 0.0.3
- 0.0.2
- 0.0.1
- dev-oldserver
This package is auto-updated.
Last update: 2024-10-29 04:53:02 UTC
README
Skylab is a 100% backwards compatible PHP port of the Python based hosting scripts used at Kunstmaan. By using the Cilex, Symfony Components and lots of good code samples from the Composer project we hope to create an application that everyone in our organisation can work with, and if issues or new needed features should arise, be able to work on.
Kunstmaan wouldn't be Kunstmaan if we didn't open-source this, so here it is. MIT licensed.
Installation
To install Skylab, run this command:
$ curl -sSL https://raw.github.com/Kunstmaan/skylab/master/installer | php
This will just check a few PHP settings and then download skylab.phar to your working directory. This file is the Skylab binary. It is a PHAR (PHP archive), which is an archive format for PHP which can be run on the command line, amongst other things.
You can install Skylab to a specific directory by using the --install-dir option and providing a target directory (it can be an absolute or relative path):
$ curl -sSL https://raw.github.com/Kunstmaan/skylab/master/installer | php -- --install-dir=/bin
You can also install Skylab globally by running:
$ curl -sSL https://raw.github.com/Kunstmaan/skylab/master/installer | php
$ mv skylab.phar /usr/local/bin/skylab
Configuration
You can override the default configuration by creating a file /etc/skylab.yml and give it a secure chmod
sudo chmod 700 /etc/skylab.yml
For example if you installed skylab on a developer OSX machine:
users:
wwwuser: apache
webserver:
engine: apache
hostmachine: XXXXX.kunstmaan.be
mysql:
user: root
password: XXXXXXXXX
postgresql:
user: postgres
password: XXXXXXXXX
debug: true
develmode: true
Or on an ubuntu system:
users:
wwwuser: www-data
webserver:
engine: apache
hostmachine: XXXXX.kunstmaan.be
mysql:
user: root
password: XXXXXXXXX
postgresql:
user: postgres
password: XXXXXXXXX
debug: true
develmode: true
Special Skeletons
SSL skeleton
The ssl
skeleton can be used to configure the SSL configurations in apache via the config.xml
You start by adding <item value="ssl"/>
to the skeletons in config.xml. Then you need to add <var name="project.sslConfig">
to the config.xml to configure the SSL configuration.
You can specify different SSL configuration that has to be used per environment. The syntax for each environment is the same
<var name="{environment}">
<dir value="{the location of the ssl files (cert, key, ca)}"/>
<certFile value="{the name of the cert file}"/>
<certKeyFile value="{the name of the key file}"/>
<caCertFile value="{the name of the ca cert file}"/>
</var>
Example (we assume three environments (dev,staging,prod)).
<var name="project.sslConfig">
<var name="dev">
<dir value="/home/myproject/ssl/dev/"/>
<certFile value="myproject_dev_ssl.crt"/>
<certKeyFile value="myproject_dev_ssl.key"/>
<caCertFile value="myproject_dev_ssl.ca-bundle"/>
</var>
<var name="staging">
<dir value="/home/myproject/ssl/staging/"/>
<certFile value="myproject_staging_ssl.crt"/>
<certKeyFile value="myproject_staging_ssl.key"/>
<caCertFile value="myproject_staging_ssl.ca-bundle"/>
</var>
<var name="prod">
<dir value="/home/myproject/ssl/prod/"/>
<certFile value="myproject_prod_ssl.crt"/>
<certKeyFile value="myproject_prod_ssl.key"/>
<caCertFile value="myproject_prod_ssl.ca-bundle"/>
</var>
</var>
Which ssl configuration will be used depends on the value env
in you skylab.yml file. Locally you should have env: dev
in you skylab.yml configuration file. If you do then when running maintenance it will add the dev SSL config in apache.
###Letsencrypt skeleton
The letsencrypt
skeleton can be used to generate ssl certificates for your site using the Let's Encrypt service.
To enable the use of letsenecrypt you have to add <item value="letsenecrypt"/>
to the config.xml.
The skeleton will create a ssl certificate for the urls project.url
and all the aliases in project.aliases
.
IMPORTANT NOTES:
- The letsencrypt skeleton will run the command only on a production server.
- Make sure the urls resolve to the IP where the command will run, otherwise it will fail.
- You can use the
ssl
andletsencrypt
skeletong together, BUT when enabling both the skeletons you must remove the prod ssl config. If the prod ssl config is available it will use that config instead of running letsencrypt. - The letsencrypt skeleton also creates a cronjob to renew the certs (e.g. 0 0 * * 0 letsencrypt --apache -n certonly -d myproject.com)
Commands
NewProjectCommand
Usage: php skylab.phar new [--hideLogo] [--no-interactive] [--] [<name>]
The new
command creates a new project. It will setup the directory structure and apply the "base" skeleton
which is responsible for setting up users, permissions and ownership.
php skylab.phar new
php skylab.phar new testproject
Full details at doc/NewProjectCommand.md
FetchCommand
Usage: php skylab.phar fetch [--hideLogo] [--no-interactive] [-l|--location [LOCATION]] [--no-database] [--] [<project>] [<host>]
The fetch
command fetches a Skylab project from a server and puts it in the right locations on your computer. It
will also drop the databases, so be very careful if you want to use this on a production server to do a migration.
php skylab.phar fetch
# Will ask for a project and server to fetch it from
php skylab.phar fetch testproject server1
# Will fetch the testproject from server1
Full details at doc/FetchCommand.md
ShareCommand
Usage: php skylab.phar share [--hideLogo] [--no-interactive]
The share
command shows a table of all your locally installed projects together with the xip.io url.
php skylab.phar share
# Will show the xip.io table
Full details at doc/ShareCommand.md
SetPermissionsCommand
Usage: php skylab.phar permissions [--hideLogo] [--no-interactive] [--] <name>
The permissions
command will fix the permissions of a project.
php skylab.phar permissions testproject
Full details at doc/SetPermissionsCommand.md
MaintenanceCommand
Usage: php skylab.phar maintenance [--hideLogo] [--no-interactive] [--quick]
The maintenance
command will run the maintenance commands of all skeletons on a project. Most notably, it
will create the apache config files and make sure the the databases are available.
php skylab.phar maintenance
Full details at doc/MaintenanceCommand.md
BackupCommand
Usage: php skylab.phar backup [--hideLogo] [--no-interactive] [--quick] [--] [<project>]
The backup
command will dump all your databases and create a tarball of one or all projects.
php skylab.phar backup # Will backup all projects
php skylab.phar backup myproject # Will backup the myproject project
php skylab.phar backup myproject --quick # Will backup the myproject project, but not create the tar file.
php skylab.phar backup myproject --quick --anonymize # Will backup the myproject project, but not create the tar file, and anonymize the database with the edyan/neuralizer package.
Full details at doc/BackupCommand.md
RemoveProjectCommand
Usage: php skylab.phar remove [--hideLogo] [--no-interactive] [--force] [--no-backup] [--] [<name>]
The remove
command will remove the project after creating a backup first.
php skylab.phar remove testproject
# Will remove the testproject project
php skylab.phar remove testproject --force
# Will do the same, but don't ask you if you are sure.
Full details at doc/RemoveProjectCommand.md
ApplySkeletonCommand
Usage: php skylab.phar apply [--hideLogo] [--no-interactive] [-l|--list] [--] [<project>] [<skeleton>]
The apply
command applies a skeleton, and all it's dependencies to a project. It will run the "create"
method in the skeleton to setup all the requirements for that skeleton.
php skylab.phar apply -l
# Lists all available skeletons
php skylab.phar apply
# Will ask for a project and skeleton to apply
php skylab.phar apply testproject anacron
# Will apply the anacron skeleton to testproject
Full details at doc/ApplySkeletonCommand.md
SelfUpdateCommand
Usage: php skylab.phar self-update [--hideLogo] [--no-interactive] [-d|--dev] [-N|--non-dev] [-p|--pre] [-s|--stable] [-r|--rollback] [-c|--check]
The self-update
command will check if there is an updated skylab.phar released and updates if it is.
php skylab.phar self-update
Full details at doc/SelfUpdateCommand.md
Compiling a new version
- First, make sure everything works and the Travis tests are green
- Generate an updated changelog using
git changelog
from git-extras - Commit this new changelog
- Create a new release from the Github interface, add the new changelog part in the description and name the release for the next brightst star in this list
- download box.par to create the new version
- Build a new version using box.phar box.phar build -v. Note: make sure you have pulled in the latest tag!!
- Add the new phar file to the release on GitHub
- Update packagist
Modifying the documentation
- Most text is in
gen-doc
, edit what you want there. - Everything in doc/ is generated, same goes for everything in README.md under Commands
- Run
./gen-doc > README.md
to update the docs - Send a pull request
Contributing
- Fork Skylab
- Do your thing, and send a Pull Request. But please make sure Travis is green and your code has been run through php-cs-fixer!
Documentation generated on 2017-12-19 12:42:37